Difference between revisions of "CARS (IPL Section)"

From GTAMods Wiki
Jump to navigation Jump to search
(Binary format)
m (Binary format)
Line 47: Line 47:
 
  4b  - INT32    - Primary color
 
  4b  - INT32    - Primary color
 
  4b  - INT32    - Secundary color
 
  4b  - INT32    - Secundary color
  4b  - INT32    - Force spawn (Windows BOOL &ndash see ''<code>WinDef.h</code>'')
+
  4b  - INT32    - Force spawn (Windows BOOL - see ''<code>WinDef.h</code>'')
 
  4b  - INT32    - Alarm propability
 
  4b  - INT32    - Alarm propability
 
  4b  - INT32    - Locked propability
 
  4b  - INT32    - Locked propability

Revision as of 09:18, 27 July 2010

This article describes the usage of the CARS section inside a plain text IPL. For the definition of vehicle models see CARS (IDE Section)
CARS (IPL section)
Short description:Creates a parked car generator
Supported games:GTA SA, GTA IV
IPL Sections:
2DFX AUZO BLOK CARS CULL ENEX GRGE
INST JUMP LINK LODM MLO+ MULT OCCL
PATH PICK RTFX SLOW TCYC VNOD ZONE

CARS is a section in the item placement file introduced in San Andreas. This section is a simplified method to create parked cars. Usually parked cars are created by the scripts, but just as unique stunt jumps they can be written inside plain text or binary IPLs. Since parked car generators are related to savegames[1] a new game must be started before they are applied to the game. It is possible to create parked car generators without starting a new game using CLEO[2].

Format

CARS or parked car generators are used to place permanently, randomly or limited cars which are placed (parked) around the world. For this they need a position, a rotation, information about which car should be placed, the car's colors and some additional information.

San Andreas

PosX, PosY, PosZ, Angle, CarID, PrimCol, SecCol, ForceSpawn, Alarm, DoorLock, Unknown1, Unknown2
Identifier Description
PosX, PosY, PosZ
The real world coordinates of the car as floating point values.
Angle
The angle of the car in radians (degrees/~57.2958).
CarID
The ID number of the car as defined in the IDE or -1 for random car parks (influenced by the popcycle.dat file)
PrimCol, SecCol
A car color defined in the carcols.dat file. If it is set to -1 the color will be randomly choosed.
ForceSpawn
Vehicles spawn more reliably if this is set to 1.
Alarm
The probability of triggering the alarm system (0 - 100).
DoorLock
The probability that the doors of the vehicle is locked (0 - 100).
Unknown1, Unknown2
Unknown (Zero).

Binary format

CARS is one of the known sections which can be used in binary format inside streaming files. It's format is similar to the plain text format:

4b  - FLOAT    - Position X
4b  - FLOAT    - Position Y
4b  - FLOAT    - Position Z
4b  - FLOAT    - Angle (Around Z-Axis)
4b  - INT32    - Object ID (an index to an vehicle definition)
4b  - INT32    - Primary color
4b  - INT32    - Secundary color
4b  - INT32    - Force spawn (Windows BOOL - see WinDef.h)
4b  - INT32    - Alarm propability
4b  - INT32    - Locked propability
4b  - INT32    - Unknown1 (Could be tertiery color)
4b  - INT32    - Unknown2 (Could be quarternery color)

GTA IV

Scripts

Opcodes

  • 014B – Creates a parked car generator in SCM
  • 014C – Sets the flags for the parked car generator.
  • 09E2 – Creates a parked car generator where the car has a special numplate text.
  • 0A17 – Sets a parked car generator as owned by the player

Native functions

References

^ San Andreas Car generators in save files
^ San Andreas Creating a parked car generator via scripts.

External link