Item Definition - Revision history

GTAKid667 at 23:12, 12 January 2021

2021-01-12T23:12:00Z

Squ1dd13: Format details (including details on internals)

2020-08-31T12:42:26Z

Format details (including details on internals)

Tomas. at 06:51, 31 May 2019

2019-05-31T06:51:31Z

Tomas. at 04:58, 13 January 2019

2019-01-13T04:58:14Z

DK22Pac: /* {{Icon|SA}} GTA San Andreas */

2017-12-17T13:59:38Z

‎{{Icon|SA}} GTA San Andreas

DK22Pac: /* {{Icon|VC}} GTA Vice City */

2017-12-17T12:25:29Z

‎{{Icon|VC}} GTA Vice City

DK22Pac: /* IDE Flags */

2017-12-16T23:25:59Z

‎IDE Flags

DK22Pac: /* IDE Flags */

2017-12-16T23:22:39Z

‎IDE Flags

DK22Pac: /* GTA San Andreas */

2017-12-16T14:03:04Z

‎GTA San Andreas

DK22Pac: /* GTA San Andreas */

2017-12-16T10:33:48Z

‎GTA San Andreas

@@ Line 299: / Line 299: @@
 * [http://gta-worldmods.t-n-network.de/forum/thread.php?threadid=3382 ID Flagvalue Decoding Project] - project to decode all missing flag values
-{{N|5|4|SA|VC|3}}
+{{N|V|IV|VCS|LCS|SA|VC|III}}
 [[Category:Map Formats]]

@@ Line 4: / Line 4: @@
 '''Item definition''' files, usually identified by the file extension <code>.ide</code>, are used to declare many different aspects for the map system or to specify special behaviour rules for one of the aspects.
-== Overview ==
+== Format ==
-The files are in plain text format so it can be opened with any text editor (like [[wikipedia:Microsoft Notepad|Notepad]]). The files are split up into several sections. There is no order on how you arrange the sections and sections do not need to appear in the file. Line comments are indicated by the character <code>#</code> (number sign) and empty lines are allowed. They can be placed anywhere in the file. The game reads up to a maximum of 256 characters for each line and ignores the rest if the line is longer. Each section starts with a section identifier (usually four characters long, e.g. <code>objs</code>, <code>tobj</code>, etc.) indicating how the content of the section gets interpreted by the game. The identifier is followed by the definition entries. Each entry takes up one line and follows a specific format which are described in the articles handling the sections in detail below. The end of any section is indicated by the terminating string <code>end</code>. Both the section identifier and terminating string are case sensitive. Lines within sections are always formatted in the same way differing only in the number of parameters describing the semantical content of the line. Data in each entry are usually separated by the character <code>,</code> (comma) but can be separated by <code> </code>&nbsp;(space). Extra tabs and spaces anywhere in the beginning of the line, between data, or after the data are omitted by the game and can be used to improve readability for human eyes. The games' parser uses an invariant culture to parse numerical values and strings, which means strings are [[Wikipedia:ASCII|ASCII]] encrypted and the decimal separator is <code>.</code> (period).
+The files are plain text, so they can be opened with text editors such as Notepad. They resemble [[wikipedia:Comma-separated_values|CSV files]], but with some extra features.
-=== Example ===
+<syntaxhighlight lang="tcl">
-{{Pre|
+section_name
-# line comment
+# ...
 end
-}}
+</syntaxhighlight>
-== Format ==
+=== Data ===
 The following table contains all known sections in the item definition. The supported games column lists games that support the sections but it doesn't necessarily means they're functional in the games.

@@ Line 232: / Line 232: @@
 | 22 || 4194304 || 0x400000 || IS_BREAKABLE_STATUE || Object with this model can't be used as cover, i.e. peds won't try to cover behind this object. || Statue parts in atrium
 |}
 == Difference between GTA III and GTA IV engines ==
-[[GTA IV]] not only uses different formats to the previous games, it also does not use IDs to identify objects anymore. While [[GTA 3|GTA III]] era games use an ID as an index inside an array of definitions, GTA IV uses the hashes of the model name as a key inside a hash table. For more information about this see [[Map System]].
+[[GTA IV]] not only uses different formats to the previous games, it also does not use IDs to identify objects anymore. While [[GTA 3|GTA III]] era games use an ID as an index inside an array of definitions, GTA IV uses the hashes of the model name as a key inside a hash table. For more information about this see [[Map system]].
 == Tools ==
@@ Line 248: / Line 251: @@
 * [[Item placement]]
