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

# Emergency vehicles

> Create an emergency vehicle from a game car: colors, parts, lightbars, sirens, and handling that ship in your project resource.

An emergency vehicle is a game car configured for your server: stock colors, parts, extras, lightbars, sirens, and handling. Each one is saved as its own file in the project folder, so the project must be saved first.

Open **Tools** › **Vehicles** › **Emergency vehicles**. The gallery shows one card per vehicle. Click a card to open it, or click the trash icon (**Delete …**) and confirm to remove it.

> [!WARNING]
>
> Deleting a vehicle removes its file from the project folder. There is no undo.

![Gallery of four emergency vehicle cards with thumbnails](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-gallery.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=1d05b97f94b7ebc95c50a37b34b23583)

A gallery with four emergency vehicles.

![Delete emergency vehicle confirmation over the gallery](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-delete-confirm.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=817eff44658ef7ffafd128b3cb30e58c)

Deleting a vehicle asks for confirmation.

Before the first vehicle, the gallery explains itself. In a project that was never saved, **New emergency vehicle** stays disabled until you save.

![Empty gallery with No emergency vehicles and a New emergency vehicle button](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-empty-gallery.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=893686de52a980f31b2059f23f1977b9)

A saved project with no vehicles.

![Gallery asking to save the project to get started](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-save-first.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=a8397580119d8f9dca56968bc68579b7)

A project that was never saved.

## Create an emergency vehicle

**1. Open the dialog**

Click **New emergency vehicle**. You can also start from **Assets**: select a car, then **Open in** › **Projects** › **Emergency vehicle**, then choose the open project, a recent project, or **New project**. Save the chosen project first if prompted. This creates a new-model vehicle named after the car, with a number added if the name is taken.

**2. Name it and pick the model mode**

Type the **Emergency vehicle name**, then choose **New model** (the default) or **Changes the game model**. In **New model**, **Spawn name** and **In-game name** are suggested from the vehicle name until you edit them. After creation, change these in **Model**; the base car stays fixed, so create another vehicle to use a different base.

