Prerequisites
Before installing car mods, make sure you have:
- A working FiveM server (txAdmin, or manual setup)
- FTP/file access to your server files
- A converted vehicle resource (from GTA5 Mods Convertor or manually converted; see how to convert GTA5-Mods.com vehicles if you do not have one yet)
Tip
Run the zip through the Resource Inspector before you upload it. It catches the problems that otherwise show up as an invisible car after a restart.
Step-by-Step Installation
Step 1: Access Your Server Files
Connect to your server via FTP, SFTP, or your hosting panel's file manager. Navigate to the root of your server directory.
Step 2: Locate the Resources Folder
Find the resources directory. Depending on your setup, it might be at:
/server-data/resources/Many servers organize vehicle mods into a subfolder:
/server-data/resources/[vehicles]/Step 3: Upload the Resource
Extract the ZIP file from the converter and upload the resource folder. Your folder structure should look like:
resources/
[vehicles]/
your-vehicle-name/
fxmanifest.lua
stream/
vehicle.yft
vehicle.ytd
...
common/
vehicles.meta
handling.meta
carvariations.metaThe converter puts the meta files in common/. A resource built by hand, or a pack from the Car Pack Builder, usually has them in data/ instead; either works as long as the manifest points at the right folder. A converted replace mod has only the stream/ folder and the manifest.
Step 4: Update server.cfg
Open your server.cfg file and add the ensure line:
ensure your-vehicle-nameIf you're using a [vehicles] folder, you can ensure the entire folder:
ensure [vehicles]Building a config from scratch? The Server.cfg Generator lays out the resource order for you.
Step 5: Restart the Server
Restart your FiveM server. The vehicle will now be available for spawning.
Step 6: Test the Vehicle
Join your server and spawn the vehicle using the in-game command:
/spawn vehiclenameOr use a vehicle spawner menu like vMenu or QBCore's vehicle shop.
The spawn name is the model name inside the resource, not the folder name. To check that the command itself works, try a stock car first; the GTA 5 vehicle spawn names list has the base game names. If the game answers with an error, see fixing 'Invalid Model'.
Troubleshooting Common Issues
Vehicle doesn't appear in-game
- Check that the resource is started: run
ensure resource-namein the server console - Verify the
fxmanifest.luaexists and has correct syntax - Check server console for error messages
Vehicle model is invisible or broken
- Make sure all streaming files (.yft, .ytd) are in the
stream/folder - Work through the seven causes of an invisible car
- A black or white car is a texture problem: see FiveM missing textures
- If none of that helps, the original mod may be broken; try another version of the same car
Server crashes when loading the vehicle
- The mod may be too large or have incompatible files
- Check your server's RAM usage
- Try removing and re-adding the resource
Handling feels wrong
- Edit the
handling.metafile to adjust vehicle physics - Some mods include multiple handling configurations
- Mastering handling.meta explains which values to change, and the Handling Editor lets you change them without touching XML
Best Practices
- Organize by category: Use subfolders like
[vehicles],[vehicles-addon] - Keep backups: Before adding new mods, backup your resources folder
- Test individually: Add one vehicle at a time to catch issues early
- Monitor performance: Each streamed vehicle is downloaded by players and held in their memory; how vehicle streaming works explains why
- Pack them up: once you have more than a handful of cars, merge them into one resource with the Car Pack Builder (tutorial)
Next: Add the Car to Your Vehicle Shop
Spawning by command proves the resource works. To sell the car at a dealership, your framework needs an entry for it, and each one stores that entry differently:
- QBCore: add converted cars to the QBCore vehicle shop with one entry in
qb-core/shared/vehicles.lua. - ESX: add add-on cars to the ESX vehicle shop with a row in the
vehiclesdatabase table. - Qbox: add custom cars to Qbox;
qbx_coredoes not use the QBCore vehicle format. - Managing the server through a panel? Installing cars with txAdmin repeats the steps above with the CFG Editor and the Live Console.
After the Car Spawns
Installation is the start, not the end. The usual next steps:
- Sound: a converted car borrows a vanilla engine note. Add a custom engine sound if it deserves a better one.
- Handling: tune it for your server type with the Handling Editor.
- Tooling: best tools for FiveM server owners covers the rest of the kit, from txAdmin to texture optimizers.
Have a gta5-mods.com link ready?
Paste it into the converter and download a FiveM resource with the stream folder, meta files and fxmanifest.lua in place.
- 3 conversions free, no account needed
- 2 more free if you leave an email
- After that: $15 once for unlimited conversions and the Pro tools. No subscription, 14-day refund policy