-* [[Map System]]
+* [[Map system]]
 * [[Dynamic Object]]
 == References ==
-* {{note|2}} {{GTAF|post|102833|1067607073|Screenshots of flags in GTA III}}
+* {{note|1}} {{GTAF|post|102833|1067607073|Screenshots of flags in GTA III}}
 == External links ==

@@ Line 208: / Line 208: @@
 | 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || Breakable glass type 2: object first cracks on a strong collision, then it breaks (does also require object.dat registration). || Large windows
 |-
-| 11 || 2048 || 0x800 || IS_GARAGE_DOOR || Indicates an object as an garage door (for more information see GRGE requires object.dat registration). || Garage doors
+| 11 || 2048 || 0x800 || IS_GARAGE_DOOR || Indicates an object as an garage door (for more information see GRGE – requires object.dat registration). || Garage doors
 |-
 | 12 || 4096 || 0x1000 || IS_DAMAGABLE || Model with ok/dam states. || Vehicle upgrades, barriers
@@ Line 228: / Line 228: @@
 | 20 || 1048576 || 0x100000 || IS_TAG || This model is a tag. Object will switch from mesh 2 to mesh 1 after getting sprayed by the player. || Tags
 |-
-| 21 || 2097152 || 0x200000 || DISABLE_BACKFACE_CULLING || Disables backface culling as an result the texture will be drawed on both sides of the model. || Roads, houses, trees, vehicle parts
+| 21 || 2097152 || 0x200000 || DISABLE_BACKFACE_CULLING || Disables backface culling – as an result the texture will be drawed on both sides of the model. || Roads, houses, trees, vehicle parts
 |-
 | 22 || 4194304 || 0x400000 || IS_BREAKABLE_STATUE || Object with this model can't be used as cover, i.e. peds won't try to cover behind this object. || Statue parts in atrium

@@ Line 224: / Line 224: @@
 | 18 || 262144 || 0x40000 || - || Not read, but present in IDE files. || pleasure-DL.dff
 |-
-| 19 || 524288 || 0x80000 ||  || Unused special object type. Read, but not present in IDE files. || -
+| 19 || 524288 || 0x80000 || - || Unused special object type. Read, but not present in IDE files. || -
 |-
 | 20 || 1048576 || 0x100000 || IS_TAG || This model is a tag. Object will switch from mesh 2 to mesh 1 after getting sprayed by the player. || Tags

@@ Line 98: / Line 98: @@
 | 1 || 2 || 0x2 || DO_NOT_FADE || Do not fade the object when it is being loaded into or out of view. || Some night objects, North Point Mall
 |-
-| 2 || 4 || 0x4 || DRAW_LAST || Model is transparent. Render this object after all opaque objects, allowing transparencies of other objects to be visible through this object. || Fencse, trees
+| 2 || 4 || 0x4 || DRAW_LAST || Model is transparent. Render this object after all opaque objects, allowing transparencies of other objects to be visible through this object. || Fences, trees
 |-
 | 3 || 8 || 0x8 || ADDITIVE || Render with additive blending. Previous flag will be enabled automatically. || Night windows
@@ Line 108: / Line 108: @@
 | 6 || 64 || 0x40 || NO_ZBUFFER_WRITE || Model is a shadow. Disable writing to z-buffer when rendering it, allowing transparencies of other objects, shadows, and lights to be visible through this object. || Tree shadows
 |-
-| 7 || 128 || 0x80 || DONT_RECEIVE_SHADOWS || Do not draw shadows on this object. || Small objects, pickups, lamps, trees
+| 7 || 128 || 0x80 || DONT_RECEIVE_SHADOWS || Do not draw dynamic shadows on this object. || Small objects, pickups, lamps, trees
 |-
 | 8 || 256 || 0x100 || IGNORE_DRAW_DISTANCE || Ignore draw distance for this object (sets its "level" (island id) to 0). || LOD models, North Bridge

@@ Line 70: / Line 70: @@
 Flags are used in order to specify the behaviour of objects. They are interpreted as signed 32-bit integer values where each bit describes a [[wikipedia:Boolean_algebra_(logic)|boolean]] value of a different aspect.
-=== GTA III ===
+=== {{Icon|3}} GTA III ===
 {| class="wikitable"
 ! Bits !! Dec !! Hex !! Name !! Description !! Examples
@@ Line 89: / Line 89: @@
 |}
-=== GTA Vice City ===
+=== {{Icon|VC}} GTA Vice City ===
 {| class="wikitable"
@@ Line 181: / Line 181: @@
 |}
