Difference between revisions of "CARS (IPL Section)"
m |
|||
(17 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | {{This| | + | {{This|This article describes the usage of the CARS section inside a plain text [[IPL]]. For the [[Item Definition|definition]] of vehicle models see [[CARS (IDE Section)]]}} |
{{IplSection | {{IplSection | ||
− | |game = | + | |name = CARS |
− | |description = Creates a | + | |game = {{Icon|SA}} {{Icon|4}} |
+ | |description = Creates a parked car generator | ||
}} | }} | ||
− | + | '''CARS''' is a section in the [[item placement]] file in [[San Andreas]] and [[GTA IV]]. This section is a simplified method to create parked cars. Usually parked cars are created by the [[script]]s, but just as [[JUMP|unique stunt jumps]] they can be written inside plain text or [[binary IPL]]s. Since parked car generators are related to [[savegame]]s{{ref|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]].{{ref|2}} | |
− | |||
== Format == | == Format == | ||
− | ''CARS'' | + | ''CARS'' is used to place car generators (parked cars) permanently, randomly or limited, around the game 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 === |
+ | <pre<includeonly></includeonly> style="overflow-x: auto;"> | ||
+ | cars | ||
+ | PosX, PosY, PosZ, Angle, CarID, PrimCol, SecCol, ForceSpawn, Alarm, DoorLock, Unknown1, Unknown2 | ||
+ | end | ||
+ | </pre> | ||
− | + | {|class="wikitable center-col-1" style="width: 100%;" | |
− | + | !style="width: 12em;"|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 <code>[[popcycle.dat]]</code> file) | ||
+ | |- | ||
+ | |PrimCol, SecCol||A car color defined in the <code>[[carcols.dat]]</code> file. If it is set to -1 the color will be randomly chosen. | ||
+ | |- | ||
+ | |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 ==== | ==== 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 [[CARS_(IDE_Section)|vehicle definition]]) | ||
+ | 4b - INT32 - Primary color | ||
+ | 4b - INT32 - Secondary color | ||
+ | 4b - INT32 - Force spawn (Windows BOOL - see ''<code>WinDef.h</code>'') | ||
+ | 4b - INT32 - Alarm probability | ||
+ | 4b - INT32 - Locked probability | ||
+ | 4b - INT32 - Unknown1 (Could be tertiary color) | ||
+ | 4b - INT32 - Unknown2 (Could be quarterdeck color) | ||
=== GTA IV === | === GTA IV === | ||
Line 24: | Line 60: | ||
{{Research}} | {{Research}} | ||
− | == | + | == References == |
− | + | {{note|1}} {{Icon|SA}} [[Saves_(GTA_SA)#Block_12:_Car_Generators|Car generators in save files]]<br> | |
− | + | {{note|2}} {{Icon|SA}} [[Spawn a vehicle#... car generator opcode|Creating a parked car generator]] via scripts. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | == External link == | |
− | |||
− | |||
− | ==External | ||
* {{GTAF|202532|Documentation of San Andreas IPL file format}} | * {{GTAF|202532|Documentation of San Andreas IPL file format}} | ||
{{N|4|SA}} | {{N|4|SA}} | ||
− | |||
− |
Latest revision as of 20:48, 12 December 2015
Short description: | Creates a parked car generator | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Supported games: | ||||||||||||||||||||||
IPL Sections:
|
CARS is a section in the item placement file in San Andreas and GTA IV. 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 is used to place car generators (parked cars) permanently, randomly or limited, around the game 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
cars PosX, PosY, PosZ, Angle, CarID, PrimCol, SecCol, ForceSpawn, Alarm, DoorLock, Unknown1, Unknown2 end
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 chosen.
|
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 - Secondary color
4b - INT32 - Force spawn (Windows BOOL - see WinDef.h
)
4b - INT32 - Alarm probability
4b - INT32 - Locked probability
4b - INT32 - Unknown1 (Could be tertiary color)
4b - INT32 - Unknown2 (Could be quarterdeck color)
GTA IV
References
^ Car generators in save files
^ Creating a parked car generator via scripts.
External link
- GTAForums: Documentation of San Andreas IPL file format
Grand Theft Auto IV | |
---|---|
File Formats | .dat • .gxt • .ide • .img • .ipl • .nod • .sco • .rpf • .rrr • .wad • .wbd/.wbn • .wdd • .wdr • .wft • .whm • .wpl • .wtd |
Documentation | Audio • Bink Video • Cryptography • Cutscenes • GXT Text • Image listing • Keycodes • Map Listing • Native functions • Paths • Radar Blips • Radio Stations • Saves • Scenarios • VTable • Weapons |
Tools | ASI Loader • ENBSeries • G-Texture • GIMS IV • Ingame WPL Editor • IV Needle • OpenIV • SparkIV • XLiveLess • WPL Manager • X Mod Installer Alice • C++ Script Hook • .NET Script Hook • Scocl |
Tutorials | Importing Textures with OpenIV • Importing Textures with SparkIV |
Modifications | GTA Connected • Gostown IV • Four Multiplayer • IV Multiplayer • CitizenMP:IV Reloaded |
Useful links | Community portal • Discussion forums • Modding forums • Mods on GTAGarage.com |