How to add a car to a FiveM server

fx_version 'cerulean'
game 'gta5'

files {
    'data/vehicles.meta',
    'data/handling.meta',
    'data/carvariations.meta',
    'data/carcols.meta',
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'

The .yft and .ytd files need no line: everything in stream/ is streamed. The folder has to be called stream in lowercase; on a Linux server Stream/ is a different folder.

The spawn name is the <modelName> in vehicles.meta. It has to match the .yft file name exactly, in lowercase, and <txdName> has to match the .ytd. The <handlingId> has to match the <handlingName> of an entry in handling.meta.

<modelName>mycar</modelName>
<txdName>mycar</txdName>
<handlingId>MYCAR</handlingId>

A mismatch between the file name and modelName is the most common reason a car does not spawn. See Vehicle or ped model not found. For the cars that come with GTA V, the spawn names of 548 of them are on their pages in Livery templates.

1. 1

   Copy the folder

   Put the car's folder, with stream/, data/ and fxmanifest.lua inside, in your server's resources/ folder.

2. 2

   Start it

   Add ensure mycar to server.cfg, with the folder's name.

3. 3

   Restart the server

   Then connect to it again.

4. 4

   Spawn it

   With /car mycar on servers that have a car spawn command, from a garage, or from a script (below).

5. 5

   Add it to your framework

   Garages and dealerships keep their own vehicle list. Add the spawn name there like any add-on car.

local model = `mycar`
RequestModel(model)
while not HasModelLoaded(model) do Wait(0) end
local ped = PlayerPedId()
local pos = GetOffsetFromEntityInWorldCoords(ped, 0.0, 5.0, 0.5)
local veh = CreateVehicle(model, pos.x, pos.y, pos.z, GetEntityHeading(ped), true, false)
SetPedIntoVehicle(ped, veh, -1)
SetModelAsNoLongerNeeded(model)

An add-on car has a new name, so the game's cars stay as they are. A replace streams files named like a game car (for example sultanrs.yft): every car of that model on the server changes. Only one resource can replace a given model; if two do, the load order decides which one wins.

The Vehicle Creator builds the add-on resource for you, starting from a car in the game:

1. 1

   Vehicle

   Pick any GTA V car, or upload your own .yft and .ytd or its resource zip (paid plan or Pro Pass).

2. 2

   Paint, Livery, Parts, Wheels

   Paint and finish; a livery designed on the body; parts from any car in the game, placed on the matching bone; parts you click on the car and remove, such as a badge or a bumper; wheels from the mod shop list.

3. 3

   Handling, Lights, Plate

   Engine, brakes, gearbox and suspension; xenon and neon; the plate text and style.

4. 4

   Download

   Each car comes out as a model of its own, built on our server, with its meta files in data/<name>/. Spawn it with /car <name>, a garage or a script; there are no commands to run.

Neon, xenon, window tint, the plate and extras are not stored in a vehicle model, so a small client.lua puts them on when the car appears. The handling starts from the car it was built on, with your engine, brakes, gearbox and suspension already in data/<name>/handling.meta.

Free to try with your Discord login: 10 exports the first month and 5 a month after on the Free plan, unlimited on any paid plan. See pricing.