handling.meta
handling.meta file in GTA V, like in previous versions of the game, controls the physics and animations of vehicles in-game. This file is found found in ..\common\data and can be edited with any text editor.
Parameters
There are 50 parameters in 6 groups, plus additional sub handling data.
Physical Attributes
These seven values represent the vehicle's physical proportions within the game:
handlingName
This is used by the vehicles.meta file to identify the handling line of the vehicle.
- Value: Any text string no more than 14 characters. By default, the handlingName consists of uppercase letters and numbers (TURISMO, E109, etc.)
fMass
This is the weight of the vehicle in kilograms. Only used when the vehicle collides with another vehicle or non-static object.
- Value: 0.0 - 10000.0 and above.
fInitialDragCoeff
Sets the drag coefficient on the rage physics archetype of the vehicle (proportional to velocity squared). Increase to simulate aerodynamic drag.
This affects the maximum speed of the vehicle. Greater value will lower the maximum speed.
- Value: 10 to 120
fDownForceModifier
Sets the amount of downforce applied to the vehicle. Increase this value to increase the grip at high speed.
- Value: TBD
fPercentSubmerged
A percentage of vehicle height in the water before vehicle "floats". So as the vehicle falls into the water, at 85% vehicle height (seemingly the default for road vehicles) it will stop sinking to float for a moment before it sinks (boats excluded).
- Value: any percentage expressed as a decimal (eg., 85% = 0.85). An invalid number will cause the vehicle to sink without the driver drowning, eventually teleporting the vehicle to the surface.
vecCentreOfMassOffset
This value shifts the center of gravity in meters from side to side (when in vehicle looking forward).
- Value x: < -5.0 to > 5.0. (0.0 means that the center of gravity will be in the center of the vehicle. Positive values move the centre of gravity right.)
- Value y: < -5.0 to > 5.0. (0.0 means that the center of gravity will be in the center of the vehicle. Positive values move the centre of gravity forwards.)
- Value z: < -5.0 to > 5.0. (0.0 means that the center of gravity will be in the center of the vehicle. Positive values move the centre of gravity up. Changing this value to great negative quantities (E.G. -10 or greater) will cause the vehicle to behave erratically, moving many feet per frame.)
vecInertiaMultiplier
This value is resistance to rotation around each axis. Therefore, the x axis affects how quickly the car shifts forward and back under braking and acceleration and how it rotates end over end in the air, the y axis affects how quickly the car shifts from side to side when cornering (or in the air) and the z axis affects how the car rotates around the middle, which manifests in normal driving as how quickly the vehicle appears to react to steering inputs. Recommend keeping the z value above 2.0 unless you want arcade style immediate reaction to steering inputs
Note: Four cars do not respond typically to this value; the police3 (Police Interceptor), Gang Burrito, 190Z and Zion Classic. They need lower z values or else they will rotate too slowly.
- Value x: < 0.0 to > 4.0.
- Value y: < 0.0 to > 4.0.
- Value z: < 0.0 to > 4.0.
Transmission Attributes
These values describe the vehicle's straight line performance. Rate of acceleration is determined by fDriveBiasFront, nInitialDriveGears, fInitialDriveForce, fDriveInertia, and fInitialDriveMaxFlatVel. Rate of deceleration is determined by fBrakeForce and fBrakeBiasFront. fSteeringLock can be thought of as a measure of sideways acceleration.
fDriveBiasFront
This value is used to determine whether a vehicle is front, rear, or four wheel drive.
- Value: 0.0 is rear wheel drive, 1.0 is front wheel drive, and any value between 0.01 and 0.99 is four wheel drive (0.5 give both front and rear axles equal force, being perfect 4WD.)
nInitialDriveGears
How many forward speeds a transmission contains.
- Value: 1 to 8 in versions before 1.0.1604.0. 1 to 10 for 1.0.1604.0 and up. Higher values work, but will exceed the gear ratio array and overwrite other data in the vehicle objects' data.
It is not recommended to have a value higher than 8 here as issues with downshifting can occur if the car's top gear is 9 or higher.
fInitialDriveForce
This value specifies the drive force of the car, at the wheels.
- fInitialDriveForce = TorqueWheelsNm/WeightKg
- Value: 0.01 - 2.0 and above. 1.0 uses drive force calculation unmodified. Values less than 1.0 will in effect give the vehicle less drive force and values greater than 1.0 will produce more drive force. Most cars have between 0.10 and 0.40.
This value is calculated with the vehicle weight, so heavy and light vehicles have an accurate acceleration.
fDriveInertia
Describes how fast an engine will rev. For example an engine with a long stroke crank and heavy flywheel will take longer to redline than an engine with a short stroke and light flywheel.
- Drive inertia formula TBD
- Value: 0.01 - 2.0. Default value is 1.0, or no modification of drive intertia. Bigger value = quicker redline
fClutchChangeRateScaleUpShift
Clutch speed multiplier on up shifts, bigger number = faster shifts. Recommended to not go over 13. A value of 1 = 0.9 seconds to shift gears.
fClutchChangeRateScaleDownShift
Clutch speed multiplier on down shifts, bigger number = faster shifts. Recommended to not go over 13. A value of 1 = 0.9 seconds to shift gears.
fInitialDriveMaxFlatVel
Determines the speed at redline in top gear; Controls the final drive of the vehicle's gearbox. Setting this value does not guarantee the vehicle will reach this speed. Multiply the number in the file by 0.82 to get the speed in mph or multiply by 1.32 to get kph. To find the right value for a given kph figure, kph * 0.75.
- TopSpeedKph = (fInitialDriveMaxFlatVel * 1.2) / 0.9
- Value: 0.00 - 500.0 and above.
The top speeds for different gears can be calculated by replacing the 0.9 in the formula with the ratio of the specific gear. GTA V uses a ratio of 0.9 for the top gear by default.
fBrakeForce
Multiplies the game's calculation of deceleration. Bigger number = harder braking
- Brake Force formula TBD
- Value: 0.01 - 2.0 and above. 1.0 uses brake force calculation unmodified.
fBrakeBiasFront
This controls the distribution of braking force between the front and rear axles.
- Value: 0.0 means the rear axle only receives brake force, 1.0 means the front axle only receives brake force. 0.5 gives both axles equal brake force. A value between 0.01 and 0.49 means the rear axle will receive more brake force than the front and a value between .051 and 0.99 means the front axles will receive more brake force than the rear. In real life, normal vehicles usually have more front braking force than the rear (eg., 0.65).
fHandBrakeForce
Braking power for handbrake. Bigger number = harder braking
fSteeringLock
This value is a multiplier of the game's calculation of the angle a steer wheel will turn while at full turn. Steering lock is directly related to over or understeer / turning radius.
- Steering lock formula TBD
- Value: 0.01 - 2.0 and above. Values around 0.1 - 0.2 will simulate a long wheelbase. Whereas a value of around 0.75 and above will turn extremely fast. To high of a value here will cause the vehicle to spin out too easily.
Wheel Traction Attributes
The following attributes describe how the vehicle will behave dynamically, from negotiating corners to acceleration and deceleration. This section has been updated from previous game versions.
fTractionCurveMax
(formerly fTractionMult)
Cornering grip of the vehicle as a multiplier of the tire surface friction. Effectively the peak grip status before any loss of grip.
fTractionCurveMin
(formerly fTractionLoss)
Accelerating/braking grip of the vehicle as a multiplier of the tire surface friction. Effectively the minimum grip status after losing traction, e.g. in a skidding situation.
fTractionCurveLateral
Shape of lateral traction curve (peak traction position in degrees). Lower values make the vehicle's grip more responsive but less forgiving to loss of traction. Higher values make the vehicle's grip less responsive but more forgiving to loss of traction. Also known as "slip angle".
fTractionSpringDeltaMax
Max distance of the lateral sidewall travel. Unit: meter. A force will pull the vehicle in the opposite direction of the lateral travel, most noticeable when stopping after a slide. The dynamic effect is a small force pulling the vehicle inwards of a corner, more noticeable as the sliding angle increases.
fLowSpeedTractionLossMult
How much traction is reduced at low speed, 0.0 means normal traction. It affects mainly car burnout (spinning wheels when car doesn't move) when pressing gas. Decreasing value will cause less burnout, less sliding at start. However, the higher value, the more burnout car gets. Optimal is 1.0. A completely artificial force.
fCamberStiffnesss
How much the vehicle is pushed towards its roll direction. Road camber also affects roll and applied forces.
Values smaller than 0.0 or greater than 1.0 create unrealistic forces.
fTractionBiasFront
Determines the distribution of traction from front to rear.
- Value: 0.01 - 0.99. 0.01 = only rear axle has traction. 0.99 = only front axle has traction. 0.5 = both axles have equal traction. Entering a value of 0.0 or 1.0 causes the vehicle to have no traction (the tires actually fail to spawn), while entering a value outside of specified range causes the car to move irrationally whenever the wheels are touching the ground.
fTractionLossMult
How much is traction affected by material grip differences from 1.0. Basically it affects how much grip is changed when driving on asphalt and mud (the higher, the more grip you loose, making car less responsive and prone to sliding).
Suspension Attributes
fSuspensionForce
1 / (Force * NumWheels) = Lower limit for zero force at full extension. Affects how strong suspension is. Can help if car is easily flipped over when turning.
fSuspensionCompDamp
Damping during strut compression. Bigger = stiffer.
fSuspensionReboundDamp
Damping during strut rebound. Bigger = stiffer
fSuspensionUpperLimit
Visual limit... how far can wheels move up / down from original position
fSuspensionLowerLimit
Visual limit... how far can wheels move up / down from original position
fSuspensionRaise
The amount that the suspension raises the body off the wheels. Recommend adjusting at second decimal unless vehicle has room to move. ie -0.02 is plenty of drop on an already low car. Too much will show the wheels clipping through or if positive, no suspension joining the body to wheels
fSuspensionBiasFront
Force damping scale front/back. If more wheels at back (e.g. trucks) need front suspension to be stronger. This value determines which suspension is stronger, front or rear. If value is above 0.50 then front is stiffer, when below, rear.
fAntiRollBarForce
The spring constant that is transmitted to the opposite wheel when under compression larger numbers are a larger force. Larger Numbers = less body roll
fAntiRollBarBiasFront
The bias between front and rear for the antiroll bar(0 front, 1 rear)
fRollCentreHeightFront
The roll center height for the front axle, from the bottom of the model (road), in meters.
High values place the roll center closer to the center of mass, reducing body roll. Values placing the roll center higher than the center of mass will induce negative body roll - the "Tyrus Effect".
Low values increase the roll center distance from the center of mass, increasing body roll. Values placing the roll center too far from the center of mass may increase rollover chances.
Since center of mass differs per vehicle, using a visualization tool may help determining a desired amount of body roll.
fRollCentreHeightRear
The roll center height for the rear axle, from the bottom of the model (road), in meters.
High values place the roll center closer to the center of mass, reducing body roll. Values placing the roll center higher than the center of mass will induce negative body roll - the "Tyrus Effect".
Low values increase the roll center distance from the center of mass, increasing body roll. Values placing the roll center too far from the center of mass may increase rollover chances.
Since center of mass differs per vehicle, using a visualization tool may help determining a desired amount of body roll.
Damage Attributes
The following attributes dictate how the vehicle will react to damaging effects.
fCollisionDamageMult
Multiplies the game's calculation of damage to the vehicle through collision, causing gas tank and wheels to catch fire.
- Value: 0.0 - 10.0. 0.0 = no damage through collision. 10.0 = Ten times damage through collision.
Higher values make body parts fall off more easily. Also enables engine damage.
fWeaponDamageMult
Multiplies the game's calculation of damage to the vehicle through weapon damage.
- Value: 0.0 - 10.0. 0.0 = no damage through weapons. 10.0 = Ten times damage through weapons.
fDeformationDamageMult
Multiplies the game's calculation of deformation-causing damage.
- Value: 0.0 - 10.0. 0.0 = no deformation through damage is possible. 10.0 = Ten times deformation-causing damage.
fEngineDamageMult
Multiplies the game's calculation of damage to the engine, causing explosion or engine failure.
- Value: 0.0 - 10.0. 0.0 = no damage to the engine. 10.0 = Ten times damage to the engine.
This value seems to respond mostly to impacts directly on the hood, and not as much to front end impacts (particularly with taller vehicles).
fPetrolTankVolume
Amount of petrol that will leak after shooting the vehicle's petrol tank. Also used by some fuel-usage scripts.
fOilVolume
Black smoke time before engine dies?
Miscellaneous Attributes
fSeatOffsetDistX
The distance from the door to the car seat.
- Value: Driver > passenger
fSeatOffsetDistY
The distance from the door to the car seat.
- Value: Trunk > hood
fSeatOffsetDistZ
The distance from the door to the car seat.
- Value: Undercarriage > roof
nMonetaryValue
Vehicle worth.
strModelFlags
Affects model-related functions.
Model Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | MF_IS_VAN | Allows the vehicle to use door_dside_r and door_pside_r bones as double rear doors.
|
0x2 | MF_IS_BUS | |
0x4 | MF_IS_LOW | |
0x8 | MF_IS_BIG | Makes the AI take wider turns when driving around corners. |
0x10 | MF_ABS_STD | |
0x20 | MF_ABS_OPTION | |
0x40 | MF_ABS_ALT_STD | |
0x80 | MF_ABS_ALT_OPTION | |
0x100 | MF_NO_DOORS | Used for vehicles that have no door bones. |
0x200 | MF_TANDEM_SEATING | |
0x400 | MF_SIT_IN_BOAT | Uses seated animations when controlling a boat. |
0x800 | MF_HAS_TRACKS | Changes the tire mark texture to tank tracks and permanently applies it to the road, and makes misc_a , misc_b , misc_c , and misc_d bones act as wheels.
|
0x1000 | MF_NO_EXHAUST | The vehicle won't render exhaust particle effects. |
0x2000 | MF_DOUBLE_EXHAUST | Creates a mirrored copy of the exhaust particle effect on the car. Technically redundant, as the game supports up to 32 individual exhaust bones. |
0x4000 | MF_NO_1STPERSON_LOOKBEHIND | Does not allow the player to use the "look behind" button while in first person view - it will instead enter third person mode and then look behind. |
0x8000 | MF_CAN_ENTER_IF_NO_DOOR | Allows entry into the vehicle even if the vehicle has no accessible door. |
0x10000 | MF_AXLE_F_TORSION | |
0x20000 | MF_AXLE_F_SOLID | |
0x40000 | MF_AXLE_F_MCPHERSON | |
0x80000 | MF_ATTACH_PED_TO_BODYSHELL | |
0x100000 | MF_AXLE_R_TORSION | |
0x200000 | MF_AXLE_R_SOLID | |
0x400000 | MF_AXLE_R_MCPHERSON | |
0x800000 | MF_DONT_FORCE_GRND_CLEARANCE | Allows car to fully bottom out during hard landings and get stuck on curbs if low enough. Also allows bumpers to collide with map (when used in conjunction with vehicles.meta function). |
0x1000000 | MF_DONT_RENDER_STEER | Will not turn the vehicle's wheels when steering - visual effect only. |
0x2000000 | MF_NO_WHEEL_BURST | Prevents the wheels from being burst in any way - essentially a default "Bulletproof Tires" option. |
0x4000000 | MF_INDESTRUCTIBLE | makes the vehicle indestructible. |
0x8000000 | MF_DOUBLE_FRONT_WHEELS | Doubles the front wheel. |
0x10000000 | MF_IS_RC | Hides the player model when they enter the vehicle. |
0x20000000 | MF_DOUBLE_REAR_WHEELS | Doubles the rear wheel. |
0x40000000 | MF_NO_WHEEL_BREAK | Prevents the vehicle's wheels from getting detached on damage. |
0x80000000 | MF_IS_HATCHBACK | |
Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. Official names have been taken from Red Dead Redemption II, which lets go of the HEX system in favor of strings. The flags in that game are identical to ones found in GTA V. |
strHandlingFlags
Affects handling-related functions.
Handling Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | HF_SMOOTHED_COMPRESSION | Makes the suspension compression smoother. |
0x2 | HF_REDUCED_MOD_MASS | Reduces the mass that is added with modification parts. |
0x4 | HF_HAS_KERS | Partially enables KERS on the vehicle; disables horn and shows the recharge bar below the minimap. KERS boost itself still needs to be enabled by the SET_VEHICLE_KERS_ALLOWED native.
|
0x8 | MF_HAS_TRACKS | Official name hash for this flag is the same as the MF_HAS_TRACKS flag from strModelFlags. The actual function is that the vehicle's grip becomes inverted.
|
0x10 | HF_NO_HANDBRAKE | Disables handbrake control. |
0x20 | HF_STEER_REARWHEELS | Rear wheels will steer instead of the front. |
0x40 | HF_HANDBRAKE_REARWHEELSTEER | Allows to use the handbrake to steer the vehicle with rear wheels, in addition to the front wheels. |
0x80 | HF_STEER_ALL_WHEELS | Front and rear wheels will steer. |
0x100 | HF_FREEWHEEL_NO_GAS | Disables auto-braking when coasting. |
0x200 | HF_NO_REVERSE | Disables reverse control. |
0x400 | _0x4C11C7F9 | Official name hash: 0x4C11C7F9 |
0x800 | HF_STEER_NO_WHEELS | Prevents vehicle from steering. |
0x1000 | HF_CVT | Enables electric vehicle physics. |
0x2000 | HF_ALT_EXT_WHEEL_BOUNDS_BEH | |
0x4000 | HF_DONT_RAISE_BOUNDS_AT_SPEED | |
0x8000 | HF_EXT_WHEEL_BOUNDS_COL | |
0x10000 | HF_LESS_SNOW_SINK | The vehicle will sink less when driving over snow. |
0x20000 | HF_TYRES_CAN_CLIP | Allows the tires to clip into the ground based on the tire sidewall, letting the vehicle handle bumps much easier. |
0x40000 | _0x2DEA7A05 | Official name hash: 0x2DEA7A05 |
0x80000 | HF_HEAVY_VEHICLE | |
0x100000 | HF_OFFROAD_ABILITIES | Allows the vehicle to perform better off-road. |
0x200000 | HF_OFFROAD_ABILITIES_X2 | Allows the vehicle to perform even better off-road. |
0x400000 | HF_TYRES_RAISE_SIDE_IMPACT_THRESHOLD | |
0x800000 | INCREASED_GRAVITY | Official name hash: 0xB7AD98ED |
0x1000000 | HF_ENABLE_LEAN | |
0x2000000 | _0xD43251F6 | Official name hash: 0xD43251F6. Disables traction control for motorcycles. |
0x4000000 | HF_HEAVYARMOUR | |
0x8000000 | HF_ARMOURED | Prevents vehicle doors from breaking open in collisions. |
0x10000000 | HF_SELF_RIGHTING_IN_WATER | |
0x20000000 | HF_IMPROVED_RIGHTING_FORCE | Adds extra force when trying to flip the vehicle back on its wheels. |
0x40000000 | HF_USE_EXTRA_SOFT_SURFACE_SUS | Affects how suspension handles abrupt changes in surface. |
0x80000000 | HF_LAST_AVAILABLE_FLAG | Does nothing. Possibly exclusive to RDRII. |
Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. Official names have been taken from Red Dead Redemption II, which lets go of the HEX system in favor of strings. The flags in that game are identical to ones found in GTA V. |
strDamageFlags
Indicates the doors that are nonbreakable.
Damage Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | DF_DRIVER_SIDE_FRONT_DOOR | Makes the driver-side front door (door_dside_f ) non-breakable.
|
0x2 | DF_DRIVER_SIDE_REAR_DOOR | Makes the driver-side rear door (door_dside_r ) non-breakable.
|
0x4 | DF_DRIVER_PASSENGER_SIDE_FRONT_DOOR | Makes the passenger-side front door (door_pside_f ) non-breakable.
|
0x8 | DF_DRIVER_PASSENGER_SIDE_REAR_DOOR | Makes the passenger-side rear door (door_pside_r ) non-breakable.
|
0x10 | DF_BONNET | Makes the hood (bonnet ) non-breakable.
|
0x20 | DF_BOOT | Makes the trunk (boot ) non-breakable.
|
Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. Official names have been taken from Red Dead Redemption II, which lets go of the HEX system in favor of strings. The flags in that game are identical to ones found in GTA V. |
AIHandling
Tells the AI which driving profile it should use when driving the vehicle. Use AVERAGE for boats, bikes, aircraft, etc.
- AVERAGE
- SPORTS_CAR
- TRUCK
- CRAP
SubHandlingData
Can use 3 different sub handling data items. For blank items, set type to "NULL"
CCarHandlingData
fBackEndPopUpCarImpulseMult
fBackEndPopUpBuildingImpulseMult
fBackEndPopUpMaxDeltaSpeed
fToeFront
Adjusts the toe of the vehicle's front wheels.
fToeRear
Adjusts the toe of the vehicle's rear wheels.
fCamberFront
Adjusts the camber of the vehicle's front wheels.
fCamberRear
Adjusts the camber of the vehicle's rear wheels.
fCastor
fEngineResistance
fMaxDriveBiasTransfer
When enabled, transfers the drive force from the slipping wheels to the less-driven wheels.
fJumpForceScale
Adjusts the force with which vehicles with a jump boost are boosted. The higher the value, the higher the jump.
Unknown (0xFD5598BA)
Unused in-game. It is a float value with unknown effect.
strAdvancedFlags
Advanced flags. Infamous for their original application having negative effects on certain vehicles.
Advanced Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | Unknown / N/A | |
0x2 | Unknown / N/A | |
0x4 | _AF_ENABLE_DRIVE_BIAS_TRANSFER | Allows the vehicle to use fMaxDriveBiasTransfer value.
|
0x8 | Unknown / N/A | |
0x10 | Unknown / N/A | |
0x20 | Unknown / N/A | |
0x40 | Unknown / N/A | |
0x80 | _AF_SMOOTH_HANDBRAKE | When using the handbrake the vehicle slows down more gradually and leaves less tire marks. |
0x100 | Unknown / N/A | |
0x200 | Unknown / N/A | |
0x400 | Unknown / N/A | |
0x800 | Unknown / N/A | |
0x1000 | Unknown / N/A | |
0x2000 | Unknown / N/A | |
0x4000 | Unknown / N/A | |
0x8000 | _AF_CAN_BE_STANCED | Allows the vehicle to be stanced using the _SET_LOWERED_STANCE_ENABLED native. Requires the _AF_IGNORE_TUNED_WHEELS_CLIP flag to be enabled.
|
0x10000 | _AF_TRACTION_CONTROL | Adds traction control to the vehicle and shifts gears up earlier. |
0x20000 | _AF_HOLD_GEAR_LONGER | Shifts gears up later than normal. Causes a revving effect before shifting on some vehicles. |
0x40000 | _AF_STIFFER_SPRING_SPEED | Increases suspension spring force as the vehicle goes faster. Also known as "bouncy suspension". |
0x80000 | _AF_FAKE_WHEELSPIN | The vehicle will do another, fake, wheelspin after a wheelspin - traction will behave as if the wheels are still spinning. |
0x100000 | _AF_REDUCED_RIGHTING_FORCE | Reduces righting force of the vehicle, effectively making it much harder and slower to flip back on its wheels. |
0x200000 | _AF_LONGER_1ST | Extends the duration of the first gear. |
0x400000 | _AF_SMOOTH_REV_1ST | The revs are smoother when in first gear. |
0x800000 | _AF_NEUTRAL_STEER | Allows the vehicle to be rotated left or right while parked on the spot. Intended for tanks/tracked vehicles. |
0x1000000 | _AF_HANDBRAKE_WHEELIE | Allows the vehicle to perform a handbrake wheelie. Muscle vehicle class is hardcoded to use this flag. |
0x2000000 | _AF_REDUCE_EXT_WHEEL_COL_CLIPPING | Makes the wheels much less likely to clip into the ground when the vehicle is tipped over. |
0x4000000 | _AF_IGNORE_TUNED_WHEELS_CLIP | Forces stock tire clipping boundaries. Also prevents lowering the vehicle by shooting at its wheels/suspension. This flag is required in addition to _AF_CAN_BE_STANCED to stance the vehicle through script.
|
0x8000000 | _AF_DOWNFORCE_KERBFIX | Changes the way downforce works, and enables the use of AdvancedData to affect downforce by individual spoilers and front bumper parts. In addition, it nullifies the speed gained from going over curbs. |
0x10000000 | _AF_IMPROVED_GRIP_WITH_SUSP_MODS | Suspension options give the vehicle more grip. |
0x20000000 | _AF_HAS_SPECIAL_PERFORMANCE_MODS | Enables the use of AdvancedData to add new performance mods affecting engine power and turbo stages. |
0x40000000 | Unknown / N/A | |
0x80000000 | Unknown / N/A | |
Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. Official names have been taken from Red Dead Redemption II, which lets go of the HEX system in favor of strings. The flags in that game are identical to ones found in GTA V. |
AdvancedData
Advanced Data for the vehicle. Currently it is known to affect two different vehicle mechanics, the wheelies and the downforce, in a different way.
If the handbrake wheelie advanced flag is enabled (hardcoded to be enabled for all Muscle class vehicles), the AdvancedData will allow defined modparts to control the force multiplier for the wheelie.
If the new downforce mechanics advanced flag is enabled, the AdvancedData will allow defined modparts to control the downforce multiplier for the vehicle ONLY on the spoiler and front bumper parts.
Has the following 3 parameters:
Slot
Mod part slot ID, as defined in carcols modpart type. The ID's are:
0: VMT_SPOILER 1: VMT_BUMPER_F 2: VMT_BUMPER_R 3: VMT_SKIRT 4: VMT_EXHAUST 5: VMT_CHASSIS 6: VMT_GRILL 7: VMT_BONNET 8: VMT_WING_L 9: VMT_WING_R 10: VMT_ROOF 11: VMT_PLTHOLDER 12: VMT_PLTVANITY 13: VMT_INTERIOR1 14: VMT_INTERIOR2 15: VMT_INTERIOR3 16: VMT_INTERIOR4 17: VMT_INTERIOR5 18: VMT_SEATS 19: VMT_STEERING 20: VMT_KNOB 21: VMT_PLAQUE 22: VMT_ICE 23: VMT_TRUNK 24: VMT_HYDRO 25: VMT_ENGINEBAY1 26: VMT_ENGINEBAY2 27: VMT_ENGINEBAY3 28: VMT_CHASSIS2 29: VMT_CHASSIS3 30: VMT_CHASSIS4 31: VMT_CHASSIS5 32: VMT_DOOR_L 33: VMT_DOOR_R 34: VMT_LIVERY_MOD 35: VMT_LIGHTBAR 36: VMT_ENGINE 37: VMT_BRAKES 38: VMT_GEARBOX 39: VMT_HORN 40: VMT_SUSPENSION 41: VMT_ARMOUR 42: VMT_NITROUS 43: VMT_TURBO 44: VMT_SUBWOOFER 45: VMT_TYRE_SMOKE 46: VMT_HYDRAULICS 47: VMT_XENON_LIGHTS 48: VMT_WHEELS 49: VMT_WHEELS_REAR_OR_HYDRAULICS
This value can be ignored if one intends on having the parts alter downforce.
Known Effects | ||
---|---|---|
Slot | Required Flag | Effect |
Any | _AF_HANDBRAKE_WHEELIE | Adjusts the force of the handbrake wheelie. |
0 | _AF_DOWNFORCE_KERBFIX | Affects downforce. |
1 | ||
20 | _AF_HAS_SPECIAL_PERFORMANCE_MODS | Allows to increase or decrease engine power when Turbo is equipped. |
22 | Allows to increase or decrease engine power. |
Index
Index of the mod part. For downforce altering, the index value is overall, and not based on type. Eg. Index value of 50 will affect the 50th (51st, if you start counting from 1) part listed in the modkit. The part at the chosen index must be classified as either a spoiler or a front bumper AND the new downforce mechanics advanced flag must be enabled for the multiplier to have any effect.
For wheelie force altering, the index value is based on type. Eg. if the chosen modpart is at index 20, but it is the second part of a specific class, then the index will be 1 and not 20. Slot value must be correctly defined, and the handbrake wheelie advanced flag must be enabled on the vehicle in order for the multiplier value to have an effect.
Value
The multiplier value.
CBoatHandlingData
Some car handling variables are used for alternate functions in boats.
fBoxFrontMult
fBoxRearMult
fBoxSideMult
fSampleTop
fSampleBottom
fSampleBottomTestCorrection
fAquaplaneForce
fAquaplanePushWaterMult
fAquaplanePushWaterCap
fAquaplanePushWaterApply
fRudderForce
fRudderOffsetSubmerge
Vertical offset of propeller from bone when determining if submerged.
fRudderOffsetForce
Vertical offset of propeller from bone when applying force.
fRudderOffsetForceZMult
fWaveAudioMult
vecMoveResistance
vecTurnResistance
fLook_L_R_CamHeight
fDragCoefficient
fKeelSphereSize
fPropRadius
fLowLodAngOffset
The angular offset from vertical that this boat sits at on calm water; used to smooth transition to/from low LOD buoyancy mode.
fLowLodDraughtOffset
fImpellerOffset
fImpellerForceMult
fDinghySphereBuoyConst
fProwRaiseMult
fDeepWaterSampleBuoyancyMult
fTransmissionMultiplier
fTractionMultiplier
CBikeHandlingData
fLeanFwdCOMMult
How much the center of mass is shifted by leaning forward.
fLeanFwdForceMult
How much force is applied when leaning forward.
fLeanBakCOMMult
How much the center of mass is shifted by leaning back.
fLeanBakForceMult
How much force is applied when leaning back.
fMaxBankAngle
Max angle of bike lean when cornering.
fFullAnimAngle
Max angle of player body lean when cornering.
fDesLeanReturnFrac
How quickly the player's body returns from leaning? Higher values = slower
fStickLeanMult
How quickly the player's body leans?
fBrakingStabilityMult
fInAirSteerMult
Strength of in-air steering.
fWheelieBalancePoint
fStoppieBalancePoint
fWheelieSteerMult
fRearBalanceMult
fFrontBalanceMult
fBikeGroundSideFrictionMult
fBikeWheelGroundSideFrictionMult
fBikeOnStandLeanAngle
fBikeOnStandSteerAngle
fJumpForce
CFlyingHandlingData
For aircraft that use multiple flight modes (e.g. the Hydra) use two separate subhandlingdata entries.
fThrust
Thrust power.
fThrustFallOff
Thrust powerloss with speed.
fThrustVectoring
Thrust direction adjustment based on steering.
fYawMult
Yaw input strength.
fYawStabilise
Yaw resistance, scales up with speed.
fSideSlipMult
Sideways resistance, scales up with speed.
fRollMult
Roll input strength, scales up with speed.
fRollStabilise
Roll resistance, scales up with speed.
fPitchMult
Pitch input strength, scales up with speed.
fPitchStabilise
Pitch resistance, scales up with speed.
fFormLiftMult
Base lift factor that�s independent from wing�s attack angle. Affects the tendency to point relative upwards with speed.
fAttackLiftMult
Lift factor of the wing�s attack angle while rising, scales up with speed.
fAttackDiveMult
Lift factor of the wing�s attack angle while diving, scales up with speed.
fGearDownDragV
Extra drag when the gear (and in some planes, the flaps too) is down, scales up with speed.
fGearDownLiftMult
Lift multiplier when the gear (and in some planes, the flaps too) is down.
fWindMult
Wind influence factor.
fMoveRes
A form of air drag/resistance factor, separate from <fInitialDragCoeff> and works in a less natural way. It is advised to use <fInitialDragCoeff> to mess with air drag instead.
vecTurnRes
Resistance to rotation, the lower, the less natural wobble.
vecSpeedRes
fGearDoorFrontOpen
fGearDoorRearOpen
fGearDoorRearOpen2
fGearDoorRearMOpen
fTurublenceMagnitudeMax
Maximum turbulence magnitude of Sinwave motion simulation.
fTurublenceForceMulti
Turbulence vertical force multiplier.
fTurublenceRollTorqueMulti
Turbulence y axis torque multiplier.
fTurublencePitchTorqueMulti
Turbulence x axis torque multiplier.
fBodyDamageControlEffectMult
Control noise factor contributed from plane damage.
fInputSensitivityForDifficulty
Control noise factor contributed from pilot driving skills.
fOnGroundYawBoostSpeedPeak
fOnGroundYawBoostSpeedCap
fEngineOffGlideMulti
fSubmergeLevelToPullHeliUnderwater
handlingType
- HANDLING_TYPE_FLYING - Plane or helicopter.
- HANDLING_TYPE_VERTICAL_FLYING - Hydra VTOL mode.
CVehicleWeaponHandlingData
uWeaponHash
Up to 3 weapons usable per vehicle. Vehicle Weapon name in weapons.meta. Available weapons:
- VEHICLE_WEAPON_TANK
- VEHICLE_WEAPON_SPACE_ROCKET
- VEHICLE_WEAPON_PLANE_ROCKET
- VEHICLE_WEAPON_PLAYER_LASER
- VEHICLE_WEAPON_ENEMY_LASER
- VEHICLE_WEAPON_PLAYER_BULLET
- VEHICLE_WEAPON_PLAYER_BUZZARD
- VEHICLE_WEAPON_PLAYER_HUNTER
- VEHICLE_WEAPON_PLAYER_LAZER
- VEHICLE_WEAPON_SEARCHLIGHT
- VEHICLE_WEAPON_WATER_CANNON
- VEHICLE_WEAPON_RADAR
- VEHICLE_WEAPON_DUNE
- VEHICLE_WEAPON_NOSE_TURRET_VALKYRIE
- VEHICLE_WEAPON_TURRET_VALKYRIE
- VEHICLE_WEAPON_TURRET_TECHNICAL
- VEHICLE_WEAPON_PLAYER_SAVAGE
- VEHICLE_WEAPON_TURRET_INSURGENT
- VEHICLE_WEAPON_TURRET_LIMO
- VEHICLE_WEAPON_TURRET_VALKYRIE
- VEHICLE_WEAPON_CARACARA_MG
- VEHICLE_WEAPON_CARACARA_MINIGUN
- VEHICLE_WEAPON_HAVOK_MINIGUN
- VEHICLE_WEAPON_INSURGENT_MINIGUN
- VEHICLE_WEAPON_MENACER_MG
- VEHICLE_WEAPON_MULE4_MG
- VEHICLE_WEAPON_MULE4_MISSILE
- VEHICLE_WEAPON_MULE4_TURRET_GL
- VEHICLE_WEAPON_OPPRESSOR2_MG
- VEHICLE_WEAPON_OPPRESSOR2_CANNON
- VEHICLE_WEAPON_OPPRESSOR2_MISSILE
- VEHICLE_WEAPON_POUNDER2_MINI
- VEHICLE_WEAPON_POUNDER2_MISSILE
- VEHICLE_WEAPON_POUNDER2_BARRAGE
- VEHICLE_WEAPON_POUNDER2_GL
- VEHICLE_WEAPON_SCRAMJET_MG
- VEHICLE_WEAPON_SCRAMJET_MISSILE
- VEHICLE_WEAPON_SPEEDO4_MG
- VEHICLE_WEAPON_SPEEDO4_TURRET_MG
- VEHICLE_WEAPON_SPEEDO4_TURRET_MINI
- VEHICLE_WEAPON_STRIKEFORCE_CANNON
- VEHICLE_WEAPON_STRIKEFORCE_MISSILE
- VEHICLE_WEAPON_STRIKEFORCE_BARRAGE
- VEHICLE_WEAPON_HACKER_MISSILE
- VEHICLE_WEAPON_HACKER_MISSILE_HOMING
- VEHICLE_WEAPON_AKULA_TURRET_SINGLE
- VEHICLE_WEAPON_AKULA_MISSILE
- VEHICLE_WEAPON_AKULA_TURRET_DUAL
- VEHICLE_WEAPON_AKULA_MINIGUN
- VEHICLE_WEAPON_AKULA_BARRAGE
- VEHICLE_WEAPON_AVENGER_CANNON
- VEHICLE_WEAPON_BARRAGE_TOP_MG
- VEHICLE_WEAPON_BARRAGE_TOP_MINIGUN
- VEHICLE_WEAPON_BARRAGE_REAR_MG
- VEHICLE_WEAPON_BARRAGE_REAR_MINIGUN
- VEHICLE_WEAPON_BARRAGE_REAR_GL
- VEHICLE_WEAPON_CHERNO_MISSILE
- VEHICLE_WEAPON_COMET_MG
- VEHICLE_WEAPON_DELUXO_MG
- VEHICLE_WEAPON_DELUXO_MISSILE
- VEHICLE_WEAPON_KHANJALI_CANNON
- VEHICLE_WEAPON_KHANJALI_CANNON_HEAVY
- VEHICLE_WEAPON_KHANJALI_MG
- VEHICLE_WEAPON_KHANJALI_GL
- VEHICLE_WEAPON_REVOLTER_MG
- VEHICLE_WEAPON_SUBCAR_MG
- VEHICLE_WEAPON_SUBCAR_MISSILE
- VEHICLE_WEAPON_SUBCAR_TORPEDO
- VEHICLE_WEAPON_THRUSTER_MG
- VEHICLE_WEAPON_THRUSTER_MISSILE
- VEHICLE_WEAPON_VISERIS_MG
- VEHICLE_WEAPON_VOLATOL_DUALMG
- VEHICLE_WEAPON_BRUISER_50CAL
- VEHICLE_WEAPON_BRUISER2_50CAL_LASER
- VEHICLE_WEAPON_BRUTUS_50CAL
- VEHICLE_WEAPON_FLAMETHROWER
- VEHICLE_WEAPON_FLAMETHROWER_SCIFI
- VEHICLE_WEAPON_DEATHBIKE_DUALMINIGUN
- VEHICLE_WEAPON_DEATHBIKE2_MINIGUN_LASER
- VEHICLE_WEAPON_DOMINATOR4_50CAL
- VEHICLE_WEAPON_DOMINATOR5_50CAL_LASER
- VEHICLE_WEAPON_IMPALER2_50CAL
- VEHICLE_WEAPON_IMPALER3_50CAL_LASER
- VEHICLE_WEAPON_IMPERATOR_50CAL
- VEHICLE_WEAPON_MORTAR_KINETIC
- VEHICLE_WEAPON_IMPERATOR2_50CAL_LASER
- VEHICLE_WEAPON_ISSI4_50CAL
- VEHICLE_WEAPON_ISSI5_50CAL_LASER
- VEHICLE_WEAPON_MONSTER3_GLKIN
- VEHICLE_WEAPON_SCARAB_50CAL
- VEHICLE_WEAPON_SCARAB2_50CAL_LASER
- VEHICLE_WEAPON_SLAMVAN4_50CAL
- VEHICLE_WEAPON_SLAMVAN5_50CAL_LASER
- VEHICLE_WEAPON_ZR380_50CAL
- VEHICLE_WEAPON_ZR3802_50CAL_LASER
- VEHICLE_WEAPON_DUNE_MG
- VEHICLE_WEAPON_DUNE_GRENADELAUNCHER
- VEHICLE_WEAPON_DUNE_MINIGUN
- VEHICLE_WEAPON_TAMPA_MISSILE
- VEHICLE_WEAPON_TAMPA_MORTAR
- VEHICLE_WEAPON_TAMPA_FIXEDMINIGUN
- VEHICLE_WEAPON_TAMPA_DUALMINIGUN
- VEHICLE_WEAPON_HALFTRACK_DUALMG
- VEHICLE_WEAPON_HALFTRACK_QUADMG
- VEHICLE_WEAPON_APC_CANNON
- VEHICLE_WEAPON_APC_MISSILE
- VEHICLE_WEAPON_APC_MG
- VEHICLE_WEAPON_ARDENT_MG
- VEHICLE_WEAPON_TECHNICAL_MINIGUN
- VEHICLE_WEAPON_TRAILER_QUADMG
- VEHICLE_WEAPON_TRAILER_MISSILE
- VEHICLE_WEAPON_TRAILER_DUALAA
- VEHICLE_WEAPON_NIGHTSHARK_MG
- VEHICLE_WEAPON_OPPRESSOR_MG
- VEHICLE_WEAPON_OPPRESSOR_MISSILE
- VEHICLE_WEAPON_MOBILEOPS_CANNON
- VEHICLE_WEAPON_JB700_MG
- VEHICLE_WEAPON_RCTANK_GUN
- VEHICLE_WEAPON_RCTANK_FLAME
- VEHICLE_WEAPON_RCTANK_ROCKET
- VEHICLE_WEAPON_RCTANK_LAZER
- VEHICLE_WEAPON_CANNON_BLAZER
- VEHICLE_WEAPON_TURRET_BOXVILLE
- VEHICLE_WEAPON_RUINER_BULLET
- VEHICLE_WEAPON_RUINER_ROCKET
- VEHICLE_WEAPON_HUNTER_MG
- VEHICLE_WEAPON_HUNTER_MISSILE
- VEHICLE_WEAPON_HUNTER_CANNON
- VEHICLE_WEAPON_HUNTER_BARRAGE
- VEHICLE_WEAPON_TULA_NOSEMG
- VEHICLE_WEAPON_TULA_MG
- VEHICLE_WEAPON_TULA_DUALMG
- VEHICLE_WEAPON_TULA_MINIGUN
- VEHICLE_WEAPON_SEABREEZE_MG
- VEHICLE_WEAPON_MICROLIGHT_MG
- VEHICLE_WEAPON_DOGFIGHTER_MG
- VEHICLE_WEAPON_DOGFIGHTER_MISSILE
- VEHICLE_WEAPON_MOGUL_NOSE
- VEHICLE_WEAPON_MOGUL_DUALNOSE
- VEHICLE_WEAPON_MOGUL_TURRET
- VEHICLE_WEAPON_MOGUL_DUALTURRET
- VEHICLE_WEAPON_ROGUE_MG
- VEHICLE_WEAPON_ROGUE_CANNON
- VEHICLE_WEAPON_ROGUE_MISSILE
- VEHICLE_WEAPON_BOMBUSHKA_DUALMG
- VEHICLE_WEAPON_BOMBUSHKA_CANNON
- VEHICLE_WEAPON_VIGILANTE_MG
- VEHICLE_WEAPON_VIGILANTE_MISSILE
- VEHICLE_WEAPON_PARAGON2_MG
WeaponSeats
Seat number that can control the weapon. Use 0 if a weapon isn't set.
- Value: Weapon 1: 0 - 8. 0 is the driver.
- Value: Weapon 2: 0 - 8. 0 is the driver.
- Value: Weapon 3: 0 - 8. 0 is the driver.
fTurretSpeed
fTurretPitchMin
fTurretPitchMax
fTurretCamPitchMin
fTurretCamPitchMax
fBulletVelocityForGravity
fTurretPitchForwardMin
fUvAnimationMult
fMiscGadgetVar
fWheelImpactOffset
CSubmarineHandlingData
fPitchMult
fPitchAngle
fYawMult
fDiveSpeed
fRollMult
fRollStab
vTurnRes
fMoveResXY
fMoveResZ
CTrailerHandlingData
fAttachLimitPitch
How much the trailer is allowed to lean forward or backward.
fAttachLimitRoll
How much the trailer is allowed to lean from side to side.
fAttachLimitYaw
How much the trailer is allowed to rotate.
fUprightSpringConstant
Exactly 0.0 will cause the upright spring to apply no force
fUprightDampingConstant
fAttachedMaxDistance
Attachment distance constraint max distance. Less than or equal to 0.0 will default to the old spherical constraint.
fAttachedMaxPenetration
Attachment distance constraint max penetration. Less than or equal to 0.0 will default to the old spherical constraint.
fAttachRaiseZ
fPosConstraintMassRatio
Indicates that we want the trailer to appear either heavier (val < 1.0) or lighter relative to the towing vehicle without actually changing its real mass
CBaseSubHandlingData
No parameters. Only used by the Metrotrain.
CSeaPlaneHandlingData
fLeftPontoonComponentId
Component ID of the left pontoon's collision within a grouped chassis COL component.
fRightPontoonComponentId
Component ID of the right pontoon's collision within a grouped chassis COL component.
fPontoonBuoyConst
fPontoonSampleSizeFront
fPontoonSampleSizeMiddle
fPontoonSampleSizeRear
fPontoonLengthFractionForSamples
fPontoonDragCoefficient
Adds drag to the pontoon when travelling on water, in a similar way to the vehicle's initial drag.
fPontoonVerticalDampingCoefficientUp
fPontoonVerticalDampingCoefficientDown
fKeelSphereSize
Increases of decreases the keel sphere emulated around each pontoon.
CSpecialFlightHandlingData
Used to enable hover mode for vehicles, added in game build 1290. Only utilized by Deluxo and Oppressor Mk II.
vecAngularDamping
vecAngularDampingMin
vecLinearDamping
vecLinearDampingMin
fLiftCoefficient
Default value is 150.0
fCriticalLiftAngle
Not adjusted by any vehicle.
Default value is 45.0
fInitialLiftAngle
Not adjusted by any vehicle.
Default value is 1.5
fMaxLiftAngle
Not adjusted by any vehicle.
Default value is 25.0
fDragCoefficient
Default value is 0.4
fBrakingDrag
Not adjusted by any vehicle.
Default value is 10.0
fMaxLiftVelocity
Not adjusted by any vehicle.
Default value is 2000.0
fMinLiftVelocity
Default value is 1.0
fRollTorqueScale
Unknown (0x6A3247B8)
Not adjusted by any vehicle.
Default value is 100.0
Unknown (0xA514ECFD)
Not adjusted by any vehicle.
Default value is 40000.0
fYawTorqueScale
Unknown (0x71141F47)
Not adjusted by any vehicle.
Default value is -5.0
fInitalOverheadAssist
Not adjusted by any vehicle.
Default value is -5.0
fMaxPitchTorque
fMaxSteeringRollTorque
fPitchTorqueScale
fSteeringTorqueScale
Not adjusted by any vehicle.
Default value is 1000.0
fMaxThrust
Thrust speed.
fTransitionDuration
Adjusts the speed of the transformation between land mode and hover mode.
fHoverVelocityScale
Default value is 1.0
fStabilityAssist
Requires the _SFF_ENABLE_STABILITY_ASSIST flag to work. Causes the vehicle to 'snap' towards the original direction it was heading in, in the event that the player turns left or right. This makes the vehicle less 'slidy' and easier to control in hover mode.
Default value is 10.0
fMinSpeedForThrustFalloff
Default value is 0.0
fBrakingThrustScale
Default value is 0.0
mode
Always set to 1. Any other value will result in a glitchy hover mode.
strFlags
Flags that adjust the behavior of the special flight feature.
Special Flight Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | _SFF_DISABLE_THRUST_HATCH | Disables movement of the "misc_c" bone, which is used as a hatch hiding the thrusts. See: Deluxo. Additionally, using the handbrake will fold the extended wings. |
0x2 | _SFF_UNK_1 | Unknown. |
0x4 | _SFF_REDUCED_CLIMB_RATE | Reduces the rate at which the vehicle gains altitude while giving it additional hovering velocity. |
0x8 | _SFF_HB_SMOOTH_LANDING | Using the handbrake makes the vehicle will gradually hover down to the ground. In addition, the player will not bail from the vehicle when using "exit vehicle" input, instead having the same effect. This seems to only affect bikes/Oppressor Mk II. |
0x10 | _SFF_ENABLE_STABILITY_ASSIST | Enables the fStabilityAssist value. Causes the vehicle to 'snap' towards the original direction it was heading in, in the event that the player turns left or right. This makes the vehicle less 'slidy' and easier to control in hover mode. |
0x20 | _SFF_UNK_5 | Unknown. Used by Oppressor Mk II. |
0x40 | _SFF_INCREASE_PITCH_ANGLE | Slightly adjusts the maximum pitch angle of the vehicle. |
0x80 | _SFF_PERMANENTLY_HOVERING | Permanently places the vehicle in hover mode. Hover mode cannot be switched off. |
Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. |
Other
fWeaponDamageScaledToVehHealthMult
Only used by the Rhino.
External Links
Grand Theft Auto V | |
---|---|
File Formats | .awc • .dat • .gfx • .gxt2 • .ide • .meta/.ymt/.xml • .mrf • .patch • .rpf • .ybn/.ybd • .ycd • .ydd • .ydr • .yed • .yfd • .yft • .yld • .ymap • .ymf • .ynd • .ynv • .ypdb • .ysc • .ytd • .ytyp • .yvr |
Documentation | Bink Video • Native functions • Weather types |
Tools | OpenIV • GIMS Evo • CodeWalker |
Multiplayer | GTAForums: GTA Online |
Useful links | Community portal • Discussion forums • GTA V Modding Forum • GTA5-Mods • Native Functions Database (alloc8or) |