Adding custom cars to your FiveM server is one of the most impactful things you can do to make your roleplay server stand out. Whether you want a fleet of debadged luxury vehicles for a serious RP experience or a garage full of JDM tuners for a drift server, installing FiveM cars is surprisingly straightforward once you understand the process.

This guide walks you through every step of how to install FiveM cars, from understanding the file structure to configuring your fxmanifest.lua and server.cfg. We cover both addon vehicles (adding entirely new cars) and replace vehicles (swapping vanilla GTA V models). By the end, you will know how to add custom vehicles to your FiveM server confidently, troubleshoot common problems, and keep your server running smoothly.

1. Prerequisites — What You Need Before Starting

Before you install your first car, make sure you have the following ready:

• A running FiveM server — either a local development server (txAdmin is the easiest way to set one up) or a remote VPS/dedicated server. If you do not have a server yet, follow the official FiveM server setup guide first.
• Access to your server files — specifically the resources folder and server.cfg file. If you are using a hosted server (such as ZAP-Hosting or STARTER), you will typically access these through an FTP client like FileZilla or through a web file manager.
• A vehicle resource to install — this is usually a ZIP file containing all the vehicle files. You can get these from the FiveMRides shop, community sites like GTA5-Mods, or FiveM forums.
• A text editor — Notepad++ or Visual Studio Code for editing configuration files. Do not use regular Windows Notepad as it can cause encoding issues with Lua files.
• Basic understanding of file management — copying, moving, and extracting ZIP files.

2. Understanding FiveM Vehicle File Structure

Every FiveM vehicle resource follows a specific folder structure. Understanding what each file does is essential for troubleshooting, so let us break it down before diving into the installation steps.

A typical vehicle resource looks like this:

Stream Files (YTD, YFT, YDR)

The stream/ folder contains the visual assets that FiveM streams to players. These are the files that make the car look like a car:

• .ytd (Texture Dictionary) — contains all the textures for the vehicle: body paint, normal maps (surface detail), specular maps (reflections), interior textures, and more. This is usually the largest file and the primary cause of performance issues when unoptimized. FiveM has a hard 16MB streaming limit per YTD file.
• .yft (Fragment Type) — the 3D model of the vehicle including all deformable parts (doors, hood, trunk, bumpers). The _hi.yft variant is the high-detail version shown when you are close to the vehicle. If this file is missing, the car will be invisible.
• .ydr (Drawable) — static 3D model used for non-deformable objects. Some vehicles include these for things like engine parts or accessories. Not all vehicles need YDR files.

Data Files (Meta Files)

The data/ folder contains XML configuration files that tell FiveM how the vehicle behaves:

• vehicles.meta — the most important meta file. Defines the vehicle name, type (car, bike, boat), model name, manufacturer, seat count, dashboard type, and dozens of other properties. Without this file, the game does not know the vehicle exists as a spawnable entity.
• handling.meta — controls all driving physics: top speed, acceleration, braking force, suspension, traction, weight distribution, and more. If your car spawns but drives like it is on ice or feels like a boat, the handling.meta is either missing or misconfigured.
• carvariations.meta — defines available color combinations, wheel types, liveries, and extra parts (spoilers, skirts, etc.). This file determines what options show up in mod shops and LS Customs.
• carcols.meta — specifies color palettes, siren settings (for emergency vehicles), neon light configurations, and headlight/taillight details.

The Manifest File

The fxmanifest.lua (or the older __resource.lua) is the entry point that tells FiveM what files this resource contains and how to load them. Think of it as a table of contents for the resource. Without a valid manifest, FiveM completely ignores the resource folder.

3. Method 1: Installing Addon Vehicles (Recommended)

Addon vehicles are added alongside the existing GTA V vehicles. This is the recommended approach because it does not remove any vanilla vehicles, is easier to manage, and lets you add as many cars as you want. Here is how to install addon cars on your FiveM server step by step:

4. Method 2: Installing Replace Vehicles

Replace vehicles swap out an existing GTA V vehicle with a custom model. When players encounter that vehicle in the game world (either spawned by traffic or by a player), they see the custom model instead of the original. This is useful for servers that want to replace the default GTA V cars with real-world models without bloating the vehicle list.

How Replace Cars Work

