CARS (IDE Section)

CARS (IDE section)

Supported games:
Short description:	Defines vehicles
IDE Sections: 2DFX • AMAT • ANIM • CARS • HIER • MLO • OBJS PATH • PEDS • TANM • TOBJ • TREE • TXDP • WEAP

cars is a section in the item definition file in Grand Theft Auto III, Grand Theft Auto: Vice City, Grand Theft Auto: San Andreas, and Grand Theft Auto IV. It is used to define vehicles and some their properties.

Format

Between GTA III and GTA San Andreas, the class of a vehicle helps determine where it should spawn, with the help of hardcoded features and the script. The ignore class is special for its ability to prevent vehicles assigned to that class from spawning as a regular NPC vehicle in traffic. Peds can be assigned to drive classes of vehicle in the peds section of the IDE file.

GTA III

This section is mainly used in the \data\default.ide file. Each type of vehicle has its own format.

cars
# type car
Id, ModelName, TxdName, Type, HandlingId, GameName, Class, Frq, Lvl, Comprules, WheelModelId, WheelScale
# type boat
Id, ModelName, TxdName, Type, HandlingId, GameName, Class, Frq, Lvl, Comprules
# type train
Id, ModelName, TxdName, Type, HandlingId, GameName, Class, Frq, Lvl, Comprules
# type heli
Id, ModelName, TxdName, Type, HandlingId, GameName, Class, Frq, Lvl, Comprules
# type plane
Id, ModelName, TxdName, Type, HandlingId, GameName, Class, Frq, Lvl, Comprules, LODModel
end

	Identifier	Type	Description
A	Id	integer	Unique object ID.
B	ModelName	string	Name of the .dff model file without extension.
C	TxdName	string	Name of the .txd texture dictionary without extension.
D	Type	string	Type of vehicle, which includes car, boat, train, heli, plane, and bike. This data is related to hardcoded functions and must not be changed or else it might crash the game. The bike type is never used in the game but is documented here for sake of completion.
E	HandlingId	string	Name corresponding to its handling data in the handling.cfg file.
F	GameName	string	Name corresponding to its GXT key, case sensitive and must be seven characters or less! Vehicles with an invalid name will show up as MODELNAME missing when entered
G	Class	string	Class of the vehicle. poorfamily richfamily executive worker special big taxi ignore
H	Frq	integer	Frequency of the vehicle spawning randomly on the streets.
I	Lvl	integer	unknown
J	Comprules	hex	Component rules, alters how vehicle models' "extras" behave, see below for list
K	car: WheelModelId boat: unused train: unused heli: unused plane: LODModel bike: unknown	integer	Model index of wheel model. - - - Model index of LOD model – can be any valid object. unknown
L	car: WheelScale boat: unused train: unused heli: unused plane: unused bike: unknown	float	Scale of wheel and collision models, 1.0 for original size of wheel and collision models - - - - unknown

Comprules

This is a list of all non-zero values used in the column.

Non-Zero Value	Effect	Vehicle(s)
0x1f10	Forces vehicle to always spawn with one of its first two extras. If a vehicle has more than two extras, one of the first two will always spawn and another extra also may spawn with either of the first two extras. Very rarely (likely due to a glitch) these vehicles can spawn without an extra.	Taxi, Hoods Rumpo XL
0x2ff0	When it is raining, vehicle will spawn with its first extra. Vehicle may also spawn with other extras (if present in the model) in addition to the first extra.	Stinger, Stallion

Wheels

Wheel models are located in the \models\generic\wheels.DFF file. Their textures are located in the \models\misc.txd file. Just like the cars themselves they are defined inside the \data\default.ide file by default.

GTA Vice City

By default all cars are defined inside the \data\default.ide file. From GTA III, type train becomes unused but bike is used.

cars
# type car
Id, ModelName, TxdName, Type, HandlingId, GameName, Anims, Class, Frq, Lvl, Comprules, WheelModelId, WheelScale
# type boat
Id, ModelName, TxdName, Type, HandlingId, GameName, Anims, Class, Frq, Lvl, Comprules
# type heli
Id, ModelName, TxdName, Type, HandlingId, GameName, Anims, Class, Frq, Lvl, Comprules
# type plane
Id, ModelName, TxdName, Type, HandlingId, GameName, Anims, Class, Frq, Lvl, Comprules, LODModel
# type bike
Id, ModelName, TxdName, Type, HandlingId, GameName, Anims, Class, Frq, Lvl, Comprules, SteeringAngle, WheelScale
end

	Identifier	Type	Description
