What is vehicles.meta?
The vehicles.meta file registers every vehicle in GTA 5 with the game engine. It defines the vehicle's display name, class, type, handling reference, and various behavioral flags. Every addon vehicle mod requires a proper vehicles.meta entry to function correctly in 2026.
File location: common.rpf/data/levels/gta5/vehicles.meta or addon dlc.rpf
Key Parameters
| Parameter | Purpose | Example |
|---|---|---|
modelName |
Internal model hash name |
adder, zentorno
|
txdName |
Texture dictionary name (usually same as model) | adder |
gameName |
Display name reference from GXT2 files | ADDER |
vehicleMakeName |
Manufacturer display name | TRUFFADE |
vehicleClass |
Category for garage/menu sorting |
VC_SUPER, VC_SPORT, VC_MUSCLE
|
type |
Vehicle type |
VEHICLE_TYPE_CAR, VEHICLE_TYPE_BIKE
|
handlingId |
Links to handling.meta entry | ADDER |
Vehicle Classes
-
VC_SUPER— Supercars (Adder, Zentorno) -
VC_SPORT— Sports cars (Jester, Elegy) -
VC_MUSCLE— Muscle cars (Dominator, Gauntlet) -
VC_SUV— SUVs (Baller, Cavalcade) -
VC_EMERGENCY— Emergency vehicles (Police, Ambulance) -
VC_MILITARY— Military vehicles (Rhino, Barracks)
Adding an Addon Vehicle Entry
- Copy an existing entry that matches your vehicle type
- Change
modelNameandtxdNameto your model's name - Set
handlingIdto match your handling.meta entry - Choose the correct
vehicleClassfor categorization - Set appropriate flags (extras, liveries, sirens if emergency)
- Add corresponding entries in
handling.meta,carvariations.meta,carcols.meta
Important Flags
-
FLAG_HAS_LIVERY— Vehicle supports livery textures -
FLAG_HAS_EXTRA— Vehicle has toggleable extra parts -
FLAG_IS_ELECTRIC— Electric engine sound and behavior -
FLAG_EMERGENCY_SERVICE— Enables siren functionality -
FLAG_LAW_ENFORCEMENT— Recognized as police vehicle by AI






Comments0
Sign in to leave a comment
No comments yet. Be the first to comment!