Object.dat - Revision history

Squ1dd13: Forgot to change FX info names too

2020-08-21T14:13:26Z

Forgot to change FX info names too

Squ1dd13: Switched to alternative names for optional break info

2020-08-21T14:11:23Z

Switched to alternative names for optional break info

Squ1dd13: Removed stub template

2020-08-19T16:06:22Z

Removed stub template

Squ1dd13: Stuff I forgot last time

2020-08-19T16:04:44Z

Stuff I forgot last time

Squ1dd13: Added all descriptions. Still not sure about table formatting...

2020-08-19T15:55:50Z

Added all descriptions. Still not sure about table formatting...

Spaceeinstein: format

2017-09-12T04:20:37Z

format

Spaceeinstein: Spaceeinstein moved page Dynamic Object to Object.dat over redirect

2017-09-12T03:48:04Z

Spaceeinstein moved page Dynamic Object to Object.dat over redirect

Aschratt at 08:55, 13 August 2009

2009-08-13T08:55:21Z

Seemann at 09:04, 27 March 2009

2009-03-27T09:04:41Z

Aschratt at 18:15, 18 February 2009

2009-02-18T18:15:20Z

@@ Line 68: / Line 68: @@
 |colspan="2" |K ||Camera to avoid this object ||integer || Boolean (written as 1 or 0, not true/false) that controls whether the camera should move around the object.
 |-
-| ||L ||{{a|c}} |Causes Explosion ||integer || If not 0, <code>FX_NAME</code> should be a valid effect name. 0 if no explosion effect should occur.
+| ||L ||{{a|c}} |Causes Explosion ||integer || If not 0, ''Name of FxSystem'' should be a valid effect name. 0 if no explosion effect should occur.
 |-
-| ||M ||{{a|c}} |FX_TYPE ||integer ||When the explosion effect should be played. Values:
+| ||M ||{{a|c}} |Type of FxSystem ||integer ||When the explosion effect should be played. Values:
 :<code>0</code> = No effect
@@ Line 81: / Line 81: @@
 |-
-| ||N,O,P ||{{a|c}} |FX_OFFSET ||float[3] ||3D vector. Offset of the effect system from the pivot of the object. If <code>x == -999.0</code>, the game plays the effect at the point of collision.
+| ||N,O,P ||{{a|c}} |Offset of FxSystem ||float[3] ||3D vector. Offset of the effect system from the pivot of the object. If <code>x == -999.0</code>, the game plays the effect at the point of collision.
 |-
-| ||Q ||{{a|c}} |FX_NAME ||string || The name of the effect to play. If there is no effect, <code>none</code> should be used. (The file says it should be <code>noname</code>, but <code>none</code> is used instead. <code>noname</code> is never used.)
+| ||Q ||{{a|c}} |Name of FxSystem ||string || The name of the effect to play. If there is no effect, <code>none</code> should be used. (The file says it should be <code>noname</code>, but <code>none</code> is used instead. <code>noname</code> is never used.)
 |-
 |colspan="5" |<h3>Extra breakable object information</h3>
@@ Line 100: / Line 100: @@
 | ||U ||{{a|c}} |Break Velocity Z ||float ||Offset velocity on Z axis.
 |-
-| ||V ||{{a|c}} |Break Velocity Rand ||float ||The maximum deviation from the B-VX/Y/Z values due to randomness.
+| ||V ||{{a|c}} |Break Velocity Rand ||float ||The maximum deviation from the velocity X/Y/Z values due to randomness.
 |-
 | ||W ||{{a|c}} |Gun Break Mode ||integer || Object behaviour when shot with a gun. Values:

@@ Line 87: / Line 87: @@
 |colspan="5" |<h3>Extra breakable object information</h3>
 |-
-| ||R ||{{a|c}} |B-SM ||float ||How much larger the force needed to smash an object should be than the force needed to break it. In code:
+| ||R ||{{a|c}} |Smash Multiplier ||float ||How much larger the force needed to smash an object should be than the force needed to break it. In code:
-<code>smashForce = B_SM * breakForce</code>
+<code>smashForce = smashMultiplier * breakForce</code>
 Smashing always takes precedence over breaking so if <code>smashForce == breakForce</code>, the object will smash and not break.
@@ Line 94: / Line 94: @@
 To prevent the object smashing, set a very large value so that it is impossible for the player to achieve the required smash force.
 |-
-| ||S ||{{a|c}} |B-VX ||float ||Offset velocity on X axis. Offset values are added to the velocity from the impact after randomness is factored in.
+| ||S ||{{a|c}} |Break Velocity X ||float ||Offset velocity on X axis. Offset values are added to the velocity from the impact after randomness is factored in.
 |-
-| ||T ||{{a|c}} |B-VY ||float ||Offset velocity on Y axis.
+| ||T ||{{a|c}} |Break Velocity Y ||float ||Offset velocity on Y axis.
 |-
