Difference between revisions of "CARS (IDE Section)"

From GTAMods Wiki
Jump to navigation Jump to search
(Wheels: added xbox images)
(Vice City: testing messy table)
Line 81: Line 81:
  
 
By default all cars are defined inside the <code>../data/default.ide</code> file. Unlike ''GTA III'' there are the types ''bike'' and ''heli'' but ''train'' is missing or unused.
 
By default all cars are defined inside the <code>../data/default.ide</code> file. Unlike ''GTA III'' there are the types ''bike'' and ''heli'' but ''train'' is missing or unused.
 
''Car''
 
ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Level, Comprules, WheelID, WheelScale
 
 
''Bike''
 
ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Level, Comprules, Unknown, WheelScale
 
 
''Boat and Heli''
 
ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Level, Comprules
 
 
''Plane''
 
ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Level, Comprules, LODModel
 
  
 
{|{{Prettytable}} width="100%"
 
{|{{Prettytable}} width="100%"
!width="250px"|Identifier
+
! width="36px"|
!Description
+
! width="150px"| Identifier
 +
! width="100px"| Type
 +
! Description
 
|-
 
|-
|<center>ID</center>||Unique model ID
+
| <center>A</center> || <center>ID</center> || integer || Unique object ID.
 
|-
 
|-
|<center>ModelName</center>||Name of the <code>.dff</code> ''model file'' without extension.
+
| <center>B</center> || <center>ModelName</center> || string || Name of the <code>.dff</code> [[model file]] without extension.
 
|-
 
|-
|<center>TxdName</center>||Name of the <code>.txd</code> ''texture dictionary'' without extension.
+
| <center>C</center> || <center>TextureName</center> || string || Name of the <code>.txd</code> [[texture dictionary]] without extension.
 
|-
 
|-
|<center>Type</center>||Type of vehicle, which includes ''car'', ''bike'', ''boat'', ''plane'', and ''heli''. Flyable helicopters are of type ''car''.
+
| <center>D</center> || <center>Type</center> || string || Type of vehicle, which includes ''car'', ''boat'', ''train'', ''heli'', ''plane'', and ''bike''. Flyable helicopters are of type ''car''.
 
|-
 
|-
|<center>HandlingID</center>||Name corresponding to its handling data in the ''handling.cfg'' file.
+
| <center>E</center> || <center>HandlingID</center> || string || Name corresponding to its handling data in the ''handling.cfg'' file.
 
|-
 
|-
|<center>GameName</center>||Name corresponding to its ''GXT'' entry, case sensitive and must be seven characters or less.<br>Invalid name will not show up in the game.
+
| <center>F</center> || <center>GameName</center> || string || Name corresponding to its ''GXT'' entry, case sensitive and must be seven characters or less.<br>Invalid name will not show up in the game.
 
|-
 
|-
|<center>Anims</center>||Appropriate animation file mainly used on bikes.
+
| <center>G</center> || <center>Anims</center> || string || Appropriate animation file mainly used on bikes.
 
|-
 
|-
|<center>Class</center>||Class of the vehicle (see [[CARS_(IDE_Section)#Vehicle_Classes|below]]).
+
| <center>H</center> || <center>Class</center> || string || Class of the vehicle (see [[CARS_(IDE_Section)#Vehicle_Classes|below]]).
 
|-
 
|-
|<center>Frequency</center>||Frequency of the vehicle spawning randomly on the streets.
+
| <center>I</center> || <center>Frequency</center> || integer || Frequency of the vehicle spawning randomly on the streets.
 
|-
 
|-
|<center>Level</center>||Unknown integer.
+
| <center>J</center> || <center>Level</center> || integer || unknown
 
|-
 
|-
|<center>Comprules</center>||Unknown hexadecimal value.
+
| <center>K</center> || <center>Comprules</center> || hex || unknown
 
|-
 
|-
|<center>WheelID</center>||ID number of wheel model<br>Only available for type ''car'', has no effect if used on type ''boat''.
+
| <center>L</center> || Type<br>''car'': WheelID<br>''boat'': unused<br>''train'': unused<br>''heli'': unused<br>''plane'': LODModel<br>''bike'': unknown || integer || <br>ID number of wheel model.<br>-<br>-<br>-<br>ID number of ''LOD'' model &ndash; can be any valid [[OBJS|object]].<br>unknown
 
|-
 
|-
|<center>WheelScale</center>||Scale of wheel and ''collision'' models for type ''car'', scale of wheel collision model for type ''bike'', 1.0 for original size of wheel and collision models<br>Only available for types ''car'' and ''bike'', has no effect if used on type ''boat''.
+
| <center>M</center> || Type<br>''car'': WheelScale<br>''boat'': unused<br>''train'': unused<br>''heli'': unused<br>''plane'': unused<br>''bike'': WheelScale || float || <br>Scale of wheel and collision models, 1.0 for original size of wheel and collision models<br>-<br>-<br>-<br>-<br>Scale of wheel collision model, 1.0 for original size of wheel and collision models
|-
 
|<center>LODModel</center>||ID number of ''LOD'' model &ndash; can be any valid [[OBJS|object]].<br>Only available for type ''plane''.
 
 
|}
 
|}
  

Revision as of 04:31, 22 January 2011

CARS redirects here. For the IPL section see CARS (IPL Section)
CARS (IDE section)
Supported games:GTA III, GTA VC, GTA SA, GTA IV
Brief description:Used to define vehicles
IDE Sections:
2DFX AMAT ANIM CARS HIER HAND MLO OBJS
PATH PEDS TANM TOBJ TREE TXDP WEAP

CARS is a section in the item definition file. It is used to define vehicles and some their properties.

Format

GTA III

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

Car

ID, ModelName, TxdName, Type, HandlingID, GameName, Class, Frequency, Level, Comprules, WheelID, WheelScale

Boat and Train

ID, ModelName, TxdName, Type, HandlingID, GameName, Class, Frequency, Level, Comprules

Plane

ID, ModelName, TxdName, Type, HandlingID, GameName, Class, Frequency, Level, Comprules, LODModel
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 car, boat, train, and plane
This data is related to hardcoded functions and must not be changed or else it might crash the game.
HandlingID
Name corresponding to its handling data in the handling.cfg file
GameName
Name corresponding to its GXT entry, case sensitive and must be seven characters or less!
Invalid name will show up as NAME missing
Class
Class of the vehicle (see below).
Frequency
Frequency of the vehicle spawning randomly on the streets.
Level
Unknown integer.
Comprules
Unknown hexadecimal value.
WheelID
ID number of wheel model
Only available for type car, has no effect if used on type boat.
WheelScale
Scale of wheel and collision models, 1.0 for original size of wheel and collision models
Only available for type car, has no effect if used on type boat.
LODModel
ID number of LOD model – can be any valid object.
Only available for type plane.

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. The following table shows the different wheels and their ID's.

ID 160 161 162 163 164 165 166
Image wheel_sport64 wheel_saloon64 wheel_lightvan64 wheel_classic64 wheel_alloy64 wheel_lighttruck64 wheel_smallcar64

Vice City

By default all cars are defined inside the ../data/default.ide file. Unlike GTA III there are the types bike and heli but train is missing or unused.

Identifier Type Description
A
ID
integer Unique object ID.
B
ModelName
string Name of the .dff model file without extension.
C
TextureName
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.
E
HandlingID
string Name corresponding to its handling data in the handling.cfg file.
F
GameName
string Name corresponding to its GXT entry, 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 (see below).
I
Frequency
integer Frequency of the vehicle spawning randomly on the streets.
J
Level
integer unknown
K
Comprules
hex unknown
L
Type
car: WheelID
boat: unused
train: unused
heli: unused
plane: LODModel
bike: unknown
integer
ID number of wheel model.
-
-
-
ID number of LOD model – can be any valid object.
unknown
M
Type
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 and collision models

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. The following table shows all Vice City wheels and their ID's.

ID 237 238 239 250 251 252 253 254 255 256
Image PC/PS2 wheel_rim wheel_offroad wheel_truck wheel_sport wheel_saloon wheel_lightvan wheel_classic wheel_alloy wheel_lighttruck wheel_smallcar
Xbox wheel_rim wheel_offroad wheel_truck wheel_sport wheel_saloon wheel_lightvan wheel_classic wheel_alloy wheel_lighttruck wheel_smallcar

San Andreas

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

Car

ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Flags, Comprules, WheelID, WheelScale_Front, WheelScale_Rear, Unknown_value
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 entry, 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
Frequency
Frequency of the vehicle spawning randomly on the streets.
Flags
Unknown integer.
Comprules
Unknown hexadecimal value.
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
Unknown value
Untested value. For most vehicles it is 0, or -1 regardless of Type.

For the Flash, Elegy, Stratum, Jester and Uranus this value is 1. For the Remington, Blade, Slamvan, Savanna, Broadway and Tornado this value is 2.

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

There is no documentation about the Comprules, however there are multiple vehicles, some specific to San Andreas, that have them set to non-zero values indicating use at least during one point in the games development.

Non-Zero Value Vehicle(s)
0x1012 Tram
0x1f10 Taxi, Barracks Ol, Coach, Cabbie, Slamvan
0x2ff0 Sabre, Comet, Savanna, Broadway, Tornado (related to convertibles?)
0x3012 Coast Guard
0x3210 Stallion
0x3f01 Reefer
0x3f10 Securicar
0x4fff Speeder, Tropic, Flatbed, Hotring Racer A, Hotring Racer B, Bloodring Banger, DFT30 (related to racing vehicles?)
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 still present, but no longer 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

This section is incomplete. You can help by fixing and expanding it.

Vehicle Classes

The class of a vehicle helps determines where a vehicle 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 a class of vehicle in the PEDS section of the IDE file. The following table shows the classes that are available and used in the game.

Flag Supported games Binary Description
0
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0000 0000
ignore
1
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0000 0001
normal
2
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0000 0010
poorfamily
4
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0000 0100
richfamily
8
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0000 1000
executive
16
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0001 0000
worker
32
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0010 0000
big
64
GTA III Vice City San Andreas GTA IV
0000 0000 0000 0000 0100 0000
taxi
128
Vice City San Andreas GTA IV
0000 0000 0000 0000 1000 0000
moped
256
Vice City San Andreas GTA IV
0000 0000 0000 0001 0000 0000
motorbike
512
Vice City San Andreas GTA IV
0000 0000 0000 0010 0000 0000
leisureboat
1024
Vice City San Andreas GTA IV
0000 0000 0000 0100 0000 0000
workerboat
2048
San Andreas GTA IV
0000 0000 0000 1000 0000 0000
bicycle
4096
San Andreas GTA IV
0000 0000 0001 0000 0000 0000
on foot

See also