FiveM loads resources in a specific order. When a replace vehicle resource provides stream files with the same name as a vanilla GTA V vehicle, FiveM uses the custom files instead of the originals. For example, if you name your YTD and YFT files adder.ytd and adder.yft, they will replace the Adder (Bugatti Veyron) in the game.

Step-by-Step Replace Installation

The process is simpler than addon vehicles because you typically do not need meta files — the vehicle inherits the original car's metadata:

1. Create a resource folder the same way as addon vehicles (e.g., replace_adder).
2. Add stream files with names matching the vanilla vehicle you want to replace. For example, to replace the Adder: adder.ytd, adder.yft, adder_hi.yft.
3. Create a minimal fxmanifest.lua:

4. Add custom handling (optional) — if you want the replaced vehicle to drive differently, include a handling.meta with the original vehicle's handling name but your custom values. Add the corresponding files and data_file entries to the manifest.
5. Add to server.cfg and restart, same as addon vehicles.

Finding Vanilla Vehicle Names

To replace a specific GTA V vehicle, you need to know its internal name. Here are some common ones:

• adder — Bugatti Veyron
• zentorno — Lamborghini Sesto Elemento
• t20 — McLaren P1
• sultan — Subaru Impreza WRX STI
• elegy2 — Nissan GT-R
• buffalo — Dodge Charger
• police / police2 / police3 — Police vehicles

A full list of GTA V vehicle spawn names is available on the FiveM documentation.

5. Common Issues & How to Fix Them

Even experienced server owners run into problems when installing FiveM vehicles. Here are the most common issues and their solutions:

Car Spawns but Is Invisible

This is the single most common issue. The vehicle entity spawns (you can hear it, sit in it, and it has collision), but you cannot see it.

• Missing YFT file — the most likely cause. Make sure both vehiclename.yft and vehiclename_hi.yft are in the stream/ folder. The _hi.yft is the version that renders when you are nearby.
• Incorrect file names — the YFT file name must match the modelName in vehicles.meta. Check for typos, extra spaces, or incorrect capitalization.
• Corrupted files — re-download the vehicle resource. ZIP extraction errors can corrupt binary files silently.
• Stream folder not detected — make sure the folder is named exactly stream (lowercase). Some systems create Stream or STREAM which may not work on Linux servers.

Texture Loss After Adding Multiple Cars

You had 5 cars working fine, then added 10 more and now all vehicles look blurry, flickery, or have missing textures. This is texture loss — the most frustrating FiveM issue and the reason we built the FiveMRides Optimizer.

• Root cause — FiveM has finite VRAM streaming budget. When too many vehicles have oversized, uncompressed textures, the engine cannot stream them all. It starts dropping textures for distant or less-priority vehicles.
• The fix — optimize your vehicle textures before installing them. Compress textures to the right formats, resize to FiveM limits (1024px max for standard textures, 512px for RGBA), and ensure no single YTD exceeds 16MB. See our dedicated guide: How to Fix FiveM Texture Loss.
• Quick check — if a single vehicle's YTD file is larger than 16MB, it absolutely needs optimization. Many downloaded vehicles ship with 2048px or even 4096px textures that FiveM will never render at full resolution anyway.

Car Has No Handling (Drives Weird)

The vehicle spawns and looks correct but drives terribly — either stuck in place, extremely slow, slides around, or has no suspension.

• Missing handling.meta entry — open your handling.meta and verify the <handlingName> matches what is referenced in vehicles.meta.
• handling.meta not loaded — check your fxmanifest.lua. Make sure the file is listed in both the files block AND has a data_file 'HANDLING_FILE' declaration.
• Conflicting handling names — if two resources define handling entries with the same name, one will override the other. Make sure handling names are unique across all your vehicle resources.

Server Crashes or Resource Fails to Start

The server crashes during startup, or you see red errors in the console about the vehicle resource.

• Syntax error in fxmanifest.lua — Lua is sensitive to syntax. Check for missing quotes, commas, or brackets. The server console will usually tell you the exact line number of the error.
• Wrong data_file type string — if you use VEHICLE_META_FILE instead of VEHICLE_METADATA_FILE, it will fail. Copy the type strings exactly from this guide.
• Missing referenced files — if your fxmanifest.lua lists 'data/carcols.meta' but the file does not exist, the resource will fail to load. Remove references to files you do not have or create the missing files.
• File encoding issues — meta files must be UTF-8 encoded. If you edited them in Windows Notepad and saved with BOM (Byte Order Mark), it can cause XML parsing failures. Use Notepad++ and set encoding to "UTF-8" (without BOM).