-| ||U ||{{a|c}} |B-VZ ||float ||Offset velocity on Z axis.
+| ||U ||{{a|c}} |Break Velocity Z ||float ||Offset velocity on Z axis.
 |-
-| ||V ||{{a|c}} |B-VR ||float ||The maximum deviation from the B-VX/Y/Z values due to randomness.
+| ||V ||{{a|c}} |Break Velocity Rand ||float ||The maximum deviation from the B-VX/Y/Z values due to randomness.
 |-
-| ||W ||{{a|c}} |B-GUN ||integer || Object behaviour when shot with a gun. Values:
+| ||W ||{{a|c}} |Gun Break Mode ||integer || Object behaviour when shot with a gun. Values:
 :<code>0</code> = Immune to gun damage
@@ Line 111: / Line 111: @@
 |-
-| ||X ||{{a|c}} |B_SPK ||integer ||Whether sparks are produced on impact (1) or not (0).
+| ||X ||{{a|c}} |Produce Sparks on Impact ||integer ||Whether sparks are produced on impact (1) or not (0).
 |}
 [[Category:Map Formats]]
 {{N|4|SA|VC|3}}

← Older revision		Revision as of 16:06, 19 August 2020
Line 1:		Line 1:
−	{{file-stub}}	+	<!-- I don't think {{file-stub}} applies anymore -->{{lowercase}}
−	{{lowercase}}
	The '''<code>object.dat</code>''' file is located in the <code>/data</code> directory of [[GTA III]], [[Vice City]], and [[San Andreas]], or the <code>/common/data</code> directory of [[GTA IV]]. It defines the physical aspects of objects defined in [[IDE]] files.		The '''<code>object.dat</code>''' file is located in the <code>/data</code> directory of [[GTA III]], [[Vice City]], and [[San Andreas]], or the <code>/common/data</code> directory of [[GTA IV]]. It defines the physical aspects of objects defined in [[IDE]] files.

@@ Line 40: / Line 40: @@
 :<code>202</code> = Breaks and does not get regenerated when the area is reloaded
 |-
@@ Line 82: / Line 84: @@
 | ||N,O,P ||{{a|c}} |FX_OFFSET ||float[3] ||3D vector. Offset of the effect system from the pivot of the object. If <code>x == -999.0</code>, the game plays the effect at the point of collision.
 |-
-| ||Q ||{{a|c}} |FX_NAME ||string || The name of the effect to play.
+| ||Q ||{{a|c}} |FX_NAME ||string || The name of the effect to play. If there is no effect, <code>none</code> should be used. (The file says it should be <code>noname</code>, but <code>none</code> is used instead. <code>noname</code> is never used.)
 |-
 | ||R ||{{a|c}} |B-SM ||float ||How much larger the force needed to smash an object should be than the force needed to break it. In code:

@@ Line 1: / Line 1: @@
 {{file-stub}}
 {{lowercase}}
-The '''<code>object.dat</code>''' file is located in the <code>.\data</code> directory of [[GTA III]], [[Vice City]], and [[San Andreas]], or the <code>.\common\data</code> directory of [[GTA IV]]. It allows objects defined in an [[IDE]] file to be dynamic and able to interact with the environment.
+The '''<code>object.dat</code>''' file is located in the <code>/data</code> directory of [[GTA III]], [[Vice City]], and [[San Andreas]], or the <code>/common/data</code> directory of [[GTA IV]]. It defines the physical aspects of objects defined in [[IDE]] files.
 == Format ==
