Difference between revisions of "Handling.cfg"

From GTAMods Wiki
Jump to navigation Jump to search
m (See also)
(Standard Data)
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{lowercase}}
 
{{lowercase}}
The '''<code>handling.cfg</code>''' file is a text data [[:Category:File Formats|file format]] which sets many performance and behaviour values for each vehicle in GTA III, GTA VC and GTA SA. The file can be opened and edited with any text editor.
+
The '''<code>handling.cfg</code>''' file stores handling [[CFG|configuration]] data and settings for vehicles in [[GTA III]], [[Vice City]], and [[San Andreas]].
  
==GTA III==
+
==GTA III and Vice City==
 +
 
 +
===Format and syntax description===
 +
The file is in plain text format so it can be opened with any text editor (like [[wikipedia:Microsoft Notepad|Notepad]]). Line comments are indicated by the character <code>;</code> (semicolon) and empty lines are allowed. They can be placed anywhere in the file. Each entry takes up one line and follows a specific format detailed below. Data in each entry are separated by <code> </code>&nbsp;(space) and <code> </code>&nbsp;(horizontal tab). The file must contain the line <code>;the end\n</code> (<code>;the end</code> with at least an empty line after it) in order for the game to stop reading the file. The length of each line is limited to 200 characters and the size of the file is limited to 55000 bytes but the games do not perform any checks on the limits so going past them can cause instabilities or crashes.
  
 
===Standard Data===
 
===Standard Data===
This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles. The special behaviour of boats, bikes and flying vehicles are [[hardcoded]] in GTA III and are not included in the <code>handling.cfg</code> file.
+
This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles. In GTA III the special behaviour of boats, bikes and flying vehicles are [[hardcoded]] and are not included in the <code>handling.cfg</code> file. Vice City included many of those handling data into the file.
  
The below table provides the column letter, column name and a brief description for each setting available in this section.
+
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
 