Vehicle Spawns as a Default GTA Car

You try to spawn the vehicle by name but get a random GTA V car instead.

• vehicles.meta not loaded — without it, FiveM does not register the spawn name. Verify the data_file declaration in your manifest.
• Wrong spawn name — you might be typing the wrong name. Open vehicles.meta and look for the <modelName> value — that is what you use to spawn it.
• Resource not started — check the server console to confirm the resource loaded without errors. Run ensure resource-name and look for any error output.

6. Optimizing Vehicles Before Installing

This section is arguably the most important in this entire guide. If you are running more than a handful of custom vehicles on your FiveM server, optimization is not optional — it is essential for keeping your server playable.

Why Optimization Matters

Most custom FiveM vehicles you download from the internet are not optimized for multiplayer. They are often converted from single-player GTA V mods or created by 3D modelers who prioritize visual fidelity in a single-player context. In FiveM, where the server may stream dozens of custom vehicles simultaneously to 64+ players, these unoptimized assets cause serious problems:

• Texture loss — blurry, missing, or flickering textures on vehicles because FiveM's streaming budget is exceeded.
• FPS drops — high-polygon models and uncompressed textures chew through GPU VRAM, causing stuttering and low frame rates for your players.
• Longer loading times — oversized files take longer to stream, meaning players see placeholder vehicles or pop-in as they drive around.
• The 16MB YTD limit — FiveM hard-caps individual YTD streaming at 16MB. If a vehicle's texture dictionary exceeds this, textures simply will not load.

What Good Optimization Looks Like

Proper FiveM vehicle optimization involves two areas:

Texture optimization: Resizing textures to FiveM's actual rendering caps (1024px for standard textures, 512px for RGBA), applying the correct compression format for each texture type (BC5 for normal maps, BC7 for specular maps, DXT1/DXT5 for diffuse), and generating proper mipmaps. This alone typically reduces file size by 40-70% with zero visible quality loss in-game.

3D model optimization: Reducing polygon counts by removing invisible interior geometry, dissolving unnecessary flat-surface polygons, and applying intelligent decimation that preserves body lines and sharp edges. A well-optimized model has 20-40% fewer polygons without any visible difference during normal gameplay.

For a deep dive into the technical details, read our guide on FiveM Vehicle Optimization Best Practices.

Automate It with the FiveMRides Optimizer

You can do all of this manually using OpenIV and Blender — but it takes 30-60 minutes per vehicle and requires significant technical knowledge. The FiveMRides Optimizer does it automatically in about 30 seconds:

1. Upload your vehicle resource ZIP file
2. Choose your preset (Optimized for zero quality loss, or Maximum for aggressive compression)
3. Download the optimized version, ready to install

It is web-based (no software to install), uses smart per-type compression that no other tool offers, and handles both textures and 3D models. If you are running more than 10 custom vehicles, the optimizer will make a noticeable difference in your server's performance.

7. Where to Get Quality FiveM Cars

Not all FiveM vehicles are created equal. The quality of the source files directly affects how the car looks and performs on your server. Here is where to find reliable, high-quality vehicle resources:

FiveMRides (Our Shop)

Every vehicle in the FiveMRides shop is pre-optimized for FiveM multiplayer performance. We test every car on a live server before listing it. Our specialties include:

• Debadged vehicles — real-world car models with brand logos and badges removed, perfect for serious RP servers that want realistic cars without trademark issues.
• Car packs — curated collections of 10-50+ vehicles designed to populate your server with a cohesive vehicle roster. Already optimized and ready to install.
• Instant delivery — all downloads are available immediately after purchase through your account dashboard.

Community Sources

• GTA5-Mods.com — the largest repository of GTA V mods. Look for vehicles tagged as "FiveM-ready" or that include fxmanifest.lua. Quality varies significantly — always check the comments for known issues.
• FiveM Forums — community creators share free and paid resources. The releases section often has well-documented vehicles with proper meta files.
• Discord communities — many FiveM development communities share resources. Join the FiveMRides Discord for recommendations.

8. Frequently Asked Questions