> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Exportar como resource

> Transforme um projeto em uma pasta de resource do FiveM e atualize-a quando o projeto mudar.

**Exportar** grava o projeto como um resource do FiveM: os arquivos do jogo, um `fxmanifest.lua` e um `README.txt` com notas de instalação. O projeto precisa ter conteúdo para exportar: uma textura com uma camada visível, uma estrutura, um prop ou uma viatura definida como **Modelo novo** ou com ao menos uma personalização.

## Exportar pela primeira vez

**1. Abra o menu Exportar**

Clique em **Exportar** na barra do projeto. **Pasta** exporta para qualquer pasta. **Servidores FiveM** lista os servidores que você vinculou, para exportar direto em um deles. [Vincule um servidor](/pt-BR/projects/hot-reload.md#vincular-um-servidor) antes se a lista não aparecer.

![Menu Exportar com Escolher pasta e uma lista de servidores FiveM](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/projects-export-destinations.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=5a58baf8302bb099623d3b0892a9d589)

Destinos de exportação: uma pasta e quatro servidores vinculados.

**2. Escolha o destino**

Clique em **Escolher pasta…** ou em um servidor e depois escolha uma pasta. Para um servidor, escolha uma pasta dentro da pasta `resources/` dele, ou uma pasta de categoria dentro dela: o FiveM não carrega um resource de nenhum outro lugar.

**3. Confira a pasta do resource**

O diálogo propõe um nome de **Pasta do resource** e mostra o caminho final abaixo. Mude o nome se quiser e clique em **Exportar**.

![Diálogo Exportar para uma pasta com o campo Pasta do resource e o caminho final](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/projects-export-folder-name.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=5e09ae549df98d6d967c57bb5fc3a59d)

O nome da pasta do resource e onde ela será criada.

**4. Acompanhe o progresso**

**Exportando projeto** passa por quatro fases: **Verificar o documento**, **Escrever os arquivos do jogo**, **Gerar fxmanifest e README** e **Publicar na pasta de destino**.

![Diálogo Exportando projeto com quatro fases e Cancelar exportação](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/projects-export-running.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=56104dc32e8536ae9a4331dcddbb9a81)

Uma exportação na segunda fase.

**5. Leia o resultado**

**Projeto exportado** lista os arquivos do jogo gerados com os tamanhos. A pasta também contém `fxmanifest.lua` e `README.txt`, que não aparecem nessa tabela. **Abrir pasta** mostra o resultado no seu gerenciador de arquivos.

![Diálogo Projeto exportado com uma tabela de arquivos gravados](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/projects-export-done.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=c448d369c3aeeae61cd85dee5e798896)

Arquivos do jogo gravados pela exportação do projeto.

Mantenha a pasta do resource exportado dentro de `resources/` do servidor. Adicione `ensure <resource>` ao `server.cfg`, trocando `<resource>` pelo nome da pasta exportada, e reinicie o servidor. O Rageon não adiciona essa linha para você.

## O nome da pasta

O app limpa o nome para letras minúsculas, dígitos, `_` e `-`, sem acentos. Ele corta esse nome limpo em 60 caracteres antes de acrescentar `r_` se começar com dígito. Um campo **Pasta do resource** vazio usa o nome do projeto; um nome sem nenhum caractere utilizável vira `rageon_mod`. O caminho abaixo do campo mostra o resultado; o campo em si continua como você digitou.

## Atualizar uma exportação

Um destino que você já usou exporta na hora quando você clica nele, sem diálogos. A nova exportação substitui o resource anterior por completo: um arquivo que o projeto não gera mais some da pasta.

* Para mudar a pasta ou o nome sem exportar, use **Pasta e nome do resource…** no destino, ajuste e clique em **Salvar**.
* Dentro de uma edição de textura, estrutura, prop ou veículo, o menu do projeto tem **Exportar** (**Ctrl+E**). Ele repete o único destino que o projeto lembra. Com nenhum ou vários lembrados, usa **Escolher pasta…**. Um destino de pasta lembrado atualiza direto; caso contrário, o Rageon pede uma pasta e um nome de resource.
* Se a pasta lembrada não existir mais, o Rageon pede uma pasta de novo.

> [!WARNING]
>
> Exportar sobre um resource existente substitui tudo nele. Se você mudou arquivos dessa pasta à mão, copie-os para fora antes.

## Minimizar ou cancelar

**Minimizar exportação** esconde o diálogo e a exportação continua rodando. Acompanhe e reabra pela lista de Tarefas. **Cancelar exportação** funciona até a última fase começar. Uma exportação cancelada não publica nada, e o resource anterior continua como estava.

![Diálogo de exportação cancelada dizendo que nada foi publicado](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/projects-export-canceled.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=ad99e3a15473de85d8c7c8045a1d3382)

Uma exportação cancelada deixa o destino intacto.

## Avisos

Leia os **Avisos** antes de instalar o resource. Alguns avisos significam que parte das mudanças pedidas para um veículo ficou de fora; uma exportação bem-sucedida não garante que toda mudança foi gravada.

![Diálogo Projeto exportado com uma seção Avisos mostrando 4](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/projects/projects-export-finished.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=e966a5bb44204cf25baad68b97b0a7ec)

Uma exportação concluída com quatro avisos.

## O que cada ferramenta grava

Edições de textura, estruturas, props e viaturas vão todas para o mesmo resource. Uma viatura com modelo novo é exportada para a própria pasta em `stream/`. Cores, sirenes e handling vão para os arquivos meta do veículo, e peças, rodas e extras precisam do trecho de Lua no `README.txt` da exportação, executado pelo script do seu servidor depois que cada veículo é criado. Veja [Viaturas](/pt-BR/projects/emergency-vehicles/overview.md).

Para viaturas, `carvariations.meta` guarda as trocas de cor, `carcols.meta` guarda as sirenes editadas e `handling.meta` guarda as mudanças de handling na raiz do resource. Um **Modelo novo** também acrescenta `vehicles.meta`, `viaturas.lua` para o nome no jogo e arquivos de modelo em `stream/<spawn name>/`. Veículos com giroflexos também gravam arquivos de modelo `.yft` em `stream/<model>/`. Os arquivos são incluídos conforme a necessidade.

Para trocas de textura no jogo, instale e inicie o `rageon-bridge` antes de iniciar o resource exportado. Se a exportação avisar que o bridge do servidor está ausente ou desatualizado, atualize em **Configurações** › **Bridge** e reinicie o servidor. A exportação ainda pode terminar com esse aviso.

## Limites e planos

A exportação confere as texturas por projeto, as estruturas por projeto e os interiores por estrutura com o seu plano atual. Servidores além do limite do plano continuam na sua lista, mas não aparecem como destinos. Os detalhes estão na [página de preços](https://rageon.dev/pricing).

## Solução de problemas

> **O projeto não tem nada para exportar: nenhuma textura com camadas e nenhuma estrutura, prop ou viatura com conteúdo.**
>
> Adicione conteúdo primeiro. Texturização precisa de uma camada visível. Um **Modelo novo** basta; um veículo definido como **Altera o modelo do jogo** precisa de ao menos uma personalização.

> **Nenhuma camada visível para exportar.**
>
> Todas as camadas da textura estão escondidas. Mostre uma.

> **Nenhum conteúdo pôde ser exportado.**
>
> Nenhum conteúdo utilizável foi gerado. Se um veículo estiver vazio, defina-o como **Modelo novo** ou personalize-o; confira também se há camadas de textura escondidas.

> **A pasta precisa ficar dentro de resources/ do servidor — fora dela o FiveM não carrega o resource.**
>
> Escolha uma pasta dentro da pasta `resources/` do servidor.

> **A pasta de destino existe e não é um resource. Escolha outro nome.**
>
> A pasta existente não tem `fxmanifest.lua`. Escolha outro nome de **Pasta do resource**.

> **A pasta de destino está nas fontes do app, e o ….yft dela já é a exportação anterior. Remova a pasta das fontes do app ou exporte para outra pasta.**
>
> Você exportou para uma pasta que o app lê como arquivos do jogo. Exporte para outro lugar, ou remova essa pasta das fontes do jogo que o app lê.

> **Exportação bloqueada: …**
>
> O Verificador de uma estrutura, prop ou veículo encontrou um erro. Abra o item e corrija o que ele lista. Para veículos, veja o [Verificador](/pt-BR/projects/emergency-vehicles/checker.md).

> **Duas pinturas usam entradas diferentes do modelo "…".**
>
> Duas pinturas do mesmo carro apontam para entradas diferentes. Mantenha uma.

> **O modelo novo "…" também recebe uma pintura da Texturização.**
>
> A Texturização editou o modelo novo de uma viatura. Remova a edição de pintura para esse spawn name. Um **Modelo novo** não pode ser exportado com uma pintura da Texturização apontando para o mesmo modelo. Veja [Liveries](/pt-BR/projects/emergency-vehicles/overview.md#liveries).

> **A viatura "…" (…) está sem …; o resource não foi publicado.**
>
> O Rageon não conseguiu ler parte do veículo nos arquivos do jogo. Leia os avisos da exportação e tente de novo.

> **Já há uma exportação em andamento**
>
> Espere a exportação em andamento terminar.

> **Sua sessão é anterior aos limites dos planos. Entre na sua conta de novo.**
>
> Saia e entre de novo.

> **A exportação falhou: …**
>
> Leia o motivo depois dos dois-pontos. Nada é publicado quando uma exportação falha.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.