GTA V handling.meta Explained: Every Parameter and What It Does

What Is handling.meta?

Every driveable vehicle in GTA V has its physics defined in a single file: handling.meta. It controls how the vehicle accelerates, brakes, turns, and responds to damage. Whether you're building a realistic patrol car for FiveM or making a supercar that handles like it should, this is the file you need to understand.

The file lives inside update/update.rpf/common/data/handling.meta for the base game, and inside individual DLC RPFs for add-on vehicles. Each vehicle entry is an <Item type="CHandlingData"> block containing dozens of parameters.

This guide covers every parameter, what it actually does, and practical values to get you started.

Engine and Drivetrain

These parameters control how the vehicle puts power to the ground.

fMass

The vehicle's weight in kilograms. Affects acceleration, braking distance, and collision physics. A typical sedan is around 1500, an SUV around 2500, and a heavy truck can be 10000+.

fDriveBiasFront

Controls which wheels receive engine power. Set to 0.0 for rear-wheel drive, 1.0 for front-wheel drive, and 0.5 for all-wheel drive. Most sports cars use values between 0.0 and 0.2.

nInitialDriveGears

Number of forward gears, between 1 and 16. More gears means smoother power delivery across the speed range. Most cars use 5-6, supercars use 7-8.

fInitialDriveForce

The engine's power output as a multiplier. Higher values mean faster acceleration. A standard car sits around 0.25-0.35, while supercars go up to 0.50 or higher. Going above 1.0 creates unrealistically fast acceleration.

fDriveInertia

How quickly the engine revs up and down. Lower values make the engine feel sluggish, higher values make it responsive. Typical range is 0.5 to 1.5.

fClutchChangeRateScaleUpShift / fClutchChangeRateScaleDownShift

How fast the clutch engages during gear changes. Higher values mean quicker shifts. Setting upshift higher than downshift makes the vehicle feel snappier under acceleration while keeping downshifts smooth.

fInitialDriveMaxFlatVel

The vehicle's top speed in kph (in-game units). A realistic sedan might be 160, a supercar 320. Note that actual in-game top speed is also affected by drag and other factors — this sets the theoretical maximum.

fInitialDragCoeff

Air resistance. Higher values slow the vehicle down more at high speeds. Typical range is 5 to 15 for cars. Lower values let the vehicle reach top speed more easily. Trucks and boxy vehicles should have higher drag than sleek sports cars.

Braking

fBrakeForce

How hard the brakes stop the vehicle. A value of 1.0 is standard. Higher values give shorter stopping distances. Most cars sit between 0.5 and 1.5. Don't go too high or the vehicle will lock up unrealistically.

fBrakeBiasFront

Where the braking force is concentrated. 0.5 is evenly split, values above 0.5 shift braking to the front wheels. Most real vehicles have a front bias between 0.55 and 0.70 because weight transfers forward under braking.

fHandBrakeForce

Handbrake strength. Higher values make the handbrake more effective for drifting and emergency stops. Values between 0.5 and 1.5 are typical.

Steering

fSteeringLock

Maximum steering angle in degrees. Lower values make the vehicle feel more stable at speed but less maneuverable at low speed. Typical values range from 30 for sports cars to 45 for standard vehicles. Setting this too high makes the vehicle twitchy.

Suspension

Suspension parameters have the biggest impact on how a vehicle feels moment-to-moment. Get these wrong and the car will either float like a boat or bounce like a pogo stick.

fSuspensionForce

Spring stiffness. Higher values make the suspension firmer. A soft sedan might use 1.5, a sports car 2.5, and a race car 3.5 or higher. Too stiff and the car bounces over bumps instead of absorbing them.

fSuspensionCompDamp

How much the suspension resists compression (hitting a bump). Works with fSuspensionForce to control ride quality. Typical values range from 1.0 to 3.0. Should generally be lower than the spring force.

fSuspensionReboundDamp

How much the suspension resists returning to its resting position. Higher values prevent the car from bouncing after hitting bumps. Usually set slightly higher than compression damping.

fSuspensionUpperLimit / fSuspensionLowerLimit

The range of suspension travel. Upper limit is typically 0.05 to 0.15, lower limit -0.05 to -0.20. A larger range (bigger difference between upper and lower) gives the suspension more room to work, which suits offroad vehicles. A tighter range suits sports cars.

fSuspensionRaise

Raises or lowers the vehicle's ride height visually. Positive values raise, negative values lower. Affects both appearance and center of gravity. Common for lifted trucks (0.05 to 0.10) or lowered sports cars (-0.05 to -0.10).

fSuspensionBiasFront

Distributes suspension stiffness between front and rear. 0.5 is even, higher values make the front stiffer. Most vehicles use 0.45 to 0.55.

fAntiRollBarForce

Controls body roll in corners. Higher values reduce lean. Sports cars use 2.0 to 4.0, while soft-riding vehicles might use 0.5 to 1.5. Setting this too high makes the vehicle feel rigid and unrealistic in turns.

fRollCentreHeightFront / fRollCentreHeightRear

The pivot point for body roll. Higher values make the car roll more. These are subtle but affect handling feel, especially at the limit. Typical values range from 0.15 to 0.45.

Traction

Traction parameters determine how much grip the tires have and how the vehicle behaves at the limit of adhesion.

fTractionCurveMax