* **New model** makes a new car with its own spawn name. No game car changes. Set the **Spawn name** (the model name used by your server's vehicle-spawn script) and the **In-game name** the game shows.
* **Changes the game model** edits the game's own car for the whole server. Colors, sirens, and handling then apply to every car of that model.

![New emergency vehicle dialog with New model, spawn name, in-game name, and police3 selected](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-new-dialog.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=7e5cefe621e76c0c6ccc1321594053f3)

A new model based on police3.

![Dialog with Changes the game model and an amber note about every model on the server](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-new-dialog-game-model.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=a8b4eca4f273d46d6464cefa0f3fe80c)

Changes the game model shows a note about the whole server.

**3. Choose the base car**

Type at least two letters in **Base car** to search, or pick from the list of emergency-class vehicles. Before you enter two characters, cars you edited in Texturing appear before the emergency-class list, marked **Textured**.

**4. Click Create emergency vehicle**

The vehicle opens on the stage and its file is already in the project folder. **Create emergency vehicle** stays disabled until the name contains a letter or number, a base car is selected, and the model fields are valid. For **New model**, it also waits for the spawn-name check; a failed check offers **Try again**, and export checks the name again.

A spawn name has 3 to 16 characters, starts with a lowercase letter, and continues with lowercase letters, digits, or `_`. It cannot match a vehicle that already exists in the game files or another vehicle's final model in the project. Also check your server's other resources for the same spawn name.

![New emergency vehicle dialog with an amber message that the model already exists](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-new-dialog-errors.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=20b24cb3fcfc01d7762866b9be00fec8)

A spawn name that already exists in the game files.

## The editor

Use the **Emergency vehicle sheet** to edit the car and the timeline to preview its siren pattern. Lights on the stage flash in time with the timeline.

![Stage with a police car, siren timeline, and the vehicle sheet](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-overview.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=f87b088c2ff9d0ef337db363bcbfdc0d)

An emergency vehicle open on the stage.

| Page | What it covers |
| - | - |
| [Colors, parts and extras](/projects/emergency-vehicles/appearance.md) | Stock paints, kit parts, wheels, extras. |
| [Lightbars](/projects/emergency-vehicles/lightbars.md) | The lightbar catalog and how to place one. |
| [Sirens](/projects/emergency-vehicles/sirens.md) | The timeline, patterns, and the look of each light. |
| [Handling](/projects/emergency-vehicles/handling.md) | Driving values. |
| [Checker](/projects/emergency-vehicles/checker.md) | Errors that block the export, and warnings. |

**Ctrl+S** saves the open vehicle only. To rename it, save first, then click its name in the bar. Click **Back to the emergency vehicle list** to close it; Rageon asks before discarding unsaved changes.

![Gallery with a card for a file that does not open and a card marked as repeating another model](https://mintcdn.com/rageon/TCzaS11pSGz1CPPK/images/vehicles/evs-broken-gallery.webp?fit=max\&auto=format\&n=TCzaS11pSGz1CPPK\&q=85\&s=95e0961b8c5c9bc8a56fe15c19935a7a)

Cards with a broken file and a repeated model.

A card with a warning triangle is a file that does not open: you can only delete it. A card with a red ✕ repeats the final model of another vehicle, which blocks the export. Change the spawn name of one of them, or delete it.

## Liveries

Liveries and other texture work for a project vehicle are made in [Texturing](/projects/texturing/overview.md). In Texturing, the car appears pinned and dressed as the emergency vehicle. Texturing edits target the base car: a livery on it does not follow a **New model**. Export also rejects a Texturing livery that targets the new spawn name. To use a livery on the base car, use **Changes the game model**; lightbars on that model conflict with a Texturing edit that writes the same `.yft`.

## In the game

Export the project to get the vehicle in game ([Export as a resource](/projects/export.md)). A new model exports to its own folder under `stream/`; spawn it with your server's vehicle-spawn command and its **Spawn name**. Rageon does not add a spawn command. Colors, sirens, and handling are written to the vehicle's meta files and apply to every spawn of that model. Apply parts, wheels, and extras by running the Lua snippet in the export's `README.txt` from your server script after each vehicle is created; see [Colors, parts and extras](/projects/emergency-vehicles/appearance.md#in-the-game).

If the base car comes from a mod, start that mod's resource before this project's resource so its layouts, audio, and shared textures can load.

The export takes the vehicle as it is on screen, saved or not. A **New model** exports even with stock settings. In **Changes the game model**, a vehicle with no customizations is left out. There is no hot reload for vehicles: export, then restart or `ensure` the resource.

## Limits and plans

Emergency vehicles have no plan limit of their own. The project limits still apply: saving the project counts against your plan's project limit, and an export fails if the project goes over the plan's limits for textures, structures, or interiors. Details are on the [pricing page](https://rageon.dev/pricing).

## Troubleshooting

> **Use a spawn name of 3 to 16 characters, starting with a lowercase letter, followed by lowercase letters, numbers or \_.**
>
> Fix **Spawn name**.

> **The model "…" already exists in the GTA sources. Choose another spawn name.**
>
> The spawn name matches a game or mod vehicle. Use another.

> **Another emergency vehicle already uses the model "…". "…" repeats the entry for the same model.**
>
> Two vehicles end up with the same model. Change the spawn name of one, or delete one.

> **An emergency vehicle named "…" already exists in this project.**
>
> The name is taken. Pick another **Emergency vehicle name**.

> **Fill in the in-game name.**
>
> **In-game name** is empty.

> **Could not create the emergency vehicle. Try again.**
>
> Click **Create emergency vehicle** again. If it keeps failing, check that the project folder is writable.

> **Save the emergency vehicle before renaming it.**
>
> Press **Ctrl+S**, then rename.

> **The file is not valid JSON: …**
>
> The vehicle file is damaged or was edited by hand. The card cannot open; delete it.

> **Invalid field: …**
>
> A field of the vehicle file is wrong. The card cannot open; delete it.

> **Emergency vehicle created by a newer version of the app (v…)**
>
> Open the project in an app version that supports this vehicle file. Keep the file while you update the app.

> **Couldn't load the emergency vehicles: …**
>
> The project folder could not be read. Reopen the project.

Other `Couldn't …` messages end with the reason from the disk.


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