> ## 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.

# Viaturas

> Crie uma viatura a partir de um carro do jogo: cores, peças, giroflexos, sirenes e handling que vão no resource do seu projeto.

Uma viatura é um carro do jogo configurado para o seu servidor: cores de fábrica, peças, extras, giroflexos, sirenes e handling. Cada uma é salva como um arquivo próprio na pasta do projeto, então o projeto precisa estar salvo antes.

Abra **Ferramentas** › **Veículos** › **Viaturas**. A galeria mostra um cartão por veículo. Clique em um cartão para abri-lo, ou clique no ícone de lixeira (**Apagar …**) e confirme para removê-lo.

> [!WARNING]
>
> Apagar um veículo remove o arquivo dele da pasta do projeto. Não há como desfazer.

![Galeria de quatro cartões de viatura com miniaturas](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-gallery.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=33b40bb0deb982e511fd6c995e895f56)

Uma galeria com quatro viaturas.

![Confirmação de apagar viatura sobre a galeria](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-delete-confirm.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=f296e6775ae45d92b03fbeaf5100fdce)

Apagar um veículo pede confirmação.

Antes do primeiro veículo, a galeria se explica sozinha. Em um projeto que nunca foi salvo, **Nova viatura** fica desativado até você salvar.

![Galeria vazia com Nenhuma viatura e um botão Nova viatura](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-empty-gallery.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=c57469d5e3fa0471dd0b8782fbe7ef14)

Um projeto salvo sem veículos.

![Galeria pedindo para salvar o projeto para começar](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-save-first.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=a7fd1a14eaa985cfdf419b361e8ba571)

Um projeto que nunca foi salvo.

## Criar uma viatura

**1. Abra o diálogo**

Clique em **Nova viatura**. Você também pode começar por **Assets**: selecione um carro, depois **Abrir em** › **Projetos** › **Viatura**, e escolha o projeto aberto, um projeto recente ou **Novo projeto**. Salve antes o projeto escolhido, se for solicitado. Isso cria um veículo de modelo novo com o nome do carro, com um número acrescentado se o nome já estiver em uso.

**2. Dê um nome e escolha o modo do modelo**

Digite o **Nome da viatura** e escolha **Modelo novo** (o padrão) ou **Altera o modelo do jogo**. Em **Modelo novo**, o **Nome de spawn** e o **Nome no jogo** são sugeridos a partir do nome do veículo até você editá-los. Depois da criação, mude-os em **Modelo**; o carro base fica fixo, então crie outro veículo para usar uma base diferente.

* **Modelo novo** cria um carro novo com spawn name próprio. Nenhum carro do jogo muda. Defina o **Nome de spawn** (o nome do modelo usado pelo script de spawn de veículos do seu servidor) e o **Nome no jogo** que o jogo exibe.
* **Altera o modelo do jogo** edita o carro do próprio jogo para o servidor inteiro. Cores, sirenes e handling passam a valer para todo carro desse modelo.

![Diálogo de nova viatura com Modelo novo, spawn name, nome no jogo e police3 selecionado](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-new-dialog.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=9d0acd90d03e783fdab905ceda6c20d5)

Um modelo novo baseado no police3.

![Diálogo com Altera o modelo do jogo e um aviso âmbar sobre todos os modelos do servidor](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-new-dialog-game-model.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=e09b6e316f007aac09ed8f81ebefa87a)

Altera o modelo do jogo mostra um aviso sobre o servidor inteiro.

**3. Escolha o carro base**

Digite ao menos duas letras em **Carro base** para buscar, ou escolha na lista de veículos de classe de emergência. Antes de você digitar dois caracteres, os carros que você editou na Texturização aparecem antes da lista de classe de emergência, marcados como **Texturizado**.

**4. Clique em Criar viatura**

O veículo abre no palco e o arquivo dele já está na pasta do projeto. **Criar viatura** fica desativado até o nome conter uma letra ou número, um carro base estar selecionado e os campos do modelo serem válidos. Para **Modelo novo**, ele também espera a verificação do spawn name; uma verificação que falhou oferece **Tentar novamente**, e a exportação confere o nome de novo.

Um spawn name tem de 3 a 16 caracteres, começa com uma letra minúscula e continua com letras minúsculas, dígitos ou `_`. Ele não pode coincidir com um veículo que já existe nos arquivos do jogo nem com o modelo final de outro veículo do projeto. Confira também os outros resources do seu servidor para ver se há o mesmo spawn name.

![Diálogo de nova viatura com uma mensagem âmbar de que o modelo já existe](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-new-dialog-errors.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=d245fc4a08e1f3860d3cc366e89c2257)

Um spawn name que já existe nos arquivos do jogo.

## O editor

Use a **Ficha da viatura** para editar o carro e a linha do tempo para ouvir a prévia do padrão de sirene. As luzes no palco piscam no ritmo da linha do tempo.

![Palco com uma viatura de polícia, a linha do tempo das sirenes e a ficha do veículo](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-overview.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=02310acc15063348820244c596778361)

Uma viatura aberta no palco.