+
!style="width: 2em;" |{{Icon|3}}
{| {{Prettytable}}
+
!style="width: 2em;" |{{Icon|VC}}
! Column Letter
+
!style="width: 12em;" |Identifier
! Column Name
+
!style="width: 6em;" |Type
! Description
+
!Description
 +
|-
 +
|colspan="2" |A
 +
|vehicle identifier
 +
|string
 +
|The identifier must be from the list of [[hardcoded]] names ([[#List of vehicle identifiers|see below]]).
 
|-
 
|-
| a
+
|colspan="2" |B
| vehicle identifier
+
|fMass
| Relates this data with <code>[[default.ide]]</code> and other files.
+
|float
 +
|Mass of the vehicle in kilograms.
 
|-
 
|-
| b
+
|colspan="2" |C
| fMass
+
|Dimensions.x
| Mass of the vehicle in kilograms.
+
|float
 +
|Width of the vehicle in metres, used for aerodynamic and motion effects.
 
|-
 
|-
| c
+
|colspan="2" |D
| Dimensions.x
+
|Dimensions.y
| Width of the vehicle in metres, used for aerodynamic and motion effects.
+
|float
 +
|Length of the vehicle in metres, used for aerodynamic and motion effects.
 
|-
 
|-
| d
+
|colspan="2" |E
| Dimensions.y
+
|Dimensions.z
| Length of the vehicle in metres, used for aerodynamic and motion effects.
+
|float
 +
|Height of the vehicle in metres, used for aerodynamic and motion effects.
 
|-
 
|-
| e
+
|colspan="2" |F
| Dimensions.z
+
|CentreOfMass.x
| Height of the vehicle in metres, used for aerodynamic and motion effects.
+
|float
 +
|Distance from the centre of the car in metres to the right for the centre of mass.
 
|-
 
|-
| f
+
|colspan="2" |G
| CentreOfMass.x
+
|CentreOfMass.y
| Distance from the centre of the car in metres to the right for the centre of mass.
+
|float
 +
|Distance from the centre of the car in metres forward for the centre of mass.
 
|-
 
|-
| g
+
|colspan="2" |H
| CentreOfMass.y
+
|CentreOfMass.z
| Distance from the centre of the car in metres forward for the centre of mass.
+
|float
 +
|Distance from the centre of the car in metres upward for the centre of mass.
 
|-
 
|-
| h
+
|colspan="2" |I
| CentreOfMass.z
+
|nPercentSubmerged
| Distance from the centre of the car in metres upward for the centre of mass.
+
|integer
 +
|Percentage of the vehicle height required to be submerged for the car to float.
 
|-
 
|-
| i
+
|colspan="2" |J
| nPercentSubmerged
+
|fTractionMultiplier
| Percentage of the vehicle height required to be submerged for the car to float.
+
|float
 +
|Grip of the vehicle as a multiplier of the tyre surface friction. Effectively the peak grip status before any loss of grip.
 
|-
 
|-
| j
+
|colspan="2" |K
| fTractionMultiplier
+
|fTractionLoss
| Cornering grip of the vehicle as a multiplier of the tyre surface friction.
+
|float
 +
|Effectively the minimum grip status after losing traction, e.g. in a skidding situation. Higher values make the car more controllable after losing traction.
 
|-
 
|-
| k
+
|colspan="2" |L
| fTractionLoss
+
|fTractionBias
| Accelerating/braking grip of the vehicle as a multiplier of the tyre surface friction.
+
|float
 +
|Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
 
|-
 
|-
| l
+
|colspan="2" |M
| fTractionBias
+
|TransmissionData.nNumberOfGears
| Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
+
|integer
 +
|Number of gearchange animations and sound effects to use.
 
|-
 
|-
| m
+
|colspan="2" |N
| TransmissionData.nNumberOfGears
+
|TransmissionData.fMaxVelocity
| Number of gearchange animations and sound effects to use.
+
|float
 +
|Limits the top speed.
 
|-
 
|-
| n
+
|colspan="2" |O
| TransmissionData.fMaxVelocity
+
|TransmissionData.fEngineAcceleration
| Limits the top speed.
+
|float
 +
|Basic rate of acceleration.
 
|-
 
|-
| o
+
|colspan="2" |P
| TransmissionData.fEngineAcceleration
+
|TransmissionData.nDriveType
| Basic rate of acceleration.
+
|character
 +
|Assigns Front, Rear or 4 wheel drive.
 
|-
 
|-
| p
+
|colspan="2" |Q
| TransmissionData.nDriveType
+
|TransmissionData.nEngineType
| Assigns Front, Rear or 4 wheel drive.
+
|character
 +
|Assigns Petrol, Diesel or Electric engine characteristics.
 
|-
 
|-
| q
+
|colspan="2" |R
| TransmissionData.nEngineType
+
|fBrakeDeceleration
| Assigns Petrol, Diesel or Electric engine characteristics.
+
|float
 +
|Overall decelerative force, set so keyboard controls do not quite lock up the wheels.
 
|-
 
|-
| r
+
|colspan="2" |S
| fBrakeDeceleration
+
|fBrakeBias
| Overall decelerative force, set so keyboard controls do not quite lock up the wheels.
+
|float
 +
|Ratio of braking force of front compared to rear; higher values move bias forward.
 
|-
 
|-
| s
+
|colspan="2" |T
| fBrakeBias
+
|bABS
| Ratio of braking force of front compared to rear; higher values move bias forward.
+
|integer
 +
|Seems to have no effect.
 
|-
 
|-
| t
+
|colspan="2" |U
| bABS
+
|fSteeringLock
|  
+
|float
 +
|Maximum rotation of steering arc in degrees; use negatives for rear wheel steered vehicles.
 
|-
 
|-
| u
+
|colspan="2" |V
| fSteeringLock
+
|fSuspensionForceLevel
| Maximum rotation of steering arc in degrees; use negatives for rear wheel steered vehicles.
+
|float
 +
|Explained in my suspension tutorial.
 
|-
 
|-
| v
+
|colspan="2" |W
| fSuspensionForceLevel
+
|fSuspensionDampingLevel
| Explained in my suspension tutorial.
+
|float
 +
|Explained in my suspension tutorial.
 
|-
 
|-
| w
+
|colspan="2" |X
| fSuspensionDampingLevel
+
|fSeatOffsetDistance
| Explained in my suspension tutorial.
+
|float
 +
|Distance from door position to seat position.
 
|-
 
|-
| x
+
|colspan="2" |Y
| fSeatOffsetDistance
+
|fCollisionDamageMultiplier
| Distance from door position to seat position.
+
|float
 +
|How much damage vehicle engine gets from collisions. Higher value means more damage.
 
|-
 
|-
| y
+
|colspan="2" |Z
| fCollisionDamageMultiplier
+
|nMonetaryValue
| How much damage vehicle engine gets from collisions. Higher value means more damage.
+
|integer
 +
|Used to determine monetary award for crusher, collisions, and explosions in GTA III and the Property Destroyed statistic in Vice City.
 
|-
 
|-
| z
+
|colspan="2" |AA
| nMonetaryValue
+
|suspension upper limit
| Seems to have no effect.
+
|float
 +
|Uppermost movement of wheels in metres.
 
|-
 
|-
| aa
+
|colspan="2" |AB
| suspension upper limit
+
|suspension lower limit
| Uppermost movement of wheels in metres.
+
|float
 +
|Ride height of vehicle in metres.
 
|-
 
|-
| ab
+
|colspan="2" |AC
| suspension lower limit
+
|{{a|c}} |suspension bias
| Ride height of vehicle in metres.
+
|float
 +
|Ratio of suspension force to apply at the rear compared to the front.
 
|-
 
|-
| ac
+
| - ||AD
| suspension bias
+
|{{a|c}} |suspension anti-dive multiplier
| Ratio of suspension force to apply at the rear compared to the front.
+
|float
 +
|Changes the amount of body pitching under braking and acceleration.
 
|-
 
|-
| ad
+
|AD ||AE
| Flags Name
+
|{{a|c}} |Flags
| Special features which can be enabled or disabled.
+
|hex
 +
|Special features which can be enabled or disabled ([[#Flags|see below]]).
 
|-
 
|-
| ae
+
|AE ||AF
| front lights
+
|{{a|c}} |front lights
| Defines the size of the head lights of the vehicle. Using numbers out of range has unusual effects.
+
|integer
 +
|Defines the size of the head lights of the vehicle. Using numbers out of range has unusual effects.
 
|-
 
|-
| af
+
|AF ||AG
| rear lights
+
|{{a|c}} |rear lights
| Same as above but for the tail lights.
+
|integer
 +
|Same as above but for the tail lights.
 
|}
 
|}
  
====Flag Data====
+
====List of vehicle identifiers====
Column "ad", called "Flags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters).  The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left. The below table describes what each of the sixteen bits in this setting do:
+
The games contain a [[hardcoded]] list of vehicle identifiers. This is used to assign a vehicle's handling name to a handling index (LANDSTAL is at index 0, IDAHO is at index 1, etc.).
 +
{|
 +
!{{Icon|3}} ||{{Icon|VC}} ||{{Icon|LCS}}
 +
|-
 +
|style="vertical-align: top;" |
 +
*LANDSTAL
 +
*IDAHO
 +
*STINGER
 +
*LINERUN
 +
*PEREN
 +
*SENTINEL
 +
*PATRIOT
 +
*FIRETRUK
 +
*TRASH
 +
*STRETCH
 +
*MANANA
 +
*INFERNUS
 +
*BLISTA
 +
*PONY
 +
*MULE
 +
*CHEETAH
 +
*AMBULAN
 +
*FBICAR
 +
*MOONBEAM
 +
*ESPERANT
 +
*TAXI
 +
*KURUMA
 +
*BOBCAT
 +
*MRWHOOP
 +
*BFINJECT
 +
*POLICE
 +
*ENFORCER
 +
*SECURICA
 +
*BANSHEE
 +
*PREDATOR
 +
*BUS
 +
*RHINO
 +
*BARRACKS
 +
*TRAIN
 +
*HELI
 +
*DODO
 +
*COACH
 +
*CABBIE
 +
*STALLION
 +
*RUMPO
 +
*RCBANDIT
 +
*BELLYUP
 +
*MRWONGS
 +
*MAFIA
 +
*YARDIE
 +
*YAKUZA
 +
*DIABLOS
 +
*COLUMB
 +
*HOODS
 +
*AIRTRAIN
 +
*DEADDODO
 +
*SPEEDER
 +
*REEFER
 +
*PANLANT
 +
*FLATBED
 +
*YANKEE
 +
*BORGNINE
 +
||
 +
*LANDSTAL
 +
*IDAHO
 +
*STINGER
 +
*LINERUN
 +
*PEREN
 +
*SENTINEL
 +
*PATRIOT
 +
*FIRETRUK
 +
*TRASH
 +
*STRETCH
 +
*MANANA
 +
*INFERNUS
 +
*PONY
 +
*MULE
 +
*CHEETAH
 +
*AMBULAN
 +
*FBICAR
 +
*MOONBEAM
 +
*ESPERANT
 +
*TAXI
 +
*KURUMA
 +
*BOBCAT
 +
*MRWHOOP
 +
*BFINJECT
 +
*POLICE
 +
*ENFORCER
 +
*SECURICA
 +
*BANSHEE
 +
*BUS
 +
*RHINO
 +
*BARRACKS
 +
*TRAIN
 +
*HELI
 +
*DODO
 +
*COACH
 +
*CABBIE
 +
*STALLION
 +
*RUMPO
 +
*RCBANDIT
 +
*MAFIA
 +
*AIRTRAIN
 +
*DEADDODO
 +
*FLATBED
 +
*YANKEE
 +
*GOLFCART
 +
*VOODOO
 +
*WASHING
 +
*CUBAN
 +
*ROMERO
 +
*PACKER
 +
*ADMIRAL
 +
*GANGBUR
 +
*ZEBRA
 +
*TOPFUN
 +
*GLENDALE
 +
*OCEANIC
 +
*HERMES
 +
*SABRE1
 +
*SABRETUR
 +
*PHEONIX
 +
*WALTON
 +
*REGINA
 +
*COMET
 +
*DELUXO
 +
*BURRITO
 +
*SPAND
 +
*BAGGAGE
 +
*KAUFMAN
 +
*RANCHER
 +
*FBIRANCH
 +
*VIRGO
 +
*GREENWOO
 +
*HOTRING
 +
*SANDKING
 +
*BLISTAC
 +
*BOXVILLE
 +
*BENSON
 +
*DESPERAD
 +
*LOVEFIST
 +
*BLOODRA
 +
*BLOODRB
 +
*BIKE
 +
*MOPED
 +
*DIRTBIKE
 +
*ANGEL
 +
*FREEWAY
 +
*PREDATOR
 +
*SPEEDER
 +
*REEFER
 +
*RIO
 +
*SQUALO
 +
*TROPIC
 +
*COASTGRD
 +
*DINGHY
 +
*MARQUIS
 +
*CUPBOAT
 +
*SEAPLANE
 +
*SPARROW
 +
*SEASPAR
 +
*MAVERICK
 +
*COASTMAV
 +
*POLMAV
 +
*HUNTER
 +
*RCBARON
 +
*RCGOBLIN
 +
*RCCOPTER
 +
|style="vertical-align: top;" |
 +
*LANDSTAL
 +
*IDAHO
 +
*STINGER
 +
*LINERUN
 +
*PEREN
 +
*SENTINEL
 +
*PATRIOT
 +
*FIRETRUK
 +
*TRASH
 +
*STRETCH
 +
*MANANA
 +
*INFERNUS
 +
*PONY
 +
*MULE
 +
*CHEETAH
 +
*AMBULAN
 +
*FBICAR
 +
*MOONBEAM
 +
*ESPERANT
 +
*TAXI
 +
*KURUMA
 +
*BOBCAT
 +
*MRWHOOP
 +
*BFINJECT
 +
*POLICE
 +
*ENFORCER
 +
*SECURICA
 +
*BANSHEE
 +
*BUS
 +
*RHINO
 +
*BARRACKS
 +
*TRAIN
 +
*FERRY
 +
*HELI
 +
*DODO
 +
*COACH
 +
*CABBIE
 +
*STALLION
 +
*RUMPO
 +
*RCBANDIT
 +
*MAFIA
 +
*AIRTRAIN
 +
*DEADDODO
 +
*FLATBED
 +
*YANKEE
 +
*BLISTA
 +
*BELLYUP
 +
*MRWONGS
 +
*YARDIE
 +
*YAKUZA
 +
*DIABLOS
 +
*COLUMB
 +
*HOODS
 +
*PANLANT
 +
*BORGNINE
 +
*CAMPVAN
 +
*BALLOT
 +
*SPIDER
 +
*SHELBY
 +
*PONTIAC
 +
*ESPRIT
 +
*MINI
 +
*HOTROD
 +
*SINDACCO
 +
*FORELLI
 +
*BIKE
 +
*MOPED
 +
*DIRTBIKE
 +
*ANGEL
 +
*DIRTBIK2
 +
*ANGE2
 +
*FREEWAY
 +
*PREDATOR
 +
*SPEEDER
 +
*REEFER
 +
*MAVERICK
 +
*COASTMAV
 +
*POLMAV
 +
*HUNTER
 +
*RCGOBLIN
 +
*RCCOPTER
 +
|}
  
{| {{Prettytable}}
+
====Flags====
! Byte
+
The flag is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters). The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left. The below table describes what each of the sixteen bits in this setting do:
! Value
+
{|class="wikitable"
! Column Name
+
!Game
! Description
+
!Byte
 +
!Value
 +
!Column Name
 +
!Description
 
|-
 
|-
| 1
+
|rowspan="16" |{{Icon|3}} {{Icon|VC}}
| 1
+
|rowspan="4" |1
| 1G_BOOST
+
|1
| Makes tyres spin more readily from standing starts.
+
|1G_BOOST
 +
|Makes tyres spin more readily from standing starts.
 
|-
 
|-
|
+
|2
| 2
+
|2G_BOOST
| 2G_BOOST
+
|Makes tyres spin more readily at low speeds.
| Makes tyres spin more readily at low speeds.
 
 
|-
 
|-
|
+
|4
| 4
+
|REV_BONNET
| REV_BONNET
+
|Reverses the direction boot and bonnet axis operate.
| Reverses the direction boot and bonnet axis operate.
 
 
|-
 
|-
|
+
|8
| 8
+
|HANGING_BOOT
| HANGING_BOOT
+
|Affects physics of boot hinged from the top.
| Manipulates operation of boot object.
 
 
|-
 
|-
| 2
+
|rowspan="4" |2
| 1
+
|1
| NO_DOORS
+
|NO_DOORS
| Removes all testing for doors; used with BF Injection.
+
|Removes all testing for doors.
 
|-
 
|-
|
+
|2
| 2
+
|IS_VAN
| IS_VAN
+
|Allows double boot object.
| Allows double boot object.
 
 
|-
 
|-
|
+
|4
| 4
+
|IS_BUS
| IS_BUS
+
|Uses Coach version of animations over standard one and makes the driver invisible (only makes sense to use on Coach).
| Unsure of precise application.
 
 
|-
 
|-
|
+
|8
| 8
+
|IS_LOW
| IS_LOW
+
|Uses low version of animations over standard one.
| Makes driver recline into seat.
 
 
|-
 
|-
| 3
+
|rowspan="4" |3
| 1
+
|1
| DBL_EXHAUST
+
|DBL_EXHAUST
| Allows second exhaust particle animation.
+
|Creates a second exhaust by mirroring the model's exhaust over the y-axis.
 
|-
 
|-
|
+
|2
| 2
+
|TAILGATE_BOOT
| TAILGATE_BOOT
+
|Affects physics of boot hinged from the bottom.
| Manipulates operation of boot object.
 
 
|-
 
|-
|
+
|4
| 4
+
|NOSWING_BOOT
| NOSWING_BOOT
+
|When damaged, boot does not swing if it normally does and falls off instead.
| Manipulates operation of boot object.
 
 
|-
 
|-
|
+
|8
| 8
+
|NONPLAYER_STABILISER
| NONPLAYER_STABILISER
+
|Seems to have no effect, could be related to how the AI operates the vehicle
| Seems to have no effect.
 
 
|-
 
|-
| 4
+
|rowspan="4" |4
| 1
+
|1
| NEUTRALHANDLING
+
|NEUTRALHANDLING
| Seems to have no effect.
+
|Seems to have no effect, could be related to how the AI operates the vehicle
 
|-
 
|-
|
+
|2
| 2
+
|HAS_NO_ROOF
| HAS_NO_ROOF
+
|Various slight effects.
| Various slight effects.
 
 
|-
 
|-
|
+
|4
| 4
+
|IS_BIG
| IS_BIG
+
|Changes the way that the AI drives around corners.
| Changes the way that the AI drives around corners.
 
 
|-
 
|-
|
+
|8
| 8
+
|HALOGEN_LIGHTS
| HALOGEN_LIGHTS
+
|Bluish headlights.
| Slightly manipulates appearence of vehicle lights.
 
|}
 
 
 
==GTA Vice City==
 
 
 
===Standard Data===
 
This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles.  The below table provides the column letter, column name and a brief description for each setting available in this section.
 
 
 
{| {{Prettytable}}
 
! Column Letter
 
! Column Name
 
! Description
 
 
|-
 
|-
| a
+
|rowspan="12" |{{Icon|VC}}
| vehicle identifier
+
|rowspan="4" |5
| Relates this data with <code>[[default.ide]]</code> and other files.
+
|1
 +
|IS_BIKE
 +
|Makes the game engine treat this vehicle as a motorbike when used with <code>[[default.ide]]</code> attributes.
 
|-
 
|-
| b
+
|2
| fMass
+
|IS_HELI
| Mass of the vehicle in kilograms.
+
|Makes the game engine treat this vehicle as a helicopter when used with <code>default.ide</code> attributes.
 
|-
 
|-
| c
+
|4
| Dimensions.x
+
|IS_PLANE
| Width of the vehicle in metres, used for aerodynamic and motion effects.
+
|Makes the game engine treat this vehicle as a plane when used with <code>default.ide</code> attributes.
 
|-
 
|-
| d
+
|8
| Dimensions.y
+
|IS_BOAT
| Length of the vehicle in metres, used for aerodynamic and motion effects.
+
|Makes the game engine treat this vehicle as a boat when used with <code>default.ide</code> attributes.
 
|-
 
|-
| e
+
|rowspan="4" |6
| Dimensions.z
+
|1
| Height of the vehicle in metres, used for aerodynamic and motion effects.
+
|NO_EXHAUST
 +
|Removes the exhaust animation particle for this vehicle.
 
|-
 
|-
| f
+
|2
| CentreOfMass.x
+
|REARWHEEL_1ST
| Distance from the centre of the car in metres to the right for the centre of mass.
+
|Seems to have no effect.
 
|-
 
|-
| g
+
|4
| CentreOfMass.y
+
|HANDBRAKE_TYRE
| Distance from the centre of the car in metres forward for the centre of mass.
+
|Seems to have no effect.
 
|-
 
|-
| h
+
|8
| CentreOfMass.z
+
|SIT_IN_BOAT
| Distance from the centre of the car in metres upward for the centre of mass.
+
|Makes the player sit in this boat.
 
|-
 
|-
| i
+
|rowspan="4" |7
| nPercentSubmerged
+
|1
| Percentage of the vehicle height required to be submerged for the car to float.
+
|FAT_REARW
 +
|Wider rear wheels.
 
|-
 
|-
| j
+
|2
| fTractionMultiplier
+
|NARROW_FRONTW
| Cornering grip of the vehicle as a multiplier of the tyre surface friction.
+
|Narrower front wheels.
 
|-
 
|-
| k
+
|4
| fTractionLoss
+
|GOOD_INSAND
| Accelerating/braking grip of the vehicle as a multiplier of the tyre surface friction.
+
|Prevents vehicle from bogging down on sand surface.
 
|-
 
|-
| l
+
|8
| fTractionBias
+
|
| Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
+
|Is not mentioned in the <code>handling.cfg</code> comments. Causes the vehicle to not render while looking behind in first person view.
 +
|}
 +
 
 +
<gallery>
 +
Dbl exhaust.jpg|A Sentinel with double exhausts (DBL_<wbr>EXHAUST).
 +
Halogen lights.jpg|An Idaho with normal headlights on the left compared with a Stinger with halogen lights (HALOGEN_<wbr>LIGHTS) on the right.
 +
Fat rearw.jpg|A Linerunner with normal wheels on the left compared with a Linerunner with fat rear wheels (FAT_<wbr>REARW) on the right.
 +
Narrow frontw.jpg|A Linerunner with normal wheels on the left compared with a Linerunner with narrow front wheels (NARROW_<wbr>FRONTW) on the right.
 +
</gallery>
 +
 
 +
===Vice City-specific===
 +
The following sections contain information specific to Vice City.
 +
====Boat Data====
 +
Some of the Standard Data settings have a different effect for floating vehicles than they would for land vehicles.
 +
 
 +
{|class="wikitable"
 +
!Column Letter
 +
!Column Name
 +
!Description
 
|-
 
|-
| m
+
|J
| TransmissionData.nNumberOfGears
+
|Bank Force Mult
| Number of gearchange animations and sound effects to use.
+
|Amount of lean when turning.
 
|-
 
|-
| n
+
|K
| TransmissionData.fMaxVelocity
+
|Rudder Turn Force
| Limits the top speed.
+
|Effect of the steering.
 
|-
 
|-
| o
+
|L
| TransmissionData.fEngineAcceleration
+
|Speed Steer Falloff
| Basic rate of acceleration.
+
|Amount to reduce steering effect by as speed increases.
 
|-
 
|-
| p
+
|R
| TransmissionData.nDriveType
+
|Vertical Wave Hit Limit
| Assigns Front, Rear or 4 wheel drive.
+
|
 
|-
 
|-
| q
+
|S
| TransmissionData.nEngineType
+
|Forward Wave Hit Brake
| Assigns Petrol, Diesel or Electric engine characteristics.
+
|
 
|-
 
|-
| r
+
|V
| fBrakeDeceleration
+
|WaterResistance Volume Mult
| Overall decelerative force, set so keyboard controls do not quite lock up the wheels.
+
|
 
|-
 
|-
| s
+
|W
| fBrakeBias
+
|Water Damping Mult
| Ratio of braking force of front compared to rear; higher values move bias forward.
+
|
 
|-
 
|-
| t
+
|ab
| bABS
+
|Handbrake Drag Mult
| Seems to have no effect.
+
|
 
|-
 
|-
| u
+
|ac
| fSteeringLock
+
|Sideslip Force
| Maximum rotation of steering arc in degrees; use negatives for rear wheel steered vehicles.
+
|Strength that the boat will be pushed sideways by waves.
 +
|}
 +
 
 +
Data specific to boats have lines that begin with <code>%</code> (percentage sign) character.
 +
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
 +
!style="width: 3em;" |%
 +
!style="width: 12em;" |Identifier
 +
!style="width: 6em;" |Type
 +
!Description
 +
|-
 +
|A ||ID ||string ||The identifier must be from the list of [[hardcoded]] names ([[#List of vehicle identifiers|see above]]).
 +
|-
 +
|B ||ThrustY ||float ||
 +
|-
 +
|C ||ThrustZ ||float ||
 
|-
 
|-
| v
+
|D ||ThrustAppZ ||float ||
| fSuspensionForceLevel
 
| Explained in my suspension tutorial.
 
 
|-
 
|-
| w
+
|E ||AqPlaneForce ||float ||
| fSuspensionDampingLevel
 
| Explained in my suspension tutorial.
 
 
|-
 
|-
| x
+
|F ||AqPlaneLimit ||float ||
| fSeatOffsetDistance
 
| Distance from door position to seat position.
 
 
|-
 
|-
| y
+
|G ||AqPlaneOffset ||float ||
| fCollisionDamageMultiplier
 
| How much damage vehicle engine gets from collisions. Higher value means more damage.
 
 
|-
 
|-
| z
+
|H ||WaveAudioMult ||float ||
| nMonetaryValue
 
| Used to calculate the Property Destroyed statistic.
 
 
|-
 
|-
| aa
+
|I ||MoveResX ||float ||
| suspension upper limit
 
| Uppermost movement of wheels in metres.
 
 
|-
 
|-
| ab
+
|J ||MoveResY ||float ||
| suspension lower limit
 
| Ride height of vehicle in metres.
 
 
|-
 
|-
| ac
+
|K ||MoveResZ ||float ||
| suspension bias
 
| Ratio of suspension force to apply at the rear compared to the front.
 
 
|-
 
|-
| ad
+
|L ||TurnResX ||float ||
| suspension anti-dive multiplier
 
| Changes the amount of body pitching under braking and acceleration.
 
 
|-
 
|-
| ad
+
|M ||TurnResY ||float ||
| Flags
 
| Special features which can be enabled or disabled.
 
 
|-
 
|-
| ae
+
|N ||TurnResZ ||float ||
| front lights
 
| Defines the size of the head lights of the vehicle. Using numbers out of range has unusual effects.
 
 
|-
 
|-
| af
+
|O ||Look_L_R_BehindCamHeight ||float ||
| rear lights
 
| Same as above but for the tail lights.
 
 
|}
 
|}
  
====Flag Data====
+
====Bike Data====
Column "ae", called "Flags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters). The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left.  The below table describes what each of the sixteen bits in this setting do:
+
Data specific to bikes have lines that begin with <code>!</code> (exclamation mark) character.
  
{| {{Prettytable}}
+
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
! Byte
+
!style="width: 3em;" |!
! Value
+
!style="width: 12em;" |Identifier
! Column Name
+
!style="width: 6em;" |Type
! Description
+
!Description
 
|-
 
|-
| 1
+
|A ||ID ||string ||The identifier must be from the list of [[hardcoded]] names ([[#List of vehicle identifiers|see above]]).
| 1
 
| 1G_BOOST
 
| Makes tyres spin more readily from standing starts.
 
 
|-
 
|-
|  
+
|B ||LeanFwdCOM ||float ||
| 2
 
| 2G_BOOST
 
| Makes tyres spin more readily at low speeds.
 
 
|-
 
|-
|  
+
|C ||LeanFwdForce ||float ||
| 4
 
| REV_BONNET
 
| Reverses the direction boot and bonnet axis operate.
 
 
|-
 
|-
|  
+
|D ||LeanBakCOM ||float ||
| 8
 
| HANGING_BOOT
 
| Manipulates operation of boot object.
 
 
|-
 
|-
| 2
+
|E ||LeanBackForce ||float ||
| 1
 
| NO_DOORS
 
| Removes all testing for doors; used with BF Injection.
 
 
|-
 
|-
|  
+
|F ||MaxLean ||float ||
| 2
 
| IS_VAN
 
| Allows double boot object.
 
 
|-
 
|-
|  
+
|G ||FullAnimLean ||float ||
| 4
 
| IS_BUS
 
| Unsure of precise application, possibly used in conjunction with special bus animation that instructs that no actor model is displayed for actor inside bus.
 
 
|-
 
|-
|  
+
|H ||DesLean ||float ||
| 8
 
| IS_LOW
 
| Makes driver recline into seat.
 
 
|-
 
|-
| 3
+
|I ||SpeedSteer ||float ||
| 1
 
| DBL_EXHAUST
 
| Allows second exhaust particle animation.
 
 
|-
 
|-
|  
+
|J ||SlipSteer ||float ||
| 2
 
| TAILGATE_BOOT
 
| Manipulates operation of boot object.
 
 
|-
 
|-
|  
+
|K ||NoPlayerCOMz ||float ||
| 4
 
| NOSWING_BOOT
 
| Manipulates operation of boot object.
 
 
|-
 
|-
|  
+
|L ||WheelieAng ||float ||
| 8
 
| NONPLAYER_STABILISER
 
| Seems to have no effect, could be related to how the AI operates the vehicle
 
 
|-
 
|-
| 4
+
|M ||StoppieAng ||float ||
| 1
 
| NEUTRALHANDLING
 
| Seems to have no effect, could be related to how the AI operates the vehicle
 
 
|-
 
|-
|  
+
|N ||WheelieSteer ||float ||
| 2
 
| HAS_NO_ROOF
 
| Various slight effects.
 
 
|-
 
|-
|  
+
|O ||WheelieStabMult ||float ||
| 4
 
| IS_BIG
 
| Changes the way that the AI drives around corners.
 
 
|-
 
|-
|  
+
|P ||StoppieStabMult ||float ||
| 8
+
|}
| HALOGEN_LIGHTS
+
 
| Slightly manipulates appearence of vehicle lights.
+
====Flying Data====
|-
+
Data specific to flying vehicles have lines that begin with <code>$</code> (dollar sign) character.
| 5
+
 
| 1
+
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
| IS_BIKE
+
!style="width: 3em;" |$
| Makes the game engine treat this vehicle as a motorbike when used with <code>[[default.ide]]</code> attributes.
+
!style="width: 12em;" |Identifier
|-
+
!style="width: 6em;" |Type
|  
+
!Description
| 2
 
| IS_HELI
 
| Makes the game engine treat this vehicle as a helicopter when used with <code>default.ide</code> attributes.
 
 
|-
 
|-
|  
+
|A ||ID ||string ||The identifier must be from the list of [[hardcoded]] names ([[#List of vehicle identifiers|see above]]).
| 4
 
| IS_PLANE
 
| Makes the game engine treat this vehicle as a plane when used with <code>default.ide</code> attributes.
 
 
|-
 
|-
|  
+
|B ||Thrust ||float || Engine power. This affects yaw, pitch and roll in that those values could be equal, but the vehicle with greater thrust will have more pronounced yaw, pitch and roll.
| 8
 
| IS_BOAT
 
| Makes the game engine treat this vehicle as a boat when used with <code>default.ide</code> attributes.
 
 
|-
 
|-
| 6
+
|C ||ThrustFallOff ||float ||
| 1
 
| NO_EXHAUST
 
| Removes the exhaust animation particle for this vehicle.
 
 
|-
 
|-
|  
+
|D ||Yaw ||float ||
| 2
 
| REARWHEEL_1ST
 
| Seems to have no effect.
 
 
|-
 
|-
|  
+
|E ||YawStab ||float ||
| 4
 
| HANDBRAKE_TYRE
 
| Seems to have no effect.
 
 
|-
 
|-
|  
+
|F ||SideSlip ||float ||
| 8
 
| SIT_IN_BOAT
 
| Makes the player sit in this boat.
 
 
|-
 
|-
| 7
+
|G ||Roll ||float ||
| 1
 
| FAT_REARW
 
| Doubles the width of the rear wheels.
 
 
|-
 
|-
|  
+
|H ||RollStab ||float ||
| 2
 
| NARROW_FRONTW
 
| Halves the width of the front wheels.
 
 
|-
 
|-
|  
+
|I ||Pitch ||float ||
| 4
 
| GOOD_INSAND
 
| Prevents vehicle from bogging down on sand surface.
 
 
|-
 
|-
|  
+
|J ||PitchStab ||float ||
| 8
 
| SPECIAL_FLIGHT
 
| Is not mentioned in the <code>handling.cfg</code> comments. This is applied to some flying vehicles.
 
|}
 
 
 
===Boat Data===
 
This section contains all the performance settings from the section for floating vehicles, such as boats and flying vehicles which can land on water.  The below table provides the column letter, column name and a brief description for each setting available in this section.
 
 
 
{| {{Prettytable}}
 
! Column Letter
 
! Column Name
 
! Description
 
 
|-
 
|-
| J
+
|K ||FormLift ||float ||
| Bank Force Mult
 
| Amount of lean when turning.
 
 
|-
 
|-
| K
+
|L ||AttackLift ||float ||
| Rudder Turn Force
 
| Effect of the steering.
 
 
|-
 
|-
| L
+
|M ||MoveRes ||float ||
| Speed Steer Falloff
 
| Amount to reduce steering effect by as speed increases.
 
 
|-
 
|-
| R
+
|N ||TurnRes.x ||float ||
| Vertical Wave Hit Limit
 
|  
 
 
|-
 
|-
| S
+
|O ||TurnRes.y ||float ||
| Forward Wave Hit Brake
 
|  
 
 
|-
 
|-
| V
+
|P ||TurnRes.z ||float || Affects how likely vehicle is to rotate in terms of yaw without using the rudder.
| WaterResistance Volume Mult
 
|  
 
 
|-
 
|-
| W
+
|Q ||SpeedRes.x ||float ||
| Water Damping Mult
 
|  
 
 
|-
 
|-
| ab
+
|R ||SpeedRes.y ||float ||
| Handbrake Drag Mult
 
|  
 
 
|-
 
|-
| ac
+
|S ||SpeedRes.z ||float ||
| Sideslip Force
 
| Strength that the boat will be pushed sideways by waves.
 
 
|}
 
|}
 
====Repurposed Standard Data====
 
Some of the Standard Data settings have a different effect for floating vehicles than they would for land vehicles.
 
 
<table border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse;">
 
<tr>
 
  <th scope="col" abbr="Letter">Column Letter</th>
 
  <th scope="col" abbr="Name">Column Name</th>
 
  <th scope="col">Description</th>
 
</tr>
 
<tr>
 
  <td>-</td>
 
  <td>-</td>
 
  <td>-</td>
 
</tr>
 
</table>
 
{{Incomplete}}
 
 
===Bike Data===
 
This section contains the performance settings from the section for motorbikes.  The below table provides the column letter, column name and a brief description for each setting available in this section.
 
 
<table border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse;">
 
<tr>
 
  <th scope="col" abbr="Letter">Column Letter</th>
 
  <th scope="col" abbr="Name">Column Name</th>
 
  <th scope="col">Description</th>
 
</tr>
 
<tr>
 
  <td>-</td>
 
  <td>-</td>
 
  <td>-</td>
 
</tr>
 
</table>
 
{{Incomplete}}
 
 
===Flying Data===
 
This section contains the performance settings from the section for flying vehicles, such as planes and helicopters.  The below table provides the column letter, column name and a brief description for each setting available in this section.
 
 
<table border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse;">
 
<tr>
 
  <th scope="col" abbr="Letter">Column Letter</th>
 
  <th scope="col" abbr="Name">Column Name</th>
 
  <th scope="col">Description</th>
 
</tr>
 
<tr>
 
  <td>-</td>
 
  <td>-</td>
 
  <td>-</td>
 
</tr>
 
</table>
 
{{Incomplete}}
 
  
 
==GTA San Andreas==
 
==GTA San Andreas==
Line 627: Line 755:
 
This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles. The below table provides the column letter, column name and a brief description for each setting available in this section.
 
This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles. The below table provides the column letter, column name and a brief description for each setting available in this section.
  
{| {{Prettytable}}
+
{|class="wikitable"
! Column Letter
+
!Column Letter
! Column Name
+
!Column Name
! Description
+
!Description
 
|-
 
|-
| A
+
|A
| vehicle identifier
+
|vehicle identifier
| Relates this data with <code>[[vehicle.ide]]</code> and other files.
+
|Relates this data with <code>[[vehicle.ide]]</code> and other files.
 
|-
 
|-
| B
+
|B
| fMass
+
|fMass
| Mass of the vehicle in kilograms.
+
|Mass of the vehicle in kilograms.
 
|-
 
|-
| C
+
|C
| fTurnMass
+
|fTurnMass
| Used to calculate motion effects.
+
|Used to calculate motion effects. Higher values make the vehicle's body rotate slower around every axis (similar to the VecInertiaMultiplier values in GTAV). This also seems to be relative to Mass, meaning that a vehicle with a greater Mass requires an exponentially greater Turn Mass to achieve the same effect.
 
|-
 
|-
| D
+
|D
| fDragMult
+
|fDragMult
| Changes resistance to movement.
+
|Changes resistance to movement.
 
|-
 
|-
| F
+
|F
| CentreOfMass.x
+
|CentreOfMass.x
| Distance from the centre of the car in metres to the right for the centre of mass.
+
|Distance from the centre of the car in metres to the right for the centre of mass.
 
|-
 
|-
| G
+
|G
| CentreOfMass.y
+
|CentreOfMass.y
| Distance from the centre of the car in metres forwards for the centre of mass.
+
|Distance from the centre of the car in metres forwards for the centre of mass. Affects handling such that negative values (moving the weight back) induces oversteer in RWD vehicles. Moving the weight forward has the same effect on FWD vehicles.
 
|-
 
|-
| H
+
|H
| CentreOfMass.z
+
|CentreOfMass.z
| Distance from the centre of the car in metres upwards for the centre of mass.
+
|Distance from the centre of the car in metres upwards for the centre of mass. Affects stability of car; negative values inhibit rolling over.
 
|-
 
|-
| I
+
|I
| nPercentSubmerged
+
|nPercentSubmerged
| Percentage of the vehicle height required to be submerged for the car to float.
+
|Percentage of the vehicle height required to be submerged for the car to float.
 
|-
 
|-
| J
+
|J
| fTractionMultiplier
+
|fTractionMultiplier
| Cornering grip of the vehicle as a multiplier of the tyre surface friction.
+
|Grip of the vehicle as a multiplier of the tyre surface friction. Effectively the peak grip status before any loss of grip.
 
|-
 
|-
| K
+
|K
| fTractionLoss
+
|fTractionLoss
| Accelerating/braking grip of the vehicle as a multiplier of the tyre surface friction.
+
|Effectively the minimum grip status after losing traction, e.g. in a skidding situation. Higher values make the car more controllable after losing traction.
 
|-
 
|-
| L
+
|L
| fTractionBias
+
|fTractionBias
| Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
+
|Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
 
|-
 
|-
| M
+
|M
| TransmissionData.nNumberOfGears
+
|TransmissionData.nNumberOfGears
| Number of gearchange animations and sound effects to use.
+
|Number of gearchange animations and sound effects to use.
 
|-
 
|-
| N
+
|N
| TransmissionData.fMaxVelocity
+
|TransmissionData.fMaxVelocity
| Limits the top speed.
+
|Limits the top speed.
 
|-
 
|-
| O
+
|O
| TransmissionData.fEngineAcceleration
+
|TransmissionData.fEngineAcceleration
| Basic rate of acceleration.
+
|Basic rate of acceleration. Functionally acts as engine power.
 
|-
 
|-
| P
+
|P
| TransmissionData.fEngineInertia
+
|TransmissionData.fEngineInertia
| Smooths or sharpens the acceleration curve.
+
|Smooths or sharpens the acceleration curve.
 
|-
 
|-
| Q
+
|Q
| TransmissionData.nDriveType
+
|TransmissionData.nDriveType
| Assigns Front, Rear or 4 wheel drive.
+
|Assigns Front, Rear or 4 wheel drive.
 
|-
 
|-
| R
+
|R
| TransmissionData.nEngineType
+
|TransmissionData.nEngineType
| Assigns Petrol, Diesel or Electric engine characteristics.
+
|Assigns Petrol, Diesel or Electric engine characteristics.
 
|-
 
|-
| S
+
|S
| fBrakeDeceleration
+
|fBrakeDeceleration
| Overall decelerative force.
+
|Overall decelerative force.
 
|-
 
|-
| T
+
|T
| fBrakeBias
+
|fBrakeBias
| Ratio of braking force of front compared to rear; higher values move bias forward.
+
|Ratio of braking force of front compared to rear; higher values move bias forward.
 
|-
 
|-
| U
+
|U
| bABS
+
|bABS
| ABS Brakes "0" = no and "1" = yes
+
|Anti-lock Brakes. "0" = disabled and "1" = enabled
 
|-
 
|-
| V
+
|V
| fSteeringLock
+
|fSteeringLock
| Maximum angle of steering in degrees.
+
|Maximum angle of steering in degrees.
 
|-
 
|-
| a
+
|a
| fSuspensionForceLevel
+
|fSuspensionForceLevel
|  
+
|Stiffness of springs.
 
|-
 
|-
| b
+
|b
| fSuspensionDampingLevel
+
|fSuspensionDampingLevel
|  
+
|Damping strength.
 
|-
 
|-
| c
+
|c
| fSuspensionHighSpdComDamp
+
|fSuspensionHighSpdComDamp
| Stiffens the dampening strength as speed increases.
+
|Stiffens the dampening strength as speed increases.
 
|-
 
|-
| d
+
|d
| suspension upper limit
+
|suspension upper limit
| Explained in my suspension tutorial.
+
|Explained in my suspension tutorial.
 
|-
 
|-
| e
+
|e
| suspension lower limit
+
|suspension lower limit
| Explained in my suspension tutorial.
+
|Explained in my suspension tutorial.
 
|-
 
|-
| f
+
|f
| suspension bias between front and rear
+
|suspension bias between front and rear
| Ratio of suspension force to apply at the front compared to the rear.
+
|Ratio of suspension force to apply at the front compared to the rear. If weight is shifted forward or backward, this must be adjusted or else the car will lean in that direction.
 
|-
 
|-
| g
+
|g
| suspension anti-dive multiplier
+
|suspension anti-dive multiplier
| Changes the amount of body pitching under braking and acceleration.
+
|Reduces body pitching under braking and acceleration.
 
|-
 
|-
| aa
+
|aa
| fSeatOffsetDistance
+
|fSeatOffsetDistance
| Distance from door position to seat postion.
+
|Distance from door position to seat postion.
 
|-
 
|-
| ab
+
|ab
| fCollisionDamageMultiplier
+
|fCollisionDamageMultiplier
| Amount of engine damage vehicle gets from collisions. Higher value means more damage.
+
|Amount of engine damage vehicle gets from collisions. Higher value means more damage.
 
|-
 
|-
| ac
+
|ac
| nMonetaryValue
+
|nMonetaryValue
| Used to calculate the Value of property damaged statistic.
+
|Used to calculate the Value of property damaged statistic.
 
|-
 
|-
| af
+
|af
| modelFlags
+
|modelFlags
| Special animations features of the which can be enabled or disabled.
+
|Special animations features of the which can be enabled or disabled.
 
|-
 
|-
| ag
+
|ag
| handlingFlags
+
|handlingFlags
| Special performance features.
+
|Special performance features.
 
|-
 
|-
| ah
+
|ah
| front lights
+
|front lights
| Type of head lights of the vehicle.
+
|Type of head lights of the vehicle.
 
|-
 
|-
| ai
+
|ai
| rear lights
+
|rear lights
| Same as above but for the tail lights.
+
|Same as above but for the tail lights.
 
|-
 
|-
| aj
+
|aj
| Vehicle anim group
+
|Vehicle anim group
| Refers to an Animation ID number.
+
|Refers to an Animation ID number.
 
|}
 
|}
  
Line 780: Line 908:
 
Column "af", called "modelFlags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters).  The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left.  The below table describes what each of the sixteen bits in this setting do:
 
Column "af", called "modelFlags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters).  The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left.  The below table describes what each of the sixteen bits in this setting do:
  
{| {{Prettytable}}
+
{|class="wikitable"
! Byte
+
!Byte
! Value
+
!Value
! Column Name
+
!Column Name
! Description
+
!Description
 
|-
 
|-
| 1
+
|1
| 1
+
|1
| IS_VAN
+
|IS_VAN
| Allows double doors for the rear animation.
+
|Allows double doors for the rear animation.
 
|-
 
|-
|  
+
|
| 2
+
|2
| IS_BUS
+
|IS_BUS
| Vehicle uses bus stops and will try to take on passengers.
+
|Uses Coach version of animations over standard one and makes the driver invisible (only makes sense to use on Coach).
 
|-
 
|-
 
|
 
|
| 4
+
|4
| IS_LOW
+
|IS_LOW
| Drivers and passengers sit lower and lean back.
+
|Uses low version of animations over standard one.
 
|-
 
|-
 
|
 
|
| 8
+
|8
| IS_BIG
+
|IS_BIG
| Changes the way that the AI drives around corners.
+
|Changes the way that the AI drives around corners.
 
|-
 
|-
| 2
+
|2
| 1
+
|1
| REVERSE_BONNET
+
|REVERSE_BONNET
| Bonnet and boot open in opposite direction from normal.
+
|Bonnet and boot open in opposite direction from normal.
 
|-
 
|-
 
|
 
|
| 2
+
|2
| HANGING_BOOT
+
|HANGING_BOOT
| Boot opens from top edge.
+
|Affects physics of boot hinged from the top.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| TAILGATE_BOOT
+
|TAILGATE_BOOT
| Boot opens from bottom edge.
+
|Affects physics of boot hinged from the bottom.
 
|-
 
|-
 
|
 
|
| 8
+
|8
| NOSWING_BOOT
+
|NOSWING_BOOT
| Boot does not open.
+
|When damaged, boot does not swing if it normally does and falls off instead.
 
|-
 
|-
| 3
+
|3
| 1
+
|1
| NO_DOORS
+
|NO_DOORS
| Door open and close animations are skipped.
+
|Removes all testing for doors.
 
|-
 
|-
 
|
 
|
| 2
+
|2
| TANDEM_SEATS
+
|TANDEM_SEATS
| Two people will use the front passenger seat.
+
|Two people will use the front passenger seat.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| SIT_IN_BOAT
+
|SIT_IN_BOAT
| Uses seated boat animation instead of standing.
+
|Uses seated boat animation instead of standing.
 
|-
 
|-
 
|
 
|
| 8
+
|8
| CONVERTIBLE
+
|CONVERTIBLE
| Changes how hookers operate and other small effects.
+
|Changes how hookers operate and other small effects.
 
|-
 
|-
| 4
+
|4
| 1
+
|1
| NO_EXHAUST
+
|NO_EXHAUST
| Removes all exhaust particles.
+
|Removes all exhaust particles.
 
|-
 
|-
 
|
 
|
| 2
+
|2
| DBL_EXHAUST
+
|DBL_EXHAUST
| Adds a second exhaust particle on opposite side to first.
+
|Creates a second exhaust by mirroring the model's exhaust over the y-axis.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| NO1FPS_LOOK_BEHIND
+
|NO1FPS_LOOK_BEHIND
| Prevents player using rear view when in first-person mode.
+
|Prevents player using rear view when in first-person mode.
 
|-
 
|-
|  
+
|
| 8
+
|8
| FORCE_DOOR_CHECK
+
|FORCE_DOOR_CHECK
|  
+
|
 
|-
 
|-
| 5
+
|5
| 1
+
|1
| AXLE_F_NOTILT
+
|AXLE_F_NOTILT
| Front wheels stay vertical to the car like GTA 3.
+
|Front wheels stay vertical to the car like GTA 3.
 
|-
 
|-
|  
+
|
| 2
+
|2
| AXLE_F_SOLID
+
|AXLE_F_SOLID
| Front wheels stay parallel to each other.
+
|Front wheels stay parallel to each other.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| AXLE_F_MCPHERSON
+
|AXLE_F_MCPHERSON
| Front wheels tilt like GTA Vice City.
+
|Front wheels tilt like GTA Vice City.
 
|-
 
|-
 
|
 
|
| 8
+
|8
| AXLE_F_REVERSE
+
|AXLE_F_REVERSE
| Reverses the tilting of wheels when using AXLE_F_MCPHERSON suspension.
+
|Reverses the tilting of wheels when using AXLE_F_MCPHERSON suspension.
 
|-
 
|-
| 6
+
|6
| 1
+
|1
| AXLE_R_NOTILT
+
|AXLE_R_NOTILT
| Rear wheels stay vertical to the car like GTA 3.
+
|Rear wheels stay vertical to the car like GTA 3.
 
|-
 
|-
 
|
 
|
| 2
+
|2
| AXLE_R_SOLID
+
|AXLE_R_SOLID
| Rear wheels stay parallel to each other.
+
|Rear wheels stay parallel to each other.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| AXLE_R_MCPHERSON
+
|AXLE_R_MCPHERSON
| Rear wheels tilt like GTA Vice City.
+
|Rear wheels tilt like GTA Vice City.
 
|-
 
|-
 
|
 
|
| 8
+
|8
| AXLE_R_REVERSE
+
|AXLE_R_REVERSE
| Reverses the tilting of wheels when using AXLE_R_MCPHERSON suspension.
+
|Reverses the tilting of wheels when using AXLE_R_MCPHERSON suspension.
 
|-
 
|-
| 7
+
|7
| 1
+
|1
| IS_BIKE
+
|IS_BIKE
| Use extra handling settings in the bikes section.
+
|Use extra handling settings in the bikes section.
 
|-
 
|-
 
|
 
|
| 2
+
|2
| IS_HELI
+
|IS_HELI
| Use extra handling settings in the flying section.
+
|Use extra handling settings in the flying section.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| IS_PLANE
+
|IS_PLANE
| Use extra handling settings in the flying section.
+
|Use extra handling settings in the flying section.
 
|-
 
|-
|  
+
|
| 8
+
|8
| IS_BOAT
+
|IS_BOAT
| Use extra handling settings in the boats section.
+
|Use extra handling settings in the boats section.
 
|-
 
|-
| 8
+
|8
| 1
+
|1
| BOUNCE_PANELS
+
|BOUNCE_PANELS
|  
+
|
 
|-
 
|-
 
|
 
|
| 2
+
|2
| DOUBLE_RWHEELS
+
|DOUBLE_RWHEELS
| Places a second instance of each rear wheel next to the normal one.
+
|Places a second instance of each rear wheel next to the normal one.
 
|-
 
|-
 
|
 
|
| 4
+
|4
| FORCE_GROUND_CLEARANCE
+
|FORCE_GROUND_CLEARANCE
|  
+
|Prevents vehicle from bottoming out. If disabled, vehicle may collide with stairs instead of jumping off them.
 
|-
 
|-
 
|
 
|
| 8
+
|8
| IS_HATCHBACK
+
|IS_HATCHBACK
|  
+
|
 
|}
 
|}
  
Line 950: Line 1,078:
 
Column "ag", called "handlingFlags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters).  The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left.  The below table describes what each of the sixteen bits in this setting do:
 
Column "ag", called "handlingFlags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters).  The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left.  The below table describes what each of the sixteen bits in this setting do:
  
{| {{Prettytable}}
+
{|class="wikitable"
! Byte
+
!Byte
! Value
+
!Value
! Column Name
+
!Column Name
! Description
+
!Description
 
|-
 
|-
| 1
+
|1
| 1
+
|1
| 1G_BOOST
+
|1G_BOOST
| Gives more engine power for standing starts; better hill climbing.
+
|Gives more engine power for standing starts; better hill climbing.
 
|-
 
|-
|  
+
|
| 2
+
|2
| 2G_BOOST
+
|2G_BOOST
| Gives more engine power at slightly higher speeds.
+
|Gives more engine power at slightly higher speeds.
 
|-
 
|-
|  
+
|
| 4
+
|4
| NPC_ANTI_ROLL
+
|NPC_ANTI_ROLL
| No body roll when driven by AI characters.
+
|No body roll when driven by AI characters.
 
|-
 
|-
|  
+
|
| 8
+
|8
| NPC_NEUTRAL_HANDL
+
|NPC_NEUTRAL_HANDL
| Less likely to spin out when driven by AI characters.
+
|Less likely to spin out when driven by AI characters.
 
|-
 
|-
| 2
+
|2
| 1
+
|1
| NO_HANDBRAKE
+
|NO_HANDBRAKE
| Disables the handbrake effect.
+
|Disables the handbrake effect.
 
|-
 
|-
|  
+
|
| 2
+
|2
| STEER_REARWHEELS
+
|STEER_REARWHEELS
| Rear wheels steer instead of front, like a forklift truck.
+
|Rear wheels steer instead of front, like a forklift truck.
 
|-
 
|-
|  
+
|
| 4
+
|4
| HB_REARWHEEL_STEER
+
|HB_REARWHEEL_STEER
| Handbrake makes the rear wheels steer as well as front, like the monster truck.
+
|Handbrake makes the rear wheels steer as well as front, like the monster truck.
 
|-
 
|-
|  
+
|
| 8
+
|8
| ALT_STEER_OPT
+
|ALT_STEER_OPT
|  
+
|
 
|-
 
|-
| 3
+
|3
| 1
+
|1
| WHEEL_F_NARROW2
+
|WHEEL_F_NARROW2
| Very narrow front wheels.
+
|Very narrow front wheels.
 
|-
 
|-
|  
+
|
| 2
+
|2
| WHEEL_F_NARROW
+
|WHEEL_F_NARROW
| Narrow front wheels.
+
|Narrow front wheels.
 
|-
 
|-
|  
+
|
| 4
+
|4
| WHEEL_F_WIDE
+
|WHEEL_F_WIDE
| Wide front wheels.
+
|Wide front wheels.
 
|-
 
|-
|  
+
|
| 8
+
|8
| WHEEL_F_WIDE2
+
|WHEEL_F_WIDE2
| Very wide front wheels.
+
|Very wide front wheels.
 
|-
 
|-
| 4
+
|4
| 1
+
|1
| WHEEL_R_NARROW2
+
|WHEEL_R_NARROW2
| Very narrow rear wheels.
+
|Very narrow rear wheels.
 
|-
 
|-
|  
+
|
| 2
+
|2
| WHEEL_R_NARROW
+
|WHEEL_R_NARROW
| Narrow rear wheels.
+
|Narrow rear wheels.
 
|-
 
|-
|  
+
|
| 4
+
|4
| WHEEL_R_WIDE
+
|WHEEL_R_WIDE
| Wide rear wheels.
+
|Wide rear wheels.
 
|-
 
|-
|  
+
|
| 8
+
|8
| WHEEL_R_WIDE2
+
|WHEEL_R_WIDE2
| Very wide rear wheels.
+
|Very wide rear wheels.
 
|-
 
|-
| 5
+
|5
| 1
+
|1
| HYDRAULIC_GEOM
+
|HYDRAULIC_GEOM
| Lowrider hydraulics
+
|Lowrider hydraulics
 
|-
 
|-
|  
+
|
| 2
+
|2
| HYDRAULIC_INST
+
|HYDRAULIC_INST
| Will spawn with hydraulics installed.
+
|Will spawn with hydraulics installed.
 
|-
 
|-
|  
+
|
| 4
+
|4
| NOS_INST
+
|NOS_INST
| Vehicle automatically gets NOS installed when it spawns.
+
|Vehicle automatically gets NOS installed when it spawns.
 
|-
 
|-
|  
+
|
| 8
+
|8
| HYDRAULIC_NONE
+
|HYDRAULIC_NONE
| Hydraulics cannot be installed.
+
|Hydraulics cannot be installed.
 
|-
 
|-
| 6
+
|6
| 1
+
|1
| OFFROAD_ABILITY
+
|OFFROAD_ABILITY
| Vehicle will perform better on loose surfaces like dirt.
+
|Vehicle will perform better on loose surfaces like dirt.
 
|-
 
|-
|  
+
|
| 2
+
|2
| OFFROAD_ABILITY2
+
|OFFROAD_ABILITY2
| Vehicle will perform better on soft surfaces like sand.
+
|Vehicle will perform better on soft surfaces like sand.
 
|-
 
|-
|  
+
|
| 4
+
|4
| HALOGEN_LIGHTS
+
|HALOGEN_LIGHTS
| Makes headlights brighter and more blue.
+
|Bluish headlights.
 
|-
 
|-
|  
+
|
| 8
+
|8
| PROC_REARWHEEL_1ST
+
|PROC_REARWHEEL_1ST
|  
+
|
 
|-
 
|-
| 7
+
|7
| 1
+
|1
| USE_MAXSP_LIMIT
+
|USE_MAXSP_LIMIT
| Prevents vehicle going faster than column N value for maximum speed.
+
|Prevents vehicle going faster than column N value for maximum speed.
 
|-
 
|-
|  
+
|
| 2
+
|2
| LOW_RIDER
+
|LOW_RIDER
| Allows vehicle to be modified at Loco Low Co shops.
+
|Allows vehicle to be modified at Loco Low Co shops.
 
|-
 
|-
|  
+
|
| 4
+
|4
| STREET_RACER
+
|STREET_RACER
| When set, vehicle can only be modified at Wheel Arch Angels.
+
|When set, vehicle can only be modified at Wheel Arch Angels.
 
|-
 
|-
|  
+
|
| 8
+
|8
| UNDEFINED
+
|UNDEFINED
| No effect.
+
|No effect.
 
|-
 
|-
| 8
+
|8
| 1
+
|1
| SWINGING_CHASSIS
+
|SWINGING_CHASSIS
| Lets the car body move from side to side on the suspension.
+
|Lets the car body move from side to side on the suspension.
 
|-
 
|-
|  
+
|
| 2
+
|2
| UNDEFINED
+
|UNDEFINED
| No effect.
+
|No effect.
 
|-
 
|-
|  
+
|
| 4
+
|4
| UNDEFINED
+
|UNDEFINED
| No effect.
+
|No effect.
 
|-
 
|-
|  
+
|
| 8
+
|8
| UNDEFINED
+
|UNDEFINED
| No effect.
+
|No effect.
 
|}
 
|}
  
Line 1,120: Line 1,248:
 
This section contains all the performance settings from the section for floating vehicles, such as boats and flying vehicles which can land on water.  The below table provides the column letter, column name and a brief description for each setting available in this section.
 
This section contains all the performance settings from the section for floating vehicles, such as boats and flying vehicles which can land on water.  The below table provides the column letter, column name and a brief description for each setting available in this section.
  
{| {{Prettytable}}
+
{|class="wikitable"
! Column Letter
+
!Column Letter
! Column Name
+
!Column Name
! Description
+
!Description
 
|-
 
|-
| J
+
|J
| Bank Force Mult
+
|Bank Force Mult
| Amount of lean when turning.
+
|Amount of lean when turning.
 
|-
 
|-
| K
+
|K
| Rudder Turn Force
+
|Rudder Turn Force
| Effect of the steering.
+
|Effect of the steering.
 
|-
 
|-
| L
+
|L
| Speed Steer Falloff
+
|Speed Steer Falloff
| Amount to reduce steering effect by as speed increases.
+
|Amount to reduce steering effect by as speed increases.
 
|-
 
|-
| S
+
|S
| Vertical Wave Hit Limit
+
|Vertical Wave Hit Limit
|  
+
|
 
|-
 
|-
| T
+
|T
| Forward Wave Hit Brake
+
|Forward Wave Hit Brake
|  
+
|
 
|-
 
|-
| a
+
|a
| WaterResistance Volume Mult
+
|WaterResistance Volume Mult
|  
+
|
 
|-
 
|-
| b
+
|b
| Water Damping Mult
+
|Water Damping Mult
|  
+
|
 
|-
 
|-
| d
+
|d
| Handbrake Drag Mult
+
|Handbrake Drag Mult
|  
+
|
 
|-
 
|-
| e
+
|e
| Sideslip Force
+
|Sideslip Force
| Strength that the boat will be pushed sideways by waves.
+
|Strength that the boat will be pushed sideways by waves.
 
|}
 
|}
  
Line 1,174: Line 1,302:
 
* [http://projectcerbera.com/gta/sa/tutorials/handling SA Handling Definitions] - Project Cerbera
 
* [http://projectcerbera.com/gta/sa/tutorials/handling SA Handling Definitions] - Project Cerbera
  
{{N|SA|VC}}
+
{{N|SA|VC|3}}
[[Category:Vehicle Formats]][[Category:GTA_3]]
+
[[Category:Vehicle Formats]]

Latest revision as of 05:27, 6 July 2022

The handling.cfg file stores handling configuration data and settings for vehicles in GTA III, Vice City, and San Andreas.

GTA III and Vice City

Format and syntax description

The file is in plain text format so it can be opened with any text editor (like Notepad). Line comments are indicated by the character ; (semicolon) and empty lines are allowed. They can be placed anywhere in the file. Each entry takes up one line and follows a specific format detailed below. Data in each entry are separated by  (space) and  (horizontal tab). The file must contain the line ;the end\n (;the end with at least an empty line after it) in order for the game to stop reading the file. The length of each line is limited to 200 characters and the size of the file is limited to 55000 bytes but the games do not perform any checks on the limits so going past them can cause instabilities or crashes.

Standard Data

This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles. In GTA III the special behaviour of boats, bikes and flying vehicles are hardcoded and are not included in the handling.cfg file. Vice City included many of those handling data into the file.

GTA III Vice City Identifier Type Description
A vehicle identifier string The identifier must be from the list of hardcoded names (see below).
B fMass float Mass of the vehicle in kilograms.
C Dimensions.x float Width of the vehicle in metres, used for aerodynamic and motion effects.
D Dimensions.y float Length of the vehicle in metres, used for aerodynamic and motion effects.
E Dimensions.z float Height of the vehicle in metres, used for aerodynamic and motion effects.
F CentreOfMass.x float Distance from the centre of the car in metres to the right for the centre of mass.
G CentreOfMass.y float Distance from the centre of the car in metres forward for the centre of mass.
H CentreOfMass.z float Distance from the centre of the car in metres upward for the centre of mass.
I nPercentSubmerged integer Percentage of the vehicle height required to be submerged for the car to float.
J fTractionMultiplier float Grip of the vehicle as a multiplier of the tyre surface friction. Effectively the peak grip status before any loss of grip.
K fTractionLoss float Effectively the minimum grip status after losing traction, e.g. in a skidding situation. Higher values make the car more controllable after losing traction.
L fTractionBias float Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
M TransmissionData.nNumberOfGears integer Number of gearchange animations and sound effects to use.
N TransmissionData.fMaxVelocity float Limits the top speed.
O TransmissionData.fEngineAcceleration float Basic rate of acceleration.
P TransmissionData.nDriveType character Assigns Front, Rear or 4 wheel drive.
Q TransmissionData.nEngineType character Assigns Petrol, Diesel or Electric engine characteristics.
R fBrakeDeceleration float Overall decelerative force, set so keyboard controls do not quite lock up the wheels.
S fBrakeBias float Ratio of braking force of front compared to rear; higher values move bias forward.
T bABS integer Seems to have no effect.
U fSteeringLock float Maximum rotation of steering arc in degrees; use negatives for rear wheel steered vehicles.
V fSuspensionForceLevel float Explained in my suspension tutorial.
W fSuspensionDampingLevel float Explained in my suspension tutorial.
X fSeatOffsetDistance float Distance from door position to seat position.
Y fCollisionDamageMultiplier float How much damage vehicle engine gets from collisions. Higher value means more damage.
Z nMonetaryValue integer Used to determine monetary award for crusher, collisions, and explosions in GTA III and the Property Destroyed statistic in Vice City.
AA suspension upper limit float Uppermost movement of wheels in metres.
AB suspension lower limit float Ride height of vehicle in metres.
AC suspension bias float Ratio of suspension force to apply at the rear compared to the front.
- AD suspension anti-dive multiplier float Changes the amount of body pitching under braking and acceleration.
AD AE Flags hex Special features which can be enabled or disabled (see below).
AE AF front lights integer Defines the size of the head lights of the vehicle. Using numbers out of range has unusual effects.
AF AG rear lights integer Same as above but for the tail lights.

List of vehicle identifiers

The games contain a hardcoded list of vehicle identifiers. This is used to assign a vehicle's handling name to a handling index (LANDSTAL is at index 0, IDAHO is at index 1, etc.).

GTA III Vice City Liberty City Stories
  • LANDSTAL
  • IDAHO
  • STINGER
  • LINERUN
  • PEREN
  • SENTINEL
  • PATRIOT
  • FIRETRUK
  • TRASH
  • STRETCH
  • MANANA
  • INFERNUS
  • BLISTA
  • PONY
  • MULE
  • CHEETAH
  • AMBULAN
  • FBICAR
  • MOONBEAM
  • ESPERANT
  • TAXI
  • KURUMA
  • BOBCAT
  • MRWHOOP
  • BFINJECT
  • POLICE
  • ENFORCER
  • SECURICA
  • BANSHEE
  • PREDATOR
  • BUS
  • RHINO
  • BARRACKS
  • TRAIN
  • HELI
  • DODO
  • COACH
  • CABBIE
  • STALLION
  • RUMPO
  • RCBANDIT
  • BELLYUP
  • MRWONGS
  • MAFIA
  • YARDIE
  • YAKUZA
  • DIABLOS
  • COLUMB
  • HOODS
  • AIRTRAIN
  • DEADDODO
  • SPEEDER
  • REEFER
  • PANLANT
  • FLATBED
  • YANKEE
  • BORGNINE
  • LANDSTAL
  • IDAHO
  • STINGER
  • LINERUN
  • PEREN
  • SENTINEL
  • PATRIOT
  • FIRETRUK
  • TRASH
  • STRETCH
  • MANANA
  • INFERNUS
  • PONY
  • MULE
  • CHEETAH
  • AMBULAN
  • FBICAR
  • MOONBEAM
  • ESPERANT
  • TAXI
  • KURUMA
  • BOBCAT
  • MRWHOOP
  • BFINJECT
  • POLICE
  • ENFORCER
  • SECURICA
  • BANSHEE
  • BUS
  • RHINO
  • BARRACKS
  • TRAIN
  • HELI
  • DODO
  • COACH
  • CABBIE
  • STALLION
  • RUMPO
  • RCBANDIT
  • MAFIA
  • AIRTRAIN
  • DEADDODO
  • FLATBED
  • YANKEE
  • GOLFCART
  • VOODOO
  • WASHING
  • CUBAN
  • ROMERO
  • PACKER
  • ADMIRAL
  • GANGBUR
  • ZEBRA
  • TOPFUN
  • GLENDALE
  • OCEANIC
  • HERMES
  • SABRE1
  • SABRETUR
  • PHEONIX
  • WALTON
  • REGINA
  • COMET
  • DELUXO
  • BURRITO
  • SPAND
  • BAGGAGE
  • KAUFMAN
  • RANCHER
  • FBIRANCH
  • VIRGO
  • GREENWOO
  • HOTRING
  • SANDKING
  • BLISTAC
  • BOXVILLE
  • BENSON
  • DESPERAD
  • LOVEFIST
  • BLOODRA
  • BLOODRB
  • BIKE
  • MOPED
  • DIRTBIKE
  • ANGEL
  • FREEWAY
  • PREDATOR
  • SPEEDER
  • REEFER
  • RIO
  • SQUALO
  • TROPIC
  • COASTGRD
  • DINGHY
  • MARQUIS
  • CUPBOAT
  • SEAPLANE
  • SPARROW
  • SEASPAR
  • MAVERICK
  • COASTMAV
  • POLMAV
  • HUNTER
  • RCBARON
  • RCGOBLIN
  • RCCOPTER
  • LANDSTAL
  • IDAHO
  • STINGER
  • LINERUN
  • PEREN
  • SENTINEL
  • PATRIOT
  • FIRETRUK
  • TRASH
  • STRETCH
  • MANANA
  • INFERNUS
  • PONY
  • MULE
  • CHEETAH
  • AMBULAN
  • FBICAR
  • MOONBEAM
  • ESPERANT
  • TAXI
  • KURUMA
  • BOBCAT
  • MRWHOOP
  • BFINJECT
  • POLICE
  • ENFORCER
  • SECURICA
  • BANSHEE
  • BUS
  • RHINO
  • BARRACKS
  • TRAIN
  • FERRY
  • HELI
  • DODO
  • COACH
  • CABBIE
  • STALLION
  • RUMPO
  • RCBANDIT
  • MAFIA
  • AIRTRAIN
  • DEADDODO
  • FLATBED
  • YANKEE
  • BLISTA
  • BELLYUP
  • MRWONGS
  • YARDIE
  • YAKUZA
  • DIABLOS
  • COLUMB
  • HOODS
  • PANLANT
  • BORGNINE
  • CAMPVAN
  • BALLOT
  • SPIDER
  • SHELBY
  • PONTIAC
  • ESPRIT
  • MINI
  • HOTROD
  • SINDACCO
  • FORELLI
  • BIKE
  • MOPED
  • DIRTBIKE
  • ANGEL
  • DIRTBIK2
  • ANGE2
  • FREEWAY
  • PREDATOR
  • SPEEDER
  • REEFER
  • MAVERICK
  • COASTMAV
  • POLMAV
  • HUNTER
  • RCGOBLIN
  • RCCOPTER

Flags

The flag is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters). The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left. The below table describes what each of the sixteen bits in this setting do:

Game Byte Value Column Name Description
GTA III Vice City 1 1 1G_BOOST Makes tyres spin more readily from standing starts.
2 2G_BOOST Makes tyres spin more readily at low speeds.
4 REV_BONNET Reverses the direction boot and bonnet axis operate.
8 HANGING_BOOT Affects physics of boot hinged from the top.
2 1 NO_DOORS Removes all testing for doors.
2 IS_VAN Allows double boot object.
4 IS_BUS Uses Coach version of animations over standard one and makes the driver invisible (only makes sense to use on Coach).
8 IS_LOW Uses low version of animations over standard one.
3 1 DBL_EXHAUST Creates a second exhaust by mirroring the model's exhaust over the y-axis.
2 TAILGATE_BOOT Affects physics of boot hinged from the bottom.
4 NOSWING_BOOT When damaged, boot does not swing if it normally does and falls off instead.
8 NONPLAYER_STABILISER Seems to have no effect, could be related to how the AI operates the vehicle
4 1 NEUTRALHANDLING Seems to have no effect, could be related to how the AI operates the vehicle
2 HAS_NO_ROOF Various slight effects.
4 IS_BIG Changes the way that the AI drives around corners.
8 HALOGEN_LIGHTS Bluish headlights.
Vice City 5 1 IS_BIKE Makes the game engine treat this vehicle as a motorbike when used with default.ide attributes.
2 IS_HELI Makes the game engine treat this vehicle as a helicopter when used with default.ide attributes.
4 IS_PLANE Makes the game engine treat this vehicle as a plane when used with default.ide attributes.
8 IS_BOAT Makes the game engine treat this vehicle as a boat when used with default.ide attributes.
6 1 NO_EXHAUST Removes the exhaust animation particle for this vehicle.
2 REARWHEEL_1ST Seems to have no effect.
4 HANDBRAKE_TYRE Seems to have no effect.
8 SIT_IN_BOAT Makes the player sit in this boat.
7 1 FAT_REARW Wider rear wheels.
2 NARROW_FRONTW Narrower front wheels.
4 GOOD_INSAND Prevents vehicle from bogging down on sand surface.
8 Is not mentioned in the handling.cfg comments. Causes the vehicle to not render while looking behind in first person view.

Vice City-specific

The following sections contain information specific to Vice City.

Boat Data

Some of the Standard Data settings have a different effect for floating vehicles than they would for land vehicles.

Column Letter Column Name Description
J Bank Force Mult Amount of lean when turning.
K Rudder Turn Force Effect of the steering.
L Speed Steer Falloff Amount to reduce steering effect by as speed increases.
R Vertical Wave Hit Limit
S Forward Wave Hit Brake
V WaterResistance Volume Mult
W Water Damping Mult
ab Handbrake Drag Mult
ac Sideslip Force Strength that the boat will be pushed sideways by waves.

Data specific to boats have lines that begin with % (percentage sign) character.

% Identifier Type Description
A ID string The identifier must be from the list of hardcoded names (see above).
B ThrustY float
C ThrustZ float
D ThrustAppZ float
E AqPlaneForce float
F AqPlaneLimit float
G AqPlaneOffset float
H WaveAudioMult float
I MoveResX float
J MoveResY float
K MoveResZ float
L TurnResX float
M TurnResY float
N TurnResZ float
O Look_L_R_BehindCamHeight float

Bike Data

Data specific to bikes have lines that begin with ! (exclamation mark) character.

! Identifier Type Description
A ID string The identifier must be from the list of hardcoded names (see above).
B LeanFwdCOM float
C LeanFwdForce float
D LeanBakCOM float
E LeanBackForce float
F MaxLean float
G FullAnimLean float
H DesLean float
I SpeedSteer float
J SlipSteer float
K NoPlayerCOMz float
L WheelieAng float
M StoppieAng float
N WheelieSteer float
O WheelieStabMult float
P StoppieStabMult float

Flying Data

Data specific to flying vehicles have lines that begin with $ (dollar sign) character.

$ Identifier Type Description
A ID string The identifier must be from the list of hardcoded names (see above).
B Thrust float Engine power. This affects yaw, pitch and roll in that those values could be equal, but the vehicle with greater thrust will have more pronounced yaw, pitch and roll.
C ThrustFallOff float
D Yaw float
E YawStab float
F SideSlip float
G Roll float
H RollStab float
I Pitch float
J PitchStab float
K FormLift float
L AttackLift float
M MoveRes float
N TurnRes.x float
O TurnRes.y float
P TurnRes.z float Affects how likely vehicle is to rotate in terms of yaw without using the rudder.
Q SpeedRes.x float
R SpeedRes.y float
S SpeedRes.z float

GTA San Andreas

Standard Data

This section contains all the performance settings for land vehicles and provides the base settings for boats, bikes and flying vehicles. The below table provides the column letter, column name and a brief description for each setting available in this section.

Column Letter Column Name Description
A vehicle identifier Relates this data with vehicle.ide and other files.
B fMass Mass of the vehicle in kilograms.
C fTurnMass Used to calculate motion effects. Higher values make the vehicle's body rotate slower around every axis (similar to the VecInertiaMultiplier values in GTAV). This also seems to be relative to Mass, meaning that a vehicle with a greater Mass requires an exponentially greater Turn Mass to achieve the same effect.
D fDragMult Changes resistance to movement.
F CentreOfMass.x Distance from the centre of the car in metres to the right for the centre of mass.
G CentreOfMass.y Distance from the centre of the car in metres forwards for the centre of mass. Affects handling such that negative values (moving the weight back) induces oversteer in RWD vehicles. Moving the weight forward has the same effect on FWD vehicles.
H CentreOfMass.z Distance from the centre of the car in metres upwards for the centre of mass. Affects stability of car; negative values inhibit rolling over.
I nPercentSubmerged Percentage of the vehicle height required to be submerged for the car to float.
J fTractionMultiplier Grip of the vehicle as a multiplier of the tyre surface friction. Effectively the peak grip status before any loss of grip.
K fTractionLoss Effectively the minimum grip status after losing traction, e.g. in a skidding situation. Higher values make the car more controllable after losing traction.
L fTractionBias Ratio of front axle grip to rear axle grip; higher value shifts grip forwards.
M TransmissionData.nNumberOfGears Number of gearchange animations and sound effects to use.
N TransmissionData.fMaxVelocity Limits the top speed.
O TransmissionData.fEngineAcceleration Basic rate of acceleration. Functionally acts as engine power.
P TransmissionData.fEngineInertia Smooths or sharpens the acceleration curve.
Q TransmissionData.nDriveType Assigns Front, Rear or 4 wheel drive.
R TransmissionData.nEngineType Assigns Petrol, Diesel or Electric engine characteristics.
S fBrakeDeceleration Overall decelerative force.
T fBrakeBias Ratio of braking force of front compared to rear; higher values move bias forward.
U bABS Anti-lock Brakes. "0" = disabled and "1" = enabled
V fSteeringLock Maximum angle of steering in degrees.
a fSuspensionForceLevel Stiffness of springs.
b fSuspensionDampingLevel Damping strength.
c fSuspensionHighSpdComDamp Stiffens the dampening strength as speed increases.
d suspension upper limit Explained in my suspension tutorial.
e suspension lower limit Explained in my suspension tutorial.
f suspension bias between front and rear Ratio of suspension force to apply at the front compared to the rear. If weight is shifted forward or backward, this must be adjusted or else the car will lean in that direction.
g suspension anti-dive multiplier Reduces body pitching under braking and acceleration.
aa fSeatOffsetDistance Distance from door position to seat postion.
ab fCollisionDamageMultiplier Amount of engine damage vehicle gets from collisions. Higher value means more damage.
ac nMonetaryValue Used to calculate the Value of property damaged statistic.
af modelFlags Special animations features of the which can be enabled or disabled.
ag handlingFlags Special performance features.
ah front lights Type of head lights of the vehicle.
ai rear lights Same as above but for the tail lights.
aj Vehicle anim group Refers to an Animation ID number.

Model Flag Data

Column "af", called "modelFlags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters). The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left. The below table describes what each of the sixteen bits in this setting do:

Byte Value Column Name Description
1 1 IS_VAN Allows double doors for the rear animation.
2 IS_BUS Uses Coach version of animations over standard one and makes the driver invisible (only makes sense to use on Coach).
4 IS_LOW Uses low version of animations over standard one.
8 IS_BIG Changes the way that the AI drives around corners.
2 1 REVERSE_BONNET Bonnet and boot open in opposite direction from normal.
2 HANGING_BOOT Affects physics of boot hinged from the top.
4 TAILGATE_BOOT Affects physics of boot hinged from the bottom.
8 NOSWING_BOOT When damaged, boot does not swing if it normally does and falls off instead.
3 1 NO_DOORS Removes all testing for doors.
2 TANDEM_SEATS Two people will use the front passenger seat.
4 SIT_IN_BOAT Uses seated boat animation instead of standing.
8 CONVERTIBLE Changes how hookers operate and other small effects.
4 1 NO_EXHAUST Removes all exhaust particles.
2 DBL_EXHAUST Creates a second exhaust by mirroring the model's exhaust over the y-axis.
4 NO1FPS_LOOK_BEHIND Prevents player using rear view when in first-person mode.
8 FORCE_DOOR_CHECK
5 1 AXLE_F_NOTILT Front wheels stay vertical to the car like GTA 3.
2 AXLE_F_SOLID Front wheels stay parallel to each other.
4 AXLE_F_MCPHERSON Front wheels tilt like GTA Vice City.
8 AXLE_F_REVERSE Reverses the tilting of wheels when using AXLE_F_MCPHERSON suspension.
6 1 AXLE_R_NOTILT Rear wheels stay vertical to the car like GTA 3.
2 AXLE_R_SOLID Rear wheels stay parallel to each other.
4 AXLE_R_MCPHERSON Rear wheels tilt like GTA Vice City.
8 AXLE_R_REVERSE Reverses the tilting of wheels when using AXLE_R_MCPHERSON suspension.
7 1 IS_BIKE Use extra handling settings in the bikes section.
2 IS_HELI Use extra handling settings in the flying section.
4 IS_PLANE Use extra handling settings in the flying section.
8 IS_BOAT Use extra handling settings in the boats section.
8 1 BOUNCE_PANELS
2 DOUBLE_RWHEELS Places a second instance of each rear wheel next to the normal one.
4 FORCE_GROUND_CLEARANCE Prevents vehicle from bottoming out. If disabled, vehicle may collide with stairs instead of jumping off them.
8 IS_HATCHBACK

Handling Flag Data

Column "ag", called "handlingFlags", is a sixteen-bit integer value stored as a hexadecimal value in four bytes (characters). The number is written with the smallest value on the right, which is bit number one, with the higher value bits to the left. The below table describes what each of the sixteen bits in this setting do:

Byte Value Column Name Description
1 1 1G_BOOST Gives more engine power for standing starts; better hill climbing.
2 2G_BOOST Gives more engine power at slightly higher speeds.
4 NPC_ANTI_ROLL No body roll when driven by AI characters.
8 NPC_NEUTRAL_HANDL Less likely to spin out when driven by AI characters.
2 1 NO_HANDBRAKE Disables the handbrake effect.
2 STEER_REARWHEELS Rear wheels steer instead of front, like a forklift truck.
4 HB_REARWHEEL_STEER Handbrake makes the rear wheels steer as well as front, like the monster truck.
8 ALT_STEER_OPT
3 1 WHEEL_F_NARROW2 Very narrow front wheels.
2 WHEEL_F_NARROW Narrow front wheels.
4 WHEEL_F_WIDE Wide front wheels.
8 WHEEL_F_WIDE2 Very wide front wheels.
4 1 WHEEL_R_NARROW2 Very narrow rear wheels.
2 WHEEL_R_NARROW Narrow rear wheels.
4 WHEEL_R_WIDE Wide rear wheels.
8 WHEEL_R_WIDE2 Very wide rear wheels.
5 1 HYDRAULIC_GEOM Lowrider hydraulics
2 HYDRAULIC_INST Will spawn with hydraulics installed.
4 NOS_INST Vehicle automatically gets NOS installed when it spawns.
8 HYDRAULIC_NONE Hydraulics cannot be installed.
6 1 OFFROAD_ABILITY Vehicle will perform better on loose surfaces like dirt.
2 OFFROAD_ABILITY2 Vehicle will perform better on soft surfaces like sand.
4 HALOGEN_LIGHTS Bluish headlights.
8 PROC_REARWHEEL_1ST
7 1 USE_MAXSP_LIMIT Prevents vehicle going faster than column N value for maximum speed.
2 LOW_RIDER Allows vehicle to be modified at Loco Low Co shops.
4 STREET_RACER When set, vehicle can only be modified at Wheel Arch Angels.
8 UNDEFINED No effect.
8 1 SWINGING_CHASSIS Lets the car body move from side to side on the suspension.
2 UNDEFINED No effect.
4 UNDEFINED No effect.
8 UNDEFINED No effect.

Boat Data

This section contains all the performance settings from the section for floating vehicles, such as boats and flying vehicles which can land on water. The below table provides the column letter, column name and a brief description for each setting available in this section.

Column Letter Column Name Description
J Bank Force Mult Amount of lean when turning.
K Rudder Turn Force Effect of the steering.
L Speed Steer Falloff Amount to reduce steering effect by as speed increases.
S Vertical Wave Hit Limit
T Forward Wave Hit Brake
a WaterResistance Volume Mult
b Water Damping Mult
d Handbrake Drag Mult
e Sideslip Force Strength that the boat will be pushed sideways by waves.

Tools

See also

External links