-Documentation of the format already exists within the file itself.
+{|class="wikitable center-col-1 center-col-2 center-col-3" style="width: 100%;"
 !style="width: 3em;" |{{Icon|3}} {{Icon|VC}}
 !style="width: 3em;" |{{Icon|SA}}
-!style="width: 12em;" |Identifier
+!style="width: 12em;" |Name in file
-!style="width: 6em;" |Type
+!style="width: 6em;" |Data type
 !Description
 |-
-|colspan="2" |A ||Object name ||string ||
+|colspan="2" |A ||Object name ||string || Object name. Maximum of 256 characters in length.
 |-
-|colspan="2" |B ||Mass ||float ||
+|colspan="2" |B ||Mass ||float || 1 to 50000 inclusive. Unit is kilograms.
 |-
-|colspan="2" |C ||TurnMass ||float ||
+|colspan="2" |C ||TurnMass ||float || The description within the file says ''kg m^3 or some such dimension'', but kg/m<sup>3</sup> is actually the [[Wikipedia:Kilogram per cubic metre|unit of density]]. However, kg/m<sup>2</sup> is the unit of [[Wikipedia:Moment of inertia|rotational inertia]], which is sometimes referred to as "rotational mass" (and could be what "TurnMass" is referring to).
 |-
-|colspan="2" |D ||Air Resistance ||float ||
+|colspan="2" |D ||Air Resistance ||float || Normalised between 1 and 0. 0 means complete air resistance, 1 means no air resistance. Most objects have a value of 0.99 for this attribute.
 |-
-|colspan="2" |E ||Elasticity ||float ||
+|colspan="2" |E ||Elasticity ||float || How much the object bounces when it collides with something. Normalised. 0 is the least bouncy, 1 is the most.
 |-
-|colspan="2" |F ||Percent Submerged ||float ||
+|colspan="2" |F ||Percent Submerged ||float || 10 to 120. Most objects have a value of 50.0 for this attribute.
 |-
-|colspan="2" |G ||Uproot Limit ||float ||
+|colspan="2" |G ||Uproot Force ||float || The magnitude of the force vector that must be applied to the object to remove it from the ground. Possibly Newtons, but no units given.
 |-
-|colspan="2" |H ||Collision Damage Multiplier ||float ||
+|colspan="2" |H ||Collision Damage Multiplier ||float || Controls how much damage a collision with this object should do to vehicles. "0.1 - 5.0 ish" according to the file.
 |-
-|colspan="2" |I ||Collision Damage Effect ||integer ||
+|colspan="2" |I ||Collision Damage Effect ||integer || What happens to the object when it is collided with. Values:
 |-
-|colspan="2" |J ||Special Collision Response Cases ||integer ||
+|colspan="2" |J ||Special Collision Response Cases ||integer || Specifies if the game has a custom response for collisions with this object, and what the response should be if there is one. Values:
 |-
-|colspan="2" |K ||Camera to avoid this object ||integer ||
+|colspan="2" |K ||Camera to avoid this object ||integer || Boolean (written as 1 or 0, not true/false) that controls whether the camera should move around the object.
 |-
-| ||L ||{{a|c}} |Causes Explosion ||integer ||
+| ||L ||{{a|c}} |Causes Explosion ||integer || If not 0, <code>FX_NAME</code> should be a valid effect name. 0 if no explosion effect should occur.
 |-
-| ||M ||{{a|c}} |FX_TYPE ||integer ||
+| ||M ||{{a|c}} |FX_TYPE ||integer ||When the explosion effect should be played. Values:
 |-
-| ||N,O,P ||{{a|c}} |FX_OFFSET ||float[3] ||
+| ||N,O,P ||{{a|c}} |FX_OFFSET ||float[3] ||3D vector. Offset of the effect system from the pivot of the object. If <code>x == -999.0</code>, the game plays the effect at the point of collision.
 |-
-| ||Q ||{{a|c}} |FX_NAME ||string ||
+| ||Q ||{{a|c}} |FX_NAME ||string || The name of the effect to play.
 |-
-| ||R ||{{a|c}} |B-SM ||float ||
+| ||R ||{{a|c}} |B-SM ||float ||How much larger the force needed to smash an object should be than the force needed to break it. In code:
 |-
-| ||S ||{{a|c}} |B-VX ||float ||
+| ||S ||{{a|c}} |B-VX ||float ||Offset velocity on X axis. Offset values are added to the velocity from the impact after randomness is factored in.
 |-
-| ||T ||{{a|c}} |B-VY ||float ||
+| ||T ||{{a|c}} |B-VY ||float ||Offset velocity on Y axis.
 |-
-| ||U ||{{a|c}} |B-VZ ||float ||
+| ||U ||{{a|c}} |B-VZ ||float ||Offset velocity on Z axis.
 |-
-| ||V ||{{a|c}} |B-VR ||float ||
+| ||V ||{{a|c}} |B-VR ||float ||The maximum deviation from the B-VX/Y/Z values due to randomness.
 |-
-| ||W ||{{a|c}} |B-GUN ||integer ||
+| ||W ||{{a|c}} |B-GUN ||integer || Object behaviour when shot with a gun. Values:
 |-
-| ||X ||{{a|c}} |B_SPK ||integer ||
+| ||X ||{{a|c}} |B_SPK ||integer ||Whether sparks are produced on impact (1) or not (0).
 |}
 [[Category:Map Formats]]
 {{N|4|SA|VC|3}}

← Older revision	Revision as of 03:48, 12 September 2017
(No difference)

@@ Line 1: / Line 1: @@
 '''Dynamic objects''' are defined in the <code>object.dat</code> file. They must be defined in an [[IDE]] file first. With additionally defining them in the <code>object.dat</code> file they will have special abilities. Dynamic objects are used to create objects which are able to interact with their environment. For example they are able to explode or open when the player approaches them ([[Garage|garage doors]]).
 {{N|4|SA}}
 [[Category:Map_Formats]]

← Older revision		Revision as of 18:15, 18 February 2009
Line 6:		Line 6:

	{{SA-navi}}		{{SA-navi}}
		+	{{GTA4-navi}}