The Complete GTA 5 & FiveM Developer Guide Vehicles.Meta

Full vehicles.meta reference for FiveM: model and handling bindings, vehicle types, critical flags, wheel scale, LOD distances and spawn failures.

vehicles.meta: GTA 5 & FiveM Archetype Properties, Vehicle Flags, and Streaming Architecture

vehicles.meta is where a car becomes a car. Without an entry here, the engine never mounts your .yft, never allocates collision, and the spawn code returns nothing.

It is also the hub. handling.meta, carvariations.meta, vehiclelayouts.meta and vehicle_names.lua all resolve through bindings declared in this file — modelName, handlingId, layout, gameName. Break one of those strings and the failure surfaces somewhere else entirely.

This guide covers those bindings, the vehicle types and what each one changes at runtime, the flags worth knowing, wheel scale and LOD distances, and the spawn failures they cause when set wrong.

1. The Foundation of Vehicle Streaming: What is vehicles.meta?

In the Rockstar Advanced Game Engine (RAGE) and FiveM, vehicles.meta serves as the primary root manifest and archetype registry for every drivable entity. While handling.meta dictates physics, carcols.meta catalogs modifications and sirens, and carvariations.meta handles spawn variants, vehicles.meta is the core identity file that registers the 3D model into the engine's memory space.

Without an entry in vehicles.meta, the RAGE engine cannot mount .yft and .ytd streaming files, allocate collision bounds, assign wheel scale geometry, manage LOD (Level of Detail) rendering distances, or resolve engine sound hashes.

2. Core XML Architecture (<CVehicleModelInfo__InitDataList>)

The root XML wrapper is <CVehicleModelInfo__InitDataList>, which contains an <InitDatas> array where each vehicle is defined inside an <Item> block:

3. Parameter & Property Breakdown

A. Model Identification & Core References

• modelName: The internal model hash and spawn code. Must match the exact filename of the .yft files (e.g., tt_pursuit_gt.yft).
• txdName: The primary texture dictionary reference matching the base .ytd file name.
• handlingId: Maps directly to the <handlingName> string inside handling.meta.
• gameName: The internal GXT entry key resolved by AddTextEntry in vehicle_names.lua for UI notifications and garage names.
• vehicleMakeName: The vehicle brand or manufacturer label (e.g., TTMODZ, PEGASSI, VAPID) mapped via text natives.
• audioHash: Audio bank identifier dictating engine revs, exhaust pops, transmission whines, and door open/close acoustic sound effects (e.g., vacca, adder, sultanrs).

B. Vehicle Types and Classification (<type>)

The <type> tag determines which internal engine subroutines and physics controllers manage the entity:

C. Critical Vehicle Flags (<flags>)

Flags configure runtime attributes and hardware capabilities. Common and high-impact flags include:

• FLAG_SPORTS / FLAG_SUPER: Categorizes vehicle class for AI routing and native evaluations.
• FLAG_HAS_LIVERY: Enables native multi-livery texture swapping from the .ytd.
• FLAG_CAN_HAVE_NEONS: Enables underglow neon light compatibility.
• FLAG_EMERGENCY_SERVICE: Required for police, ambulance, and fire models to unlock siren lighting and emergency AI responses.
• FLAG_EXTRAS_REQUIRE: Automatically forces extras to spawn based on carvariations configuration.
• FLAG_CAN_NAVIGATE_WATER: Used on amphibious vehicles to prevent water-induced engine stall.
• FLAG_NO_BOOT / FLAG_NO_DOORS: Disables trunk or door interactions for open-cockpit or utility vehicles.

D. Dimensional Geometry: Wheel Scale & LOD Distances

• wheelScale / wheelScaleRear: The bounding radius multiplier for front and rear wheels. Setting accurate values ensures custom aftermarket wheels from Los Santos Customs match the original tire diameter perfectly.
• wheelWidth / wheelWidthRear: Determines physical tire contact track width and wheel lip offset.
• lodDistances: Six sequential threshold distances (in game meters) governing Level of Detail model mesh switching (LOD0 high-poly mesh down to LOD4 low-poly distant proxies).

---

4. Metadata Dependency & Linking Matrix

5. Resource Manifest Setup (fxmanifest.lua)

To mount vehicles.meta inside a FiveM resource stream folder, configure your fxmanifest.lua as follows:

6. Troubleshooting & Common Configuration Issues

• Vehicle Spawns Invisible or Disappears at Distance: The lodDistances values are misconfigured or .yft models lack proper LOD hierarchy. Set baseline lodDistances: 15.0 / 30.0 / 60.0 / 120.0 / 500.0 / 500.0.
• Aftermarket Tuning Wheels Clip or Shrink: The wheelScale parameter is improperly scaled. Re-measure your 3D tire mesh radius in Blender or ZModeler and update wheelScale.
• No Engine Sound: The <audioHash> is invalid, misspelled, or left empty. Use standard base game sound hashes such as tailgater, sultan, or elegy2.
• Sirens Don't Activate on Emergency Cars: Missing FLAG_EMERGENCY_SERVICE inside the <flags> block will prevent emergency lighting scripts and native siren toggles from functioning.

SUPPORT & COMMUNITY CONTACT

Add taxis and medical response with the FiveM city fleet pack, or browse all lore-friendly FiveM cars.