Item Definition - Revision history

Spaceeinstein: contributions from myself, Aschratt, DK22Pac, MarioSonic2987, Solom, and The Hero

2018-07-21T14:43:32Z

contributions from myself, Aschratt, DK22Pac, MarioSonic2987, Solom, and The Hero

Spaceeinstein: Spaceeinstein moved page IDE to Item Definition over redirect

2018-07-21T04:14:49Z

Spaceeinstein moved page IDE to Item Definition over redirect

← Older revision	Revision as of 04:14, 21 July 2018
(No difference)

Spaceeinstein: corrections to overview

2018-07-14T14:08:51Z

corrections to overview

← Older revision		Revision as of 14:08, 14 July 2018
Line 1:		Line 1:
	~~: ''Main page at [http://www.gtamodding.com/index.php?title=Item_Definition GTAModding.com]''~~
	{{IdeSection		{{IdeSection
	\| noheader = 1		\| noheader = 1
Line 7:		Line 6:

	== Overview ==		== Overview ==
	The ''item definition'' files are split up into several sections. There is no order on how you arrange the sections~~. Also you~~ do not need to ~~use all~~ the ~~sections in a~~ file.		The ''item definition'' 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.

	=== Format and syntax description ===		=== Format and syntax description ===
	The basic structure of the different sections is pretty simple. Each section starts with a four-character section identifier indicating how the content of the section gets interpreted by the game. The identifier is followed by the definition entries. Each entry takes one line and every line follows certain rules which are described in the articles handling the sections in detail (see below). However, lines can also be empty or commented. If so, they get ignored by the games' parser. The end of every section are indicated by the terminating string "end". Both (section identifier and terminating string) are not case sensitive, but by default they are written in lower case.

	~~Comments~~ are ~~usually~~ indicated by the character <code>#</code> (number sign). ~~It is possible to add comments~~ to the ~~end of~~ a ~~line~~, ~~but breaking~~ the ~~line format for~~ the ~~current~~ section ~~using comments may cause~~ the game ~~to crash during loading~~. It is ~~recommended that~~ a ~~comment be placed on a separate~~ line. ~~Comments~~ can ~~also~~ be ~~placed outside~~ of ~~sections~~.		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 one line and every line follows a specific format which are described in the articles handling the sections in detail (see 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 are usually separated by the character <code>,</code> (comma) but can be separated by <code> </code> (space). 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).

	Lines itself are always formatted in the same way differing only in the number of their parameters describing the semantical content of the line. Parameters are usually separated by the character <code>,</code> (comma). [[wp:Whitespace character\|Whitespace characters]] at the beginning or the end of an parameter get trimmed, but they are usually used to give the content a more clear structure to make it more easier to read for humans. Strings can be encased by the character <code>"</code> (quotation mark), but this is optional and rarely used by default. Also 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).		==== Example ====
			{{Pre\|
	==== ~~Section example~~ ====		# line comment
	objs		objs
	~~...~~		# default style in objs section
	end		200, ind_land101, pjs, 1, 127, 0
			# valid style
			200 ind_land101 pjs 1 127 0
			end
			}}

	==~~= Sections =~~==		== Format ==
	The following table contains basic information about all known sections. For additional information read the articles itself.		The following table contains basic information about all known sections. For additional information read the articles itself.

Rage1651 at 01:42, 27 April 2015

2015-04-27T01:42:59Z

What changes will this make?

A-Dust at 22:48, 19 February 2011

2011-02-19T22:48:32Z

← Older revision		Revision as of 22:48, 19 February 2011
Line 103:		Line 103:
	\|<center>131072</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0000 0010 0000 0000 0000 0000</code></center>\|\|Unknown – apparently some flag for the [[SCM\|Script]].		\|<center>131072</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0000 0010 0000 0000 0000 0000</code></center>\|\|Unknown – apparently some flag for the [[SCM\|Script]].
	\|-		\|-
	\|<center>262144</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0000 0100 0000 0000 0000 0000</code></center>\|\|Unknown – only used 1 time in [[~~GTA SA~~\|San Andreas]].		\|<center>262144</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0000 0100 0000 0000 0000 0000</code></center>\|\|Unknown – only used 1 time in [[Grand Theft Auto: San Andreas\|San Andreas]].
	\|-		\|-
	\|<center>1048576</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0000 1000 0000 0000 0000 0000</code></center>\|\|Object will switch from clump ''2'' to clump ''1'' after getting sprayed by the player (graffity flag).		\|<center>1048576</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0000 1000 0000 0000 0000 0000</code></center>\|\|Object will switch from clump ''2'' to clump ''1'' after getting sprayed by the player (graffity flag).
	\|-		\|-
	\|<center>2097152</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0001 0000 0000 0000 0000 0000</code></center>\|\|Disables backface culling – as an result the texture will be drawed on both sides of the model (Always enabled for GTA III and [[~~GTA VC~~\|Vice City]])		\|<center>2097152</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0001 0000 0000 0000 0000 0000</code></center>\|\|Disables backface culling – as an result the texture will be drawed on both sides of the model (Always enabled for GTA III and [[Grand Theft Auto: Vice City\|Vice City]])
	\|-		\|-
	\|<center>4194304</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0010 0000 0000 0000 0000 0000</code></center>\|\|Unknown – apparently related into physics.		\|<center>4194304</center>\|\|<center>{{Icon\|SA}}</center>\|\|<center><code>0010 0000 0000 0000 0000 0000</code></center>\|\|Unknown – apparently related into physics.
Line 118:		Line 118:
	== Difference between GTA III and GTA IV engines ==		== 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]].		[[Grand Theft Auto IV]] not only uses different formats to the previous games, it also does not use IDs to identify objects anymore. While [[Grand Theft Auto 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 ==		== Tools ==

Spaceeinstein at 15:41, 14 December 2010

2010-12-14T15:41:37Z

← Older revision		Revision as of 15:41, 14 December 2010
Line 1:		Line 1:
			:''Main page at [http://www.gtamodding.com/index.php?title=Item_Definition GTAModding.com]''
	{{IdeSection		{{IdeSection
	\| noheader = 1		\| noheader = 1

Spaceeinstein: copied from gtamodding

2010-12-14T15:39:50Z

copied from gtamodding

What changes will this make?

Gta-mysteries: /* OBJS */

2010-03-08T08:01:53Z

OBJS

← Older revision		Revision as of 08:01, 8 March 2010
Line 426:		Line 426:
	ModelName, TextureName, DrawDistance, Flag1, Flag2, (Bounds min)X, Y, Z, (Bounds max)X, Y, Z, (Bounds Sphere)X,Y,Z, Radius, WDD		ModelName, TextureName, DrawDistance, Flag1, Flag2, (Bounds min)X, Y, Z, (Bounds max)X, Y, Z, (Bounds Sphere)X,Y,Z, Radius, WDD

	;ModelName: name of the .wdr [[model file]], without extension (string)		;ModelName: name of the .wdr [[Model File\|model file]], without extension (string)
	;TextureName: set to 'null' by default in procobj.ide		;TextureName: set to 'null' by default in procobj.ide
	;DrawDistance: [[draw distance]] in [[unit]]s, one for each sub object (float)		;DrawDistance: [[draw distance]] in [[unit]]s, one for each sub object (float)

Gboyers: moved Item Definition to IDE

2010-01-24T01:52:09Z

moved Item Definition to IDE

← Older revision	Revision as of 01:52, 24 January 2010
(No difference)

Gboyers at 01:51, 24 January 2010

2010-01-24T01:51:23Z

← Older revision		Revision as of 01:51, 24 January 2010
Line 19:		Line 19:
	ID, ModelName, TextureName, ObjectCount, DrawDist, [DrawDist2, ...], Flags		ID, ModelName, TextureName, ObjectCount, DrawDist, [DrawDist2, ...], Flags

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 42:		Line 42:
	Note that GTA IV does not use any unique object ID numbers		Note that GTA IV does not use any unique object ID numbers

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 71:		Line 71:
	ID, ModelName, TextureName, ObjectCount, DrawDist, [DrawDist2, ...], Flags, TimeOn, TimeOff		ID, ModelName, TextureName, ObjectCount, DrawDist, [DrawDist2, ...], Flags, TimeOn, TimeOff

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 98:		Line 98:
	Note that GTA IV does not use any unique object ID numbers.		Note that GTA IV does not use any unique object ID numbers.

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 145:		Line 145:
	ID, ModelName, TxdName, Threat, Behavior, AnimationType, VehClass		ID, ModelName, TxdName, Threat, Behavior, AnimationType, VehClass

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 167:		Line 167:
	ID, ModelName, TxdName, Threat, Behavior, AnimationType, VehClass, StartAnimation?, Radio1, Radio2		ID, ModelName, TxdName, Threat, Behavior, AnimationType, VehClass, StartAnimation?, Radio1, Radio2

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 207:		Line 207:
	ID, ModelName, TxdName, Type, HandlingID, GameName, Class, Frequency, Level, Comprules, LODModel		ID, ModelName, TxdName, Type, HandlingID, GameName, Class, Frequency, Level, Comprules, LODModel

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 252:		Line 252:
	ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Level, Comprules, LODModel		ID, ModelName, TxdName, Type, HandlingID, GameName, Anims, Class, Frequency, Level, Comprules, LODModel

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 312:		Line 312:
	ID, X, Y, Z, R, G, B, unknown (0 or 200), 1, Corona, Shadow, Distance, Outer range, Size, Inner range, IDE flag, Wet, Flare, Dust		ID, X, Y, Z, R, G, B, unknown (0 or 200), 1, Corona, Shadow, Distance, Outer range, Size, Inner range, IDE flag, Wet, Flare, Dust

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 348:		Line 348:
	ID, X, Y, Z, R, G, B, unknown (63 or 200), 2, Particle, unk1, unk2, unk3, Size		ID, X, Y, Z, R, G, B, unknown (63 or 200), 2, Particle, unk1, unk2, unk3, Size

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 366:		Line 366:
	ID, X, Y, Z, R, G, B, unknown (200), 3, Behavior, unk1, unk2, unk3, RotX, RotY, RotZ		ID, X, Y, Z, R, G, B, unknown (200), 3, Behavior, unk1, unk2, unk3, RotX, RotY, RotZ

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 386:		Line 386:
	ID, X, Y, Z, R, G, B, unknown (120), 4		ID, X, Y, Z, R, G, B, unknown (120), 4

	{\|~~class="prettytable"~~ width="100%" class="collapsible collapsed"		{\| width="100%" class="prettytable collapsible collapsed"
	!width="250px"\|Identifier		!width="250px"\|Identifier
	!Description		!Description
Line 447:		Line 447:


	~~[[Category:Map Formats]][[Category:GTA III Modifications]][[Category:GTA Vice City]]~~{{fdl}}		{{fdl}}
	~~[[Category:Modifications]]~~

	{{modding}}		{{modding}}
			[[Category:Map Formats]]
			[[Category:GTA III Modifications]]
			[[Category:GTA Vice City]]
			[[Category:Modifications]]