12,236
edits
No edit summary |
(contributions from myself and Aschratt) |
||
Line 1: | Line 1: | ||
{{IdeSection | |||
|game = {{Icon-square|t}} {{Icon-square|4}} | |||
|description = Used to define timed map objects | |||
}} | |||
'''TOBJ''' is a section in the item definition file in [[Grand Theft Auto III]], [[Grand Theft Auto: Vice City]], [[Grand Theft Auto: San Andreas]], and [[Grand Theft Auto IV]]. It is used to define standard map objects similar to the [[OBJS]] section with an additional in-game time range defining when the object gets rendered. GTA IV also support time controlled objects linked to animations through the TANM section. Most, if not all, time objects use the object flag 2 to prevent them from fading into and out of view at those times. | |||
== Format == | |||
=== GTA III, GTA Vice City, and GTA San Andreas === | |||
<pre> | |||
tobj | |||
# type 1 (III/VC/SA) | |||
Id, ModelName, TxdName, MeshCount, DrawDistance, Flags, TimeOn, TimeOff | |||
# type 2 (III/VC/SA) | |||
Id, ModelName, TxdName, MeshCount, DrawDistance1, DrawDistance2, Flags, TimeOn, TimeOff | |||
# type 3 (III/VC/SA) | |||
Id, ModelName, TxdName, MeshCount, DrawDistance1, DrawDistance2, DrawDistance3, Flags, TimeOn, TimeOff | |||
# type 4 (SA) | |||
Id, ModelName, TxdName, DrawDistance, Flags, TimeOn, TimeOff | |||
end | |||
</pre> | |||
== | ====Type 0==== | ||
=== | This type should never be used but it is still considered valid. It is documented here for sake of completion. | ||
{|class="wikitable center-col-1 center-col-2" style="width: 100%;" | |||
!style="width: 4em;" |{{Icon-square|t}} | |||
!style="width: 12em;" |Identifier | |||
!style="width: 6em;" |Type | |||
!Description | |||
|- | |||
|A ||Id ||integer ||Unique object ID. | |||
|- | |||
|B ||ModelName ||string ||Name of the <code>.dff</code> model file without extension. | |||
|- | |||
|C ||TxdName ||string ||Name of the <code>.txd</code> texture dictionary without extension. | |||
|- | |||
|D ||''unknown'' ||integer ||''unknown'' | |||
|} | |||
=== | ====Type 1==== | ||
This is used for non-breakable objects. | |||
{|class="wikitable center-col-1 center-col-2" style="width: 100%;" | |||
!style="width: 4em;" |{{Icon-square|t}} | |||
!style="width: 12em;" |Identifier | |||
!style="width: 6em;" |Type | |||
!Description | |||
|- | |||
|A ||Id ||integer ||Unique object ID. | |||
|- | |||
|B ||ModelName ||string ||Name of the <code>.dff</code> model file without extension. | |||
|- | |||
|C ||TxdName ||string ||Name of the <code>.txd</code> texture dictionary without extension. | |||
|- | |||
|D ||MeshCount ||integer ||Number of meshes. 1 for this type. | |||
|- | |||
|E ||DrawDistance ||float ||Draw distance in [[unit]]s. | |||
|- | |||
|F ||Flags ||integer ||Object flags. | |||
|- | |||
|G ||TimeOn ||integer ||Hour to appear | |||
|- | |||
|H ||TimeOff ||integer ||Hour to disappear | |||
|} | |||
====Type 2==== | |||
This is used for breakable objects. | |||
{|class="wikitable center-col-1 center-col-2" style="width: 100%;" | |||
!style="width: 4em;" |{{Icon-square|t}} | |||
!style="width: 12em;" |Identifier | |||
!style="width: 6em;" |Type | |||
!Description | |||
|- | |||
|A ||Id ||integer ||Unique object ID. | |||
|- | |||
|B ||ModelName ||string ||Name of the <code>.dff</code> model file without extension. | |||
|- | |||
|C ||TxdName ||string ||Name of the <code>.txd</code> texture dictionary without extension. | |||
|- | |||
|D ||MeshCount ||integer ||Number of meshes. 2 for this type. | |||
|- | |||
|E,F ||DrawDistance1, DrawDistance2 ||float[2] ||Draw distance in [[unit]]s (one for each mesh, only the first is actually used). | |||
|- | |||
|G ||Flags ||integer ||Object flags. | |||
|- | |||
|H ||TimeOn ||integer ||Hour to appear | |||
|- | |||
|I ||TimeOff ||integer ||Hour to disappear | |||
|} | |||
====Type 3==== | |||
This is used for complex breakable objects. | |||
{|class="wikitable center-col-1 center-col-2" style="width: 100%;" | |||
!style="width: 4em;" |{{Icon-square|t}} | |||
!style="width: 12em;" |Identifier | |||
!style="width: 6em;" |Type | |||
!Description | |||
|- | |||
|A ||Id ||integer ||Unique object ID. | |||
|- | |||
|B ||ModelName ||string ||Name of the <code>.dff</code> model file without extension. | |||
|- | |||
|C ||TxdName ||string ||Name of the <code>.txd</code> texture dictionary without extension. | |||
|- | |||
|D ||MeshCount ||integer ||Number of meshes. 3 for this type. | |||
|- | |||
|E,F,G ||DrawDistance1, DrawDistance2, DrawDistance3 ||float[3] ||Draw distance in [[unit]]s (one for each mesh, only the first is actually used). | |||
|- | |||
|H ||Flags ||integer ||Object flags. | |||
|- | |||
|I ||TimeOn ||integer ||Hour to appear | |||
|- | |||
|J ||TimeOff ||integer ||Hour to disappear | |||
|} | |||
== | ====Type 4==== | ||
=== | This is used for non-breakable objects and behaves equivalently to [[#Type 1|Type 1]]. | ||
{|class="wikitable center-col-1 center-col-2" style="width: 100%;" | |||
!style="width: 3em;" |{{Icon-square|SA}} | |||
!style="width: 12em;" |Identifier | |||
!style="width: 6em;" |Type | |||
!Description | |||
|- | |||
|A ||Id ||integer ||Unique object ID. | |||
|- | |||
|B ||ModelName ||string ||Name of the <code>.dff</code> model file without extension. | |||
|- | |||
|C ||TxdName ||string ||Name of the <code>.txd</code> texture dictionary without extension. | |||
|- | |||
|D ||DrawDistance ||float ||Draw distance in [[unit]]s. | |||
|- | |||
|E ||Flags ||integer ||Object flags. | |||
|- | |||
|F ||TimeOn ||integer ||Hour to appear | |||
|- | |||
|G ||TimeOff ||integer ||Hour to disappear | |||
|} | |||
=== GTA IV === | === GTA IV === | ||
<pre> | |||
tobj | |||
ModelName, TxdName, DrawDistance, Flags, Unknown, MinX, MinY, MinZ, MaxX, MaxY, MaxZ, SphereX, SphereY, SphereZ, Radius, LODModel, NightFlag | |||
end | |||
</pre> | |||
== | {|class="wikitable center-col-1 center-col-2" style="width: 100%;" | ||
!style="width: 3em;" |{{Icon-square|4}} | |||
!style="width: 12em;" |Identifier | |||
!style="width: 6em;" |Type | |||
!Description | |||
|- | |||
|A ||ModelName ||string ||Name of the <code>.wdr</code> ''model file'' without extension. | |||
|- | |||
|B ||TxdName ||string ||name of the <code>.wtd</code> ''texture dictionary'' without extension. | |||
|- | |||
|C ||DrawDistance ||float ||Draw distance in units. | |||
|- | |||
|D ||Flags ||integer ||Object flag. | |||
|- | |||
|E ||''unknown'' ||float ||Unknown integer (0 by default). | |||
|- | |||
|F,G,H ||MinX, MinY, MinZ ||float[3] ||Lower left corner of the bounding box for the object. | |||
|- | |||
|I,J,K ||MaxX, MaxY, MaxZ ||float[3] ||Upper right corner of the bounding box for the object. | |||
|- | |||
|L,M,N ||SphereX, SphereY, SphereZ ||float[3] ||Center of the bounding sphere for the object. | |||
|- | |||
|O ||Radius ||float ||Radius of the bounding sphere into all dimensions. | |||
|- | |||
|P ||LODModel||string ||Name of the <code>.wdd</code> file that contains the ''lod model'' for the defined modelname. | |||
|- | |||
|Q ||NightFlag||integer ||If enabled (1) the object only shows at nighttime, otherwise the object gets only rendered at daytime. Day- and nighttimes are hardcoded. | |||
|} | |||
== | == Statistics == | ||
Total number of TOBJ entries in: | |||
:GTA III: 24 (max 30) | |||
:Vice City: 342 (max 385) | |||
:San Andreas: 160 | |||
{{ | {{fdl}} | ||
{{modding}} | |||
[[Category:GTA III Modifications]] | |||
[[Category:GTA Vice City]] | |||
{{ | [[Category:Modifications]] | ||
[[Category: | |||
[[Category: | |||
[[Category: |