Item placement files, usually identified by the file extension
.ipl, are a part of the map system and used to create and place (for example) different objects, zones of special behaviour or paths in the world. All games support standard item placement files which are mostly stored in plain text format that can be opened and edited using any text-editing program (like Notepad), but there are tools to simplify editing. San Andreas is the first game to introduce a binary format for item placement files. Most of the placement information in GTA IV is stored inside of binary files (see WPL).
- See also: Item Definition § Overview
The structure and format of the plain text item placement files are similar to that of the item definition files.
San Andreas introduced an simple binary format of item placement files. They are stored as "streaming files" inside the archive files. Editing them requires an special editor (see below). The format is pretty simple and their possibilities are not completely used by Rockstar. By default they do only support
cars sections. It is unconfirmed if other sections also can be used or if they are just stubs which are not implemented. Anyway their binary format is completely unknown.
This section is incomplete. You can help by it.
Each binary placement information file starts with an 4-Byte identifier followed by a header containing information about the files content.
4b - CHAR - Always "bnry" 4b - INT32 - Number of item instances 4b - INT32 - Number of unknown 1 (CULL ?) 4b - INT32 - Number of unknown 2 (GRGE ?) 4b - INT32 - Number of unknown 3 (ENEX ?) 4b - INT32 - Number of parked cars 4b - INT32 - Number of unknown 4 (PICK ?) 4b - INT32 - Offset of item instances (0x4C by default) 4b - INT32 - Size of item instances (unused - always 0) 4b - INT32 - Offset of unknown 1 4b - INT32 - Size of unknown 1 (unused - always 0) 4b - INT32 - Offset of unknown 2 4b - INT32 - Size of unknown 2 (unused - always 0) 4b - INT32 - Offset of unknown 3 4b - INT32 - Size of unknown 3 (unused - always 0) 4b - INT32 - Offset of parked cars 4b - INT32 - Size of parked cars (unused - always 0) 4b - INT32 - Offset of unknown 4 4b - INT32 - Size of unknown 4 (unused - always 0)
The header is followed by the arrays of the entries. For more information about their format see the articles about the sections.
Loading a Custom Binary IPL
There are few minor differences between a normal
.ipl and a binary
.ipl.The object name becomes dummy and decimal values are 5.
15072, PLS_carpark, 0, 2579.8796445, 645.50208432, 9.93, 0, 0, 0, 1, -1
15072, dummy, 0, 2579.87964, 645.50208, 9.93000, 0, 0, 0, 1, -1
Now for converting a normal
.ipl to binary form and vice-versa,we can use fastman92-processor.Its a pretty simple program we can get most of the work done by editing the
fastman92_processor.bat(Or can use Binary (De-)Compiler).
After converting to binary form we have to create a normal
.ipl file and index it in Gta.dat.Suppose the name of our
So the name of our binary
.ipl would be as below,
test_stream0.ipl test_stream1.ipl test_stream2.ipl ... etc
Then we'll need to import them in any of the IMG Archives.Finished.
For a detailed tutorial see here.
The following table contains all known sections in the item placement. The supported games column lists games that support the sections but it doesn't necessarily means they're functional in the games.
||Places objects defined in |
||Creates map, navigation, and info zones.|
||Creates zones with special attributes.|
||Creates pickups. This section is only functional in San Andreas.|
||Creates waypoints for random NPC spawns.|
Note: this section is also present in San Andreas and GTA IV. It is used as a base for Rockstar's paths compiler, but gets ignored by the games. For more information see: Paths.
||Creates occlusion zones.|
||This section is not functional.|
||Creates entry-exit markers.|
||Creates car generators (parked cars).|
||Creates stunt jumps. This section is not functional in GTA IV.|
||Creates time cycles modifiers.|
||Creates audio zones. This section is not functional in GTA IV.|
||Extended format of |
||This section is not functional. Appears to be used to allocate responsibilities during the development stage of GTA IV, but also could be used to place decision makers.|
||Used to make many game effects, for example - Particle.|
||Unknown for what it is responsible, used very rare and only in two extended .WPL. Section contains a box.|
- KEd – By JernejL
- MEd – By Tonywob
- GTAForums: IPL Helper – By Xmen
- Binary (De-)Compiler – By ocram88
- GTAForums: SA Binary IPL Exporter for 3DS Max – by Gforce
- fastman92processor – By fastman92
- GTAForums: GTA3/VC Map File Documentation and Troubleshooting - Topic by Opius covering general features of IPL files in GTA3 and GTA VC.
- GTAForums: GTA SA IPL Documentation - Topic by spaceeinstein covering details of the IPL format in GTA SA.
|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 • Image listing • Map Listing • Native functions • Paths • 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||Gostown IV • Four Multiplayer • IV Multiplayer|
|Grand Theft Auto: Vice City|
|File Formats||.adf • .b • .col • .cfg • .dff • .dat • .gxt • .ide • .ifp • .img/.dir • .ipl • .raw/.sdt • .rep • .set • .scm • .txd|
|Documentation||Audio • Handling • Map Listing • Opcodes • RenderWare • Script Paths • Saves • Sound Effects • Statistics • Vehicles • Wanted levels • Weapons|
|Tools||CLEO • Collision File Editor II • G-Tools • GXT Editor • IMG Tool • Limit Adjuster • KEd (map editor) • Sanny Builder • TXD Workshop • Magic.TXD|
|Tutorials||How to create a mission • How to create a script • Vehicle Mod Installation|
|Multiplayer||GTA:LC Multiplayer • gtaTournament • Multi Theft Auto • State Of Liberty Online • Vice City Multiplayer • Vice City Online|
|Grand Theft Auto III|
|File Formats||.b • .col • .cfg • .dff • .dat • .gxt • .ide • .ifp • .img • .ipl • .raw/.sdt • .set • .scm • .txd|
|Documentation||Audio • Handling.cfg • Map Listing • Opcodes • Paths • RenderWare • Saves • Sound Effects • Statistics • Vehicles • Wanted levels • Weapons|
|Tools||CLEO • Collision File Editor II • G-Tools • IMG Tool • Map Editor • Sanny Builder • TXD Workshop • Magic.TXD • Water Editor|
|Tutorials||How to create a mission • How to create a script • How to use Map Editor • Vehicle Mod Installation|