Peak lateral grip. This is the most grip the tires can produce. Standard cars use 2.0 to 2.5, sports cars 2.5 to 3.0, and race cars can go up to 3.5. Higher values mean more cornering speed before the tires break loose.

fTractionCurveMin

Grip level after the tires have lost traction (sliding). Lower than fTractionCurveMax, creating a grip drop-off when you push too hard. The gap between max and min determines how "snappy" the breakaway is. A small gap feels more forgiving.

fTractionCurveLateral

Controls the shape of the grip curve. Higher values make the transition from grip to slip more gradual. Typical range is 20 to 25.

fTractionBiasFront

Where grip is concentrated. 0.5 is even. Values above 0.5 give the front more grip (understeer tendency), below 0.5 gives the rear more grip (oversteer tendency). Most production cars use 0.48 to 0.52.

fLowSpeedTractionLossMult

Traction loss when doing burnouts or launching from a stop. Higher values make the wheels spin more easily at low speed. 0.5 to 1.5 is typical. Setting this high gives rear-wheel-drive vehicles more dramatic wheelspin.

fTractionLossMult

General traction loss multiplier. Affects grip loss across all conditions. Keep this between 0.5 and 1.5 for predictable behavior.

fCamberStiffnesss

Yes, three S's — that's how Rockstar spelled it. Controls the effect of wheel camber on grip. Most vehicles leave this at 0.0. Non-zero values affect how camber changes affect tire grip.

Centre of Mass

vecCentreOfMassOffset

An XYZ offset for the vehicle's center of gravity. X shifts it left/right, Y forward/back, Z up/down. Lowering Z (negative value) improves stability. Moving Y forward shifts weight to the front wheels, which affects braking and turn-in behavior. Most vehicles keep this close to 0.0, 0.0, 0.0 with minor Z adjustments.

vecInertiaMultiplier

Controls how resistant the vehicle is to rotation around each axis. Higher X values make it harder to pitch (nose up/down). Higher Y values resist roll. Higher Z values resist yaw (spinning). Typical values range from 1.0 to 3.0 per axis.

Damage

fCollisionDamageMult / fWeaponDamageMult / fDeformationDamageMult / fEngineDamageMult

Multipliers for different damage sources. Values around 1.0 are standard. Lower values make the vehicle tougher, higher values make it more fragile. Set engine damage multiplier lower if you want the vehicle to keep running after taking hits.

fPetrolTankVolume

Fuel tank capacity. Affects how long until the vehicle catches fire after the tank is punctured. Larger tanks take longer to empty but create bigger explosions. Typical values are 60 to 80.

Flags

Handling flags are hex values where each bit enables a specific behavior.

strModelFlags

Controls physical properties of the vehicle model. Common flags include IS_VAN, IS_BUS, IS_LOW, ABS_STD (standard ABS), NO_DOORS, and DOUBLE_FRONT_WHEELS. These affect AI behavior, damage model, and physics interactions.

strHandlingFlags

Controls driving behavior. Key flags include FREEWHEEL_NO_GAS (engine braking behavior), OFFROAD_ABILITY (better grip on dirt), IMPROVED_DOWNFORCE (aerodynamic grip at speed), and HAS_KERS (boost system). The STEER_REARWHEELS flag enables rear-wheel steering.

strDamageFlags

Controls damage behavior. Most vehicles leave this at the default.

SubHandlingData

Some vehicle types need additional handling parameters beyond the base set. These are added as SubHandlingData entries.

CBoatHandlingData

Used for boats. Controls buoyancy, rudder behavior, water resistance, wave reactions, and propeller physics. Key parameters include fRudderForce (steering responsiveness) and fAquaplaneForce (how the hull interacts with the water surface).

CBikeHandlingData

Used for motorcycles. Controls lean angles, wheelie balance points, in-air steering, and ground friction. The most important parameters are fLeanFwdCOMMult and fLeanBakCOMMult (how the rider's weight shifts) and fMaxBankAngle (maximum lean in corners).

CFlyingHandlingData

Used for planes and helicopters. Controls thrust, lift, drag, yaw/pitch/roll behavior, turbulence response, and landing gear physics. fThrust and fFormLiftMult are the most impactful parameters.

CSpecialFlightHandlingData

Used for vehicles with special flight modes like the Deluxo or Oppressor. Controls hover behavior, transition between driving and flying, angular damping, and stability assist.

Common Mistakes

Setting fInitialDriveForce too high. If your vehicle accelerates to top speed in two seconds, this value is too high. Keep it under 0.50 for most vehicles.

Ignoring suspension damping. Setting spring force without matching compression and rebound damping creates bouncy, unrealistic handling.

Mismatched traction bias and drive bias. A rear-wheel-drive vehicle with front traction bias will feel disconnected. Match these values to the drivetrain layout.

Using extreme flag combinations. Don't enable OFFROAD_ABILITY and IMPROVED_DOWNFORCE together unless you want the vehicle to stick to every surface regardless of terrain.

Editing handling.meta

You can edit handling.meta directly with a text editor since it's XML, but for anything beyond a quick tweak, a visual editor helps you see relationships between parameters and avoid typos in the raw XML.

ModWorks includes a handling tuner that loads any handling.meta, presents parameters in organized tabs with sliders and value ranges, and lets you apply changes without manually editing XML. It also shows estimated performance figures based on your current values.