| Página | O que cobre |
| - | - |
| [Cores, peças e extras](/pt-BR/projects/emergency-vehicles/appearance.md) | Pinturas de fábrica, peças do kit, rodas, extras. |
| [Giroflexos](/pt-BR/projects/emergency-vehicles/lightbars.md) | O catálogo de giroflexos e como posicionar um. |
| [Sirenes](/pt-BR/projects/emergency-vehicles/sirens.md) | A linha do tempo, os padrões e a aparência de cada luz. |
| [Handling](/pt-BR/projects/emergency-vehicles/handling.md) | Valores de condução. |
| [Verificador](/pt-BR/projects/emergency-vehicles/checker.md) | Erros que bloqueiam a exportação, e avisos. |

**Ctrl+S** salva só o veículo aberto. Para renomeá-lo, salve primeiro e depois clique no nome dele na barra. Clique em **Voltar à lista de viaturas** para fechá-lo; o Rageon pergunta antes de descartar mudanças não salvas.

![Galeria com um cartão de um arquivo que não abre e um cartão marcado como repetindo outro modelo](https://mintcdn.com/rageon/MDCPTWhXTgKhzlYR/images/pt_br/vehicles/evs-broken-gallery.webp?fit=max\&auto=format\&n=MDCPTWhXTgKhzlYR\&q=85\&s=2f4724f5811b0f5bb137418528d9d513)

Cartões com um arquivo quebrado e um modelo repetido.

Um cartão com um triângulo de aviso é um arquivo que não abre: você só pode apagá-lo. Um cartão com um ✕ vermelho repete o modelo final de outro veículo, o que bloqueia a exportação. Mude o spawn name de um deles, ou apague-o.

## Liveries

Liveries e outros trabalhos de textura de um veículo do projeto são feitos na [Texturização](/pt-BR/projects/texturing/overview.md). Na Texturização, o carro aparece fixado e vestido como a viatura. As edições de Texturização apontam para o carro base: uma livery nele não acompanha um **Modelo novo**. A exportação também rejeita uma livery de Texturização que aponte para o novo spawn name. Para usar uma livery no carro base, use **Altera o modelo do jogo**; giroflexos nesse modelo entram em conflito com uma edição de Texturização que grava o mesmo `.yft`.

## No jogo

Exporte o projeto para ter o veículo no jogo ([Exportar como resource](/pt-BR/projects/export.md)). Um modelo novo é exportado para a própria pasta em `stream/`; faça o spawn com o comando de spawn de veículos do seu servidor e o **Nome de spawn** dele. O Rageon não adiciona um comando de spawn. Cores, sirenes e handling são gravados nos arquivos meta do veículo e valem para todo spawn desse modelo. Aplique peças, rodas e extras executando o trecho de Lua do `README.txt` da exportação a partir do script do seu servidor depois que cada veículo for criado; veja [Cores, peças e extras](/pt-BR/projects/emergency-vehicles/appearance.md#no-jogo).

Se o carro base vem de um mod, inicie o resource desse mod antes do resource deste projeto, para que os layouts, o áudio e as texturas compartilhadas dele possam carregar.

A exportação pega o veículo como ele está na tela, salvo ou não. Um **Modelo novo** é exportado mesmo com os ajustes de fábrica. Em **Altera o modelo do jogo**, um veículo sem personalizações fica de fora. Não há hot reload para veículos: exporte e depois reinicie ou use `ensure` no resource.

## Limites e planos

Viaturas não têm limite de plano próprio. Os limites do projeto continuam valendo: salvar o projeto conta no limite de projetos do seu plano, e uma exportação falha se o projeto passar dos limites do plano para texturas, estruturas ou interiores. Os detalhes estão na [página de preços](https://rageon.dev/pricing).

## Solução de problemas

> **Use um spawn name de 3 a 16 caracteres, começando com uma letra minúscula, seguida de letras minúsculas, números ou \_.**
>
> Corrija o **Nome de spawn**.

> **O modelo "…" já existe nas fontes do GTA. Escolha outro spawn name.**
>
> O spawn name coincide com um veículo do jogo ou de mod. Use outro.

> **Outra viatura já usa o modelo "…". "…" repete a entrada do mesmo modelo.**
>
> Dois veículos acabam com o mesmo modelo. Mude o spawn name de um, ou apague um.

> **Já existe uma viatura chamada "…" neste projeto.**
>
> O nome já está em uso. Escolha outro **Nome da viatura**.

> **Preencha o nome no jogo.**
>
> O **Nome no jogo** está vazio.

> **Não foi possível criar a viatura. Tente de novo.**
>
> Clique em **Criar viatura** de novo. Se continuar falhando, confira se a pasta do projeto permite gravação.

> **Salve a viatura antes de renomeá-la.**
>
> Pressione **Ctrl+S** e depois renomeie.

> **O arquivo não é um JSON válido: …**
>
> O arquivo do veículo está danificado ou foi editado à mão. O cartão não abre; apague-o.

> **Campo inválido: …**
>
> Um campo do arquivo do veículo está errado. O cartão não abre; apague-o.

> **Viatura criada por uma versão mais nova do app (v…)**
>
> Abra o projeto em uma versão do app que suporte este arquivo de veículo. Mantenha o arquivo enquanto atualiza o app.

> **Não foi possível carregar as viaturas: …**
>
> A pasta do projeto não pôde ser lida. Reabra o projeto.

Outras mensagens `Não foi possível …` terminam com o motivo vindo do disco.


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