A	Id	integer	Unique object ID.
B	ModelName	string	Name of the .dff model file without extension.
C	TxdName	string	Name of the .txd texture dictionary without extension.
D	Type	string	Type of vehicle, which includes car, boat, train, heli, plane, and bike. Flyable helicopters are of type car. The train type is never used in the game but is documented here for sake of completion.
E	HandlingId	string	Name corresponding to its handling data in the handling.cfg file.
F	GameName	string	Name corresponding to its GXT key, case sensitive and must be seven characters or less. Invalid name will not show up in the game.
G	Anims	string	Appropriate animation file mainly used on bikes.
H	Class	string	Class of the vehicle. normal poorfamily richfamily executive worker big taxi moped motorbike leisureboat workerboat ignore
I	Frq	integer	Frequency of the vehicle spawning randomly on the streets.
J	Lvl	integer	unknown
K	Comprules	hex	Component rules, alters how vehicle models' "extras" behave, see below for list
L	car: WheelID boat: unused train: unused heli: unused plane: LODModel bike: Steering angle	integer	Model index of wheel model. - - - Model index of LOD model – can be any valid object. Steering angle (in degrees)
M	car: WheelScale boat: unused train: unused heli: unused plane: unused bike: WheelScale	float	Scale of wheel and collision models, 1.0 for original size of wheel and collision models - - - - Scale of wheel collision model, 1.0 for original size of wheel collision models; wheel visually not affected

Comprules

This is a list of all non-zero values used in the column.

Non-Zero Value	Vehicle(s)
0x1f10	Taxi, Cabbie, Zebra Cab, Kaufman Cab
0x2ff0	Stinger, Stallion, Sabre, Sabre Turbo, Comet, Deluxo
0x4fff	Flatbed, Hotring A, Hotring B, Bloodring Banger A, Bloodring Banger B
0x30123345	Caddy

Wheels

The location of the definition files, models and textures are just the same as for GTA III. However there are some different textures and models.

GTA San Andreas

By default all cars are defined inside the \data\vehicles.ide file.

cars
# type car
Id, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Flags, Comprules, WheelID, WheelScale_Front, WheelScale_Rear, Unknown_value
end

Identifier	Description
Id	Unique model ID
ModelName	Name of the .dff model file without extension.
TxdName	Name of the .txd texture dictionary without extension.
Type	Type of vehicle, which includes trailer, bmx, bike, train, boat, plane, heli, quad, mtruck and car
HandlingID	Name corresponding to its handling data in the handling.cfg file.
GameName	Name corresponding to its GXT key, case sensitive and must be seven characters or less. Invalid name will not show up in the game.
Anims	Appropriate character animation
Class	Class of the vehicle. normal poorfamily richfamily executive worker big taxi moped motorbike leisureboat workerboat bicycle ignore
Frequency	Frequency of the vehicle spawning randomly on the streets.
Flags	Unknown integer.
Comprules	Component rules, alters how vehicle models' "extras" behave, see below for list
WheelID	Wheel index, needs to be -1 for vehicles to use wheel model defined in the vehicle's model (wheels.dff is no longer used)
WheelScale_Front	Scale of front wheels and collision models for types car, trailer, quad, mtruck, bmx and bike
WheelScale_Rear	Scale of rear wheels and collision models for types car, trailer, quad, mtruck, bmx and bike
Wheel Upgrade Class	The wheel set this vehicle relates to, the ids are equivalent to the ones defined in carmods.dat

Flags

According to the vehicles.ide file, flag 0x01 streams a vehicle out after it has been spawned once, and flag 0x02 whis is "used internally". There are 3 vehicles that use flag 0x01, none that use flag 0x02, and one that uses 0x07, which is not mentioned at all.

Non-Zero Value	Vehicle(s)
0x01	Dumper, Mr. Whoopee, Pizzaboy
0x07	Huntley

Comprules

This is a list of all non-zero values used in the column.

