Difference between revisions of "Handling.meta"
WildBrick142 (talk | contribs) (→CSpecialFlightHandlingData) |
(→CBikeHandlingData) |
||
(32 intermediate revisions by 5 users not shown) | |||
Line 14: | Line 14: | ||
=== handlingName === | === handlingName === | ||
This is used by the [[vehicles.meta]] file to identify the handling line of the vehicle. | This is used by the [[vehicles.meta]] file to identify the handling line of the vehicle. | ||
− | :'''Value:''' Any text string no more than | + | :'''Value:''' Any text string no more than 16 characters. By default, the handlingName consists of uppercase letters and numbers (TURISMO, E109, etc.) |
=== fMass === | === fMass === | ||
Line 29: | Line 29: | ||
''Sets the amount of downforce applied to the vehicle. Increase this value to increase the grip at high speed.'' | ''Sets the amount of downforce applied to the vehicle. Increase this value to increase the grip at high speed.'' | ||
:'''Value:''' TBD | :'''Value:''' TBD | ||
+ | |||
+ | === fPopUpLightRotation === | ||
+ | Overrides the behavior of light_cover bone to allow it to rotate up to the specified angle. | ||
=== fPercentSubmerged === | === fPercentSubmerged === | ||
Line 39: | Line 42: | ||
:'''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 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.) | :'''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.) | ||
+ | The center of gravity of a vehicle is by default the model coordinate 0,0,0. This means the default center of gravity can be anywhere relative to the model itself(including outside the model). Open the model with OpenIV to view where it is. | ||
=== vecInertiaMultiplier === | === 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''' | 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 | + | '''Note:''' Four cars do not respond typically to this value; the police3 (Police Interceptor), Gang Burrito, 190Z and Zion Classic. They need lower values or else they will rotate too slowly. |
+ | |||
+ | '''Note 2:''' Motorcycles do not use this attribute at all. | ||
:'''Value x:''' '''<''' 0.0 to '''>''' 4.0. | :'''Value x:''' '''<''' 0.0 to '''>''' 4.0. | ||
Line 50: | Line 56: | ||
== Transmission Attributes == | == Transmission Attributes == | ||
− | These values describe the vehicle's straight line performance. Rate of acceleration is determined by fDriveBiasFront, nInitialDriveGears, fInitialDriveForce, fDriveInertia, and fInitialDriveMaxFlatVel<!-- fClutchChangeRateScaleUpShift and fClutchChangeRateScaleDownShift possibly too? -->. Rate of deceleration is determined by fBrakeForce and fBrakeBiasFront | + | These values describe the vehicle's straight line performance. Rate of acceleration is determined by fDriveBiasFront, nInitialDriveGears, fInitialDriveForce, fDriveInertia, and fInitialDriveMaxFlatVel<!-- fClutchChangeRateScaleUpShift and fClutchChangeRateScaleDownShift possibly too? -->. Rate of deceleration is determined by fBrakeForce and fBrakeBiasFront. |
=== fDriveBiasFront === | === fDriveBiasFront === | ||
This value is used to determine whether a vehicle is front, rear, or four wheel drive. | This value is used to determine whether a vehicle is front, rear, or four wheel drive. | ||
Line 58: | Line 64: | ||
:'''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. | :'''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. | 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. | ||
+ | The final gear ratio is static and independent of the number of gears (1 to 8). The 6th, and 7th gear ratios are taller than the final gear ratio. This gives any setup with more than 6 gears an awkward downshift as its final gear. (Based on old testing. Might only apply to older versions of the game.) | ||
=== fInitialDriveForce === | === fInitialDriveForce === | ||
Line 70: | Line 77: | ||
an engine with a short stroke and light flywheel. | an engine with a short stroke and light flywheel. | ||
*''Drive inertia formula TBD'' | *''Drive inertia formula TBD'' | ||
− | :'''Value:''' 0.01 - 2.0. Default value is 1.0, or no modification of drive intertia. Bigger value = quicker redline | + | :'''Value:''' 0.01 - 2.0. Default value is 1.0, or no modification of drive intertia. Bigger value = quicker redline) |
+ | This value is a max change rate cap for the rpm of the engine, and will not increase your rate of forward acceleration under normal circumstances. values below 0.5 may slow down cars with high acceleration | ||
=== fClutchChangeRateScaleUpShift === | === fClutchChangeRateScaleUpShift === | ||
Line 79: | Line 87: | ||
=== fInitialDriveMaxFlatVel === | === 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. | + | 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. To convert mph, multiply by 1.22. |
+ | |||
*'' TopSpeedKph = (fInitialDriveMaxFlatVel * 1.2) / 0.9 '' | *'' TopSpeedKph = (fInitialDriveMaxFlatVel * 1.2) / 0.9 '' | ||
:'''Value:''' 0.00 - 500.0 and above. | :'''Value:''' 0.00 - 500.0 and above. | ||
Line 89: | Line 98: | ||
*''Brake Force formula TBD'' | *''Brake Force formula TBD'' | ||
:'''Value:''' 0.01 - 2.0 and above. 1.0 uses brake force calculation unmodified. | :'''Value:''' 0.01 - 2.0 and above. 1.0 uses brake force calculation unmodified. | ||
− | + | Increasing this value will not increase deceleration rate if the wheels are traction limited. To use all of a vehicles traction for braking fBrakeForce must be higher than fTractionCurveMax / 4 (only tested with cars) | |
+ | |||
=== fBrakeBiasFront === | === fBrakeBiasFront === | ||
This controls the distribution of braking force between the front and rear axles. | 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). | + | :'''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). A value above 0.5 does not necessarily mean the front wheels will trigger abs/lock before the rear wheels (It is possible to check this by turning off the abs. see section on strModelFlags). |
=== fHandBrakeForce === | === fHandBrakeForce === | ||
Line 98: | Line 108: | ||
=== fSteeringLock === | === 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 | + | 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 turning radius. |
*''Steering lock formula TBD'' | *''Steering lock formula TBD'' | ||
− | :'''Value:''' | + | :'''Value:''' 1 - 90. sample value = 40 |
+ | This value is directly tied to steering smoothing that happens at high speed and fTractionCurve lateral. fSteeringLock and fTractionCurveLateral is in harmony when fSteeringLock = fTractionCurveLateral * 2. A higher steering lock value will cause the vehicle to either understeer or spin out easily. A low steering lock will cause the vehicle to have fake understeer (stops steering before running out of traction). This can be used to simulate a crude form of Electronic stability control (ESC). | ||
== Wheel Traction Attributes == | == Wheel Traction Attributes == | ||
Line 108: | Line 119: | ||
(formerly fTractionMult) | (formerly fTractionMult) | ||
− | + | maximum cornering/acceleration coefficient of grip. Effectively the peak grip status before any loss of grip. | |
=== fTractionCurveMin === | === fTractionCurveMin === | ||
(formerly fTractionLoss) | (formerly fTractionLoss) | ||
− | + | sliding cornering/acceleration coefficient of grip. Effectively the grip status after loss of grip, e.g. spinning tires, oversteer, understeer. | |
=== fTractionCurveLateral === | === 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. | + | Shape of lateral traction curve (peak traction position in degrees sideways = fTractionCurveLateral / 2). 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". | Also known as "slip angle". | ||
Line 125: | Line 136: | ||
=== fLowSpeedTractionLossMult === | === 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. | + | 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. Default is 1.0. A completely artificial force. |
=== fCamberStiffnesss === | === fCamberStiffnesss === | ||
Line 151: | Line 162: | ||
=== fSuspensionUpperLimit === | === fSuspensionUpperLimit === | ||
− | + | how far can wheels move up from original position | |
=== fSuspensionLowerLimit === | === fSuspensionLowerLimit === | ||
− | + | how far can wheels move down from original position | |
=== fSuspensionRaise === | === fSuspensionRaise === | ||
Line 212: | Line 223: | ||
=== fOilVolume === | === fOilVolume === | ||
Black smoke time before engine dies? | Black smoke time before engine dies? | ||
+ | |||
+ | === fPetrolConsumptionRate === | ||
== Miscellaneous Attributes == | == Miscellaneous Attributes == | ||
Line 392: | Line 405: | ||
|- | |- | ||
|0x8 | |0x8 | ||
− | |MF_HAS_TRACKS | + | |HF_HAS_RALLY_TYRES <sup>(GTA5)</sup><br>MF_HAS_TRACKS <sup>(RDRII)</sup> |
− | | | + | |'''GTA5:''' Inverts the way grip works on the vehicle. <br>'''RDRII:''' The name hash for this flag is the same as the <code>MF_HAS_TRACKS</code> flag from strModelFlags. Most likely unused, with no effect. |
|- | |- | ||
|0x10 | |0x10 | ||
Line 420: | Line 433: | ||
|- | |- | ||
|0x400 | |0x400 | ||
− | | | + | |HF_REDUCED_RIGHTING_FORCE <sup>(GTA5)</sup><br>HF_REDUCED_DRIVE_OVER_DAMAGE <sup>(RDRII)</sup> |
− | | | + | |'''GTA5:''' Reduces the speed at which the vehicle rotates back onto its wheels.<br>'''RDRII:''' Unknown. Possible the same effect as the GTA5 equivalent of this flag. |
|- | |- | ||
|0x800 | |0x800 | ||
Line 452: | Line 465: | ||
|- | |- | ||
|0x40000 | |0x40000 | ||
− | |_0x2DEA7A05 | + | |HF_REDUCED_DRIVE_OVER_DAMAGE <sup>(GTA5)</sup><br>_0x2DEA7A05 <sup>(RDRII)</sup> |
− | | | + | |'''GTA5:''' Reduces the damage the vehicle takes when colliding with pedestrians.<br>'''RDRII:''' Unknown. Name hash: <code>0x2DEA7A05</code> |
|- | |- | ||
|0x80000 | |0x80000 | ||
− | |HF_HEAVY_VEHICLE | + | |HF_ALT_EXT_WHEEL_BOUNDS_SHRINK <sup>(GTA5)</sup><br>HF_HEAVY_VEHICLE <sup>(RDRII)</sup> |
| | | | ||
|- | |- | ||
|0x100000 | |0x100000 | ||
|HF_OFFROAD_ABILITIES | |HF_OFFROAD_ABILITIES | ||
− | | | + | |Sets the vehicle's gravity multiplier to 1.1. |
|- | |- | ||
|0x200000 | |0x200000 | ||
|HF_OFFROAD_ABILITIES_X2 | |HF_OFFROAD_ABILITIES_X2 | ||
− | | | + | |Sets the vehicle's gravity multiplier to 1.2, makes it immune to large foliage collisions, and the vehicle will continually attempt to self-level while in mid-air. |
|- | |- | ||
|0x400000 | |0x400000 | ||
Line 472: | Line 485: | ||
|- | |- | ||
|0x800000 | |0x800000 | ||
− | | | + | |HF_OFFROAD_INCREASED_GRAVITY_NO_FOLIAGE_DRAG <sup>(GTA5)</sup><br>HF_UNUSED_23 <sup>(RDRII)</sup> |
− | | | + | |'''GTA5:''' Same effects as <code>HF_OFFROAD_ABILITIES_X2</code>, except that the vehicle will not attempt to self-level while in mid-air.<br>'''RDRII:''' Unused. |
|- | |- | ||
|0x1000000 | |0x1000000 | ||
|HF_ENABLE_LEAN | |HF_ENABLE_LEAN | ||
− | | | + | |Prevents rolling in mid air. Used for ATVs. |
|- | |- | ||
|0x2000000 | |0x2000000 | ||
− | | | + | |HF_FORCE_NO_TC_OR_SC <sup>(GTA5)</sup><br>HF_UNUSED_25 <sup>(RDRII)</sup> |
− | | | + | |'''GTA5:''' Disables traction control for motorcycles.<br>'''RDRII:''' Unused. |
|- | |- | ||
|0x4000000 | |0x4000000 | ||
Line 500: | Line 513: | ||
|- | |- | ||
|0x40000000 | |0x40000000 | ||
− | |HF_USE_EXTRA_SOFT_SURFACE_SUS | + | |HF_LOW_SPEED_WHEELIES <sup>(GTA5)</sup><br>HF_USE_EXTRA_SOFT_SURFACE_SUS <sup>(RDRII)</sup> |
− | |Affects how suspension handles abrupt changes in surface. | + | |'''GTA5:''' Allows bikes to do wheelies at lower speeds.<br>'''RDRII:''' Affects how suspension handles abrupt changes in surface. |
|- | |- | ||
|0x80000000 | |0x80000000 | ||
|HF_LAST_AVAILABLE_FLAG | |HF_LAST_AVAILABLE_FLAG | ||
− | |Does nothing | + | |Does nothing. |
|- | |- | ||
|colspan="3" align="center"|Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations.<br>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. | |colspan="3" align="center"|Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations.<br>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. | ||
Line 557: | Line 570: | ||
== CCarHandlingData == | == CCarHandlingData == | ||
=== fBackEndPopUpCarImpulseMult === | === fBackEndPopUpCarImpulseMult === | ||
+ | Adjusts how much the rear end of the vehicle lifts off the ground in a front-end impact with another vehicle. | ||
+ | |||
=== fBackEndPopUpBuildingImpulseMult === | === fBackEndPopUpBuildingImpulseMult === | ||
+ | Presumably adjusts how much the rear end of the vehicle lifts off the ground in a front-end impact with a building or other map object, however there are no observed effects from this value. | ||
+ | |||
=== fBackEndPopUpMaxDeltaSpeed === | === fBackEndPopUpMaxDeltaSpeed === | ||
+ | Seems to be the maximum speed delta (difference in speed) between the two objects colliding where the back end pop-up impulse stops increasing in force. Units used are unknown. | ||
+ | |||
=== fToeFront === | === fToeFront === | ||
− | Adjusts the toe of the vehicle's front wheels. | + | Adjusts the toe of the vehicle's front wheels. value=degrees/45, positive numbers is toe in negative is toe out. |
+ | :'''Default value:''' 0.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' 0.05 <sup><small>(VAMOS)</small></sup> | ||
=== fToeRear === | === fToeRear === | ||
− | Adjusts the toe of the vehicle's rear wheels. | + | Adjusts the toe of the vehicle's rear wheels. value=degrees/45, positive numbers is toe in negative is toe out. |
+ | :'''Default value:''' 0.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' 0.007 <sup><small>(CHEBUREK)</small></sup> | ||
=== fCamberFront === | === fCamberFront === | ||
− | Adjusts the camber of the vehicle's front wheels. | + | Adjusts the camber of the vehicle's front wheels. Suspension mods decrease camber by 0.015 for every 15 modifier points in the suspension's mod data if the <code>FLAG_INCREASE_CAMBER_WITH_SUSPENSION_MOD</code>[[Vehicles.meta#flags|vehicle flag]] is present. value=degrees/22.5 (roughly), negative numbers are negative camber. |
+ | :'''Default value:''' 0.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' -0.02 <sup><small>(MICHELLI)</small></sup> | ||
=== fCamberRear === | === fCamberRear === | ||
− | Adjusts the camber of the vehicle's rear wheels. | + | Adjusts the camber of the vehicle's rear wheels. Suspension mods decrease camber by 0.015 for every 15 modifier points in the suspension's mod data if the <code>FLAG_INCREASE_CAMBER_WITH_SUSPENSION_MOD</code> vehicle flag is present. value=degrees/22.5 (roughly), negative numbers are negative camber. |
+ | :'''Default value:''' 0.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' -0.005 <sup><small>(ISSI3)</small></sup> | ||
=== fCastor === | === fCastor === | ||
+ | Adjusts the caster angle of the vehicle. Each 0.01 increment represents a 1-degree change in caster/castor angle. | ||
+ | :'''Default value:''' 0.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' 0.175 <sup><small>(GB200)</small></sup> | ||
+ | |||
=== fEngineResistance === | === fEngineResistance === | ||
+ | Adjusted by several vehicles since the addition of this parameter, however there are no known or observed effects. | ||
+ | :'''Default value:''' 0.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' 0.04 <sup><small>(HOTRING)</small></sup> | ||
+ | |||
=== fMaxDriveBiasTransfer === | === fMaxDriveBiasTransfer === | ||
− | + | Transfers the drive force from the slipping wheels to the less-driven wheels. Affects differentials, when set by car advanced flags. | |
+ | :'''Default value:''' -1.0 | ||
+ | :'''Minimum value:''' ??? | ||
+ | :'''Maximum value:''' ??? | ||
+ | :'''Example value:''' 0.5 <sup><small>(FLASHGT)</small></sup> | ||
+ | |||
=== fJumpForceScale === | === fJumpForceScale === | ||
Adjusts the force with which vehicles with a jump boost are boosted. The higher the value, the higher the jump. | Adjusts the force with which vehicles with a jump boost are boosted. The higher the value, the higher the jump. | ||
+ | :'''Default value:''' 1.0 | ||
+ | :'''Minimum value:''' 0.0 | ||
+ | :'''Maximum value:''' 10.0 | ||
+ | :'''Example value:''' 1.25 <sup><small>(SCRAMJET)</small></sup> | ||
− | === | + | === fIncreasedRammingForceScale === |
− | + | Not adjusted by any vehicle. Doesn't seem to affect the Arena vehicle ramming bar abilities. | |
+ | :'''Default value:''' 1.0 | ||
+ | :'''Minimum value:''' 0.0 | ||
+ | :'''Maximum value:''' 10.0 | ||
=== strAdvancedFlags === | === strAdvancedFlags === | ||
− | + | Car advanced flags. | |
{| class="wikitable" | {| class="wikitable" | ||
− | ! colspan="3" |Advanced Flags | + | ! colspan="3" |Car (Advanced) Flags |
|- | |- | ||
!HEX | !HEX | ||
Line 592: | Line 651: | ||
|- | |- | ||
|0x1 | |0x1 | ||
− | | | + | |CF_DIFF_FRONT |
− | | | + | |Open front differential. |
|- | |- | ||
|0x2 | |0x2 | ||
− | | | + | |CF_DIFF_REAR |
− | | | + | |Open rear differential. |
|- | |- | ||
|0x4 | |0x4 | ||
− | | | + | |CF_DIFF_CENTRE |
− | | | + | |Open center differential. Observed effect: Strongly affected by the <code>fMaxDriveBiasTransfer</code> value. |
|- | |- | ||
|0x8 | |0x8 | ||
− | | | + | |CF_DIFF_LIMITED_FRONT |
− | | | + | |Torsen (limited-slip) front differential. |
|- | |- | ||
|0x10 | |0x10 | ||
− | | | + | |CF_DIFF_LIMITED_REAR |
− | | | + | |Torsen (limited-slip) rear differential. |
|- | |- | ||
|0x20 | |0x20 | ||
− | | | + | |CF_DIFF_LIMITED_CENTRE |
− | | | + | |Torsen (limited-slip) center differential. |
|- | |- | ||
|0x40 | |0x40 | ||
− | | | + | |CF_DIFF_LOCKING_FRONT |
− | | | + | |Locking front differential. |
|- | |- | ||
|0x80 | |0x80 | ||
− | | | + | |CF_DIFF_LOCKING_REAR |
− | |When using the handbrake the vehicle slows down more gradually and leaves less tire marks. | + | |Locking rear differential. Observed effect: When using the handbrake the vehicle slows down more gradually and leaves less tire marks. |
|- | |- | ||
|0x100 | |0x100 | ||
− | | | + | |CF_DIFF_LOCKING_CENTRE |
− | | | + | |Locking center differential. |
|- | |- | ||
|0x200 | |0x200 | ||
− | | | + | |CF_GEARBOX_FULL_AUTO |
| | | | ||
|- | |- | ||
|0x400 | |0x400 | ||
− | | | + | |CF_GEARBOX_MANUAL |
− | | | + | |Observed effect: The clutch value when the car is idling is set to 0.0 |
|- | |- | ||
|0x800 | |0x800 | ||
− | | | + | |CF_GEARBOX_DIRECT_SHIFT |
| | | | ||
|- | |- | ||
|0x1000 | |0x1000 | ||
− | | | + | |CF_GEARBOX_ELECTRIC |
− | | | + | |Only used on the Obey Omnis e-GT and Powersurge. |
|- | |- | ||
|0x2000 | |0x2000 | ||
− | | | + | |CF_ASSIST_TRACTION_CONTROL |
− | | | + | |Enables drift physics. |
|- | |- | ||
|0x4000 | |0x4000 | ||
− | | | + | |CF_ASSIST_STABILITY_CONTROL |
| | | | ||
|- | |- | ||
|0x8000 | |0x8000 | ||
− | | | + | |CF_ALLOW_REDUCED_SUSPENSION_FORCE |
− | |Allows the vehicle to be stanced using the <code> | + | |Allows the vehicle to be stanced using the <code>SET_REDUCED_SUSPENSION_FORCE</code> native. Requires the <code>CF_FIX_OLD_BUGS</code> flag to be enabled. |
|- | |- | ||
|0x10000 | |0x10000 | ||
− | | | + | |CF_HARD_REV_LIMIT |
− | |Adds | + | |Adds a rev limit, causing the vehicle to shift gears up earlier. |
|- | |- | ||
|0x20000 | |0x20000 | ||
− | | | + | |CF_HOLD_GEAR_WITH_WHEELSPIN |
|Shifts gears up later than normal. Causes a revving effect before shifting on some vehicles. | |Shifts gears up later than normal. Causes a revving effect before shifting on some vehicles. | ||
|- | |- | ||
|0x40000 | |0x40000 | ||
− | | | + | |CF_INCREASE_SUSPENSION_FORCE_WITH_SPEED |
|Increases suspension spring force as the vehicle goes faster. Also known as "bouncy suspension". | |Increases suspension spring force as the vehicle goes faster. Also known as "bouncy suspension". | ||
|- | |- | ||
|0x80000 | |0x80000 | ||
− | | | + | |CF_BLOCK_INCREASED_ROT_VELOCITY_WITH_DRIVE_FORCE |
− | |The vehicle will do another, fake, wheelspin after a wheelspin - traction will behave as if the wheels are still spinning. | + | |The vehicle will do another, fake, wheelspin after a real wheelspin - traction will behave as if the wheels are still spinning. |
|- | |- | ||
|0x100000 | |0x100000 | ||
− | | | + | |CF_REDUCED_SELF_RIGHTING_SPEED |
|Reduces righting force of the vehicle, effectively making it much harder and slower to flip back on its wheels. | |Reduces righting force of the vehicle, effectively making it much harder and slower to flip back on its wheels. | ||
|- | |- | ||
|0x200000 | |0x200000 | ||
− | | | + | |CF_CLOSE_RATIO_GEARBOX |
− | |Extends the duration of the first gear. | + | |Extends the duration of the first gear, causing the vehicle to launch slower and with reduced wheelspin. |
|- | |- | ||
|0x400000 | |0x400000 | ||
− | | | + | |CF_FORCE_SMOOTH_RPM |
− | | | + | |Smoother revs when in first gear. |
|- | |- | ||
|0x800000 | |0x800000 | ||
− | | | + | |CF_ALLOW_TURN_ON_SPOT |
− | |Allows the vehicle to be rotated left or right while parked on the spot. Intended for tanks/tracked vehicles. | + | |Allows the vehicle to be rotated left or right while parked on the spot, also known as neutral steering. Intended for tanks/tracked vehicles. |
|- | |- | ||
|0x1000000 | |0x1000000 | ||
− | | | + | |CF_CAN_WHEELIE |
|Allows the vehicle to perform a handbrake wheelie. Muscle vehicle class is hardcoded to use this flag. | |Allows the vehicle to perform a handbrake wheelie. Muscle vehicle class is hardcoded to use this flag. | ||
|- | |- | ||
|0x2000000 | |0x2000000 | ||
− | | | + | |CF_ENABLE_WHEEL_BLOCKER_SIDE_IMPACTS |
|Makes the wheels much less likely to clip into the ground when the vehicle is tipped over. | |Makes the wheels much less likely to clip into the ground when the vehicle is tipped over. | ||
|- | |- | ||
|0x4000000 | |0x4000000 | ||
− | | | + | |CF_FIX_OLD_BUGS |
− | | | + | |Has multiple uses, intended to fix various handling bugs. Currently-known effects are:<br>— Limits the effects of the <code>HF_TYRES_CAN_CLIP</code> flag by forcing stock tire clipping boundaries on all wheels.<br>— Prevents lowering the vehicle by shooting at its wheels/suspension.<br>This flag is also required in addition to <code>CF_ALLOW_REDUCED_SUSPENSION_FORCE</code> to stance the vehicle through script. |
|- | |- | ||
|0x8000000 | |0x8000000 | ||
− | | | + | |CF_USE_DOWNFORCE_BIAS |
|Changes the way downforce works, and enables the use of [[#AdvancedData|AdvancedData]] to affect downforce by individual spoilers and front bumper parts. In addition, it nullifies the speed gained from going over curbs. | |Changes the way downforce works, and enables the use of [[#AdvancedData|AdvancedData]] to affect downforce by individual spoilers and front bumper parts. In addition, it nullifies the speed gained from going over curbs. | ||
|- | |- | ||
|0x10000000 | |0x10000000 | ||
− | | | + | |CF_REDUCE_BODY_ROLL_WITH_SUSPENSION_MODS |
− | | | + | |Each suspension upgrade reduces body roll and increases grip. |
|- | |- | ||
|0x20000000 | |0x20000000 | ||
− | | | + | |CF_ALLOWS_EXTENDED_MODS |
− | |Enables the use of AdvancedData to add new performance mods affecting engine power and turbo stages. | + | |Enables the use of AdvancedData to add new "Hao's Special Works" performance mods affecting engine power and adding turbo stages. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
|colspan="3" align="center"|Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations.<br>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. | |colspan="3" align="center"|Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations.<br>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. | ||
Line 723: | Line 774: | ||
=== AdvancedData === | === AdvancedData === | ||
− | Advanced Data for the vehicle. Currently it is known to affect | + | Advanced Data for the vehicle. Currently it is known to affect three different vehicle mechanics, the wheelies, downforce and HSW performance upgrades, in a different way.<br> |
− | + | — 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.<br> | |
− | 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.<br> | + | — If the downforce bias 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.<br> |
− | If the | + | — If the allows extended mods advanced flag is enabled, the AdvancedData will allow defined modparts to control the power of the HSW Performance Upgrade and the HSW Turbos. |
Has the following 3 parameters: | Has the following 3 parameters: | ||
Line 791: | Line 842: | ||
|- | |- | ||
|Any | |Any | ||
− | | | + | |CF_CAN_WHEELIE |
|Adjusts the force of the handbrake wheelie. | |Adjusts the force of the handbrake wheelie. | ||
|- | |- | ||
|0 | |0 | ||
− | |rowspan="2"| | + | |rowspan="2"|CF_USE_DOWNFORCE_BIAS |
|rowspan="2"|Affects downforce. | |rowspan="2"|Affects downforce. | ||
|- | |- | ||
Line 801: | Line 852: | ||
|- | |- | ||
|20 | |20 | ||
− | |rowspan="2"| | + | |rowspan="2"|CF_ALLOWS_EXTENDED_MODS |
|Allows to increase or decrease engine power when Turbo is equipped. | |Allows to increase or decrease engine power when Turbo is equipped. | ||
|- | |- | ||
Line 871: | Line 922: | ||
=== fMaxBankAngle === | === fMaxBankAngle === | ||
− | Max angle of bike lean when cornering. | + | Max angle of bike lean from vertical when cornering. |
=== fFullAnimAngle === | === fFullAnimAngle === | ||
− | Max angle of player body lean when cornering. | + | Max angle of player body lean from vertical when cornering. |
=== fDesLeanReturnFrac === | === fDesLeanReturnFrac === | ||
− | How quickly the | + | How quickly the character/bike returns from a lean when changing direction. Higher values = slower. |
=== fStickLeanMult === | === fStickLeanMult === | ||
− | + | Magnifies the lean response to joystick input. Negative values invert the lean direction. Recommend keeping this at zero. | |
=== fBrakingStabilityMult === | === fBrakingStabilityMult === | ||
+ | |||
+ | Causes the bike's rear end to swing around when braking and turning at the same time. Lower and negative values prevent this behavior, higher values allow it. | ||
+ | |||
=== fInAirSteerMult === | === fInAirSteerMult === | ||
− | Strength of in-air steering. | + | Strength of in-air steering. Value of zero also disables self-leveling. |
=== fWheelieBalancePoint === | === fWheelieBalancePoint === | ||
Line 896: | Line 950: | ||
=== fFrontBalanceMult === | === fFrontBalanceMult === | ||
=== fBikeGroundSideFrictionMult === | === fBikeGroundSideFrictionMult === | ||
+ | |||
+ | Prevents abrupt changes in pitch of the bike; for example when hitting a steep ramp at speed, causes bike to stay unusually level. Seems to be done to make "Derailed" mission possible, driving across gaps in train cars. | ||
+ | |||
=== fBikeWheelGroundSideFrictionMult === | === fBikeWheelGroundSideFrictionMult === | ||
+ | |||
+ | Prevents abrupt changes in pitch of the wheel? | ||
+ | |||
=== fBikeOnStandLeanAngle === | === fBikeOnStandLeanAngle === | ||
=== fBikeOnStandSteerAngle === | === fBikeOnStandSteerAngle === | ||
Line 910: | Line 970: | ||
Thrust direction adjustment based on steering. | Thrust direction adjustment based on steering. | ||
=== fInitialThrust === | === fInitialThrust === | ||
− | === | + | Added in b1180. |
+ | === fInitialThrustFallOff === | ||
+ | Added in b1180. | ||
=== fYawMult === | === fYawMult === | ||
Yaw input strength. | Yaw input strength. | ||
Line 918: | Line 980: | ||
Sideways resistance, scales up with speed. | Sideways resistance, scales up with speed. | ||
=== fInitialYawMult === | === fInitialYawMult === | ||
+ | Added in b1180. | ||
=== fRollMult === | === fRollMult === | ||
Roll input strength, scales up with speed. | Roll input strength, scales up with speed. | ||
Line 923: | Line 986: | ||
Roll resistance, scales up with speed. | Roll resistance, scales up with speed. | ||
=== fInitialRollMult === | === fInitialRollMult === | ||
+ | Added in b1180. | ||
=== fPitchMult === | === fPitchMult === | ||
Pitch input strength, scales up with speed. | Pitch input strength, scales up with speed. | ||
Line 928: | Line 992: | ||
Pitch resistance, scales up with speed. | Pitch resistance, scales up with speed. | ||
=== fInitialPitchMult === | === fInitialPitchMult === | ||
+ | Added in b1180. | ||
=== fFormLiftMult === | === fFormLiftMult === | ||
Base lift factor that's independent from wing's attack angle. Affects the tendency to point relative upwards with speed. | Base lift factor that's independent from wing's attack angle. Affects the tendency to point relative upwards with speed. | ||
Line 969: | Line 1,034: | ||
=== fSubmergeLevelToPullHeliUnderwater === | === fSubmergeLevelToPullHeliUnderwater === | ||
=== fExtraLiftWithRoll === | === fExtraLiftWithRoll === | ||
+ | Added in b1180. | ||
=== handlingType === | === handlingType === | ||
*HANDLING_TYPE_FLYING - Plane or helicopter. | *HANDLING_TYPE_FLYING - Plane or helicopter. | ||
Line 1,253: | Line 1,319: | ||
Default value is 1.0 | Default value is 1.0 | ||
=== fStabilityAssist === | === fStabilityAssist === | ||
− | Requires the | + | Requires the SF_STEER_TOWARDS_VELOCITY 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.<br><br>Default value is 10.0 |
+ | |||
=== fMinSpeedForThrustFalloff === | === fMinSpeedForThrustFalloff === | ||
Default value is 0.0 | Default value is 0.0 | ||
Line 1,263: | Line 1,330: | ||
Flags that adjust the behavior of the special flight feature. | Flags that adjust the behavior of the special flight feature. | ||
{| class="wikitable" | {| class="wikitable" | ||
− | ! colspan="3" |Special (Flight) Flags | + | ! colspan="3" |Special (Flight Mode) Flags |
|- | |- | ||
!HEX | !HEX | ||
Line 1,270: | Line 1,337: | ||
|- | |- | ||
|0x1 | |0x1 | ||
− | | | + | |SF_WORKS_UPSIDE_DOWN |
|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. | |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 | |0x2 | ||
− | | | + | |SF_DONT_RETRACT_WHEELS |
− | | | + | |Does nothing. |
|- | |- | ||
|0x4 | |0x4 | ||
− | | | + | |SF_REDUCE_DRAG_WITH_SPEED |
|Reduces the rate at which the vehicle gains altitude while giving it additional hovering velocity. | |Reduces the rate at which the vehicle gains altitude while giving it additional hovering velocity. | ||
|- | |- | ||
|0x8 | |0x8 | ||
− | | | + | |SF_MAINTAIN_HOVER_HEIGHT |
|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. | |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 | |0x10 | ||
− | | | + | |SF_STEER_TOWARDS_VELOCITY |
|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. | |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 | |0x20 | ||
− | | | + | |SF_FORCE_MIN_THROTTLE_WHEN_TURNING |
− | | | + | |Adjusts the throttle when turning. Used by Oppressor Mk II. |
|- | |- | ||
|0x40 | |0x40 | ||
− | | | + | |SF_LIMIT_FORCE_DELTA |
|Slightly adjusts the maximum pitch angle of the vehicle. | |Slightly adjusts the maximum pitch angle of the vehicle. | ||
|- | |- | ||
|0x80 | |0x80 | ||
− | | | + | |SF_FORCE_SPECIAL_FLIGHT_WHEN_DRIVEN |
− | |Permanently places the vehicle in hover mode. Hover mode cannot be switched off. | + | |Permanently places the vehicle in hover mode. Hover mode cannot be switched off by any means. |
|- | |- | ||
|colspan="3" align="center"|Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. | |colspan="3" align="center"|Flag names prefixed with an underscore are unofficial and/or based on guesswork or observations. |
Latest revision as of 02:31, 6 December 2024
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 16 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
fPopUpLightRotation
Overrides the behavior of light_cover bone to allow it to rotate up to the specified angle.
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.)
The center of gravity of a vehicle is by default the model coordinate 0,0,0. This means the default center of gravity can be anywhere relative to the model itself(including outside the model). Open the model with OpenIV to view where it is.
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 values or else they will rotate too slowly.
Note 2: Motorcycles do not use this attribute at all.
- 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.
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. The final gear ratio is static and independent of the number of gears (1 to 8). The 6th, and 7th gear ratios are taller than the final gear ratio. This gives any setup with more than 6 gears an awkward downshift as its final gear. (Based on old testing. Might only apply to older versions of the game.)
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)
This value is a max change rate cap for the rpm of the engine, and will not increase your rate of forward acceleration under normal circumstances. values below 0.5 may slow down cars with high acceleration
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. To convert mph, multiply by 1.22.
- 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.
Increasing this value will not increase deceleration rate if the wheels are traction limited. To use all of a vehicles traction for braking fBrakeForce must be higher than fTractionCurveMax / 4 (only tested with cars)
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). A value above 0.5 does not necessarily mean the front wheels will trigger abs/lock before the rear wheels (It is possible to check this by turning off the abs. see section on strModelFlags).
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 turning radius.
- Steering lock formula TBD
- Value: 1 - 90. sample value = 40
This value is directly tied to steering smoothing that happens at high speed and fTractionCurve lateral. fSteeringLock and fTractionCurveLateral is in harmony when fSteeringLock = fTractionCurveLateral * 2. A higher steering lock value will cause the vehicle to either understeer or spin out easily. A low steering lock will cause the vehicle to have fake understeer (stops steering before running out of traction). This can be used to simulate a crude form of Electronic stability control (ESC).
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)
maximum cornering/acceleration coefficient of grip. Effectively the peak grip status before any loss of grip.
fTractionCurveMin
(formerly fTractionLoss)
sliding cornering/acceleration coefficient of grip. Effectively the grip status after loss of grip, e.g. spinning tires, oversteer, understeer.
fTractionCurveLateral
Shape of lateral traction curve (peak traction position in degrees sideways = fTractionCurveLateral / 2). 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. Default 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
how far can wheels move up from original position
fSuspensionLowerLimit
how far can wheels move 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?
fPetrolConsumptionRate
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 | HF_HAS_RALLY_TYRES (GTA5) MF_HAS_TRACKS (RDRII) |
GTA5: Inverts the way grip works on the vehicle. RDRII: The name hash for this flag is the same as the MF_HAS_TRACKS flag from strModelFlags. Most likely unused, with no effect.
|
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 | HF_REDUCED_RIGHTING_FORCE (GTA5) HF_REDUCED_DRIVE_OVER_DAMAGE (RDRII) |
GTA5: Reduces the speed at which the vehicle rotates back onto its wheels. RDRII: Unknown. Possible the same effect as the GTA5 equivalent of this flag. |
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 | HF_REDUCED_DRIVE_OVER_DAMAGE (GTA5) _0x2DEA7A05 (RDRII) |
GTA5: Reduces the damage the vehicle takes when colliding with pedestrians. RDRII: Unknown. Name hash: 0x2DEA7A05
|
0x80000 | HF_ALT_EXT_WHEEL_BOUNDS_SHRINK (GTA5) HF_HEAVY_VEHICLE (RDRII) |
|
0x100000 | HF_OFFROAD_ABILITIES | Sets the vehicle's gravity multiplier to 1.1. |
0x200000 | HF_OFFROAD_ABILITIES_X2 | Sets the vehicle's gravity multiplier to 1.2, makes it immune to large foliage collisions, and the vehicle will continually attempt to self-level while in mid-air. |
0x400000 | HF_TYRES_RAISE_SIDE_IMPACT_THRESHOLD | |
0x800000 | HF_OFFROAD_INCREASED_GRAVITY_NO_FOLIAGE_DRAG (GTA5) HF_UNUSED_23 (RDRII) |
GTA5: Same effects as HF_OFFROAD_ABILITIES_X2 , except that the vehicle will not attempt to self-level while in mid-air.RDRII: Unused. |
0x1000000 | HF_ENABLE_LEAN | Prevents rolling in mid air. Used for ATVs. |
0x2000000 | HF_FORCE_NO_TC_OR_SC (GTA5) HF_UNUSED_25 (RDRII) |
GTA5: Disables traction control for motorcycles. RDRII: Unused. |
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_LOW_SPEED_WHEELIES (GTA5) HF_USE_EXTRA_SOFT_SURFACE_SUS (RDRII) |
GTA5: Allows bikes to do wheelies at lower speeds. RDRII: Affects how suspension handles abrupt changes in surface. |
0x80000000 | HF_LAST_AVAILABLE_FLAG | Does nothing. |
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
Adjusts how much the rear end of the vehicle lifts off the ground in a front-end impact with another vehicle.
fBackEndPopUpBuildingImpulseMult
Presumably adjusts how much the rear end of the vehicle lifts off the ground in a front-end impact with a building or other map object, however there are no observed effects from this value.
fBackEndPopUpMaxDeltaSpeed
Seems to be the maximum speed delta (difference in speed) between the two objects colliding where the back end pop-up impulse stops increasing in force. Units used are unknown.
fToeFront
Adjusts the toe of the vehicle's front wheels. value=degrees/45, positive numbers is toe in negative is toe out.
- Default value: 0.0
- Minimum value: ???
- Maximum value: ???
- Example value: 0.05 (VAMOS)
fToeRear
Adjusts the toe of the vehicle's rear wheels. value=degrees/45, positive numbers is toe in negative is toe out.
- Default value: 0.0
- Minimum value: ???
- Maximum value: ???
- Example value: 0.007 (CHEBUREK)
fCamberFront
Adjusts the camber of the vehicle's front wheels. Suspension mods decrease camber by 0.015 for every 15 modifier points in the suspension's mod data if the FLAG_INCREASE_CAMBER_WITH_SUSPENSION_MOD
vehicle flag is present. value=degrees/22.5 (roughly), negative numbers are negative camber.
- Default value: 0.0
- Minimum value: ???
- Maximum value: ???
- Example value: -0.02 (MICHELLI)
fCamberRear
Adjusts the camber of the vehicle's rear wheels. Suspension mods decrease camber by 0.015 for every 15 modifier points in the suspension's mod data if the FLAG_INCREASE_CAMBER_WITH_SUSPENSION_MOD
vehicle flag is present. value=degrees/22.5 (roughly), negative numbers are negative camber.
- Default value: 0.0
- Minimum value: ???
- Maximum value: ???
- Example value: -0.005 (ISSI3)
fCastor
Adjusts the caster angle of the vehicle. Each 0.01 increment represents a 1-degree change in caster/castor angle.
- Default value: 0.0
- Minimum value: ???
- Maximum value: ???
- Example value: 0.175 (GB200)
fEngineResistance
Adjusted by several vehicles since the addition of this parameter, however there are no known or observed effects.
- Default value: 0.0
- Minimum value: ???
- Maximum value: ???
- Example value: 0.04 (HOTRING)
fMaxDriveBiasTransfer
Transfers the drive force from the slipping wheels to the less-driven wheels. Affects differentials, when set by car advanced flags.
- Default value: -1.0
- Minimum value: ???
- Maximum value: ???
- Example value: 0.5 (FLASHGT)
fJumpForceScale
Adjusts the force with which vehicles with a jump boost are boosted. The higher the value, the higher the jump.
- Default value: 1.0
- Minimum value: 0.0
- Maximum value: 10.0
- Example value: 1.25 (SCRAMJET)
fIncreasedRammingForceScale
Not adjusted by any vehicle. Doesn't seem to affect the Arena vehicle ramming bar abilities.
- Default value: 1.0
- Minimum value: 0.0
- Maximum value: 10.0
strAdvancedFlags
Car advanced flags.
Car (Advanced) Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | CF_DIFF_FRONT | Open front differential. |
0x2 | CF_DIFF_REAR | Open rear differential. |
0x4 | CF_DIFF_CENTRE | Open center differential. Observed effect: Strongly affected by the fMaxDriveBiasTransfer value.
|
0x8 | CF_DIFF_LIMITED_FRONT | Torsen (limited-slip) front differential. |
0x10 | CF_DIFF_LIMITED_REAR | Torsen (limited-slip) rear differential. |
0x20 | CF_DIFF_LIMITED_CENTRE | Torsen (limited-slip) center differential. |
0x40 | CF_DIFF_LOCKING_FRONT | Locking front differential. |
0x80 | CF_DIFF_LOCKING_REAR | Locking rear differential. Observed effect: When using the handbrake the vehicle slows down more gradually and leaves less tire marks. |
0x100 | CF_DIFF_LOCKING_CENTRE | Locking center differential. |
0x200 | CF_GEARBOX_FULL_AUTO | |
0x400 | CF_GEARBOX_MANUAL | Observed effect: The clutch value when the car is idling is set to 0.0 |
0x800 | CF_GEARBOX_DIRECT_SHIFT | |
0x1000 | CF_GEARBOX_ELECTRIC | Only used on the Obey Omnis e-GT and Powersurge. |
0x2000 | CF_ASSIST_TRACTION_CONTROL | Enables drift physics. |
0x4000 | CF_ASSIST_STABILITY_CONTROL | |
0x8000 | CF_ALLOW_REDUCED_SUSPENSION_FORCE | Allows the vehicle to be stanced using the SET_REDUCED_SUSPENSION_FORCE native. Requires the CF_FIX_OLD_BUGS flag to be enabled.
|
0x10000 | CF_HARD_REV_LIMIT | Adds a rev limit, causing the vehicle to shift gears up earlier. |
0x20000 | CF_HOLD_GEAR_WITH_WHEELSPIN | Shifts gears up later than normal. Causes a revving effect before shifting on some vehicles. |
0x40000 | CF_INCREASE_SUSPENSION_FORCE_WITH_SPEED | Increases suspension spring force as the vehicle goes faster. Also known as "bouncy suspension". |
0x80000 | CF_BLOCK_INCREASED_ROT_VELOCITY_WITH_DRIVE_FORCE | The vehicle will do another, fake, wheelspin after a real wheelspin - traction will behave as if the wheels are still spinning. |
0x100000 | CF_REDUCED_SELF_RIGHTING_SPEED | Reduces righting force of the vehicle, effectively making it much harder and slower to flip back on its wheels. |
0x200000 | CF_CLOSE_RATIO_GEARBOX | Extends the duration of the first gear, causing the vehicle to launch slower and with reduced wheelspin. |
0x400000 | CF_FORCE_SMOOTH_RPM | Smoother revs when in first gear. |
0x800000 | CF_ALLOW_TURN_ON_SPOT | Allows the vehicle to be rotated left or right while parked on the spot, also known as neutral steering. Intended for tanks/tracked vehicles. |
0x1000000 | CF_CAN_WHEELIE | Allows the vehicle to perform a handbrake wheelie. Muscle vehicle class is hardcoded to use this flag. |
0x2000000 | CF_ENABLE_WHEEL_BLOCKER_SIDE_IMPACTS | Makes the wheels much less likely to clip into the ground when the vehicle is tipped over. |
0x4000000 | CF_FIX_OLD_BUGS | Has multiple uses, intended to fix various handling bugs. Currently-known effects are: — Limits the effects of the HF_TYRES_CAN_CLIP flag by forcing stock tire clipping boundaries on all wheels.— Prevents lowering the vehicle by shooting at its wheels/suspension. This flag is also required in addition to CF_ALLOW_REDUCED_SUSPENSION_FORCE to stance the vehicle through script.
|
0x8000000 | CF_USE_DOWNFORCE_BIAS | 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 | CF_REDUCE_BODY_ROLL_WITH_SUSPENSION_MODS | Each suspension upgrade reduces body roll and increases grip. |
0x20000000 | CF_ALLOWS_EXTENDED_MODS | Enables the use of AdvancedData to add new "Hao's Special Works" performance mods affecting engine power and adding turbo stages. |
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 three different vehicle mechanics, the wheelies, downforce and HSW performance upgrades, 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 downforce bias 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.
— If the allows extended mods advanced flag is enabled, the AdvancedData will allow defined modparts to control the power of the HSW Performance Upgrade and the HSW Turbos.
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 | CF_CAN_WHEELIE | Adjusts the force of the handbrake wheelie. |
0 | CF_USE_DOWNFORCE_BIAS | Affects downforce. |
1 | ||
20 | CF_ALLOWS_EXTENDED_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 from vertical when cornering.
fFullAnimAngle
Max angle of player body lean from vertical when cornering.
fDesLeanReturnFrac
How quickly the character/bike returns from a lean when changing direction. Higher values = slower.
fStickLeanMult
Magnifies the lean response to joystick input. Negative values invert the lean direction. Recommend keeping this at zero.
fBrakingStabilityMult
Causes the bike's rear end to swing around when braking and turning at the same time. Lower and negative values prevent this behavior, higher values allow it.
fInAirSteerMult
Strength of in-air steering. Value of zero also disables self-leveling.
fWheelieBalancePoint
fStoppieBalancePoint
fWheelieSteerMult
fRearBalanceMult
fFrontBalanceMult
fBikeGroundSideFrictionMult
Prevents abrupt changes in pitch of the bike; for example when hitting a steep ramp at speed, causes bike to stay unusually level. Seems to be done to make "Derailed" mission possible, driving across gaps in train cars.
fBikeWheelGroundSideFrictionMult
Prevents abrupt changes in pitch of the wheel?
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.
fInitialThrust
Added in b1180.
fInitialThrustFallOff
Added in b1180.
fYawMult
Yaw input strength.
fYawStabilise
Yaw resistance, scales up with speed.
fSideSlipMult
Sideways resistance, scales up with speed.
fInitialYawMult
Added in b1180.
fRollMult
Roll input strength, scales up with speed.
fRollStabilise
Roll resistance, scales up with speed.
fInitialRollMult
Added in b1180.
fPitchMult
Pitch input strength, scales up with speed.
fPitchStabilise
Pitch resistance, scales up with speed.
fInitialPitchMult
Added in b1180.
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
fAfterburnerEffectRadius
fAfterburnerEffectDistance
fAfterburnerEffectForceMulti
fSubmergeLevelToPullHeliUnderwater
fExtraLiftWithRoll
Added in b1180.
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.
WeaponVehicleModType
fTurretSpeed
fTurretPitchMin
fTurretPitchMax
fTurretCamPitchMin
fTurretCamPitchMax
fBulletVelocityForGravity
fTurretPitchForwardMin
TurretPitchLimitData
fUvAnimationMult
fMiscGadgetVar
fWheelImpactOffset
CSubmarineHandlingData
vTurnRes
fMoveResXY
fMoveResZ
fPitchMult
fPitchAngle
fYawMult
fDiveSpeed
fRollMult
fRollStab
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
Default value is 3.0
fMaxTorqueVelocity
Not adjusted by any vehicle.
Default value is 100.0
fMinTorqueVelocity
Not adjusted by any vehicle.
Default value is 40000.0
fYawTorqueScale
Left-right rotation when in hover mode.
Default is -900.0, but a value of -5.0 or so is more reasonable.
fSelfLevelingPitchTorqueScale
Not adjusted by any vehicle.
Default value is -5.0
fInitalOverheadAssist
Not adjusted by any vehicle.
Default value is -5.0
fMaxPitchTorque
fMaxSteeringRollTorque
Default value is 250.0
fPitchTorqueScale
Up-down rotation when in hover mode.
Default value is 400.0, but a value of 8.0 or so is more reasonable.
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 SF_STEER_TOWARDS_VELOCITY 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 Mode) Flags | ||
---|---|---|
HEX | Name | Description |
0x1 | SF_WORKS_UPSIDE_DOWN | 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 | SF_DONT_RETRACT_WHEELS | Does nothing. |
0x4 | SF_REDUCE_DRAG_WITH_SPEED | Reduces the rate at which the vehicle gains altitude while giving it additional hovering velocity. |
0x8 | SF_MAINTAIN_HOVER_HEIGHT | 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 | SF_STEER_TOWARDS_VELOCITY | 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 | SF_FORCE_MIN_THROTTLE_WHEN_TURNING | Adjusts the throttle when turning. Used by Oppressor Mk II. |
0x40 | SF_LIMIT_FORCE_DELTA | Slightly adjusts the maximum pitch angle of the vehicle. |
0x80 | SF_FORCE_SPECIAL_FLIGHT_WHEN_DRIVEN | Permanently places the vehicle in hover mode. Hover mode cannot be switched off by any means. |
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) |