What a replace mod contains
A replace mod is small. It normally has just the model and texture files, named after the vehicle they replace: for a mod that replaces the Adder that is adder.yft, adder_hi.yft and adder.ytd. There is usually no vehicles.meta or handling.meta, because in single player the mod relies on the base game's entries for that vehicle. See add-on vs replace for the short comparison.
How a replace mod behaves on a FiveM server
In single player you overwrite the files inside the game archives. On FiveM nothing in the game install is touched (SP to FiveM has the full comparison). The files sit in a resource's stream folder, and any streamed file with the same name as a base game asset takes its place while the resource is running.
So the converted download is a resource you install like any other, with one consequence: every Adder on the server becomes the modded car, for every player, including the ones in traffic. The spawn name stays adder, and handling, engine sound and seating still come from the base game Adder. Stop the resource and the original returns.
That is a perfectly good setup when you want it, for example to restyle police vehicles without touching job scripts. It is a poor one when you want the mod as an extra car.
Replace vs standalone: turning a replace mod into its own vehicle
To keep the original and have the mod as a separate vehicle, give it a new identity. After converting, do this in the resource (the guide to converting a replace car to an add-on goes through each step with the finished manifest):
- Pick a new, unique name and rename every file in
stream/consistently:adder.yfttomycar.yft,adder_hi.yfttomycar_hi.yft,adder.ytdtomycar.ytd. Files with a suffix keep the suffix. - Create a
vehicles.metawhose<modelName>and<txdName>are the new name. The Vehicles.meta Generator builds it together withcarvariations.metafrom one spawn name. - Add a
handling.metaentry. Copying the values of the replaced vehicle is a sensible start, since the model was built around it; adjust them later in the Handling Editor. - Declare the meta files in
fxmanifest.luawith theirdata_filelines. The FXManifest Generator writes them for you.
Limits of the rename approach
From then on the car behaves like any add-on vehicle; if an add-on release of the same model exists, running it through the addon to FiveM converter saves the renaming. One caveat: replace mods that include tuning parts name those files after the original vehicle too, and they are tied to its mod kit. Renaming them correctly takes a matching carcols.meta, so for a heavily tuned car it is often quicker to look for an add-on version of the same mod.
Name collisions
Because a replace mod is identified only by its file names, collisions are easy to create. Two replace mods for the same vehicle cannot both be active: the server ends up streaming two different files with one name, and which one players see is not something you should rely on. The same happens when a car pack already contains a file with that name.
Before adding a replace resource, search your resources folder for the model name. The vehicle spawn codes list shows which names belong to base game vehicles, and the Car Pack Builder reports duplicate spawn names when you merge resources.
How to convert replace cars with this site
- 1
Copy the mod page link
Open the vehicle on gta5-mods.com and copy the address of its page from the browser. It has to be the mod page itself (
gta5-mods.com/vehicles/...), not the download button link or a search result. - 2
Paste it into the converter
Go to the converter on the homepage, paste the link and start the conversion. The first 3 conversions are free; unlimited conversions are a one-time $15, listed on the pricing page.
- 3
Install the resource
Download the zip, extract the folder into your server's
resourcesdirectory and addensure folder-nametoserver.cfg. The Server.cfg Generator helps if you are setting up a server from scratch. - 4
Restart and spawn
Restart the server, or run
refreshand thenensure folder-namein the console. Spawn the vehicle with the<modelName>fromcommon/vehicles.meta. - 5
Decide: swap or standalone
Look at the file names in
stream/. If they match a base game vehicle and you want to keep that vehicle, rename them and add meta files as described above before the resource goes on a live server.
Got the mod page link copied? Paste it into the converter and carry on from step 3. Open the converter
Want every step with screenshots of the result? Follow the complete gta5-mods.com to FiveM workflow.
Common problems with replace cars
A stock car changed everywhere on the server
That is how a streamed replace mod works. Rename the files and add meta files to make it standalone, or stop the resource to get the original back.
Two replace mods fight over the same car
Only one resource can own a file name. Remove one, or rename one of them into a standalone vehicle.
The handling does not suit the new model
A replace mod drives like the vehicle it replaces. After making it standalone you can give it its own handling.meta entry.
After renaming, the car is invisible or untextured
One file was missed or <txdName> still has the old name. Every file and both meta values must use the new name; the Resource Inspector reports mismatches, and the invisible car guide lists the other causes.
Seeing an error in the F8 console instead? Paste it into the Error Analyzer for the likely cause.
Replace car conversion FAQ
Can replace mods be used on a FiveM server?
Yes. The mod's model and texture files are streamed from a resource. While that resource is running, the base game vehicle with the same file name is shown as the modded car for everyone on the server.
What is the difference between a replace mod and a standalone resource?
A replace mod reuses the file names of a base game vehicle and takes over that vehicle. A standalone or add-on vehicle has its own unique file names and its own vehicles.meta entry, so it has its own spawn name and exists alongside the original.
How do I turn a replace car into an add-on?
Rename all of its stream files to a new unique name, create a vehicles.meta with that name as modelName and txdName, add handling and carvariations entries, and declare those files in fxmanifest.lua. The car then spawns under the new name and no longer overrides the original.
What is the spawn name of a converted replace car?
Unless you rename it, it is the spawn name of the base game vehicle it replaces, for example adder. The mod page states which vehicle that is.
Does a replace mod change the car's handling?
Usually not. Most replace mods only contain the model and textures, so the vehicle keeps the base game handling, sound and seating of the car it replaces. Some mods include an optional handling line in their readme that you can apply yourself.
Can I run two replace mods for the same vehicle?
No. Both would stream files with the same names, so only one can be visible. Convert one of them into a standalone vehicle with a new name if you want both on the server.
Questions about limits, payments or downloads are answered in the main FAQ.
Guides and tools for this vehicle type
- Add-on vs replaceWiki comparison of the two mod types.
- Vehicles.meta GeneratorCreates the meta files a renamed replace car needs.
- gta5-mods.com to FiveM compatibilityWhich mod types work and which need extra steps.
- FiveM vehicle streaming guideHow the stream folder and overrides work.
All free and Pro utilities are listed on the tools page.