Non-Zero Value	Vehicle(s)
0x1012	Tram
0x1f10	Taxi, Barracks Ol, Coach, Cabbie, Slamvan
0x2ff0	Sabre, Comet, Savanna, Broadway, Tornado
0x3012	Coast Guard
0x3210	Stallion
0x3f01	Reefer
0x3f10	Securicar
0x4fff	Speeder, Tropic, Flatbed, Hotring Racer A, Hotring Racer B, Bloodring Banger, DFT30
0x1f341210	NRG500
0x30123345	Caddy
0x3f341210	FCR900, BF400

Wheels

Wheel models are now in the same model as the vehicle itself. The wheels.dff and wheels.txd are present but not used. If the "WheelID" is -1, the game will scale the wheel collision, but NOT the wheel model. If "WheelID" is 0, the game will scale the collision AND the wheel model, however this only works properly if the wheel model is set up properly before exporting.

GTA IV

By default all cars are defined inside the \common\data\vehicles.ide file.

	Identifier	Type	Description
A	ModelName	string	Name of the .wdr model file without extension.
B	TxdName	string	Name of the .wtd texture dictionary without extension.
C	Type	string	Type of vehicle, which includes car, bike, boat, train, heli, and plane.
D	HandlingId	string	Name corresponding to its handling data in the handling.dat file.
E	GameName	string	Name corresponding to its GXT key (changing this will also change the sound of the vehicle)
F	Anims	string	Name of the animation used while entering and driving a vehicle from anim.img file. VEH@STD - Standard Car VEH@VAN - Van VEH@LOW - Low to the ground VEH@TRUCK - Truck VEH@BUS - Bus VEH@BIKE_FREEWAY - Freeway Motorcycle VEH@BIKE_SCOOTER - Scooter VEH@BIKE_SPT - Sports Bike VEH@BIKE_DIRT - Dirt Bike VEH@BIKE_CHOPPER - Chopper Motor Cycle VEH@HELICOPTER - Helicopter veh@boat_speed - Speed Boat veh@boat_STAND_BIG - Big Boat, player stands while driving veh@boat_standing - Boat that player stands while driving VEH@TRAIN - Train
G	Anims2	string	Name of the secondary vehicle animation used from anim.img file. NULL - Ignored VEH@HELICOPTER_XX_H VEH@HELI_ANNIH VEH@VAN_LL_LO, _LR1_LF1, _HL1_HI1, _FO2_FO2, _XX_LE1, _FO1_FO1, _RI1_LE1, _RI2_LE2, _RI3_LE3 VEH@STD_LO1_LO1, _LO2_LO2, _LO3_LO3, _LO4_LO4, _LO5_LO5, _LE1_RI1, _RI2_LE2, _DF8, _RI1, _RI3, _XX_RI1, _XX_RI2, _RI1_LO1, _RI2_LO2, _RI3_LO3, _FO1, VEH@LOW_INFERNUS, _CONV, _LE1_RI1, _LE2_RI2, _LU1_RI1, _LU2_RI2, _HI_HI, _HI2_HI2, _HI3_HI3, _HI4_HI4, _XX_LO1 VEH@TRUCK_BA_XX, _LE1_RI1, _LO1_LO1, _PHANTOM
H	Frq	integer	Frequency of the vehicle spawning randomly on the streets.
I	MaxNum	integer	Maximum number of vehicles to exist at a time.
J,K	WheelRadius	float[2]
L	DefDirtLevel	float	Dirt level of traffic vehicles that includes a range from set value to 1.0. Supported values range from 0.0 (clean) to 1.0 (dirty).
M	LodMult	integer
N	Swankness	float
O	Flags	string	noboot smallworker big onlyduringofficehours bootinfront isvan avoidturns livery liveryextra sports delivery noambocc onlyonhighways - spawn only on .NOD path, who uses 'Highway' Flag in 3th section of Flags. ext_gang ext_conv ext_taxi ext_rare ext_requi ext_strong ext_script ext_all ext_sunroof tallship truckfx truckenginefx truckexhaustfx truckfirefx bangerexhaustfx

This page is licensed under the GNU Free Documentation Licence. This page has a separate license to the CC-BY-SA that applies to most of Grand Theft Wiki.

The full text of the GNU FDL v1.2 is here. Click the "History" button to see the full list of authors. See Grand Theft Wiki:Copyright for more detail on our copyright policy.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. See Grand Theft Wiki:Copyright for more information.