# Tuning vehicle handling in FiveM: handling.meta value by value

> Which handling.meta value does what in FiveM: drive force and mass for acceleration, drag for top speed, the traction curve for grip, brake bias for stopping.

Source: https://fam-tools.com/guides/fivem-handling-meta-guide · FAM Tools · published 2026-09-11 · updated 2026-09-11 · about 12 min

**Short answer.** Acceleration comes mainly from `fInitialDriveForce` and `fMass`; top speed from `fInitialDriveMaxFlatVel` and drag (`fInitialDragCoeff`); grip from `fTractionCurveMax`, `fTractionCurveMin` and `fTractionBiasFront`; stopping from `fBrakeForce` and `fBrakeBiasFront`; body movement from the suspension and `fAntiRollBarForce`; crash toughness from the damage multipliers. Change one value at a time, test with `SetVehicleHandlingFloat` in game, then write the result into the file.

## Key points

- Power: `fInitialDriveForce`; weight: `fMass`.
- Top speed: `fInitialDriveMaxFlatVel` plus drag.
- Grip: `fTractionCurveMax` / `Min` / `BiasFront`.
- Test live with `SetVehicleHandlingFloat`, then save to the file.
- Balance cars against each other, not against reality.

Most complaints about add-on cars — too fast, spins out, floats over bumps, explodes on contact — are handling problems. handling.meta has dozens of fields, but a small group decides how a car accelerates, grips, brakes and survives crashes. Tune those, one at a time.

## The fields that matter most

| Area | Fields | Effect |
| --- | --- | --- |
| Weight | `fMass` | Heavier = slower to accelerate, wins collisions |
| Aerodynamics | `fInitialDragCoeff` | Higher = lower top speed |
| Engine | `fInitialDriveForce`, `nInitialDriveGears`, `fInitialDriveMaxFlatVel` | Acceleration, gears, top speed |
| Drivetrain | `fDriveBiasFront` | 0.0 RWD, 1.0 FWD, in between AWD |
| Brakes | `fBrakeForce`, `fBrakeBiasFront`, `fHandBrakeForce` | Stopping and handbrake turns |
| Grip | `fTractionCurveMax`, `fTractionCurveMin`, `fTractionCurveLateral`, `fTractionBiasFront` | Cornering grip and balance |
| Suspension | `fSuspensionForce`, `fSuspensionCompDamp`, `fSuspensionReboundDamp`, `fSuspensionRaise` | Stiffness, damping, ride height |
| Stability | `fAntiRollBarForce`, `vecCentreOfMassOffset` | Body roll and tipping over |
| Damage | `fCollisionDamageMult`, `fDeformationDamageMult`, `fEngineDamageMult` | How much crashes hurt |

## Testing values in game

*client.lua — a quick tuning command*

```lua
RegisterCommand('hset', function(_, args)
    local veh = GetVehiclePedIsIn(PlayerPedId(), false)
    if veh == 0 then return end
    local field, value = args[1], tonumber(args[2])
    if not field or not value then return end
    print(field, GetVehicleHandlingFloat(veh, 'CHandlingData', field), '->', value)
    SetVehicleHandlingFloat(veh, 'CHandlingData', field, value)
end, false)

-- /hset fInitialDriveForce 0.32
```

> **Runtime changes are local** — These natives change the vehicle on your client for testing. When you are happy, write the values into handling.meta so every player gets the same car.

## A safe tuning workflow

1. Pick a vanilla car the add-on should feel like and compare values side by side.
2. Change one field, test on the same road, note the result.
3. Fix acceleration and top speed first, then grip, then brakes, then suspension.
4. Balance against other cars in the same class — a supercar that beats everything ruins races and chases.
5. Save the final values in handling.meta and restart the resource.

## Common problems

| Problem | Try |
| --- | --- |
| Too fast | Lower `fInitialDriveMaxFlatVel` or raise `fInitialDragCoeff` |
| Spins out constantly | Raise `fTractionCurveMin`, lower drive force, move `fTractionBiasFront` towards 0.5 |
| Rolls over easily | Lower `vecCentreOfMassOffset` Z, raise `fAntiRollBarForce` |
| Bounces over bumps | Raise damping (`fSuspensionCompDamp`, `fSuspensionReboundDamp`) |
| Wrecked by a tap | Lower `fCollisionDamageMult` / `fEngineDamageMult` |

## Questions

### How do I make a FiveM car faster?

Raise `fInitialDriveForce` for acceleration and `fInitialDriveMaxFlatVel` for top speed, and check `fInitialDragCoeff`.

### How do I stop a car from spinning out?

Increase traction (`fTractionCurveMin`/`Max`), reduce drive force or balance `fTractionBiasFront`.

### Can I change handling without restarting?

For testing, yes: `SetVehicleHandlingFloat(vehicle, 'CHandlingData', field, value)` on the client. Save the final values in handling.meta.

### Why does my handling.meta have no effect?

The `handlingName` does not match `handlingId` in vehicles.meta, or the file is not declared as `HANDLING_FILE`.

## Related

- https://fam-tools.com/guides/fivem-vehicle-meta-files
- https://fam-tools.com/guides/fivem-add-addon-cars
- https://fam-tools.com/guides/fivem-replace-vs-addon-vehicles
- https://fam-tools.com/guides/fivem-desync-network-issues