What is handling.meta?
handling.meta is the XML file that defines how a GTA V vehicle drives. Each entry is a named handling profile with values for mass, drag, engine force, top speed, gearing, brakes, traction, suspension and damage. A vehicle picks its profile through the handlingId tag in vehicles.meta, so several models can share one profile. In FiveM the file is declared in fxmanifest.lua with the HANDLING_FILE data file type and applies to every player on the server.
Structure of the file
The root element is CHandlingDataMgr. Each profile is an Item of type CHandlingData inside HandlingData, identified by handlingName. Float values are prefixed with f, integers with n, vectors with vec and flag fields with str.
<CHandlingDataMgr>
<HandlingData>
<Item type="CHandlingData">
<handlingName>MYCAR</handlingName>
<fMass value="1500.000000" />
<fInitialDragCoeff value="8.000000" />
<vecCentreOfMassOffset x="0.000000" y="0.000000" z="0.000000" />
<fDriveBiasFront value="0.000000" />
<nInitialDriveGears value="6" />
<fInitialDriveForce value="0.300000" />
<fInitialDriveMaxFlatVel value="150.000000" />
<fBrakeForce value="1.000000" />
<fTractionCurveMax value="2.500000" />
<fTractionCurveMin value="2.200000" />
<!-- suspension, damage, flags and sub handling follow -->
</Item>
</HandlingData>
</CHandlingDataMgr>To change these values without editing XML by hand, use the Handling Editor. Open the Handling Editor
The values that change the feel most
| Value | What it controls |
|---|---|
fMass | Weight in kilograms. Affects collisions with other vehicles more than acceleration. |
fInitialDriveForce | Engine pull. Higher means stronger acceleration. |
fInitialDriveMaxFlatVel | Speed the gearing is built around. Raising it raises top speed. |
fInitialDragCoeff | Air resistance. Higher drag lowers top speed. |
fDriveBiasFront | 0.0 is rear-wheel drive, 1.0 is front-wheel drive, values between are all-wheel drive. |
nInitialDriveGears | Number of forward gears. |
fBrakeForce | Braking strength. |
fTractionCurveMax / Min | Peak grip and grip once the tyres are sliding. |
vecCentreOfMassOffset | Shifts the centre of mass. Lowering z makes a car harder to roll. |
fSuspensionForce | Spring stiffness. |
Change one value at a time and test. Many values interact, and a profile copied from a similar stock vehicle is a safer base than one written from nothing. The handling.meta guide covers tuning in depth.
Loading it in FiveM
files {
'data/handling.meta',
}
data_file 'HANDLING_FILE' 'data/handling.meta'The link to a car is the name: handlingName here must equal <handlingId> in vehicles.meta. Handling names are global, so two resources that define the same name overwrite each other; the Car Pack Builder checks for that when merging cars. Scripts can also read and change values on a spawned vehicle at runtime with natives such as GetVehicleHandlingFloat and SetVehicleHandlingFloat.
Common problems and fixes
- Edits have no effect: the data_file line is missing, the name does not match
handlingId, or another resource defines the same name. If the file is correct, reconnect to the server, because handling data is not always reloaded when a resource restarts. - Car flips or rolls in corners: centre of mass too high or grip too high for the suspension. Lower the z value of
vecCentreOfMassOffset. - Car spins its wheels and will not move: drive force far too high for the traction values.
- Car bounces or sinks into the road: suspension force and suspension travel values do not suit the model's wheel positions.
The free Handling Editor exposes these values as sliders and writes the XML for you.
Frequently asked questions
Where does handling.meta go in a FiveM resource?
Outside the stream folder, usually in a data folder. List it under files in fxmanifest.lua and register it with a data_file line of type HANDLING_FILE.
How do I make a car faster in handling.meta?
Raise fInitialDriveForce for stronger acceleration and fInitialDriveMaxFlatVel for a higher top speed, and lower fInitialDragCoeff if the car stops gaining speed too early. Change one value at a time and test.
Can two vehicles share one handling entry?
Yes. Any number of vehicles can point their handlingId at the same handlingName, and they will all drive identically.
Tools for this
Related guides
Related terms
More in Vehicle Meta Files: carvariations.meta, vehiclelayouts.meta
Still need the car as a FiveM resource?
Paste a gta5-mods.com vehicle link and get a FiveM-ready resource with the manifest and metas in place. 3 free conversions, no signup.
- 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