-=== GTA San Andreas ===
+=== {{Icon|SA}} GTA San Andreas ===
 {| class="wikitable"

@@ Line 68: / Line 68: @@
 == IDE Flags ==
-Flags are used in order to specify the behaviour of objects. They are interpreted as signed 32-bit integer values where each bit describes a [[wikipedia:Boolean_algebra_(logic)|boolean]] value of a different aspect. The following table shows the standard flags used for objects defined in <code>objs</code>, <code>tobj</code> and <code>anim</code> section.
+Flags are used in order to specify the behaviour of objects. They are interpreted as signed 32-bit integer values where each bit describes a [[wikipedia:Boolean_algebra_(logic)|boolean]] value of a different aspect.
 === GTA III ===
@@ Line 205: / Line 204: @@
 | 8 || 256 || 0x100 || - || Not read, not present in IDE files. || -
 |-
-| 9 || 512 || 0x200 || IS_GLASS_TYPE_1 || Breakable glass type 1: glass object changes its textures when breaking. || Small windows
+| 9 || 512 || 0x200 || IS_GLASS_TYPE_1 || Breakable glass type 1 (additional parameters defined inside the object.dat file, otherwise there is no effect) || Small windows
 |-
-| 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || Breakable glass type 2: glass object doesn't change its textures when breaking. || Large windows
+| 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || Breakable glass type 2: object first cracks on a strong collision, then it breaks (does also require object.dat registration). || Large windows
 |-
@@ Line 213: / Line 212: @@
 | 12 || 4096 || 0x1000 || IS_DAMAGABLE || Model with ok/dam states. || Vehicle upgrades, barriers
 |-
-| 13 || 8192 || 0x2000 || IS_TREE || Trees and some plants. || Trees, some plants
+| 13 || 8192 || 0x2000 || IS_TREE || Trees and some plants. These objects move on wind. || Trees, some plants
 |-
-| 14 || 16384 || 0x4000 || IS_PALM || Palms. || Palms
+| 14 || 16384 || 0x4000 || IS_PALM || Palms. These objects move on wind. || Palms
 |-
 | 15 || 32768 || 0x8000 || DOES_NOT_COLLIDE_WITH_FLYER || Does not collide with flyer (plane or heli). || Trees, street lights, traffic lights, road signs, telegraph pole

@@ Line 197: / Line 197: @@
 | 4 || 16 || 0x10 || - || Not read, not present in IDE files. || -
 |-
-| 5 || 32 || 0x20 ||  ||  || Doors
+| 5 || 32 || 0x20 ||  || Works only with animated objects ('anim' section in IDE). || Doors
 |-
 | 6 || 64 || 0x40 || NO_ZBUFFER_WRITE || Disable writing to z-buffer when rendering this model, allowing transparencies of other objects, shadows, and lights to be visible through this object. || Shadows, lights
@@ Line 213: / Line 213: @@
 | 12 || 4096 || 0x1000 || IS_DAMAGABLE || Model with ok/dam states. || Vehicle upgrades, barriers
 |-
-| 13 || 8192 || 0x2000 ||  ||  ||
+| 13 || 8192 || 0x2000 || IS_TREE || Trees and some plants. || Trees, some plants
 |-
-| 14 || 16384 || 0x4000 ||  ||  ||
+| 14 || 16384 || 0x4000 || IS_PALM || Palms. || Palms
 |-
-| 15 || 32768 || 0x8000 ||  ||  ||
+| 15 || 32768 || 0x8000 || DOES_NOT_COLLIDE_WITH_FLYER || Does not collide with flyer (plane or heli). || Trees, street lights, traffic lights, road signs, telegraph pole
 |-
 | 16 || 65536 || 0x10000 || - || Not read, but present in IDE files. || Explosive things
 |-
-| 17 || 131072 || 0x20000 || - || Not read, but present in IDE files. ||
+| 17 || 131072 || 0x20000 || - || Not read, but present in IDE files. || chopcop_ models
 |-
 | 18 || 262144 || 0x40000 || - || Not read, but present in IDE files. || pleasure-DL.dff
 |-
-| 19 || 524288 || 0x80000 ||  || Read, but not present in IDE files. || -
+| 19 || 524288 || 0x80000 ||  || Unused special object type. Read, but not present in IDE files. || -
 |-
 | 20 || 1048576 || 0x100000 || IS_TAG || This model is a tag. Object will switch from mesh 2 to mesh 1 after getting sprayed by the player. || Tags