Difference between revisions of "Handling.meta"

From GTAMods Wiki
Jump to navigation Jump to search
(strAdvancedFlags)
(CCarHandlingData)
 
(15 intermediate revisions by 3 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 14 characters. By default, the handlingName consists of uppercase letters and numbers (TURISMO, E109, etc.)
+
:'''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 47: Line 47:
 
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 z values or else they will rotate too slowly.
+
'''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 488: Line 490:
 
|0x1000000
 
|0x1000000
 
|HF_ENABLE_LEAN
 
|HF_ENABLE_LEAN
|
+
|Prevents rolling in mid air. Used for ATVs.
 
|-
 
|-
 
|0x2000000
 
|0x2000000
Line 568: 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
 
:'''Default value:''' 0.0
 
:'''Minimum value:''' ???
 
:'''Minimum value:''' ???
Line 578: Line 586:
  
 
=== 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
 
:'''Default value:''' 0.0
 
:'''Minimum value:''' ???
 
:'''Minimum value:''' ???
Line 585: Line 593:
  
 
=== fCamberFront ===
 
=== 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 <code>FLAG_INCREASE_CAMBER_WITH_SUSPENSION_MOD</code> [[Vehicles.meta#flags|vehicle flag]] is present.
+
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
 
:'''Default value:''' 0.0
 
:'''Minimum value:''' ???
 
:'''Minimum value:''' ???
Line 592: Line 600:
  
 
=== fCamberRear ===
 
=== 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 <code>FLAG_INCREASE_CAMBER_WITH_SUSPENSION_MOD</code> vehicle flag is present.
+
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
 
:'''Default value:''' 0.0
 
:'''Minimum value:''' ???
 
:'''Minimum value:''' ???
Line 599: Line 607:
  
 
=== fCastor ===
 
=== fCastor ===
Adjusts the caster angle of the vehicle.
+
Adjusts the caster angle of the vehicle. Each 0.01 increment represents a 1-degree change in caster/castor angle.
 
:'''Default value:''' 0.0
 
:'''Default value:''' 0.0
 
:'''Minimum value:''' ???
 
:'''Minimum value:''' ???
Line 756: Line 764:
 
|0x10000000
 
|0x10000000
 
|CF_REDUCE_BODY_ROLL_WITH_SUSPENSION_MODS
 
|CF_REDUCE_BODY_ROLL_WITH_SUSPENSION_MODS
|Each suspension upgrade reduces body roll, allowing the vehicle to corner better.
+
|Each suspension upgrade reduces body roll and increases grip.
 
|-
 
|-
 
|0x20000000
 
|0x20000000
Line 922: Line 930:
 
=== fDesLeanReturnFrac ===
 
=== fDesLeanReturnFrac ===
  
How quickly the player's body returns from leaning? Higher values = slower
+
How quickly the character/bike returns from a lean when changing direction. Higher values = slower.
  
 
=== fStickLeanMult ===
 
=== fStickLeanMult ===
  
How much the player's body leans?
+
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 939: 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 1,302: Line 1,319:
 
Default value is 1.0
 
Default value is 1.0
 
=== fStabilityAssist ===
 
=== 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.<br><br>Default value is 10.0
+
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,324: Line 1,342:
 
|0x2
 
|0x2
 
|SF_DONT_RETRACT_WHEELS
 
|SF_DONT_RETRACT_WHEELS
|Unknown.
+
|Does nothing.
 
|-
 
|-
 
|0x4
 
|0x4
Line 1,340: Line 1,358:
 
|0x20
 
|0x20
 
|SF_FORCE_MIN_THROTTLE_WHEN_TURNING
 
|SF_FORCE_MIN_THROTTLE_WHEN_TURNING
|Unknown. Used by Oppressor Mk II.
+
|Adjusts the throttle when turning. Used by Oppressor Mk II.
 
|-
 
|-
 
|0x40
 
|0x40
Line 1,348: Line 1,366:
 
|0x80
 
|0x80
 
|SF_FORCE_SPECIAL_FLIGHT_WHEN_DRIVEN
 
|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 22:54, 19 October 2024

Contents

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_MODvehicle 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 when cornering.

fFullAnimAngle

Max angle of player body lean 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