GTAMods Wiki - User contributions [en]

Item Definition

2019-05-31T06:51:31Z

Tomas.:

{{IdeSection
| noheader = 1
}}
'''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 ==
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> (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).

=== Example ===
{{Pre|
# line comment
objs
# default style in objs section
200, ind_land101, pjs, 1, 127, 0
# valid style
200 ind_land101 pjs 1 127 0 # unread data
end
}}

== Format ==

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.

{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 7em;"|Section
!style="width: 8em;"|Supported games
!Description
|-
|<code>[[OBJS|objs]]</code>||{{Icon|t}} {{Icon|4}}||Defines simple objects. They can be placed into the world through the <code>[[INST|inst]]</code> section of the [[IPL|item placement files]].
|-
|<code>[[TOBJ|tobj]]</code>||{{Icon|t}} {{Icon|4}}||Defines time objects. The section functions similarly to <code>objs</code> but has two additional parameters defining the in-game time range the object can get rendered. These objects can be placed into the world through the <code>inst</code> section of the item placement files.
|-
|<code>[[HIER|hier]]</code>||{{Icon|t}} {{Icon|4}}||Defines clump objects for use in cutscenes.
|-
|<code>[[CARS (IDE Section)|cars]]</code>||{{Icon|t}} {{Icon|4}}||Defines vehicle objects.
|-
|<code>[[PEDS|peds]]</code>||{{Icon|t}} {{Icon|4}}||Defines pedestrian objects (random [[wikipedia:Non-player character|NPC's]]).
|-
|<code>[[PATH (IDE Section)|path]]</code>||{{Icon|3}} {{Icon|VC|16||Vice City (unstable)}} {{Icon|SA}}||Adds path nodes to defined objects. This section is unstable in Vice City.
|-
|<code>[[2DFX|2dfx]]</code>||{{Icon|t}} {{Icon|4}}||Adds particle effects and simple ped behaviors to defined objects.
|-
|<code>[[WEAP|weap]]</code>||{{Icon|VC}} {{Icon|SA}} {{Icon|4}}||Defines weapon objects.
|-
|<code>[[ANIM|anim]]</code>||{{Icon|SA}} {{Icon|4}}||Defines animated objects. The section functions similarly to <code>objs</code> but has one additional parameter indicating an [[IFP]] or [[WAD]] animation file to assign an animation to the object. These objects can be placed into the world through the <code>inst</code> section of the item placement files.
|-
|<code>[[TXDP|txdp]]</code>||{{Icon|SA}} {{Icon|4}}||Used to virtually extend [[TXD|texture dictionaries]].
|-
|<code>[[TANM|tanm]]</code>||{{Icon|4}}||Used to combine <code>tobj</code> and <code>anim</code> sections.<br>Those objects get placed inside the <code>inst</code> section of the ''WPL''.
|-
|<code>[[TREE|tree]]</code>||{{Icon|4|16||GTA IV (not functional)}}||This section is not functional.
|-
|<code>[[VNOD|vnod]]</code>||{{Icon|4}}||–
|-
|<code>[[LINK|link]]</code>||{{Icon|4}}||–
|-
|<code>[[MLO|mlo]]</code>||{{Icon|4}}||Used to create [[interior]]s. This section does also contain information about portals (previous <code>[[ENEX|enex]]</code> connections) and dimensions of the interior which influences certain aspects, like the weather, for example. All objects are placed relative to an offset placed using <code>[[MLO+|mlo+]]</code> inside the [[IPL]] or [[WPL]] file.
|-
|<code>[[AMAT|amat]]</code>||{{Icon|4}}||This is Audio Materials. Possible Used to make a sound effect at the model. Usually used for dynamic objects.
|-
|<code>[[LODM|lodm]]</code>||{{Icon|4|16||GTA IV (not functional)}}||This section is not functional.
|-
|<code>[[AGRPS|agrps]]</code>||{{Icon|4}}||–
|-
|<code>[[HAND|hand]]</code>||VC Xbox/Mobile||–
|}

== 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.

=== {{Icon|3}} GTA III ===
{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Description !! Examples
|-
| 0 || 1 || 0x1 || - || Cull model if player doesn't look at it? Read, but ignored. || Fences
|-
| 1 || 2{{ref|1}} || 0x2 || DO_NOT_FADE || Do not fade the object when it is being loaded into or out of view. || Some lampposts
|-
| 2 || 4{{ref|1}} || 0x4 || DRAW_LAST || Model is transparent. Render this object after all opaque objects, allowing transparencies of other objects to be visible through this object. || Trees
|-
| 3 || 8 || 0x8 || ADDITIVE || Render with additive blending. Previous flag must be enabled too. ||
|-
| 4 || 16{{ref|1}} || 0x10 || IS_SUBWAY || Model is a tunnel, i.e. set the object as invisible unless the player enters [[Cullzone.dat|cull zone flag 128]]. This flag works only with static models. || Tunnels, some dynamic objects
|-
| 5 || 32 || 0x20 || IGNORE_LIGHTING || Don't use static lighting, we want dynamic if it's possible. || Some lampposts and trafficlights
|-
| 6 || 64{{ref|1}} || 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. Not implemented in the PS2 version. || Shadow
|}

=== {{Icon|VC}} GTA Vice City ===

{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Description !! Examples
|-
| 0 || 1 || 0x1 || IS_ROAD || Identifies objects to draw "wet reflections" on them. || Roads
|-
| 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. || Fences, trees
|-
| 3 || 8 || 0x8 || ADDITIVE || Render with additive blending. Previous flag will be enabled automatically. || Night windows
|-
| 4 || 16 || 0x10 || - || Read, but not used. || _dy, _dt objects
|-
| 5 || 32 || 0x20 || IGNORE_LIGHTING || Don't use static lighting, we want dynamic if it's possible. || Interior objects
|-
| 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 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
|-
| 9 || 512 || 0x200 || IS_GLASS_TYPE_1 || Breakable glass type 1: glass object changes its textures when breaking. || Small windows
|-
| 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || Breakable glass type 2: glass object doesn't change its textures when breaking. || Large windows
|}

==== Reference table ====

{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Model info flag !! Ref address !! Ref description
|-
| 0 || 1 || 0x1 || IS_ROAD || 0x04 || 0x4CA1D7 || <font face="Consolas"><b>CRenderer::RenderRoads()</b></font>
<source lang="cpp">if (CModelInfo::GetModelInfo(entity->m_nModelIndex)->m_nFlags & IS_ROAD)
entity->Render();</source>
|-
| 1 || 2 || 0x2 || DO_NOT_FADE || 0x20 || 0x4C7E03 || <font face="Consolas"><b>CRenderer::ShouldModelBeStreamed(CEntity *,CVector const&)</b></font>
<source lang="cpp">if (model->m_nFlags & DO_NOT_FADE) {
if (distance >= model->GetLargestLodDistance() + 30.0f)
return true;
}
else if ( distance >= model->GetLargestLodDistance() + 50.0f)
return true;</source>
|-
| 2 || 4 || 0x4 || DRAW_LAST || 0x40 || 0x56F4F3 || <font face="Consolas"><b>CSimpleModelInfo::SetupBigBuilding(int,int)</b></font>
<source lang="cpp">if (model->m_nFlags & DRAW_LAST) {
model->m_nFlags &= ~DRAW_LAST;
dbgprint("%s was draw last\n", model->m_szName);
}</source>
|-
| 3 || 8 || 0x8 || ADDITIVE || 0x80 || 0x582590 || <font face="Consolas"><b>CVisibilityPlugins::RenderFadingAtomic(RpAtomic *,float)</b></font>
<source lang="cpp">if (model->m_nFlags & ADDITIVE)
RwRenderStateSet(rwRENDERSTATEDESTBLEND, rwBLENDONE);</source>
|-
| 4 || 16 || 0x10 || - || 0x100 || - || -
|-
| 5 || 32 || 0x20 || IGNORE_LIGHTING || 0x200 || 0x56F7C4 || <font face="Consolas"><b>CSimpleModelInfo::SetAtomic(int,RpAtomic *)</b></font>
<source lang="cpp">if (model->m_nFlags & IGNORE_LIGHTING)
atomic->geometry->flags &= ~rpGEOMETRYLIGHT;</source>
|-
| 6 || 64 || 0x40 || NO_ZBUFFER_WRITE || 0x400 || 0x581390 || <font face="Consolas"><b>CVisibilityPlugins::RenderFadingEntities(CLinkList<CVisibilityPlugins::AlphaObjectInfo> &)</b></font>
<source lang="cpp">if (model->m_nType == MODEL_INFO_SIMPLE && model->m_nFlags & NO_ZBUFFER_WRITE)
RwRenderStateSet(rwRENDERSTATEZWRITEENABLE, FALSE);</source>
|-
| 7 || 128 || 0x80 || DONT_RECEIVE_SHADOWS || 0x800 || 0x48AF21 || <font face="Consolas"><b>CFileLoader::LoadObjectInstance(char const*)</b></font>
<source lang="cpp">if (model->m_nFlags & DONT_RECEIVE_SHADOWS)
entity->m_nFlags.bDontCastShadowsOn = true;</source>
|-
| 8 || 256 || 0x100 || IGNORE_DRAW_DISTANCE || 0x1000 || 0x487CDE || <font face="Consolas"><b>CEntity::SetupBigBuilding()</b></font>
<source lang="cpp">if (model->m_afLodDistances[0] > 2500.0f || model->m_nFlags & IGNORE_DRAW_DISTANCE)
entity->m_nLevel = 0;</source>
|-
| 9 || 512 || 0x200 || IS_GLASS_TYPE_1 || 0x2000 || 0x488CCD || <font face="Consolas"><b>CEntity::PreRender()</b>, probably in-lined <b>CModelInfo::IsGlassModel(int)</b> @0x488CAA</font>
<source lang="cpp">bool CModelInfo::IsGlassModel(int modelId) {
CBaseModelInfo *model = CModelInfo::GetModelInfo(modelId);
if (model->m_nType == MODEL_INFO_SIMPLE || model->m_nType == MODEL_INFO_TIME) {
CSimpleModelInfo *simpleModel = reinterpret_cast<CSimpleModelInfo *>(model);
return simpleModel->m_nFlags & IS_GLASS_TYPE_1 || simpleModel->m_nFlags & IS_GLASS_TYPE_2;
}
return false;
}</source>
|-
| 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || 0x4000 || 0x488CE7 || <font face="Consolas"><b>CEntity::PreRender()</b></font>
<source lang="cpp">if (CModelInfo::IsGlassModel(modelId)) {
if (!(CModelInfo::GetModelInfo(modelId)->m_nFlags & IS_GLASS_TYPE_2) ) {
CGlass::AskForObjectToBeRenderedInGlass(entity);
entity->m_nFlags.bIsVisible = false;
}
}</source>
|}

=== {{Icon|SA}} GTA San Andreas ===

{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Description !! Examples
|-
| 0 || 1 || 0x1 || IS_ROAD || This model is a road. || Roads
|-
| 1 || 2 || 0x2 || - || Not read, but present in IDE files. ||
|-
| 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
|-
| 4 || 16 || 0x10 || - || Not read, not present in IDE files. || -
|-
| 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
|-
| 7 || 128 || 0x80 || DONT_RECEIVE_SHADOWS || Do not draw shadows on this object. || Small objects, pickups, lamps, trees
|-
| 8 || 256 || 0x100 || - || Not read, not present in IDE files. || -
|-
| 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: 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
|-
| 12 || 4096 || 0x1000 || IS_DAMAGABLE || Model with ok/dam states. || Vehicle upgrades, barriers
|-
| 13 || 8192 || 0x2000 || IS_TREE || Trees and some plants. These objects move on wind. || Trees, some plants
|-
| 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
|-
| 16 || 65536 || 0x10000 || - || Not read, but present in IDE files. || Explosive things
|-
| 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 || - || 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
|-
| 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
|}

=== {{Icon|4}} GTA IV ===
{{Incomplete}}

== 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]].

== Tools ==

* [[KEd]] – By {{U|JernejL}}
* [[MEd]] – By {{U|Tonywob}}
* {{GTAG|4817|IDEditor}} – By {{U|Xmen}}
* {{GTAF|402942|IDE-IV in GTA-IV script centre}} – by {{U|Gforce}}
* [http://www.aschratt.com/fileview.php?file=1004 FlagValue Calculator] – By {{U|Aschratt}} - Calculates all flagvalues (even those unknown).

== See also ==

* [[Item placement]]
* [[Map system]]
* [[Dynamic Object]]

== References ==

* {{note|1}} {{GTAF|post|102833|1067607073|Screenshots of flags in GTA III}}

== External links ==

* {{GTAF|102833|GTAVC IDE Definitions}} - topic by {{U|ODIE}} covering specific details of IDE files in GTA VC
* {{GTAF|118193|GTA3/VC Map File Documentation and Troubleshooting}} - topic by {{U|Opius}} covering general features of IDE files in GTA3 and GTA VC
* [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}}

[[Category:Map Formats]]

ANIM

2019-05-31T06:51:28Z

Tomas.:

{{IdeSection
| game = {{Icon|SA}} {{Icon|4}}
| description = Used to define animated map objects
}}
'''ANIM''' is a section in the [[item definition]] file in [[San Andreas]] and [[GTA IV]]. It is used to define standard map objects linked to an animation. Its format is almost exactly like [[OBJS|standard map objects]] but with one additional parameter for the animation file. [[GTA IV]] added a section ([[TANM]]) that supports time controlled objects linked to animations.

== Format ==

=== San Andreas ===
{{Pre|
anim
Id, ModelName, TxdName, AnimationName, DrawDistance, Flags
end
}}

{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
! style="width: 3em;"| {{Icon|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 || AnimationName || string || Name of the <code>.ifp</code> [[animation file]] without extension.
|-
| E || DrawDistance || float || [[Draw distance]] in [[unit]]s.
|-
| F || Flags || integer || [[Item Definition#IDE Flags|Object flags]]
|}

Note that animated models still have static [[COL|collisions]]. This means that the collision do not animate with the model since it does not contain bone information for the animation. If you want to move objects, you can do this using the [[SCM|script]]. {{ref|1}}

=== GTA IV ===
{{Pre|
anim
ModelName, TxdName, AnimationName, DrawDistance, Flag, unknown, MinX, MinY, MinZ, MaxX, MaxY, MaxZ, SphereX, SphereY, SphereZ, Radius, LODModel
end
}}

{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
! style="width: 3em;"| {{Icon|4}}
! style="width: 12em;"| Identifier
! style="width: 6em;" | Type
! Description
|-
| A || ModelName || string || Name of the <code>[[WDR|.wdr]]</code> model file without extension.
|-
| B || TxdName || string || Name of the <code>[[WTD|.wtd]]</code> texture dictionary without extension.
|-
| C || AnimationName || string || Name of the <code>[[WAD|.wad]]</code> animation file without extension.
|-
| D || DrawDistance || float || Draw distance in units.
|-
| E || Flag || integer || [[Item Definition#IDE Flags|Object flag]]
|-
| F || ''unknown'' || float || Unknown integer (0 by default).
|-
| G,H,I || MinX, MinY, MinZ || float[3] || Lower left corner of the bounding box for the object.
|-
| J,K,L || MaxX, MaxY, MaxZ || float[3] || Upper right corner of the bounding box for the object.
|-
| M,N,O || SphereX, SphereY, SphereZ || float[3] || Center of the bounding sphere for the object.
|-
| P || Radius || float || Radius of the bounding sphere into all dimensions.
|-
| Q || LODModel || string || Name of the <code>[[WDD|.wdd]]</code> file that contains the ''lod model'' for the defined modelname.
|}

== Statistics ==
Total number of ANIM entries in:
:San Andreas: 54
:GTA IV: 158

== References ==

* {{note|1}} [[Move an object]]

== See also ==

* [[Item definition]]
* [[OBJS]]
* [[TANM]]

{{N|4|SA}}

TOBJ

2019-05-31T06:51:26Z

Tomas.:

{{IdeSection
|game = {{Icon|t}} {{Icon|LCS}} {{Icon|4}}
|description = Defines timed map objects
}}
'''<code>tobj</code>''' is a section in the [[item definition]] file in [[GTA III]], [[Vice City]], [[San Andreas]], [[Liberty City Stories]], and [[GTA IV]]. It is used to define standard map objects similar to the <code>[[OBJS|objs]]</code> 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 <code>[[TANM|tanm]]</code> section. Most, if not all, time objects use the [[Item Definition#IDE Flags|object flag]] 2 to prevent them from fading into and out of view at those times.

== Format ==
=== GTA III – Liberty City Stories ===
{{Pre|
tobj
# [[#Type 1|type 1]] (III/VC/SA/LCS)
Id, ModelName, TxdName, MeshCount, DrawDistance, Flags, TimeOn, TimeOff
# [[#Type 2|type 2]] (III/VC/SA/LCS)
Id, ModelName, TxdName, MeshCount, DrawDistance1, DrawDistance2, Flags, TimeOn, TimeOff
# [[#Type 3|type 3]] (III/VC/SA/LCS)
Id, ModelName, TxdName, MeshCount, DrawDistance1, DrawDistance2, DrawDistance3, Flags, TimeOn, TimeOff
# [[#Type 4|type 4]] (SA)
Id, ModelName, TxdName, DrawDistance, Flags, TimeOn, TimeOff
end
}}

====Type 1====
This is used for non-breakable objects.
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 3em;" |{{Icon|3}} {{Icon|VC}}<br>{{Icon|SA}} {{Icon|LCS}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[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 ||[[Item Definition#IDE Flags|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: 3em;" |{{Icon|3}} {{Icon|VC}}<br>{{Icon|SA}} {{Icon|LCS}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[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 ||[[Item Definition#IDE Flags|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: 3em;" |{{Icon|3}} {{Icon|VC}}<br>{{Icon|SA}} {{Icon|LCS}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[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 ||[[Item Definition#IDE Flags|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|SA}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[texture dictionary]] without extension.
|-
|D ||DrawDistance ||float ||[[Draw distance]] in [[unit]]s.
|-
|E ||Flags ||integer ||[[Item Definition#IDE Flags|Object flags]]
|-
|F ||TimeOn ||integer ||Hour to appear
|-
|G ||TimeOff ||integer ||Hour to disappear
|}

=== GTA IV ===
{{Pre|
tobj
ModelName, TxdName, DrawDistance, Flags, Unknown, MinX, MinY, MinZ, MaxX, MaxY, MaxZ, SphereX, SphereY, SphereZ, Radius, LODModel, NightFlag
end
}}

{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 3em;" |{{Icon|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 ||[[Item Definition#IDE Flags|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|.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 <code>tobj</code> entries in:
:GTA III: 24 (max 30)
:Vice City: 342 (max 385)
:San Andreas: 160

{{N|4|LCS|SA|VC|3}}
[[Category:GTA LCS]]

OBJS

2019-05-31T06:51:24Z

Tomas.:

{{IdeSection
|game = {{Icon|t}} {{Icon|LCS}} {{Icon|4}}
|description = Defines simple objects
}}
'''<code>objs</code>''' is a section in the [[item definition]] file in [[GTA III]], [[Vice City]], [[San Andreas]], [[Liberty City Stories]], and [[GTA IV]]. It is used to define simple objects. There are also sections to extend default object definitions:

* <code>[[TOBJ|tobj]]</code> for defining an additional in-game time range the object gets rendered in.
* <code>[[ANIM|anim]]</code> which links an animation to an object.
* <code>[[TANM|tanm]]</code> which does both of the previously mentioned sections.

== Format ==
=== GTA III – Liberty City Stories ===
{{Pre|
objs
# [[#Type 1|type 1]] (III/VC/SA/LCS)
Id, ModelName, TxdName, MeshCount, DrawDistance, Flags
# [[#Type 2|type 2]] (III/VC/SA/LCS)
Id, ModelName, TxdName, MeshCount, DrawDistance1, DrawDistance2, Flags
# [[#Type 3|type 3]] (III/VC/SA/LCS)
Id, ModelName, TxdName, MeshCount, DrawDistance1, DrawDistance2, DrawDistance3, Flags
# [[#Type 4|type 4]] (SA)
Id, ModelName, TxdName, DrawDistance, Flags
end
}}

====Type 1====
This is used for non-breakable objects.
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 3em;" |{{Icon|3}} {{Icon|VC}}<br>{{Icon|SA}} {{Icon|LCS}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[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 ||[[Item Definition#IDE Flags|Object flags]]
|}

====Type 2====
This is used for breakable objects.
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 3em;" |{{Icon|3}} {{Icon|VC}}<br>{{Icon|SA}} {{Icon|LCS}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[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 ||[[Item Definition#IDE Flags|Object flags]]
|}

====Type 3====
This is used for complex breakable objects.
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 3em;" |{{Icon|3}} {{Icon|VC}}<br>{{Icon|SA}} {{Icon|LCS}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[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 ||[[Item Definition#IDE Flags|Object flags]]
|}

====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|SA}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||Id ||integer ||Unique object identifier.
|-
|B ||ModelName ||string ||Name of the [[model file]] without extension.
|-
|C ||TxdName ||string ||Name of the [[texture dictionary]] without extension.
|-
|D ||DrawDistance ||float ||[[Draw distance]] in [[unit]]s.
|-
|E ||Flags ||integer ||[[Item Definition#IDE Flags|Object flags]]
|}

=== GTA IV ===
{{Pre|
objs
ModelName, TxdName, DrawDistance, Flag, unknown, MinX, MinY, MinZ, MaxX, MaxY, MaxZ, SphereX, SphereY, SphereZ, Radius, LODModel
end
}}
==== Type 1 ====
{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 3em;" |{{Icon|4}}
!style="width: 12em;" |Identifier
!style="width: 6em;" |Type
!Description
|-
|A ||ModelName ||string ||Name of the <code>[[WDR|.wdr]]</code> model file without extension.
|-
|B ||TxdName ||string ||Name of the <code>[[WTD|.wtd]]</code> texture dictionary without extension.
|-
|C ||DrawDistance ||float ||Draw distance in units.
|-
|D ||Flag ||integer ||[[Item Definition#IDE Flags|Object flag]]
|-
|E ||''unknown'' ||float ||Unknown integer (usually 0 but uses other values as high as 32).
|-
|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|.wdd]]</code> file that contains the ''lod model'' for the defined modelname; otherwise ''null''.
|}

[[GTA IV]] stores bounding information inside the ''item definitions'' for better performance. The previous games stored bounding information inside the [[COLL|collision]] files. Also it uses the hashes of the model names as a key of an hash table instead of the ID as an index to the definition array for previous games.

== Statistics ==
Total number of <code>objs</code> entries in:
:GTA III: 2908 (max 5000)
::Type 1: 2844
::Type 2: 63
::Type 3: 1

:Vice City: 3800 (max 3885)
::Type 1: 3761
::Type 2: 38
::Type 3: 1

:San Andreas: 14052
::Type 1: 1
::Type 4: 14051

:GTA IV: 24820

{{N|4|LCS|SA|VC|3}}
[[Category:GTA LCS]]

Material Effects PLG (RW Section)

2019-02-05T09:48:38Z

Tomas.:

{{RW Section|Material Effects PLG|0x0120}}

'''Material Effects PLG''' is an extension to the [[Material (RW Section)|Material]] section in the [[RenderWare binary stream file|Renderware stream file format]]. It is part of the [[List_of_RW_section_IDs#Toolkit|Renderware Toolkit]] and can be used to attach certain effects to a material, such as bump mapping, reflections and UV-Animations.

If a material defines material effects, the [[Atomic (RW Section)|Atomic]] that draws the material's parent geometry also contains a material effects extension. However, the format of this section is different from the actual one that is defined for the material.

== Binary structure ==

Basically each section is structured starting with a header, that contains a effect type identifier, followed by two effects that can be overlayed, if the effect type supports it.

uint32 - Type (Header)
First Effect (variable size)
Second Effect (variable size)

It's certain, that at least the second effect is not used, even both effects can be disabled by setting the type identifier to 0x00 ([[Material Effects PLG (RW Section)#No Effect (rwMATFXNULL)|rwMATFXNULL]]). It is important to note, that the effect rwMATFXNULL allocates 4 bytes of memory for it's effect header.

== Header ==

The section starts with a type identifier. The section's actual size depends on the section type.

uint32 - Type

The section type can be of one of the following values:

0 rwMATFXEFFECTNULL No Effect
1 rwMATFXEFFECTBUMPMAP Bump Map
2 rwMATFXEFFECTENVMAP Environment Map (Reflections)
3 rwMATFXEFFECTBUMPENVMAP Bump Map/Environment Map
4 rwMATFXEFFECTDUAL Dual Textures
5 rwMATFXEFFECTUVTRANSFORM UV-Tranformation
6 rwMATFXEFFECTDUALUVTRANSFORM Dual Textures/UV-Transformation

The effect types 3 (rwMATFXEFFECTBUMPENVMAP) and 6 (rwMATFXEFFECTDUALUVTRANSFORM) are requiring both effects to be set. For all other section types, the second effect is usually set to 0 (rwMATFXEFFECTNULL).

== Effects (Types) ==

Each effect starts with a header on it's own, containing the effect identifier. The effect identifier is of the same type as the section identifier and therefor the effect identifier of the first effect typically equals the section identifier. Exceptions are the section types 3 (rwMATFXEFFECTBUMPENVMAP) and 6 (rwMATFXEFFECTDUALUVTRANSFORM), which are invalid when beeing used as effect type.

=== No Effect (rwMATFXNULL) ===

The effect starts with a header, containing its type identifier.

uint32 - 0x00, rwMATFXEFFECTNULL

There are no other contents stored within this effect.

=== Bump Mapping (rwMATFXEFFECTBUMPMAP) ===

The effect starts with a header, containing its type identifier, followed by some settings.

uint32 - 0x01, rwMATFXEFFECTBUMPMAP
float32 - Intensity
bool32 - Contains Bump Map
RwTexture - Bump Map (Only if effect contains a bump map)
bool32 - Contains Height Map
RwTexture - Height Map (Only if the effect contains a height map)

Note that there are two switches within the effect, that determine the existence of two child sections, containing the actual bump or height map. The textures are stored as raw [[Texture (RW_Section)|RwTexture]]s, simply within the effect structure.

Bump maps are restricted in their format: The actual texture inside the [[Texture archive|TXD archive]] needs to be stored in X8R8G8B8-Format, meaning there are four 8-bit channels for red, green, blue and alpha. However, bump maps do not support alpha maps (a second texture that encodes opacity-information per texel), compression or mip-mapping for performance reasons.

=== Environment Mapping (rwMATFXENVMAP) ===

Environment maps are used to simulate real-time reflections by blending in a pre-rendered environmental texture. Renderware does not support real-time reflections, besides [[wikipedia:Reflection mapping|Environment Mapping]] out of the box, but it can be hooked up with mods like [[ENBSeries_(SA)|ENBSeries]].

uint32 - 0x02, rwMATFXENVMAP
float32 - Reflection Coefficient (default is 1.0)
bool32 - Use Frame Buffer Alpha Channel
bool32 - Contains Environment Map
RwTexture - Environment Map

The effect itself contains a switch that determines the existence of a environment map in form of a texture. If the switch is true, the texture is stored as a raw [[Texture (RW_Section)|RwTexture]] section, succeeded by the switch itself.

=== Dual Texturing (rwMATFXEFFECTDUAL) ===

Dual Texturing enables the engine to blend two textures together. The effect therefor defines a set of blending options.

uint32 - 0x04, rwMATFXEFFECTDUAL
int32 - src blend mode
int32 - dest blend mode
bool32 - Contains Texture
RwTexture - Texture

If the effect contains a texture, it is stored as a raw [[Texture (RW_Section)|RwTexture]] section right after the ''Contains Texture'' option. The ''Blend Mode'' options defines how two textures are blended together. Basically each mode executes a different vector function that returns the blending result for each texel.

The first set of blend functions returns a constant value for each texel.

0x00 - rwNOBLEND
0x01 - rwBLENDZERO (0, 0, 0, 0 )
0x02 - rwBLENDONE (1, 1, 1, 1 )
0x03 - rwBLENDSRCCOLOR (Rs, Gs, Bs, As )
0x04 - rwBLENDINVSRCCOLOR (1-Rs, 1-Gs, 1-Bs, 1-As)
0x05 - rwBLENDSRCALPHA (As, As, As, As )
0x06 - rwBLENDINVSRCALPHA (1-As, 1-As, 1-As, 1-As)
0x07 - rwBLENDDESTALPHA (Ad, Ad, Ad, Ad )
0x08 - rwBLENDINVDESTALPHA (1-Ad, 1-Ad, 1-Ad, 1-Ad)
0x09 - rwBLENDDESTCOLOR (Rd, Gd, Bd, Ad )
0x0A - rwBLENDINVDESTCOLOR (1-Rd, 1-Gd, 1-Bd, 1-Ad)
0x0B - rwBLENDSRCALPHASAT (f, f, f, 1 ) f = min (As, 1-Ad)

The very first function, rwNOBLEND, disables blending at all, meaning that only the base texture of the material will be drawn.
In the other cases the final color is the sum of the base texture multiplied by the value of the dest Blend mode and the dual pass texture multiplied by the value of the src blend mode.

=== UV-Animation (rwMATFXEFFECTUVTRANSFORM) ===

UV-Animation itself does not contain any further information, besides it obligatory header.

uint32 - 0x05, rwMATFXEFFECTUVTRANSFORM

If this effect is defined, the [[Material (RW_Section)|Material]] also contains a [[UV Animation PLG (RW_Section)|UV Animation PLG]] extension.

== Atomic extension ==

Renderware does not support advanced shading or physically based rendering (PBR). In order to better quality rendering, it defines different rendering pipelines a draw call can be passed to. Each pipeline supports different features, like Bump Mapping for the illusion of uneven or rough surfaces, Environment Mapping to approximate reflection or Vertex Colors to support approximative precalculated lightning. Rockstar even defined a set of [[Pipeline Set (RW Section)|custom rendering pipelines]] to support their custom engine features, like [[Reflection Material (RW Section)|reflective materials]] or [[Night Vertex Colors (RW Section)|extra vertex colors]]. For more information about the general rendering workflow in Renderware, please refer to the [[RenderWare]] article.

In order to choose the right parameters for the rendering pipelines, while passing each [[Atomic (RW Section)|Atomic]] to a draw-call, the Atomic itself needs to know which effects the linked geometry uses. The MatFX plugin uses another [[Material (RW Section)|Material]] chunk that specifies whether the MatFX pipeline should be attached to the Atomic:

bool32 - MatFX enabled

In RW versions >= 3.4.0.0 this chunk is only written when the value is 1.

An Atomic can also have a [[Right To Render (RW Section)|Right To Render]] chunk in its Extension data, this however is ignored by the engine. In the case of MatFX this chunk is only written when a null-pipeline was attached when the file was written. This is generally the case if the file was exported from a modeling program.

== Rendering ==
=== Environment mapping ===

Environment mapping on the PS2 works different than on the PC in some ways:
* The environment effect is rendered as a second pass and hence uses alpha blending which gives a different result than using multiple texture stages
* The environment pass uses the same vertex colors as the diffuse pass
* Texture coordinates are generated differently (independent of camera position)

For an implementation of PS2-like env-mapping on PC see [[SkyGfx]]

== See also ==
* [[Atomic (RW Section)|Atomic]]
* [[Material (RW Section)|Material]]
* [[Reflection Material (RW Section)|Reflection Material]]
* [[Specular Material (RW Section)|Specular Material]]
* [[UV Animation PLG (RW Section)|UV Animation PLG]]
* [[Texture (RW Section)|Texture]]
* [[Geometry List (RW Section)|Geometry List]]
* [[RenderWare_binary_stream_file|RW file format specification]]

{{N|SA|VC}}
[[Category:GTA_3]]

0AB2

2019-01-13T20:51:18Z

Tomas.:

{{This|For CLEO for GTA III and Vice City prior to v2.0.0.0, use opcode 05F6.}}
{{Icon|t}} (with [[CLEO]])
<hr />
'''Description'''
: Returns from a [[SCM function|scm function]]
'''Syntax'''
: 0AB2: ret [''int''] ( [''any''] … )
'''Parameter'''
: [''int'']
:: Number of values to return
: [''any'']
:: Returned values if there are ones (optional), up to 30

This opcode transfers the thread execution back to [[0AB1]] opcode and stores the returned values in its variables. Total number of returned values must be equal to the number of variables storing the result in 0AB1. If the 0AB2 opcode does not return any values, it must have a 0 as the only parameter, and proper 0AB1 that calls such a function should have no variables to store.

In [[0AB1#Example|this example]] 0AB2 returns only one value, which is the value of variable 0@, this value will be copied to the variable $result.

== Keywords ==
CLEO, scm function, return, ret

[[Category:OpCodes]]
[[Category:CLEO Opcodes]]

0AB1

2019-01-13T20:51:16Z

Tomas.:

{{This|For CLEO for GTA III and Vice City prior to v2.0.0.0, use opcode 05F5.}}
{{Icon|t}} (with [[CLEO]])
<hr />
'''Description'''
: Calls a scm function
'''Syntax'''
: 0AB1: call_scm_func [''label''] [''int''] ( [''any''] … )
'''Parameter'''
: [''label'']
:: [[Label]] (SCM function start)
: [''int'']
:: Number of parameters to pass
: [''any'']
:: Parameters if there are ones (optional), up to 30

This opcode calls a SCM function, passes the parameters to it and stores a result to variable(s). The passed parameters values are copied to the local variables in series, then the thread execution is transferred to the label, it executes code there and returns after opcode [[0AB2]] is executed.

== Example ==
This is a simple example of the SCM function calculating the square number.
<syntaxhighlight lang="scm">
0@ = 5
0AB1: call_scm_func @GetSQR 1 10 $result
004E: end_thread
//…
:GetSQR
006A: 0@ *= 0@
0AB2: ret 1 0@
</syntaxhighlight>

How it works. First of all, the game comes to the opcode 0AB1. The game reads the number of parameters to pass (1) and its values (10). The variable <span style="color:blue">0@</span> of the current thread equates to 10 (if there would more parameters to pass, the next one will be copied to the <span style="color:blue">1@</span>, then <span style="color:blue">2@</span> and so on). After that the thread jumps to the label <span style="color:green">@GetSQR</span>,. Here the square number is calculated (of a value in the <span style="color:blue">0@</span>). Again, if there would be more parameters, the values of <span style="color:blue">1@</span>, <span style="color:blue">2@</span> etc may be taken in to account, if needed. After the calculation, the game comes to the opcode 0AB2. The value of <span style="color:blue">0@</span> equals to 10*10 = 100 at this moment. Then the following happens: the returned value(s) (<span style="color:blue">0@</span>) is copied to the variable(s) that is written in the opcode 0AB1 which called this function. In our example such variable is $result. After storing of the result, the thread returns back to the 0AB1 and comes to the command end_thread. The value of the <span style="color:blue">$result</span> equals to the 100 (which is square of 10) at this moment.
Finally say that 0AB2 could return not only the variables values, but also the number constants. For example, 0AB2: ret 1 1 will forever stores 1 to the result.
Also pay attention that the local variables are stayed unchanged after the function calling. In this example, the variable <span style="color:blue">0@</span> contains a value of 5 before 0AB1. Despite the fact that this variable was used in the function, after the calling it still equals to 5. This covers on all 32 local variables, so you can freely work with them within a function without fear to lose data.

== Keywords ==
CLEO, scm function, call

== External link ==
* {{GTAF|777350|SCM functions (including TraversePoolEntities algorithms)}}, documentation and tutorial by {{U|Wesser}}

[[Category:OpCodes]]
[[Category:CLEO Opcodes]]

033E

2019-01-13T05:21:05Z

Tomas.:

{{OpCode
| games = {{Icon|t}}
| command = DISPLAY_TEXT
| description = Displays [[Text#Intro text|text]] on the screen
| syntax1 = 033E: text_draw [''flt1''] [''flt2''] '[''string'']'
| p1t = [''flt1'']
| p1d = X-position from the left side of the screen, visible between 0.0 and 640.0
| p2t = [''flt2'']
| p2d = Y-position from the top side of the screen, visible between 0.0 and 448.0
| p3t = [''string'']
| p3d = [[GXT]] key
}}

This opcode displays text at any position on the screen. The X and Y positions of the text are based on a 640 × 448 resolution, which comes from the resolution of the PS2 version of the games. On different resolutions, these positions are scaled accordingly. You should use opcode [[03F0]] when using this opcode to prevent unintended side effects like permanent display or game crashes. Vice City supports up to 47 text before becoming unstable and each text must be less than 100 characters long. Positions 0.0 and lower will display only the shadow of the text. The following images show text displayed in Vice City at positions (0.0, 0.0), (50.0, 50.0), (100.0, 100.0), and (200.0, 200.0), from top left to bottom right. Note that the last text is wrapped due to the default [[0343|wrap x]] of 182.0.

<gallery>
033E.png|640 × 480
033E 1024x768.png|1024 × 768
033E 1280x720.png|1280 × 720
</gallery>

== Keywords ==
display, draw, intro, {{K|text}}

SCM language

2019-01-13T05:18:10Z

Tomas.:

<center><span style="color: #CC0000">'''Announcement''': This article is currently being reworked. Check out the progresses by visiting [http://pastebin.com/raw/YfLWLXJw this] link from time to time. Contact [http://www.gtaforums.com/index.php?showuser=172776 Wesser] for any suggestion.</span></center>
{{This|This section deals with the native SCM syntax of GTA 3 series, nothing other than [[GTA 3|III]], [[GTA VC|VC]], [[GTA SA|SA]], [[GTA LCS|LCS]] and [[GTA VCS|VCS]].<br/>
It may contain non-standard SCM definitions as R* hasn't published enough documentation about it yet.}}
{{TocRight}}On the occasion of the ''GTAIII's Tenth Anniversary'', after a long period of darkness where we fell about the real ''SCM'' syntax, R* finally treated us by attaching part of its own original source code into the ''GTAIII Anniversary'' game, available for ''iOS'' and ''Android'' devices. As far back as 2001, a snip of some debugging scripts has been already provided with ''main.sc'' and ''debug.sc'' files. However, many secrets are unrevealed yet, thus some things cannot be documented fully and so they can be only guessed. The ''SCM'' format abbreviation is one of countless proofs of this inconvenience, which may stand for ''Script Multifile''. Other doubts come with source files, whose ''SC'' extension appears to be very close to ''Mission SCript''. Although we have enough information to suppose the currently unknown mysteries of the used language, we still have no safe clue about which was its original denomination. Furthermore, it is a matter of fact that R* developers have been left untouched the ''miss2'' executable name of the ''GTA 3 series'' compiler since the chapter 2. In this connection, we could imagine the new language is a variant or an evolution of the '''GTA2script'''. In the ancient documentation by ''DMA'' (at present ''Rockstar North''), ''GBH'' sound like the initials of the codename or the primordial name of ''GTA2'', as the former is expressly stricken and overwritten by the latter (''<del>GBH</del><ins>GTA2</ins>'' occurs twice, whereas ''<del>GBHscript</del><ins>GTA2script</ins>'' only once), while ''GBHscript'' and ''GTA2script'' are quite recurring. Therefore, we are almost sure to say the language name is most likely '''GTA3script'''. However, it is definitely based on [[Wikipedia:BASIC|BASIC]].

<span style="font-size: 14pt">Preliminary remarks</span>
----
This article makes use of formatted codes to improve the reading comprehension. Note that:

* ''Square brackets'' mean everything inside may be omitted;
* ''Curly brackets'' denote the presence of useful codes but not necessarily needed;
* ''Vertical bars'' divide what can be chosen alternatively.<br/><br/>
=Fundamentals=

==Comments==

A ''comment'' is an additional text that may be helpful for the code writer or other users, in short for the reader. It is the only part of the source code which gets always ignored when compiling.

===Inline===

An ''inline comment'', denoted by '''//''' (two slashes), makes everything that follows some plain text:

[...] // Some inline comment

===Multiline===

A ''multiline comment'' embraces a particular area of the source code, starting by the opening tag '''/*''' (slash and asterisk) and ending with '''*/''' (asterisk and slash):

[...]
/*
* Some multiline comment
* ...
*/
[...]
Currently, more than one multiline comment is allowed per line:

[...] /* Some inline comment */ [...] /* Some inline comment */ [...]

;Note
:R* compiler allows multiline comments nesting.

==Highlighters==

''Highlighters'' behaviour sounds trivial, that's to say they simply highlight one or more arguments per [[#Commands|command]] within ''round brackets'', individually or together. In {{icon|3}}, they appear to be used only for '''SETUP_ZONE_PED_INFO''' (in a various order) and ''GXT keys'':

SETUP_ZONE_PED_INFO FISHFAC DAY (0) 0 0 0 (0 0 0 0) 0
PRINT_BIG (T4X4_1) 5000 2

;Limits
:Opening and closing round brakets are treated as blank spaces;
:An optional ''comma'' can be used as well to distinguish each argument, processed as a space.

==Scopes==

''Scopes'' are delimited by ''curly brackets'' (or ''multiline brackets'') which act like a [[#Local|local]] [[#Variables|variable]] [[#Scope|scope]]. Essentially, they enclose the code where local variables are used, including [[#Timers|timers]]. They can be opened and closed many times in a [[#Structure|script]]:

{
[...]
}

;Limits
:Scopes cannot be nested;
:Opening and closing curly brakets are real commands.

==Labels==

A ''label'' is a ''sequence of characters'' which identify the reference of a location of the source code useful for ''gotoes''. It can be accessed by any part of the source code. To define a label just append ''':''' (colon) to its name:

[...]

{lblname}:
[...]

At the compiling time, they are automatically converted into an [[#Offsets|offset]].

==Variables==

A ''variable'' is a ''storage location'' assigned to a ''symbolic name'' which contains a ''value'' of any ''type''.

===Value===

A ''value'' represents ''any data of any type'' it is.

===Scope===
----
The usage of a variable depends on the ''scope'', that is the context where a specific variable is declared. At this point, we can distinguish the ''global'' and ''local'' scope.

====Global====

The ''global scope'' grasps the ''whole source code''. Variables defined as ''globals'' are visible in ''any [[#Structure|script]]''. They are declared by appending the '''VAR''' prefix.

====Local====
----
The ''local scope'' wraps a ''localized part of the source code''. Variables defined as ''locals'' are visible only in the ''code enclosed by curly brackets''. You can put them everywhere and as many times as you want in the source code. They are declared by appending the '''LVAR''' prefix.

=====Timers=====

A ''timer'' is an ''unique local variable'' whose value rises automatically. It starts incrementing since the beginning of the script where it has been placed and grows endlessly. There are ''2 usable timers'' which are already defined as '''TIMERA''' and '''TIMERB''', therefore they do not need to be declared.

===Data types===
----
Among the available data types, some are equivalent to those of the most known programming languages. Their length is up to 4, 8 and 16 bytes. Each type is appended as a suffix in the ''variable declaration''.

====LABEL====

The '''LABEL''' type handles ''variable-length strings''. It can refer to either a ''[[#Labels|label]] name'' or a ''file name''.

;Notes
:While inside a script file, R* compiler treats it unambiguously as a label;
:R* compiler allocates 32 bytes per label.

;Limit
:'''LABEL''' variables aren't available.

====INT====

The '''INT''' type handles ''32-bit signed integers''. It is also used to store [[#Value|values]] with less bytes, such as a [[Wikipedia:Primitive_data_type#Booleans|bool]], a [[Wikipedia:Character_(computing)#char|char]] and a [[Wikipedia:Integer_(computer_science)#Short_integer|short int]].

====FLOAT====

The '''FLOAT''' type handles ''32-bit floating-points''. As it normally does, decimal precision of a [[Wikipedia:Floating_point|float]] is usually stuck to 6-7 digits beyond which it may get lost.

;Notes
:R* compiler also accepts ''f'' and ''F'' suffixes for the immediate value.

====TEXT_LABEL====

The '''TEXT_LABEL''' type handles ''8-byte strings''. Generally, a [[Wikipedia:String_(computer_science)|string]] is an ''array of 1-byte characters''. It requires ''7 characters plus the [[Wikipedia:Null_character|null-terminator]]'' (a blank byte meaning the ''end of the string''). It is used to hold ''GXT keys'' (those of ''town zones'', ''interiors'', ''help textes'' or ''dialogue subtitles'') ''script names'' or any short string. Literal only '''TEXT_LABEL*''' strings are probably marked by ''single quotation marks'' to distinguish them from variable and constant identifiers:

PRINT_BIG 'GXT_KEY'

;Limit
:'''TEXT_LABEL''' variables are supported in {{icon|sa}} and {{icon|vcs}}.

====TEXT_LABEL16====

The '''TEXT_LABEL16''' type handles ''16-byte strings''. Like the previous, this type holds ''15 characters plus the null-terminator''. It is used to store ''model and texture names of player clothes'', ''animation names'' or any long string.

;Limit
:'''TEXT_LABEL16''' variables and values are supported only in {{icon|sa}}.

====TEXT_LABEL32====

The '''TEXT_LABEL32''' type handles ''32-byte strings'' or larger, depending on how many continuous parameters of the same type there are, each of which occupies 32 bytes. It can hold up to ''127 characters plus the null-terminator'', after which another '''TEXT_LABEL32''' argument may begin. Strings of such type must be put within ''double quotation marks'':

SAVE_STRING_TO_DEBUG_FILE "32B-128B TEXT"

;Limits
:'''TEXT_LABEL32''' values are supported since {{icon|vc}};
:'''TEXT_LABEL32''' variables aren't available.

====TEXT====

The '''TEXT''' type handles ''N-byte strings''. It holds ''N characters plus the null-terminator''. Strings of this type mustn't exceed 255 characters (including the null-byte).

;Limits
:'''TEXT''' values are supported since {{icon|sa}};
:'''TEXT''' variables aren't available.

====CONST (pseudo)====

The '''CONST''' type handles ''32-bit signed integers''. It is used only to assign and compare [[#Constants|constants]] to '''INT''' variables regarding ''model [[#Identifiers|identifiers]]'', ''task statuses'', ''ped or audio events'' and such. It is a pseudo type of '''INT'''.

;Limit
:The [[#Arithmetic|assignment]] and [[#Comparison|comparison]] of '''CONST''' values are supported since {{icon|vc}}.

====MULTI (pseudo)====

The '''MULTI''' type handles a group of few data types acceptable per argument. It is used only for commands featuring optional arguments, those whose type is unpredictable before the compilation. It can be a pseudo type of '''INT''', '''FLOAT''' and '''TEXT_LABEL'''.

;Notes
:'''INT''' and '''FLOAT''' can be used interchangeably in {{icon|3}}, {{icon|vc}}, {{icon|sa}}, {{icon|lcs}} and {{icon|vcs}};
:{{icon|vcs}} also admits '''TEXT_LABEL''' arguments.

===Declaration===
----
''Defining a variable'' means ''assigning a token string to a memory cell'' at the compiling time. Variables must be declared in the following manner:

VAR_* {varname0}[,] [... {varnameN}]
LVAR_* {varname0}[,] [... {varnameN}]

As mentioned in the sections above, local variables have to be put within curly brackets:

{
VAR_* {varname0}[,] [... {varnameN}]
LVAR_* {varname0}[,] [... {varnameN}]

[...]
}

''Inline variable declaration'' is allowed, you just have to separate them by ''spaces'' or ''tabulations''. Adding a preceding ''comma'' before these characters is optional.

;Limits
:Whereas the ''variable buffer'' is limited, you can declare a certain amount of globals and locals. [[#INT|INT]] and [[#FLOAT|FLOAT]] types take 1 variable, while [[#TEXT_LABEL|TEXT_LABEL]] and [[#TEXT_LABEL16|TEXT_LABEL16]] types occupy respectively 2 and 4 variables to store their data (have a look [[#Variables range|here]] for further details);
:{{icon|vcs}} isn't affected by what said above;
:Global and local variable names must not collide.

====Arrays====

A ''array'' is a ''collection of variables'' having the same type which can be accessed by an ''index'', an '''INT''' lesser than or equal to the size specified, enclosed by ''square brackets'':

{
VAR_* {varname0}{[arrsize0]}[,] [... {varnameN}{[arrsizeN]}]
LVAR_* {varname0}{[arrsize0]}[,] [... {varnameN}{[arrsizeN]}]

[...]
}

;Limits
:The usage of arrays is allowed since {{icon|vc}};
:Variable indices are quite buggy in {{icon|vc}} and therefore unrecommended, but they are fully supported since {{icon|sa}};
:The aforesaid indices are one-based, possibly zero-based since {{icon|sa}};
:Multidimensional arrays are not supported.

====Handles====

A ''handle'' is an univocal identifier assigned to a game entity. It is given by the following statement:

<source lang=cpp>short nHandle = (iEntityIndexInPool << 8) | ucEntityFlag;</source>

;Note
:R* compiler won't let you assign different entity types to the same variable or using a variable which hasn't been passed to any [[#Commands|command]] designated to the creation of an entity.

==Operators==

In general, an ''operator'' is a token string that represents a math calculation or an operation of any other kind, in order to make the code understanding clearer at a glance.

===Arithmetic===

''Arithmetic operators'' compute some of the most common algebric calculations between either a [[#Variables|variable]] and a [[#Value|value]] or two variables. As well as in some programming language happens, [[#CONST (pseudo)|CONST]], [[#TEXT_LABEL|TEXT_LABEL]] and [[#TEXT_LABEL16|TEXT_LABEL16]] types are free from these operators, except for the ''basic assignment'' (see also [[#Operators composition|Operators composition]]):

{|class=wikitable
!width=70px|Operator
!width=225px colspan=2|Name
!width=225px|Syntax
!width=550px|Description
|-
!=
|align=center colspan=2|Assignment
|align=center|<code>expr0 '''=''' expr1</code>
|Store ''expr1'' to ''expr0''
|-
!+
|align=center colspan=2|Addition
|align=center|<code>expr0 '''+''' expr1</code>
|Add ''expr1'' to ''expr0''
|-
!-
|align=center colspan=2|Subtraction
|align=center|<code>expr0 '''-''' expr1</code>
|Subtract ''expr1'' from ''expr0''
|-
!*
|align=center colspan=2|Multiplication
|align=center|<code>expr0 '''*''' expr1</code>
|Multiply ''expr0'' by ''expr1''
|-
!/
|align=center colspan=2|Division
|align=center|<code>expr0 '''/''' expr1</code>
|Divide ''expr0'' by ''expr1''
|-
!+@
|align=center colspan=2|Timed addition
|align=center|<code>expr0 '''+@''' expr1</code>
|Multiply ''expr2'' by delta time and add the result to ''expr1''
|-
!-@
|align=center colspan=2|Timed subtraction
|align=center|<code>expr0 '''-@''' expr1</code>
|Multiply ''expr2'' by delta time and subtract the result from ''expr1''
|-
!rowspan=2|++
|align=center rowspan=2|Increment
|align=center|Pre{{ref|preinc|[*]}}
|align=center|<code>'''++''' expr0</code>
|rowspan=2|Increment ''expr0'' by 1 and store the result to ''expr0''
|-
|align=center|Post
|align=center|<code>expr0 '''++'''</code>
|-
!rowspan=2|--
|align=center rowspan=2|Decrement
|align=center|Pre{{ref|preinc|[*]}}
|align=center|<code>'''--''' expr0</code>
|rowspan=2|Decrement ''expr0'' by 1 and store the result to ''expr0''
|-
|align=center|Post
|align=center|<code>expr0 '''--'''</code>
|}

;Note
:{{note|preinc}} Pre and post increments have no difference unlike what you would expect.

Yet, you can put the ''assignment'' and ''algebric'' operators together inline as follows:

{|class=wikitable
!width=70px|Operators
!width=225px|Name
!width=225px|Syntax
!width=550px|Description
|-
!= +
|align=center|Addition and assignment
|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''+''' expr2</code>
|Add ''expr2'' to ''expr1'' and store the result to ''expr0''
|-
!= -
|align=center|Subtraction and assignment
|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''-''' expr2</code>
|Subtract ''expr2'' from ''expr1'' and store the result to ''expr0''
|-
!= *
|align=center|Multiplication and assignment
|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''*''' expr2</code>
|Multiply ''expr1'' by ''expr2'' and store the result to ''expr0''
|-
!= /
|align=center|Division and assignment
|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''/''' expr2</code>
|Divide ''expr1'' by ''expr2'' and store the result to ''expr0''
|-
!= +@
|align=center|Timed addition and assignment
|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''+@''' expr2</code>
|Multiply ''expr2'' by delta time, add the result to ''expr1'' and store everything to ''expr0''
|-
!= -@
|align=center|Timed subtraction and assignment
|align=center|<code>expr0 '''=''' expr1{{ref|expr01|[*]}} '''-@''' expr2</code>
|Multiply ''expr2'' by delta time, subtract the result from ''expr1'' and store everything to ''expr0''
|}

;Note
:{{note|expr01}} ''expr1'' can represent ''expr0'' too.

;Limit
:Multiple algebric operators per line are not allowed.

===Compound assignment===

''Compound assignment operators'' store [[#Value|values]] or [[#Variables|variable]] content to other variables having a particular type afterwards the computation of an arithmetic operation, to squeeze the code and clear it up from granted repetitions:

{|class=wikitable
!width=70px|Operator
!width=225px|Name
!width=225px|Syntax
!width=550px|Description
|-
!+=
|align=center|Addition assignment
|align=center|<code>expr0 '''+=''' expr1</code>
|Add ''expr1'' to ''expr0'' and store the result to ''expr0''
|-
!-=
|align=center|Subtraction assignment
|align=center|<code>expr0 '''-=''' expr1</code>
|Subtract ''expr1'' from ''expr0'' and store the result to ''expr0''
|-
!*=
|align=center|Multiplication assignment
|align=center|<code>expr0 '''*=''' expr1</code>
|Multiply ''expr0'' by ''expr1'' and store the result to ''expr0''
|-
!/=
|align=center|Division assignment
|align=center|<code>expr0 '''/=''' expr1</code>
|Divide ''expr0'' by ''expr1'' and store the result to ''expr0''
|-
!+=@
|align=center|Timed addition assignment
|align=center|<code>expr0 '''+=@''' expr1</code>
|Multiply ''expr1'' by delta time, add the result to ''expr0'' and store everything to ''expr0''
|-
!-=@
|align=center|Timed subtraction assignment
|align=center|<code>expr0 '''-=@''' expr1</code>
|Multiply ''expr1'' by delta time, subtract the result from ''expr0'' and store everything to ''expr0''
|}

===Uncompounded assignment===

''Uncompounded assignment operators'' are those on their own, or rather they are neither derivable nor decomposable similarly as those [[#Compound assignment|compounds]]:

{|class=wikitable
!width=70px|Operator
!width=225px|Name
!width=225px|Syntax
!width=550px|Description
|-
!=#
|align=center|Cast assignment
|align=center|<code>expr0 '''=#''' expr1</code>
|Cast ''expr1'' to any other type and store the result to ''expr0''
|}

;Limit
:Supported conversions are [[#FLOAT|FLOAT]] to [[#INT|INT]] and '''INT''' to '''FLOAT'''.

===Logical===

''Logical operators'' influence the way conditions are evalueted and enable to test more of them at a time. More than anything, they are built-in statements:

{|class=wikitable
!width=70px|Operator
!width=225px|Name
!width=225px|Syntax
!width=550px|Description
|-
!NOT
|align=center|Logical negation
|align=center|<code>IF '''NOT''' condition0</code>
|Test if ''condition0'' is false
|-
!AND
|align=center|Logical conjunction
|align=center|<code>IF condition0<br/>'''AND''' condition8</code>
|Test if both ''condition0'' and ''conditionN'' are true
|-
!OR
|align=center|Logical disjunction
|align=center|<code>IF condition0<br/>'''OR''' condition8</code>
|Test if either ''condition0'' or ''conditionN'' is true
|}

===Comparison===

''Comparison operators'' test the truth or falsity of the relation between either a [[#Variables|variable]] and a [[#Value|value]], a value and a variable or two variables:

{|class=wikitable
!width=70px|Operator
!width=225px|Name
!width=225px|Syntax
!width=550px|Description
|-
!=
|align=center|Equal to
|align=center|<code>IF expr0 '''=''' expr1</code>
|Test if ''expr0'' and ''expr1'' are equal
|-
!>
|align=center|Greater than
|align=center|<code>IF expr0 '''>''' expr1</code>
|Test if ''expr0'' is greater than ''expr1''
|-
!<{{ref|inverr|[*]}}
|align=center|Lesser than
|align=center|<code>IF expr0 '''<''' expr1</code>
|Test if ''expr0'' is lesser than ''expr1''
|-
!>=
|align=center|Greater than or equal to
|align=center|<code>IF expr0 '''>=''' expr1</code>
|Test if ''expr0'' is greater than or equal to ''expr1''
|-
!<={{ref|inverr|[*]}}
|align=center|Lesser than or equal to
|align=center|<code>IF expr0 '''<=''' expr1</code>
|Test if ''expr0'' is lesser than or equal to ''expr1''
|}

;Note
:{{note|inverr}} As a result of a critical bug, R* compiler mistakenly applies the operator inversion.

==Commands==

A ''command'' is a ''symbolic name'' associated to an [[#Command ID|identifier]] which executes a ''portion of code'' that specifies the operation to be performed by passing ''zero or more arguments''. An ''argument'' is in turn some data given as input to a command. Normally, commands have a defined amount of arguments and those not, such as '''START_NEW_SCRIPT''', can pass as many arguments as the available [[#Local|local]] [[#Variables|variables]] are, except [[#Timers|timers]]. Being a procedure, a command does not return [[#Value|values]] that can be assigned to a variable, even though the boolean flag is kept whenever it is used as a ''condition''. It follows the common programming syntax adopted for ''function calls'':

{commandname} [{anyvalue0|varname0} ... {anyvalueN|varnameN}]

===Alternators===

An ''alternator'' is a set of alternative and akin commands chosen specifically during the compilation on the basis of the multiple implementations of the commands binded to the reference set, according to the different argument data types but NOT the [http://en.wikipedia.org/wiki/Arity arity]. The aforementioned sets are listed below:

* {{icon|t}} {{icon|lcs}} {{icon|vcs}}:
** '''SET (=)'''
** '''CSET (=#)'''
** '''ADD_THING_TO_THING (+=)'''
** '''SUB_THING_FROM_THING (-=)'''
** '''MULT_THING_BY_THING (*=)'''
** '''DIV_THING_BY_THING (/=)'''
** '''IS_THING_EQUAL_TO_THING (=)'''
** '''IS_THING_NOT_EQUAL_TO_THING (NOT =)'''
** '''IS_THING_GREATER_THAN_THING (>, <=)'''
** '''IS_THING_GREATER_OR_EQUAL_TO_THING (>=, <)'''
** '''ADD_THING_TO_THING_TIMED (+=@)'''
** '''SUB_THING_FROM_THING_TIMED (-=@)'''
** '''ABS'''
* {{icon|sa}}:
** '''IS_EMPTY'''
** '''IS_BIT_SET'''
** '''SET_BIT'''
** '''CLEAR_BIT'''
** '''STRING_CAT'''

{{incomplete}}

===Hardcoded===

''Hardcoded commands'' are those which have unique characteristics and are handled internally:

* {{icon|t}} {{icon|lcs}} {{icon|vcs}}:
** '''GOTO'''
** '''GOTO_IF_FALSE'''
** '''TERMINATE_THIS_SCRIPT'''
** '''START_NEW_SCRIPT'''
** '''VAR_INT'''
** '''VAR_FLOAT'''
** '''LVAR_INT'''
** '''LVAR_FLOAT'''
** '''{'''
** '''}'''
** '''REPEAT'''
** '''ENDREPEAT'''
** '''IF'''
** '''IFNOT'''
** '''ELSE'''
** '''ENDIF'''
** '''WHILE'''
** '''WHILENOT'''
** '''ENDWHILE'''
** '''ANDOR'''
** '''LAUNCH_MISSION'''
** '''SAVE_VAR_INT'''
** '''SAVE_VAR_FLOAT'''
** '''START_CUTSCENE'''{{ref|depcnt|[*]}}
** '''PLAYER_MADE_PROGRESS'''
** '''SET_PROGRESS_TOTAL'''{{ref|thgtot|[*]}}
** '''REGISTER_MISSION_GIVEN'''{{ref|depcnt|[*]}}
** '''REGISTER_MISSION_PASSED'''
** '''SCRIPT_NAME'''
** '''LOAD_AND_LAUNCH_MISSION'''
** '''LOAD_AND_LAUNCH_MISSION_INTERNAL'''
** '''SET_TOTAL_NUMBER_OF_MISSIONS'''{{ref|thgtot|[*]}}
** '''VAR_TEXT_LABEL'''
** '''LVAR_TEXT_LABEL'''
* {{icon|vc}} {{icon|sa}} {{icon|lcs}} {{icon|vcs}}:
** '''REGISTER_ODDJOB_MISSION_PASSED'''
* {{icon|3}} {{icon|lcs}} {{icon|vcs}}:
** '''GOTO_IF_TRUE'''
** '''GOSUB_FILE'''
* {{icon|3}} {{icon|vc}}:
** '''CREATE_COLLECTABLE1'''
** '''SET_COLLECTABLE1_TOTAL'''{{ref|thgtot|[*]}}
* {{icon|vc}} {{icon|sa}}:
** '''LOAD_AND_LAUNCH_MISSION_EXCLUSIVE'''
* {{icon|lcs}} {{icon|vcs}}:
** '''CALL'''
** '''CALLNOT'''
* {{icon|sa}}:
** '''VAR_TEXT_LABEL16'''
** '''LVAR_TEXT_LABEL16'''
** '''SWITCH'''
** '''ENDSWITCH'''
** '''CASE'''
** '''DEFAULT'''
** '''BREAK'''
** '''SWITCH_START'''
** '''SWITCH_CONTINUED'''
* {{icon|vcs}}:
** '''SAVE_VAR_TEXT_LABEL'''{{ref|thgtot|[*]}}
** '''SET_COLLECTABLE2_TOTAL'''

;Notes
:{{note|thgtot}} The argument of these commands must be set respectively according to:
:* The sum of '''PLAYER_MADE_PROGRESS''' values;
:* The amount of '''REGISTER_MISSION_PASSED''' (those that don't have an immediate value are excluded) and '''REGISTER_ODDJOB_MISSION_PASSED''';
:* The amount of '''CREATE_COLLECTABLE1'''.
:If the argument of the listed commands differs from what expected, a 0-value must be passed;
:{{note|depcnt}} This command was intended to be counted originally but its counter got deprecated.

{{incomplete}}

===WAIT===

'''WAIT''' stops the execution of a [[#Structure|script]] according to some milliseconds after which it will resume again. Indeed, it is absolutely necessary into ''infinite loops'' or those that may or may not break after more than one frame, such as the [[#WHILE|WHILE]] control flow. In this case, a [[#INT|INT]] equal to 0 is passed.

===GOTO===

'''GOTO''' jumps to the [[#Labels|label]] of any location of the source code but conceptually it should never point off the current context. It is also used internally to build the [[#Control flows|control flows]] offered by the scripting language:

// File: any.sc

goto_ref0:
GOTO goto_refN

// File: any.sc

goto_refN:
GOTO goto_ref0

===ANDOR===

'''ANDOR''' sets out the way the comparison among more conditions have to occur (see also [[#Compare flag|Compare flag]]).

===GOTO_IF_TRUE===

'''GOTO_IF_TRUE''' operates in conjunction with [[#ANDOR|ANDOR]] and jumps to a [[#Labels|label]] if the returned boolean flag is true.

===GOTO_IF_FALSE===

Unlike [[#GOTO_IF_TRUE|GOTO_IF_TRUE]], '''GOTO_IF_FALSE''' jumps to the desired [[#Labels|label]] only if the comparison returns false.

===SCRIPT_NAME===

'''SCRIPT_NAME''' simply associates an unique name to the current working [[#Structure|script]].

;Note
:R* compiler doesn't enable you to associate a name previously used for another script.

===SAVE_STRING_TO_DEBUG_FILE===

'''SAVE_STRING_TO_DEBUG_FILE''' accepts an argument which can admit up to ''127 characters plus the null-terminator''. In the compiling process, the argument is skipped but its string is copied to a predefined ''128-bytes buffer'', compiled afterwards. Since {{icon|vc}}, these are the seemingly predetermined bytes of a random empty string block which are actually the result of uninitialized data:

00 00 41 00 09 2E 00 00 00 00 00 00 '''00''' 00 00 00
09 2E 00 00 00 00 00 00 1C FB 12 00 D8 A8 41 00
00 00 41 00 09 2E 00 00 00 00 00 00 '''01''' 00 00 00
09 2E 00 00 00 00 00 00 1C FB 12 00 D8 A8 41 00
00 00 41 00 09 2E 00 00 00 00 00 00 '''02''' 00 00 00
09 2E 00 00 00 00 00 00 1C FB 12 00 D8 A8 41 00
00 00 41 00 09 2E 00 00 00 00 00 00 '''03''' 00 00 00
09 2E 00 00 00 00 00 00 1C FB 12 00 D8 A8 41 00

The split of such bytes into 4 blocks of 32-bytes each is quite noticeable.

==Constants==

A ''constant'' is a ''symbolic name'' associated to a specific [[#Value|value]]. When compiling, their caption is converted to the assigned value. Since {{icon|vc}}, names and identifiers of objects within [[OBJS]] and [[TOBJ]] blocks are loaded from every ''IDE'' file defined into [[gta.dat|gta_vc.dat]], then those of vehicles and pedestrians within [[PEDS]] and [[CARS]] blocks are retrieved from [[default.ide]]. In {{icon|sa}}, they are listed into ''TXT'' files, whose name follows the [[Wikipedia:CamelCase|Pascal Case]] (eg. ''AudioEvents.txt''). These files respect the syntax below:

{constname0} {constvalue0}

{constnameN} {constvalueN}

''Constant names and values'' are divided by as many ''spaces'' or ''tabulations'' as you want. ''Constant lines'' are distinguished by two '''\n''' (new line) characters. The ''model names'' which aren't assigned to a constant are still valid (see also [[#Identifiers|Identifiers]]). Keep in mind arguments of some [[#Commands|commands]] having the [[#CONST (pseudo)|CONST]] type accept only ''constant values'' of a single ''namespace''.

;Notes
:Constants don't collide even though they belong to different namespaces;
:In {{icon|3}} and {{icon|vc}}, they are hardcoded as everything inside R* compiler;
:In {{icon|sa}}, the subdivision of constant namespaces in files might be just a listing of hardcoded constants useful for developers. The same would apply to {{icon|lcs}} and {{icon|vcs}}.

==Formatting==

Everything is ''case-insensitive'', that means the uppercase and lowercase letters have no dissimilarities when taken. Usually, the source code is conform to the same formatting according to:

* [[#Labels|Labels]] and [[#Variables|variables]] are entirely in lowercase;
* [[#Declaration|Declarations]], [[#Commands|commands]] and [[#Control flows|control flows]] are in uppercase;
* [[#Constants|Constants]] are mostly in uppercase but the lowercase variant can be seen as well.<br/><br/>
=Compiling=

==Structure==

The source code is split up into several ''SC'' files which comprehend ''main file'', ''foreign gosubs'', ''subscripts'', ''mission scripts'', and ''streamed scripts''. These files can be included more times because they are actually processed once.

===Main file===
----
The ''main file'' is the most significant part of the whole source. It can include many script files and/or embedded ''gosubs'', ''scripts'' or ''functions''. Originally, it is characterized by the absence of the [[#Local|local]] [[#Scope|scope]]. It must be put outside the directory, having the same name as the main script file, where all other foreign scripts must be:

<directory>
| main
| | gosub
| | |- gosub1.sc
| | \- gosubN.sc
| | subscript
| | |- subscript1.sc
| | \- subscriptN.sc
| | mission_guy
| | |- mission_guy1.sc
| | \- mission_guyN.sc
| |- gosub.sc
| |- subscript.sc
| \- mission.sc
\- main.sc

;Note
:R* compiler will scan subfolders too.

===Foreign gosubs===
----
''Foreign gosubs'' (also called ''subroutines'') are ''main extension files''. They are called using the '''GOSUB_FILE''' [[#Commands|command]] which jumps to a specific [[#Labels|label]] and executes some code that returns back to the place where it has been called with '''RETURN'''. You are able to specify the gosub label to start jumping at as well:

// File: main.sc

GOSUB_FILE gosub_ref foreign_gosub.sc

// File: foreign_gosub.sc

gosub_ref:
{
[...]
}
RETURN

;Limit
:Foreign gosubs were introduced since {{icon|3}}. They were unused in {{icon|vc}} and got removed in {{icon|sa}}, but then they were reimplemented in {{icon|lcs}} and {{icon|vcs}}.

====Gosubs====

As mentioned, ''gosubs'' are also embedded in any script file. They follow almost the same rules, except they are called by '''GOSUB''' and can actually inehrit the [[#Local|local]] [[#Scope|scope]] of the parent script:

// File: any.sc

GOSUB gosub_ref

// File: any.sc

gosub_ref:
{
[...]
}
RETURN

;Note
:R* compiler doesn't take care if the code within a scope jumps to a gosub inside which another scope is declared. It is strongly recommended to pay attention at this issue or you will fall down into an irreparable local [[#Variables|variable]] mismatch.

===Subscripts===
----
''Subscripts'' are code blocks which take part of a ''queue of other scripts'' and are allocated over the memory by '''LAUNCH_MISSION'''. They are denoted by the presence of '''MISSION_START''' at the very top of the mission file. As long as they aren't ended with '''MISSION_END''', their execution never expires till the end of the game process. Each one works independently, even though they are able to share [[#Global|global]] [[#Variables|variables]]:

// File: main.sc

LAUNCH_MISSION subscript.sc

// File: subscript.sc

MISSION_START

[VAR_* {varname0}[,] [... {varnameN}]]

SCRIPT_NAME main

subscript_loop:
{
[LVAR_* {varname0}[,] [... {varnameN}]]

[...]
}
//GOTO subscript_loop
MISSION_END

;Notes
:'''MISSION_START''' is a special and fake directive that isn't assigned to any [[#Commands|command]]. R* compiler will notify an error if it isn't placed at the first line of a subscript or a [[#Mission scripts|mission script]];
:'''MISSION_END''' is an alias of '''TERMINATE_THIS_SCRIPT'''.

====Scripts====

As for [[#Gosubs|gosubs]], ''scripts'' can be embedded everywhere in a script file. They are started by '''START_NEW_SCRIPT''' which has an undefined amount of arguments, whose type must match with those of each [[#Local|local]] variable of the starting script in order to be passed, else the compilation will interrupt. Unlike subscripts, they get terminated by '''TERMINATE_THIS_SCRIPT''' or '''TERMINATE_ALL_SCRIPTS_WITH_THIS_NAME''' (elsewhere in another script):

// File: any.sc

START_NEW_SCRIPT script [{anyvalue0|varname0} ... {anyvalueN|varnameN}]

// File: any.sc

script:
{
SCRIPT_NAME script

script_loop:

[LVAR_* {varname0}[,] [... {varnameN}]]

[...]

//GOTO script_loop
TERMINATE_THIS_SCRIPT
}

;Notes
:Scripts must have a local [[#Scope|scope]];
:Script commands must be inserted within or after the local scope;
:Since {{icon|vc}}, the ''opening curly bracket'' must be put before the script [[#Labels|label]] when more arguments are passed.

====Functions====

{{incomplete}}

===Mission scripts===
----
''Mission scripts'' are those [[#Subscripts|subscripts]] which are responsible for the presence of a storyline in the game. When they are launched with '''LOAD_AND_LAUNCH_MISSION''', the mission is loaded in the mission block, allocated over the memory and the script pointer is moved to the corresponding mission [[#Offsets|offset]]. Do not forget to begin a mission script with '''MISSION_START''' and end it with '''MISSION_END''':

// File: main.sc

LOAD_AND_LAUNCH_MISSION mission.sc

// File: mission.sc

MISSION_START

GOSUB mission_start

IF HAS_DEATHARREST_BEEN_EXECUTED
GOSUB mission_failed
ENDIF

GOSUB mission_cleanup

MISSION_END

[VAR_* {varname0}[,] [... {varnameN}]]

mission_start:

REGISTER_MISSION_GIVEN
SCRIPT_NAME mission

// Variables initialization

{
[LVAR_* {varname0}[,] [... {varnameN}]]

[...]
}
GOTO mission_passed

mission_failed:
[...]
RETURN

mission_passed:
REGISTER_MISSION_PASSED mission
//PLAYER_MADE_PROGRESS 1
[...]
RETURN

// Mark everything as no longer needed

mission_cleanup:
//MISSION_HAS_FINISHED
[...]
RETURN

Some missions doesn't need to be executed multiple times because they may just initialize some [[#Global|global]] [[#Variables|variables]] defined in the [[#Main file|main]] script or launch the intro mission. For this matter, here comes the usage of '''LOAD_AND_LAUNCH_MISSION_EXCLUSIVE''':

// File: main.sc

LOAD_AND_LAUNCH_MISSION_EXCLUSIVE initial.sc
LOAD_AND_LAUNCH_MISSION_EXCLUSIVE intro.sc

;Note
:Exclusive missions are never launched in the source code. It's likely, it was an idea not came to the end successfully or rather they were useful for debugging purposes.

;Limits
:'''LOAD_AND_LAUNCH_MISSION_EXCLUSIVE''' is available only in {{icon|vc}} and {{icon|sa}};
:Only 2 exclusive missions in {{icon|vc}} and 3 in {{icon|sa}} are handled, plus they must be launched before any of the counterpart.

===Streamed scripts===
----
{{incomplete}}

==Control flows==

As usual, the evolution of something implies its development over the years. Alongside, the ''control flows'' implementation has been distributed equally into every chapter. Their definitions are similar to those used in ''pseudocodes'' resulting in a ''raw source code''. However, you are still able to build your own control flows:

ANDOR {value}
[NOT] {condition0}
[[NOT] {condition8}]
GOTO_IF_FALSE ELSE
{consequence}
[GOTO ENDIF]
ELSE:
[{alternative}
ENDIF:]

;Note
:It's likely, user-made control flows weren't intended to be usable because R* compiler cannot recognize an [[#Comparison|equal to]] rather than an [[#Arithmetic|assignment]] operator.

===IF===

'''IF''' is one of the most widespread ''conditional statements'' which executes some codes by evaluating a boolean flag, the returning value of one or more conditions. According to the returning value, either the ''consequence'' or the ''alternative'' will be performed. The condition result can be inverted by appending the '''NOT''' [[#Logical|logical operator]] before. More conditions require the use of the remaining logical operators, they are '''AND''', when verifying if all conditions evaluate true, and '''OR''', while testing if just one is satisfied. The syntax below summarize the whole explanation:

IF [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
[ELSE
{alternative}]
ENDIF

;Limit
:More than ''8 conditions'' per statement aren't allowed.

===IFNOT===

'''IFNOT''' is a variation of the '''IF''' statement as already stated. As opposed to its closest relative, the conditions evaluetion is reversed, that is the ''consequence'' is perfomed when the boolean flag is false, else the ''alternative'' is executed:

IFNOT [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
[ELSE
{alternative}]
ENDIF

;Limit
:It is supported in {{icon|3}}, {{icon|lcs}} and {{icon|vcs}}.

===WHILE===

Alike '''IF''', '''WHILE''' is a conditional statement. The only difference consists in how it performs the ''consequence'', that is it ''loops'' every line of code built into if the boolean flag is true:

WHILE [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
ENDWHILE

===WHILENOT===

'''WHILENOT''' acts seemingly like the '''WHILE''' statement, as all condition truths are inverted and therefore the ''consequence'' is performed over and over again until the boolean flag becomes true:

WHILENOT [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
ENDWHILE

;Limit
:It is supported in {{icon|3}}, {{icon|lcs}} and {{icon|vcs}}.

===REPEAT===

Similar to the '''WHILE''' statement, '''REPEAT''' ''iterates'' the ''consequence'' repeatedly depending on a 0-value incremental [[#Variables|variable]] which rises till the times specified:

REPEAT {times} {varname}
{consequence}
ENDREPEAT

;Limits
:It is supported since {{icon|vc}};
:The times must be positive;
:The code will be read at least once in any case.

===SWITCH===

Basically, '''SWITCH''' is a ''group of concatenated '''IF''' statements''. When a condition is false the next '''CASE''' statement gets performed, otherwise the ''consequence'' is executed till a '''BREAK''' occurs and so the code jumps to the end of the construct. If none of the cases is true, a '''DEFAULT''' clause may be carried out:

SWITCH {varname}
CASE {value0}
{consequence}
BREAK
[CASE {valueN}
{consequence}
BREAK]
[DEFAULT
{alternative}
BREAK]
ENDSWITCH

;Limits
:It is supported since {{icon|sa}};
:'''CASE''' allows the use of [[#INT|INT]] and [[#CONST (pseudo)|CONST]] values only;
:In {{icon|sa}}, values must be sorted (R* compiler should do it implicitely);
:Every '''CASE''' including '''DEFAULT''' must end with a '''BREAK'''.<br/><br/>
=Decompiling=

==Structure==

For further information about the SCM file format, read [[Mission_Scripting (Overview)|this]] article. Take into account the compiling order of each ''SC'' file is [[#Main file|main file]] » [[#Foreign gosubs|foreign gosubs]] » [[#Subscripts|subscripts]] » [[#Mission scripts|mission scripts]] apart from the reading order of the commands used to include them. [[#Streamed scripts|Streamed scripts]] are compiled individually into the ''script.img'' file. On the other hand, [[#Functions|functions]] are compiled like [[#Gosubs|gosubs]].

==Identifiers==

''Undefined [[#Constants|constants]]'' of model identifiers, whose name refers to a [[DFF]] which is presumably archived into any of the [[IMG]]<nowiki>s</nowiki>, loaded by the game, are overwritten by a decrementing value in the order they get compiled. These ''model names'' are then put into the second segment of the ''SCM header''. Those of [[#Mission scripts|mission scripts]] and [[#Streamed scripts|streamed scripts]] respect the same rule except the fact they are turned into a zero-based growing identifier, while exclusive mission scripts are launched by a negative identifier resulting from the bits inversion (bitwise complement).

==Offsets==

An ''offset'' is a ''32-bit signed integer'' which points to a location of the script file. Those within the [[#Main file|main file]], [[#Foreign gosubs|foreign gosubs]] and [[#Subscripts|subscripts]] are ''absolute offsets'' that start from the beginning of the main script, while the ones inside [[#Mission scripts|mission scripts]] and [[#Streamed scripts|streamed scripts]] are ''relative and negative offsets'' starting from their beginning. The offset is related to [[#Global|global]] [[#Variables|variables]] as well, whose interval goes from ''8'' and ends to ''65532'' (''0xFFFC''), each one is aligned to the nearest 4 bytes.

==Variables range==

The following table shows the [[#Variables|variables]] range of the [[#Local|local]] [[#Scope|scope]] for each game version:

{|class=wikitable style=text-align:center
!Context
!width=50px|{{icon|3}}
!width=50px|{{icon|vc}}
!width=50px|{{icon|sa}}
!width=50px|{{icon|lcs}}
!width=50px|{{icon|vcs}}
|-
|align=left|[[#Foreign gosubs|Foreign gosub]]/[[#Gosubs|Gosub]]||0-15||0-15||n/a||0-95||0-95
|-
|align=left|[[#Subscripts|Subscript]]/[[#Scripts|Script]]||0-15||0-15||0-31||0-95||0-95
|-
|align=left|[[#Mission scripts|Mission script]]||0-15||0-15||0-1023||0-95||0-95
|-
|align=left|[[#Streamed scripts|Streamed script]]||n/a||n/a||0-31||n/a||n/a
|-
|align=left|[[#Functions|Function]]||n/a||n/a||n/a||0-95||0-95
|-
!colspan=6|
|-
|align=left|[[#Timers|Timer]]||16-17||16-17||32-33||t0-t1||t0-t1
|}

==Operators composition==

As far as you wouldn't know, SCM's [[#Operators|operators]] always take two operands to compute an operation. Their composition is listed below:

{|class=wikitable
!width=70px|Operator/s
!width=200px colspan=2|Name
!width=200px|Syntax
!width=180px|Composition
|-
!rowspan=2|++
|align=center rowspan=2|Increment
|align=center|Pre
|align=center|<code>'''++''' expr0</code>
|align=center rowspan=2|<code>expr0 '''+=''' 1</code>
|-
|align=center|Post
|align=center|<code>expr0 '''++'''</code>
|-
!rowspan=2|--
|align=center rowspan=2|Decrement
|align=center|Pre
|align=center|<code>'''--''' expr0</code>
|align=center rowspan=2|<code>expr0 '''-=''' 1</code>
|-
|align=center|Post
|align=center|<code>expr0 '''--'''</code>
|-
!= +
|align=center colspan=2|Addition and assignment
|align=center|<code>expr0 '''=''' expr1 '''+''' expr2</code>
|align=center|<code>expr0 '''=''' expr1<br/>expr0 '''+=''' expr2</code>
|-
!= -
|align=center colspan=2|Subtraction and assignment
|align=center|<code>expr0 '''=''' expr1 '''-''' expr2</code>
|align=center|<code>expr0 '''=''' expr1<br/>expr0 '''-=''' expr2</code>
|-
!= *
|align=center colspan=2|Multiplication and assignment
|align=center|<code>expr0 '''=''' expr1 '''*''' expr2</code>
|align=center|<code>expr0 '''=''' expr1<br/>expr0 '''*=''' expr2</code>
|-
!= /
|align=center colspan=2|Division and assignment
|align=center|<code>expr0 '''=''' expr1 '''/''' expr2</code>
|align=center|<code>expr0 '''=''' expr1<br/>expr0 '''/=''' expr2</code>
|-
!= +@
|align=center colspan=2|Timed addition and assignment
|align=center|<code>expr0 '''=''' expr1 '''+@''' expr2</code>
|align=center|<code>expr0 '''=''' expr1<br/>expr0 '''+=@''' expr2</code>
|-
!= -@
|align=center colspan=2|Timed subtraction and assignment
|align=center|<code>expr0 '''=''' expr1 '''-@''' expr2</code>
|align=center|<code>expr0 '''=''' expr1<br/>expr0 '''-=@''' expr2</code>
|}

==Command ID==

A ''command ID'' is a ''16-bit signed integer'' internal and progressive identifier, somehow referred to as part of the hexadecimal representation of an [http://en.wikipedia.org/wiki/Opcode opcode], which identifies the command to execute at runtime, forming the game's script [http://en.wikipedia.org/wiki/Bytecode bytecode]. The maximum number of available commands is ''32767'' (''0x7FFF''), since the least significant bit (''0x8000'') is set whenever they are used as ''negative conditions'' (those with the '''NOT''' [[#Logical|logical operator]], just to clear things up).

==Command arguments==

The limitation of the amount of arguments a [http://en.wikipedia.org/wiki/Variadic_function variadic] command can pass is game specific:

* 16 for {{icon|3}} and {{icon|vc}};
* 32 for {{icon|sa}};
* 96 for {{icon|lcs}} and {{icon|vcs}}.

==Managed commands==

Here is the list of all managed [[#Commands|commands]] and their relative specifications:

'''Legend:'''

* '''Prefix:'''
** V, [[#Global|VAR]];
** L, [[#Local|LVAR]];
** A, ANY ([[#Value|VALUE]], VAR, LVAR).

* '''Specifier:'''
** R, [[#LABEL|LABEL]];
** I, [[#INT|INT]];
** F, [[#FLOAT|FLOAT]];
** T, [[#TEXT_LABEL|TEXT_LABEL]];
** T16, [[#TEXT_LABEL16|TEXT_LABEL16]];
** T32, [[#TEXT_LABEL32|TEXT_LABEL32]];
** T[N], [[#TEXT|TEXT]];
** C, [[#CONST (pseudo)|CONST]];
** M, [[#MULTI (pseudo)|MULTI]].

* '''Suffix:'''
** O, OPTIONAL.

'''List:'''

Be aware, the argument data types of the commands below are just informative:

<div width=100% style="overflow: auto; margin: -8px auto 8px">
{|class="wikitable collapsible collapsed" style=text-align:center
|-
!rowspan=3 colspan=2|Command
!rowspan=3|ID
!colspan=9|Arguments
|-
!width=45px rowspan=2|#
!width=45px rowspan=2|1
!width=45px rowspan=2|2
!width=45px rowspan=2|3
!width=45px rowspan=2|4
!width=45px rowspan=2|...
!width=45px rowspan=2|18
!width=45px rowspan=2|...
!width=45px|n+l
|-
!n+i+o
|-
|colspan=12|{{icon|t}} {{icon|lcs}} {{icon|vcs}}
|-
!colspan=2|MISSION_START{{ref|misdef|[*]}}
|
!0
|colspan=8|
|-
!colspan=2|GOTO{{ref|statem|[*]}}
|[[0002|2]]
!1
|R||colspan=7|
|-
|colspan=12|{{icon|t}} {{icon|lcs}}
|-
!rowspan=12|=<br/>SET!!SET_VAR_INT
|[[0004|4]]
!rowspan=12|2
|VI||I||colspan=6|
|-
!SET_VAR_FLOAT
|[[0005|5]]||VF||F||colspan=6|
|-
!SET_LVAR_INT
|[[0006|6]]||LI||I||colspan=6|
|-
!SET_LVAR_FLOAT
|[[0007|7]]||LF||F||colspan=6|
|-
!SET_VAR_INT_TO_VAR_INT
|[[0084|132]]||VI||VI||colspan=6|
|-
!SET_LVAR_INT_TO_LVAR_INT
|[[0085|133]]||LI||LI||colspan=6|
|-
!SET_VAR_FLOAT_TO_VAR_FLOAT
|[[0086|134]]||VF||VF||colspan=6|
|-
!SET_LVAR_FLOAT_TO_LVAR_FLOAT
|[[0087|135]]||LF||LF||colspan=6|
|-
!SET_VAR_FLOAT_TO_LVAR_FLOAT
|[[0088|136]]||VF||LF||colspan=6|
|-
!SET_LVAR_FLOAT_TO_VAR_FLOAT
|[[0089|137]]||LF||VF||colspan=6|
|-
!SET_VAR_INT_TO_LVAR_INT
|[[008A|138]]||VI||LI||colspan=6|
|-
!SET_LVAR_INT_TO_VAR_INT
|[[008B|139]]||LI||VI||colspan=6|
|-
!rowspan=12|+=<br/>+<br/>ADD_THING_TO_THING!!ADD_VAL_TO_INT_VAR
|[[0008|8]]
!rowspan=12|2
|VI||I||colspan=6|
|-
!ADD_VAL_TO_FLOAT_VAR
|[[0009|9]]||VF||F||colspan=6|
|-
!ADD_VAL_TO_INT_LVAR
|[[000A|10]]||LI||I||colspan=6|
|-
!ADD_VAL_TO_FLOAT_LVAR
|[[000B|11]]||LF||F||colspan=6|
|-
!ADD_INT_VAR_TO_INT_VAR
|[[0058|88]]||VI||VI||colspan=6|
|-
!ADD_FLOAT_VAR_TO_FLOAT_VAR
|[[0059|89]]||VF||VF||colspan=6|
|-
!ADD_INT_LVAR_TO_INT_LVAR
|[[005A|90]]||LI||LI||colspan=6|
|-
!ADD_FLOAT_LVAR_TO_FLOAT_LVAR
|[[005B|91]]||LF||LF||colspan=6|
|-
!ADD_INT_VAR_TO_INT_LVAR
|[[005C|92]]||LI||VI||colspan=6|
|-
!ADD_FLOAT_VAR_TO_FLOAT_LVAR
|[[005D|93]]||LF||VF||colspan=6|
|-
!ADD_INT_LVAR_TO_INT_VAR
|[[005E|94]]||VI||LI||colspan=6|
|-
!ADD_FLOAT_LVAR_TO_FLOAT_VAR
|[[005F|95]]||VF||LF||colspan=6|
|-
!rowspan=12|-=<br/>-<br/>SUB_THING_FROM_THING!!SUB_VAL_FROM_INT_VAR
|[[000C|12]]
!rowspan=12|2
|VI||I||colspan=6|
|-
!SUB_VAL_FROM_FLOAT_VAR
|[[000D|13]]||VF||F||colspan=6|
|-
!SUB_VAL_FROM_INT_LVAR
|[[000E|14]]||LI||I||colspan=6|
|-
!SUB_VAL_FROM_FLOAT_LVAR
|[[000F|15]]||LF||F||colspan=6|
|-
!SUB_INT_VAR_FROM_INT_VAR
|[[0060|96]]||VI||VI||colspan=6|
|-
!SUB_FLOAT_VAR_FROM_FLOAT_VAR
|[[0061|97]]||VF||VF||colspan=6|
|-
!SUB_INT_LVAR_FROM_INT_LVAR
|[[0062|98]]||LI||LI||colspan=6|
|-
!SUB_FLOAT_LVAR_FROM_FLOAT_LVAR
|[[0063|99]]||LF||LF||colspan=6|
|-
!SUB_INT_VAR_FROM_INT_LVAR
|[[0064|100]]||LI||VI||colspan=6|
|-
!SUB_FLOAT_VAR_FROM_FLOAT_LVAR
|[[0065|101]]||LF||VF||colspan=6|
|-
!SUB_INT_LVAR_FROM_INT_VAR
|[[0066|102]]||VI||LI||colspan=6|
|-
!SUB_FLOAT_LVAR_FROM_FLOAT_VAR
|[[0067|103]]||VF||LF||colspan=6|
|-
!rowspan=12|*=<br/>*<br/>MULT_THING_BY_THING!!MULT_INT_VAR_BY_VAL
|[[0010|16]]
!rowspan=12|2
|VI||I||colspan=6|
|-
!MULT_FLOAT_VAR_BY_VAL
|[[0011|17]]||VF||F||colspan=6|
|-
!MULT_INT_LVAR_BY_VAL
|[[0012|18]]||LI||I||colspan=6|
|-
!MULT_FLOAT_LVAR_BY_VAL
|[[0013|19]]||LF||F||colspan=6|
|-
!MULT_INT_VAR_BY_INT_VAR
|[[0068|104]]||VI||VI||colspan=6|
|-
!MULT_FLOAT_VAR_BY_FLOAT_VAR
|[[0069|105]]||VF||VF||colspan=6|
|-
!MULT_INT_LVAR_BY_INT_LVAR
|[[006A|106]]||LI||LI||colspan=6|
|-
!MULT_FLOAT_LVAR_BY_FLOAT_LVAR
|[[006B|107]]||LF||LF||colspan=6|
|-
!MULT_INT_VAR_BY_INT_LVAR
|[[006C|108]]||VI||LI||colspan=6|
|-
!MULT_FLOAT_VAR_BY_FLOAT_LVAR
|[[006D|109]]||VF||LF||colspan=6|
|-
!MULT_INT_LVAR_BY_INT_VAR
|[[006E|110]]||LI||VI||colspan=6|
|-
!MULT_FLOAT_LVAR_BY_FLOAT_VAR
|[[006F|111]]||LF||VF||colspan=6|
|-
!rowspan=12|/=<br/>/<br/>DIV_THING_BY_THING!!DIV_INT_BY_VAL
|[[0014|20]]
!rowspan=12|2
|VI||I||colspan=6|
|-
!DIV_FLOAT_VAR_BY_VAL
|[[0015|21]]||VF||F||colspan=6|
|-
!DIV_INT_LVAR_BY_VAL
|[[0016|22]]||LI||I||colspan=6|
|-
!DIV_FLOAT_LVAR_BY_VAL
|[[0017|23]]||LF||F||colspan=6|
|-
!DIV_INT_VAR_BY_INT_VAR
|[[0070|112]]||VI||VI||colspan=6|
|-
!DIV_FLOAT_VAR_BY_FLOAT_VAR
|[[0071|113]]||VF||VF||colspan=6|
|-
!DIV_INT_LVAR_BY_INT_LVAR
|[[0072|114]]||LI||LI||colspan=6|
|-
!DIV_FLOAT_LVAR_BY_FLOAT_LVAR
|[[0073|115]]||LF||LF||colspan=6|
|-
!DIV_INT_VAR_BY_INT_LVAR
|[[0074|116]]||VI||LI||colspan=6|
|-
!DIV_FLOAT_VAR_BY_FLOAT_LVAR
|[[0075|117]]||VF||LF||colspan=6|
|-
!DIV_INT_LVAR_BY_INT_VAR
|[[0076|118]]||LI||VI||colspan=6|
|-
!DIV_FLOAT_LVAR_BY_FLOAT_VAR
|[[0077|119]]||LF||VF||colspan=6|
|-
!rowspan=16|><br/><=<br/>IS_THING_GREATER_THAN_THING!!IS_INT_VAR_GREATER_THAN_NUMBER
|[[0018|24]]
!rowspan=16|2
|VI||I||colspan=6|
|-
!IS_INT_LVAR_GREATER_THAN_NUMBER
|[[0019|25]]||LI||I||colspan=6|
|-
!IS_NUMBER_GREATER_THAN_INT_VAR
|[[001A|26]]||I||VI||colspan=6|
|-
!IS_NUMBER_GREATER_THAN_INT_LVAR
|[[001B|27]]||I||LI||colspan=6|
|-
!IS_INT_VAR_GREATER_THAN_INT_VAR
|[[001C|28]]||VI||VI||colspan=6|
|-
!IS_INT_LVAR_GREATER_THAN_INT_LVAR
|[[001D|29]]||LI||LI||colspan=6|
|-
!IS_INT_VAR_GREATER_THAN_INT_LVAR
|[[001E|30]]||VI||LI||colspan=6|
|-
!IS_INT_LVAR_GREATER_THAN_INT_VAR
|[[001F|31]]||LI||VI||colspan=6|
|-
!IS_FLOAT_VAR_GREATER_THAN_NUMBER
|[[0020|32]]||VF||F||colspan=6|
|-
!IS_FLOAT_LVAR_GREATER_THAN_NUMBER
|[[0021|33]]||LF||F||colspan=6|
|-
!IS_NUMBER_GREATER_THAN_FLOAT_VAR
|[[0022|34]]||F||VF||colspan=6|
|-
!IS_NUMBER_GREATER_THAN_FLOAT_LVAR
|[[0023|35]]||F||LF||colspan=6|
|-
!IS_FLOAT_VAR_GREATER_THAN_FLOAT_VAR
|[[0024|36]]||VF||VF||colspan=6|
|-
!IS_FLOAT_LVAR_GREATER_THAN_FLOAT_LVAR
|[[0025|37]]||LF||LF||colspan=6|
|-
!IS_FLOAT_VAR_GREATER_THAN_FLOAT_LVAR
|[[0026|38]]||VF||LF||colspan=6|
|-
!IS_FLOAT_LVAR_GREATER_THAN_FLOAT_VAR
|[[0027|39]]||LF||VF||colspan=6|
|-
!rowspan=16|>=<br/><<br/>IS_THING_GREATER_OR_EQUAL_TO_THING!!IS_INT_VAR_GREATER_OR_EQUAL_TO_NUMBER
|[[0028|40]]
!rowspan=16|2
|VI||I||colspan=6|
|-
!IS_INT_LVAR_GREATER_OR_EQUAL_TO_NUMBER
|[[0029|41]]||LI||I||colspan=6|
|-
!IS_NUMBER_GREATER_OR_EQUAL_TO_INT_VAR
|[[002A|42]]||I||VI||colspan=6|
|-
!IS_NUMBER_GREATER_OR_EQUAL_TO_INT_LVAR
|[[002B|43]]||I||LI||colspan=6|
|-
!IS_INT_VAR_GREATER_OR_EQUAL_TO_INT_VAR
|[[002C|44]]||VI||VI||colspan=6|
|-
!IS_INT_LVAR_GREATER_OR_EQUAL_TO_INT_LVAR
|[[002D|45]]||LI||LI||colspan=6|
|-
!IS_INT_VAR_GREATER_OR_EQUAL_TO_INT_LVAR
|[[002E|46]]||VI||LI||colspan=6|
|-
!IS_INT_LVAR_GREATER_OR_EQUAL_TO_INT_VAR
|[[002F|47]]||LI||VI||colspan=6|
|-
!IS_FLOAT_VAR_GREATER_OR_EQUAL_TO_NUMBER
|[[0030|48]]||VF||F||colspan=6|
|-
!IS_FLOAT_LVAR_GREATER_OR_EQUAL_TO_NUMBER
|[[0031|49]]||LF||F||colspan=6|
|-
!IS_NUMBER_GREATER_OR_EQUAL_TO_FLOAT_VAR
|[[0032|50]]||F||VF||colspan=6|
|-
!IS_NUMBER_GREATER_OR_EQUAL_TO_FLOAT_LVAR
|[[0033|51]]||F||LF||colspan=6|
|-
!IS_FLOAT_VAR_GREATER_OR_EQUAL_TO_FLOAT_VAR
|[[0034|52]]||VF||VF||colspan=6|
|-
!IS_FLOAT_LVAR_GREATER_OR_EQUAL_TO_FLOAT_LVAR
|[[0035|53]]||LF||LF||colspan=6|
|-
!IS_FLOAT_VAR_GREATER_OR_EQUAL_TO_FLOAT_LVAR
|[[0036|54]]||VF||LF||colspan=6|
|-
!IS_FLOAT_LVAR_GREATER_OR_EQUAL_TO_FLOAT_VAR
|[[0037|55]]||LF||VF||colspan=6|
|-
!rowspan=10|=<br/>IS_THING_EQUAL_TO_THING!!IS_INT_VAR_EQUAL_TO_NUMBER
|[[0038|56]]
!rowspan=10|2
|VI||I||colspan=6|
|-
!IS_INT_LVAR_EQUAL_TO_NUMBER
|[[0039|57]]||LI||I||colspan=6|
|-
!IS_INT_VAR_EQUAL_TO_INT_VAR
|[[003A|58]]||VI||VI||colspan=6|
|-
!IS_INT_LVAR_EQUAL_TO_INT_LVAR
|[[003B|59]]||LI||LI||colspan=6|
|-
!IS_INT_VAR_EQUAL_TO_INT_LVAR
|[[003C|60]]||VI||LI||colspan=6|
|-
!IS_FLOAT_VAR_EQUAL_TO_NUMBER
|[[0042|66]]||VF||F||colspan=6|
|-
!IS_FLOAT_LVAR_EQUAL_TO_NUMBER
|[[0043|67]]||LF||F||colspan=6|
|-
!IS_FLOAT_VAR_EQUAL_TO_FLOAT_VAR
|[[0044|68]]||VF||VF||colspan=6|
|-
!IS_FLOAT_LVAR_EQUAL_TO_FLOAT_LVAR
|[[0045|69]]||LF||LF||colspan=6|
|-
!IS_FLOAT_VAR_EQUAL_TO_FLOAT_LVAR
|[[0046|70]]||VF||LF||colspan=6|
|-
!rowspan=10|NOT =<br/>IS_THING_NOT_EQUAL_TO_THING!!IS_INT_VAR_NOT_EQUAL_TO_NUMBER
|[[003D|61]]
!rowspan=10|2
|VI||I||colspan=6|
|-
!IS_INT_LVAR_NOT_EQUAL_TO_NUMBER
|[[003E|62]]||LI||I||colspan=6|
|-
!IS_INT_VAR_NOT_EQUAL_TO_INT_VAR
|[[003F|63]]||VI||VI||colspan=6|

|-
!IS_INT_LVAR_NOT_EQUAL_TO_INT_LVAR
|[[0040|64]]||LI||LI||colspan=6|
|-
!IS_INT_VAR_NOT_EQUAL_TO_INT_LVAR
|[[0041|65]]||VI||LI||colspan=6|
|-
!IS_FLOAT_VAR_NOT_EQUAL_TO_NUMBER
|[[0047|71]]||VF||F||colspan=6|
|-
!IS_FLOAT_LVAR_NOT_EQUAL_TO_NUMBER
|[[0048|72]]||LF||F||colspan=6|
|-
!IS_FLOAT_VAR_NOT_EQUAL_TO_FLOAT_VAR
|[[0049|73]]||VF||VF||colspan=6|
|-
!IS_FLOAT_LVAR_NOT_EQUAL_TO_FLOAT_LVAR
|[[004A|74]]||LF||LF||colspan=6|
|-
!IS_FLOAT_VAR_NOT_EQUAL_TO_FLOAT_LVAR
|[[004B|75]]||VF||LF||colspan=6|
|-
!colspan=2|GOTO_IF_FALSE{{ref|statem|[*]}}
|[[004D|77]]
!1
|R||colspan=7|
|-
!colspan=2|TERMINATE_THIS_SCRIPT
|rowspan=2|[[004E|78]]
!rowspan=2|0
|rowspan=2 colspan=8|
|-
!colspan=2|MISSION_END
|-
!colspan=2|START_NEW_SCRIPT{{ref|undarg|[*]}}
|[[004F|79]]
!1+l
|R||colspan=7|AM
|-
|colspan=2|GOSUB
|[[0050|80]]
!1
|R||colspan=7|
|-
|colspan=2|RETURN
|[[0051|81]]
!0
|colspan=8|
|-
!rowspan=6|+=@<br/>+@<br/>ADD_THING_TO_THING_TIMED!!ADD_TIMED_VAL_TO_FLOAT_VAR
|[[0078|120]]
!rowspan=6|2
|VF||F||colspan=6|
|-
!ADD_TIMED_VAL_TO_FLOAT_LVAR
|[[0079|121]]||LF||F||colspan=6|
|-
!ADD_TIMED_FLOAT_VAR_TO_FLOAT_VAR
|[[007A|122]]||VF||VF||colspan=6|
|-
!ADD_TIMED_FLOAT_LVAR_TO_FLOAT_LVAR
|[[007B|123]]||LF||LF||colspan=6|
|-
!ADD_TIMED_FLOAT_LVAR_TO_FLOAT_VAR
|[[007C|124]]||LF||VF||colspan=6|
|-
!ADD_TIMED_FLOAT_VAR_TO_FLOAT_LVAR
|[[007D|125]]||VF||LF||colspan=6|
|-
!rowspan=6|-=@<br/>-@<br/>SUB_THING_FROM_THING_TIMED!!SUB_TIMED_VAL_FROM_FLOAT_VAR
|[[007E|126]]
!rowspan=6|2
|VF||F||colspan=6|
|-
!SUB_TIMED_VAL_FROM_FLOAT_LVAR
|[[007F|127]]||LF||F||colspan=6|
|-
!SUB_TIMED_FLOAT_VAR_FROM_FLOAT_VAR
|[[0080|128]]||VF||VF||colspan=6|
|-
!SUB_TIMED_FLOAT_LVAR_FROM_FLOAT_LVAR
|[[0081|129]]||LF||LF||colspan=6|
|-
!SUB_TIMED_FLOAT_LVAR_FROM_FLOAT_VAR
|[[0082|130]]||LF||VF||colspan=6|
|-
!SUB_TIMED_FLOAT_VAR_FROM_FLOAT_LVAR
|[[0083|131]]||VF||LF||colspan=6|
|-
!rowspan=8|=#<br/>CSET<br/>!!CSET_VAR_INT_TO_VAR_FLOAT
|[[008C|140]]
!rowspan=8|2
|VI||VF||colspan=6|
|-
!CSET_VAR_FLOAT_TO_VAR_INT
|[[008D|141]]||VF||VI||colspan=6|
|-
!CSET_LVAR_INT_TO_VAR_FLOAT
|[[008E|142]]||LI||VF||colspan=6|
|-
!CSET_LVAR_FLOAT_TO_VAR_INT
|[[008F|143]]||LF||VI||colspan=6|
|-
!CSET_VAR_INT_TO_LVAR_FLOAT
|[[0090|144]]||VI||LF||colspan=6|
|-
!CSET_VAR_FLOAT_TO_LVAR_INT
|[[0091|145]]||VF||LI||colspan=6|
|-
!CSET_LVAR_INT_TO_LVAR_FLOAT
|[[0092|146]]||LI||LF||colspan=6|
|-
!CSET_LVAR_FLOAT_TO_LVAR_INT
|[[0093|147]]||LF||LI||colspan=6|
|-
!rowspan=4|ABS!!ABS_VAR_INT
|[[0094|148]]
!rowspan=4|1
|VI||colspan=7|
|-
!ABS_LVAR_INT
|[[0095|149]]||LI||colspan=7|
|-
!ABS_VAR_FLOAT
|[[0096|150]]||VF||colspan=7|
|-
!ABS_LVAR_FLOAT
|[[0097|151]]||LF||colspan=7|
|-
!colspan=2|VAR_INT{{ref|defvar|[*]}}
|[[00C7|199]]
!n
|VI||colspan=7|VIO
|-
!colspan=2|VAR_FLOAT{{ref|defvar|[*]}}
|[[00C8|200]]
!n
|VF||colspan=7|VFO
|-
!colspan=2|LVAR_INT{{ref|defvar|[*]}}
|[[00C9|201]]
!n
|LI||colspan=7|LIO
|-
!colspan=2|LVAR_FLOAT{{ref|defvar|[*]}}
|[[00CA|202]]
!n
|LF||colspan=7|LFO
|-
!colspan=2|{{{ref|embdsc|[*]}}
|[[00CB|203]]
!0
|colspan=8|
|-
!colspan=2|}{{ref|embdsc|[*]}}
|[[00CC|204]]
!0
|colspan=8|
|-
!colspan=2|IF{{ref|statem|[*]}}
|[[00CF|207]]
!1
|I||colspan=7|
|-
!colspan=2|ELSE{{ref|statem|[*]}}
|[[00D1|209]]
!0
|colspan=8|
|-
!colspan=2|ENDIF{{ref|statem|[*]}}
|[[00D2|210]]
!0
|colspan=8|
|-
!colspan=2|WHILE{{ref|statem|[*]}}
|[[00D3|211]]
!1
|I||colspan=7|
|-
!colspan=2|ENDWHILE{{ref|statem|[*]}}
|[[00D5|213]]
!0
|colspan=8|
|-
|colspan=12|{{icon|t}}
|-
!colspan=2|ANDOR{{ref|statem|[*]}}
|[[00D6|214]]
!1
|I||colspan=7|
|-
!colspan=2|LAUNCH_MISSION
|[[00D7|215]]
!1
|R||colspan=7|
|-
|colspan=2|START_CUTSCENE
|[[02E7|743]]
!0
|colspan=8|
|-
!colspan=2|PLAYER_MADE_PROGRESS
|[[030C|780]]
!1
|I||colspan=7|
|-
!colspan=2|SET_PROGRESS_TOTAL
|[[030D|781]]
!1
|I||colspan=7|
|-
|colspan=2|REGISTER_MISSION_GIVEN
|[[0317|791]]
!0
|colspan=8|
|-
!colspan=2|REGISTER_MISSION_PASSED
|[[0318|792]]
!1
|T||colspan=7|
|-
!colspan=2|SCRIPT_NAME
|[[03A4|932]]
!1
|T||colspan=7|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION
|[[0416|1046]]
!1
|R||colspan=7|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION_INTERNAL
|[[0417|1047]]
!1
|I||colspan=7|
|-
!colspan=2|SET_TOTAL_NUMBER_OF_MISSIONS
|[[042C|1068]]
!1
|I||colspan=7|
|-
!colspan=2|REGISTER_ODDJOB_MISSION_PASSED
|[[0595|1429]]
!0
|colspan=8|
|-
|colspan=12|{{icon|vc}} {{icon|sa}} {{icon|lcs}}
|-
!colspan=2|REPEAT{{ref|statem|[*]}}
|[[00CD|205]]
!2
|I||VLI||colspan=6|
|-
!colspan=2|ENDREPEAT{{ref|statem|[*]}}
|[[00CE|206]]
!0
|colspan=8|
|-
|colspan=12|{{icon|3}} {{icon|vc}}
|-
!colspan=2|CREATE_COLLECTABLE1
|[[02EC|748]]
!1
|I||colspan=7|
|-
!colspan=2|SET_COLLECTABLE1_TOTAL
|[[02ED|749]]
!1
|I||colspan=7|
|-
|colspan=12|{{icon|3}} {{icon|lcs}}
|-
!colspan=2|GOTO_IF_TRUE{{ref|statem|[*]}}
|[[004C|76]]
!1
|R||colspan=7|
|-
|colspan=12|{{icon|vc}} {{icon|sa}}
|-
!rowspan=2|=<br/>IS_THING_EQUAL_TO_THING!!IS_INT_VAR_EQUAL_TO_CONSTANT
|[[04A3|1187]]
!rowspan=2|2
|VI||C||colspan=6|
|-
!IS_INT_LVAR_EQUAL_TO_CONSTANT
|[[04A4|1188]]||LI||C||colspan=6|
|-
!rowspan=2|=<br/>SET!!SET_VAR_INT_TO_CONSTANT
|[[04AE|1198]]
!rowspan=2|2
|VI||C||colspan=6|
|-
!SET_LVAR_INT_TO_CONSTANT
|[[04AF|1199]]||LI||C||colspan=6|
|-
!rowspan=4|><br/><=<br/>IS_THING_GREATER_THAN_THING!!IS_INT_VAR_GREATER_THAN_CONSTANT
|[[04B0|1200]]
!rowspan=4|2
|VI||C||colspan=6|
|-
!IS_INT_LVAR_GREATER_THAN_CONSTANT
|[[04B1|1201]]||LI||C||colspan=6|
|-
!IS_CONSTANT_GREATER_THAN_INT_VAR
|[[04B2|1202]]||C||VI||colspan=6|
|-
!IS_CONSTANT_GREATER_THAN_INT_LVAR
|[[04B3|1203]]||C||LI||colspan=6|
|-
!rowspan=4|>=<br/><<br/>IS_THING_GREATER_OR_EQUAL_TO_THING!!IS_INT_VAR_GREATER_OR_EQUAL_TO_CONSTANT
|[[04B4|1204]]
!rowspan=4|2
|VI||C||colspan=6|
|-
!IS_INT_LVAR_GREATER_OR_EQUAL_TO_CONSTANT
|[[04B5|1205]]||LI||C||colspan=6|
|-
!IS_CONSTANT_GREATER_OR_EQUAL_TO_INT_VAR
|[[04B6|1206]]||C||VI||colspan=6|
|-
!IS_CONSTANT_GREATER_OR_EQUAL_TO_INT_LVAR
|[[04B7|1207]]||C||LI||colspan=6|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION_EXCLUSIVE
|[[0515|1301]]
!1
|R||colspan=7|
|-
|colspan=12|{{icon|3}}
|-
!colspan=2|IFNOT{{ref|statem|[*]}}
|[[00D0|208]]
!1
|I||colspan=7|
|-
!colspan=2|WHILENOT{{ref|statem|[*]}}
|[[00D4|212]]
!1
|I||colspan=7|
|-
!colspan=2|GOSUB_FILE
|[[02CD|717]]
!2
|R||R||colspan=6|
|-
|colspan=12|{{icon|sa}}
|-
!rowspan=2|=<br/>SET!!SET_VAR_TEXT_LABEL
|[[05A9|1449]]
!rowspan=2|2
|VT||AT||colspan=6|
|-
!SET_LVAR_TEXT_LABEL
|[[05AA|1450]]||LT||AT||colspan=6|
|-
!colspan=2|VAR_TEXT_LABEL{{ref|defvar|[*]}}
|[[05AB|1451]]
!n
|VT||colspan=7|VTO
|-
!colspan=2|LVAR_TEXT_LABEL{{ref|defvar|[*]}}
|[[05AC|1452]]
!n
|LT||colspan=7|LTO
|-
!rowspan=2|=<br/>IS_THING_EQUAL_TO_THING!!IS_VAR_TEXT_LABEL_EQUAL_TO_TEXT_LABEL
|[[05AD|1453]]
!rowspan=2|2
|VT||AT||colspan=6|
|-
!IS_LVAR_TEXT_LABEL_EQUAL_TO_TEXT_LABEL
|[[05AE|1454]]||LT||AT||colspan=6|
|-
!rowspan=2|=<br/>SET!!SET_VAR_TEXT_LABEL16
|[[06D1|1745]]
!rowspan=2|2
|VT16||AT16||colspan=6|
|-
!SET_LVAR_TEXT_LABEL16
|[[06D2|1476]]||LT16||AT16||colspan=6|
|-
!colspan=2|VAR_TEXT_LABEL16{{ref|defvar|[*]}}
|[[06D3|1477]]
!n
|VT16||colspan=7|VT16O
|-
!colspan=2|LVAR_TEXT_LABEL16{{ref|defvar|[*]}}
|[[06D4|1478]]
!n
|LT16||colspan=7|LT16O
|-
!rowspan=2|=<br/>IS_THING_EQUAL_TO_THING!!IS_INT_LVAR_EQUAL_TO_INT_VAR
|[[07D6|2006]]
!rowspan=2|2
|LI||VI||colspan=6|
|-
!IS_FLOAT_LVAR_EQUAL_TO_FLOAT_VAR
|[[07D7|2007]]||LF||VF||colspan=6|
|-
!rowspan=4|IS_EMPTY{{ref|likely|[*]}}!!IS_VAR_TEXT_LABEL_EMPTY
|[[0844|2116]]
!rowspan=4|1
|VT||colspan=7|
|-
!IS_LVAR_TEXT_LABEL_EMPTY
|[[0845|2117]]||LT||colspan=7|
|-
!IS_VAR_TEXT_LABEL16_EMPTY
|[[0846|2118]]||VT16||colspan=7|
|-
!IS_LVAR_TEXT_LABEL16_EMPTY
|[[0847|2119]]||LT16||colspan=7|
|-
!colspan=2|SWITCH{{ref|statem|[*]}}
|[[0848|2120]]
!1
|VLI||colspan=7|
|-
!colspan=2|ENDSWITCH{{ref|statem|[*]}}
|[[0849|2121]]
!0
|colspan=8|
|-
!colspan=2|CASE{{ref|statem|[*]}}
|[[084A|2122]]
!1
|I||colspan=7|
|-
!colspan=2|DEFAULT{{ref|statem|[*]}}
|[[084B|2123]]
!0
|colspan=8|
|-
!colspan=2|BREAK{{ref|statem|[*]}}
|[[084C|2124]]
!0
|colspan=8|
|-
!rowspan=4 colspan=2|SWITCH_START{{ref|statem|[*]}}
|rowspan=4|[[0871|2161]]
!rowspan=4|18
|rowspan=2|VI
|rowspan=2|I
|rowspan=2|I
|rowspan=2|R
|colspan=2|I||colspan=2|
|-
|colspan=2|R||colspan=2|
|-
|rowspan=2|LI
|rowspan=2|I
|rowspan=2|I
|rowspan=2|R
|colspan=2|I||colspan=2|
|-
|colspan=2|R||colspan=2|
|-
!rowspan=2 colspan=2|SWITCH_CONTINUED{{ref|statem|[*]}}
|rowspan=2|[[0872|2162]]
!rowspan=2|18
|colspan=6|I
|colspan=2|
|-
|colspan=6|R
|colspan=2|
|-
!rowspan=6|IS_BIT_SET{{ref|likely|[*]}}!!IS_GLOBAL_VAR_BIT_SET_CONST
|[[08B4|2228]]
!rowspan=6|2
|VI||C||colspan=6|
|-
!IS_GLOBAL_VAR_BIT_SET_VAR
|[[08B5|2229]]||VI||VI||colspan=6|
|-
!IS_GLOBAL_VAR_BIT_SET_LVAR
|[[08B6|2230]]||VI||LI||colspan=6|
|-
!IS_LOCAL_VAR_BIT_SET_CONST
|[[08B7|2231]]||LI||C||colspan=6|
|-
!IS_LOCAL_VAR_BIT_SET_VAR
|[[08B8|2232]]||LI||VI||colspan=6|
|-
!IS_LOCAL_VAR_BIT_SET_LVAR
|[[08B9|2233]]||LI||LI||colspan=6|
|-
!rowspan=6|SET_BIT{{ref|likely|[*]}}!!SET_GLOBAL_VAR_BIT_CONST
|[[08BA|2234]]
!rowspan=6|2
|VI||C||colspan=6|
|-
!SET_GLOBAL_VAR_BIT_VAR
|[[08BB|2235]]||VI||VI||colspan=6|
|-
!SET_GLOBAL_VAR_BIT_LVAR
|[[08BC|2236]]||VI||LI||colspan=6|
|-
!SET_LOCAL_VAR_BIT_CONST
|[[08BD|2237]]||LI||C||colspan=6|
|-
!SET_LOCAL_VAR_BIT_VAR
|[[08BE|2238]]||LI||VI||colspan=6|
|-
!SET_LOCAL_VAR_BIT_LVAR
|[[08BF|2239]]||LI||LI||colspan=6|
|-
!rowspan=6|CLEAR_BIT{{ref|likely|[*]}}!!CLEAR_GLOBAL_VAR_BIT_CONST
|[[08C0|2240]]
!rowspan=6|2
|VI||C||colspan=6|
|-
!CLEAR_GLOBAL_VAR_BIT_VAR
|[[08C1|2241]]||VI||VI||colspan=6|
|-
!CLEAR_GLOBAL_VAR_BIT_LVAR
|[[08C2|2242]]||VI||LI||colspan=6|
|-
!CLEAR_LOCAL_VAR_BIT_CONST
|[[08C3|2243]]||LI||C||colspan=6|
|-
!CLEAR_LOCAL_VAR_BIT_VAR
|[[08C4|2244]]||LI||VI||colspan=6|
|-
!CLEAR_LOCAL_VAR_BIT_LVAR
|[[08C5|2245]]||LI||LI||colspan=6|
|-
!rowspan=2|=<br/>IS_THING_EQUAL_TO_THING!!IS_VAR_TEXT_LABEL16_EQUAL_TO_TEXT_LABEL
|[[08F9|2297]]
!rowspan=2|2
|VT16||AT16||colspan=6|
|-
!IS_LVAR_TEXT_LABEL16_EQUAL_TO_TEXT_LABEL
|[[08FA|2298]]||LT16||AT16||colspan=6|
|-
!rowspan=2|STRING_CAT{{ref|likely|[*]}}!!STRING_CAT16
|[[098B|2443]]
!rowspan=2|3
|VT16||VT16||VT16||colspan=5|
|-
!STRING_CAT8
|[[098C|2444]]||VT||VT||VT||colspan=5|
|-
|colspan=12|{{icon|lcs}}
|-
|colspan=2|RETURN_TRUE
|[[00C5|197]]
!0
|colspan=8|
|-
|colspan=2|RETURN_FALSE
|[[00C6|198]]
!0
|colspan=8|
|-
!colspan=2|SWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}
|214
!1
|VLI||colspan=7|
|-
!colspan=2|ENDSWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}
|215
!0
|colspan=8|
|-
!colspan=2|CASE{{ref|statem|[*]}}{{ref|posngs|[*]}}
|216
!1
|I||colspan=7|
|-
!colspan=2|DEFAULT{{ref|statem|[*]}}{{ref|posngs|[*]}}
|217
!0
|colspan=8|
|-
!colspan=2|BREAK{{ref|statem|[*]}}{{ref|posngs|[*]}}
|218
!0
|colspan=8|
|-
!colspan=2|ANDOR{{ref|statem|[*]}}
|219
!1
|I||colspan=7|
|-
!colspan=2|LAUNCH_MISSION
|220
!1
|R||colspan=7|
|-
!colspan=2|SAVE_VAR_INT{{ref|defvar|[*]}}
|502
!l
|VI||colspan=7|VIO
|-
!colspan=2|SAVE_VAR_FLOAT{{ref|defvar|[*]}}
|503
!l
|VF||colspan=7|VFO
|-
!colspan=2|GOSUB_FILE
|722
!2
|R||R||colspan=6|
|-
|colspan=2|START_CUTSCENE
|748
!0
|colspan=8|
|-
!colspan=2|PLAYER_MADE_PROGRESS
|785
!1
|I||colspan=7|
|-
!colspan=2|SET_PROGRESS_TOTAL
|786
!1
|I||colspan=7|
|-
|colspan=2|REGISTER_MISSION_GIVEN
|796
!0
|colspan=8|
|-
!colspan=2|REGISTER_MISSION_PASSED
|797
!1
|T||colspan=7|
|-
!colspan=2|SCRIPT_NAME
|937
!1
|T||colspan=7|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION
|1051
!1
|R||colspan=7|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION_INTERNAL
|1052
!1
|I||colspan=7|
|-
!colspan=2|SET_TOTAL_NUMBER_OF_MISSIONS
|1073
!1
|I||colspan=7|
|-
!rowspan=2|=<br/>IS_THING_EQUAL_TO_THING!!IS_INT_VAR_EQUAL_TO_CONSTANT
|1192
!rowspan=2|2
|VI||C||colspan=6|
|-
!IS_INT_LVAR_EQUAL_TO_CONSTANT
|1193||LI||C||colspan=6|
|-
!rowspan=2|=<br/>SET!!SET_VAR_INT_TO_CONSTANT
|1203
!rowspan=2|2
|VI||C||colspan=6|
|-
!SET_LVAR_INT_TO_CONSTANT
|1204||LI||C||colspan=6|
|-
!rowspan=4|><br/><=<br/>IS_THING_GREATER_THAN_THING!!IS_INT_VAR_GREATER_THAN_CONSTANT
|1205
!rowspan=4|2
|VI||C||colspan=6|
|-
!IS_INT_LVAR_GREATER_THAN_CONSTANT
|1206||LI||C||colspan=6|
|-
!IS_CONSTANT_GREATER_THAN_INT_VAR
|1207||C||VI||colspan=6|
|-
!IS_CONSTANT_GREATER_THAN_INT_LVAR
|1208||C||LI||colspan=6|
|-
!rowspan=4|>=<br/><<br/>IS_THING_GREATER_OR_EQUAL_TO_THING!!IS_INT_VAR_GREATER_OR_EQUAL_TO_CONSTANT
|1209
!rowspan=4|2
|VI||C||colspan=6|
|-
!IS_INT_LVAR_GREATER_OR_EQUAL_TO_CONSTANT
|1210||LI||C||colspan=6|
|-
!IS_CONSTANT_GREATER_OR_EQUAL_TO_INT_VAR
|1211||C||VI||colspan=6|
|-
!IS_CONSTANT_GREATER_OR_EQUAL_TO_INT_LVAR
|1212||C||LI||colspan=6|
|-
!colspan=2|REGISTER_ODDJOB_MISSION_PASSED
|1434
!0
|colspan=8|
|-
!rowspan=2 colspan=2|CALL{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}
|rowspan=2|1454
!rowspan=2|1+i+o
|rowspan=2|R
|colspan=7|AM
|-
|colspan=7|VLM
|-
!rowspan=2 colspan=2|CALLNOT{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}
|rowspan=2|1455
!rowspan=2|1+i+o
|rowspan=2|R
|colspan=7|AM
|-
|colspan=7|VLM
|-
|colspan=12|{{icon|vcs}}
|-
!rowspan=7|=<br/>SET!!SET_INT{{ref|likely|[*]}}
|4

!rowspan=7|2
|VLI||I||colspan=6|
|-
!SET_FLOAT{{ref|likely|[*]}}
|5||VLF||F||colspan=6|
|-
!SET_TEXT_LABEL{{ref|likely|[*]}}
|6||VLT||T||colspan=6|
|-
!SET_INT_TO_INT{{ref|likely|[*]}}
|53||VLI||VLI||colspan=6|
|-
!SET_FLOAT_TO_FLOAT{{ref|likely|[*]}}
|54||VLF||VLF||colspan=6|
|-
!SET_TEXT_LABEL_TO_TEXT_LABEL{{ref|likely|[*]}}
|55||VLT||VLT||colspan=6|
|-
!SET_INT_TO_CONSTANT{{ref|likely|[*]}}
|738||VLI||C||colspan=6|
|-
!rowspan=4|+=<br/>+<br/>ADD_THING_TO_THING!!ADD_VAL_TO_INT{{ref|likely|[*]}}
|7
!rowspan=4|2
|VLI||I||colspan=6|
|-
!ADD_VAL_TO_FLOAT{{ref|likely|[*]}}
|8||VLF||F||colspan=6|
|-
!ADD_INT_TO_INT{{ref|likely|[*]}}
|41||VLI||VLI||colspan=6|
|-
!ADD_FLOAT_TO_FLOAT{{ref|likely|[*]}}
|42||VLF||VLF||colspan=6|
|-
!rowspan=4|-=<br/>-<br/>SUB_THING_FROM_THING!!SUB_VAL_FROM_INT{{ref|likely|[*]}}
|9
!rowspan=4|2
|VLI||I||colspan=6|
|-
!SUB_VAL_FROM_FLOAT{{ref|likely|[*]}}
|10||VLF||F||colspan=6|
|-
!SUB_INT_FROM_INT{{ref|likely|[*]}}
|43||VLI||VLI||colspan=6|
|-
!SUB_FLOAT_FROM_FLOAT{{ref|likely|[*]}}
|44||VLF||VLF||colspan=6|
|-
!rowspan=4|*=<br/>*<br/>MULT_THING_BY_THING!!MULT_INT_BY_VAL{{ref|likely|[*]}}
|11
!rowspan=4|2
|VLI||I||colspan=6|
|-
!MULT_FLOAT_BY_VAL{{ref|likely|[*]}}
|12||VLF||F||colspan=6|
|-
!MULT_INT_BY_INT{{ref|likely|[*]}}
|45||VLI||VLI||colspan=6|
|-
!|MULT_FLOAT_BY_FLOAT{{ref|likely|[*]}}
|46||VLF||VLF||colspan=6|
|-
!rowspan=4|/=<br/>/<br/>DIV_THING_BY_THING!!DIV_INT_BY_VAL{{ref|likely|[*]}}
|13
!rowspan=4|2
|VLI||I||colspan=6|
|-
!DIV_FLOAT_BY_VAL{{ref|likely|[*]}}
|14||VLF||F||colspan=6|
|-
!DIV_INT_BY_INT{{ref|likely|[*]}}
|47||VLI||VLI||colspan=6|
|-
!DIV_FLOAT_BY_FLOAT{{ref|likely|[*]}}
|48||VLF||VLF||colspan=6|
|-
!rowspan=8|><br/><=<br/>IS_THING_GREATER_THAN_THING!!IS_INT_GREATER_THAN_NUMBER{{ref|likely|[*]}}
|15
!rowspan=8|2
|VLI||I||colspan=6|
|-
!IS_NUMBER_GREATER_THAN_INT{{ref|likely|[*]}}
|16||I||VLI||colspan=6|
|-
!IS_INT_GREATER_THAN_INT{{ref|likely|[*]}}
|17||VLI||VLI||colspan=6|
|-
!IS_FLOAT_GREATER_THAN_NUMBER{{ref|likely|[*]}}
|18||VLF||F||colspan=6|
|-
!IS_NUMBER_GREATER_THAN_FLOAT{{ref|likely|[*]}}
|19||F||VLF||colspan=6|
|-
!IS_FLOAT_GREATER_THAN_FLOAT{{ref|likely|[*]}}
|20||VLF||VLF||colspan=6|
|-
!IS_INT_GREATER_THAN_CONSTANT{{ref|likely|[*]}}
|739||VLI||C||colspan=6|
|-
!IS_CONSTANT_GREATER_THAN_INT{{ref|likely|[*]}}
|740||C||VLI||colspan=6|
|-
!rowspan=8|>=<br/><<br/>IS_THING_GREATER_OR_EQUAL_TO_THING!!IS_INT_GREATER_OR_EQUAL_TO_NUMBER{{ref|likely|[*]}}
|21
!rowspan=8|2
|VLI||I||colspan=6|
|-
!IS_NUMBER_GREATER_OR_EQUAL_TO_INT{{ref|likely|[*]}}
|22||I||VLI||colspan=6|
|-
!IS_INT_GREATER_OR_EQUAL_TO_INT{{ref|likely|[*]}}
|23||VLI||VLI||colspan=6|
|-
!IS_FLOAT_GREATER_OR_EQUAL_TO_NUMBER{{ref|likely|[*]}}
|24||VLF||F||colspan=6|
|-
!IS_NUMBER_GREATER_OR_EQUAL_TO_FLOAT{{ref|likely|[*]}}
|25||F||VLF||colspan=6|
|-
!IS_FLOAT_GREATER_OR_EQUAL_TO_FLOAT{{ref|likely|[*]}}
|26||VLF||VLF||colspan=6|
|-
!IS_INT_GREATER_OR_EQUAL_TO_CONSTANT{{ref|likely|[*]}}
|741||VLI||C||colspan=6|
|-
!IS_CONSTANT_GREATER_OR_EQUAL_TO_INT{{ref|likely|[*]}}
|742||C||VLI||colspan=6|
|-
!rowspan=7|=<br/>IS_THING_EQUAL_TO_THING!!IS_INT_EQUAL_TO_NUMBER{{ref|likely|[*]}}
|27
!rowspan=7|2
|VLI||I||colspan=6|
|-
!IS_INT_EQUAL_TO_INT{{ref|likely|[*]}}
|28||VLI||VLI||colspan=6|
|-
!IS_FLOAT_EQUAL_TO_NUMBER{{ref|likely|[*]}}
|29||VLF||F||colspan=6|
|-
!IS_FLOAT_EQUAL_TO_FLOAT{{ref|likely|[*]}}
|30||VLF||VLF||colspan=6|
|-
!IS_TEXT_LABEL_EQUAL_TO_STRING{{ref|likely|[*]}}
|31||VLT||T||colspan=6|
|-
!IS_TEXT_LABEL_EQUAL_TO_TEXT_LABEL{{ref|likely|[*]}}
|32||VLT||VLT||colspan=6|
|-
!IS_INT_EQUAL_TO_CONSTANT{{ref|likely|[*]}}
|731||VLI||C||colspan=6|
|-
!colspan=2|GOTO_IF_TRUE{{ref|statem|[*]}}
|33
!1
|R||colspan=7|
|-
!colspan=2|GOTO_IF_FALSE{{ref|statem|[*]}}
|34
!1
|R||colspan=7|
|-
!colspan=2|TERMINATE_THIS_SCRIPT
|rowspan=2|35
!rowspan=2|0
|rowspan=2 colspan=8|
|-
!colspan=2|MISSION_END
|-
!colspan=2|START_NEW_SCRIPT{{ref|undarg|[*]}}
|36
!1+l
|R||colspan=7|AM
|-
|colspan=2|GOSUB
|37
!1
|R||colspan=7|
|-
|colspan=2|RETURN
|38
!0
|colspan=8|
|-
!rowspan=2|+=@<br/>+@<br/>ADD_THING_TO_THING_TIMED!!ADD_TIMED_VAL_TO_FLOAT{{ref|likely|[*]}}
|49
!rowspan=2|2
|VLF||F||colspan=6|
|-
!ADD_TIMED_FLOAT_TO_FLOAT{{ref|likely|[*]}}
|50||VLF||VLF||colspan=6|
|-
!rowspan=2|-=@<br/>-@<br/>SUB_THING_FROM_THING_TIMED!!SUB_TIMED_VAL_FROM_FLOAT{{ref|likely|[*]}}
|51
!rowspan=2|2
|VLF||F||colspan=6|
|-
!SUB_TIMED_FLOAT_FROM_FLOAT{{ref|likely|[*]}}
|52||VLF||VLF||colspan=6|
|-
!rowspan=2|=#<br/>CSET!!CSET_INT_TO_FLOAT{{ref|likely|[*]}}
|56
!rowspan=2|2
|VLI||VLF||colspan=6|
|-
!CSET_FLOAT_TO_INT{{ref|likely|[*]}}
|57||VLF||VLI||colspan=6|
|-
!rowspan=2|ABS!!ABS_INT{{ref|likely|[*]}}
|58
!rowspan=2|1
|VLI||colspan=7|
|-
!ABS_FLOAT{{ref|likely|[*]}}
|59||VLF||colspan=7|
|-
|colspan=2|RETURN_TRUE
|94
!0
|colspan=8|
|-
|colspan=2|RETURN_FALSE
|95
!0
|colspan=8|
|-
!colspan=2|VAR_INT{{ref|defvar|[*]}}{{ref|posngs|[*]}}
|96
!n
|VI||colspan=7|VIO
|-
!colspan=2|VAR_FLOAT{{ref|defvar|[*]}}{{ref|posngs|[*]}}
|97
!n
|VF||colspan=7|VFO
|-
!colspan=2|LVAR_INT{{ref|defvar|[*]}}{{ref|posngs|[*]}}
|98
!n
|LI||colspan=7|LIO
|-
!colspan=2|LVAR_FLOAT{{ref|defvar|[*]}}{{ref|posngs|[*]}}
|99
!n
|LF||colspan=7|LFO
|-
!colspan=2|VAR_TEXT_LABEL{{ref|defvar|[*]}}{{ref|posngs|[*]}}
|100
!n
|VT||colspan=7|VTO
|-
!colspan=2|LVAR_TEXT_LABEL{{ref|defvar|[*]}}{{ref|posngs|[*]}}
|101
!n
|LT||colspan=7|LTO
|-
!colspan=2|{{{ref|embdsc|[*]}}{{ref|posngs|[*]}}
|102
!0
|colspan=8|
|-
!colspan=2|}{{ref|embdsc|[*]}}{{ref|posngs|[*]}}
|103
!0
|colspan=8|
|-
!colspan=2|IF{{ref|statem|[*]}}{{ref|posngs|[*]}}
|104
!1
|I||colspan=7|
|-
!colspan=2|IFNOT{{ref|statem|[*]}}{{ref|posngs|[*]}}
|105
!1
|I||colspan=7|
|-
!colspan=2|ELSE{{ref|statem|[*]}}{{ref|posngs|[*]}}
|106
!0
|colspan=8|
|-
!colspan=2|ENDIF{{ref|statem|[*]}}{{ref|posngs|[*]}}
|107
!0
|colspan=8|
|-
!colspan=2|WHILE{{ref|statem|[*]}}{{ref|posngs|[*]}}
|108
!1
|I||colspan=7|
|-
!colspan=2|WHILENOT{{ref|statem|[*]}}{{ref|posngs|[*]}}
|109
!1
|I||colspan=7|
|-
!colspan=2|ENDWHILE{{ref|statem|[*]}}{{ref|posngs|[*]}}
|110
!0
|colspan=8|
|-
!colspan=2|REPEAT{{ref|statem|[*]}}{{ref|posngs|[*]}}
|111
!2
|I||VLI||colspan=6|
|-
!colspan=2|ENDREPEAT{{ref|statem|[*]}}{{ref|posngs|[*]}}
|112
!0
|colspan=8|
|-
!colspan=2|SWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}
|113
!1
|VLI||colspan=7|
|-
!colspan=2|ENDSWITCH{{ref|statem|[*]}}{{ref|posngs|[*]}}
|114
!0
|colspan=8|
|-
!colspan=2|CASE{{ref|statem|[*]}}{{ref|posngs|[*]}}
|115
!1
|I||colspan=7|
|-
!colspan=2|DEFAULT{{ref|statem|[*]}}{{ref|posngs|[*]}}
|116
!0
|colspan=8|
|-
!colspan=2|BREAK{{ref|statem|[*]}}{{ref|posngs|[*]}}
|117
!0
|colspan=8|
|-
!colspan=2|ANDOR{{ref|statem|[*]}}
|120
!1
|I||colspan=7|
|-
!colspan=2|LAUNCH_MISSION
|121
!1
|R||colspan=7|
|-
!colspan=2|SAVE_VAR_INT{{ref|defvar|[*]}}
|297
!l
|VI||colspan=7|VIO
|-
!colspan=2|SAVE_VAR_FLOAT{{ref|defvar|[*]}}
|298
!l
|VF||colspan=7|VFO
|-
!colspan=2|SAVE_VAR_TEXT_LABEL{{ref|defvar|[*]}}
|299
!l
|VT||colspan=7|VTO
|-
!colspan=2|GOSUB_FILE
|442
!2
|R||R||colspan=6|
|-
!colspan=2|PLAYER_MADE_PROGRESS
|479
!1
|I||colspan=7|
|-
!colspan=2|SET_PROGRESS_TOTAL
|480
!1
|I||colspan=7|
|-
|colspan=2|REGISTER_MISSION_GIVEN
|490
!0
|colspan=8|
|-
!colspan=2|REGISTER_MISSION_PASSED
|491
!1
|T||colspan=7|
|-
!colspan=2|SCRIPT_NAME
|568
!1
|T||colspan=7|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION
|648
!1
|R||colspan=7|
|-
!colspan=2|LOAD_AND_LAUNCH_MISSION_INTERNAL
|649
!1
|I||colspan=7|
|-
!colspan=2|SET_TOTAL_NUMBER_OF_MISSIONS
|662
!1
|I||colspan=7|
|-
!colspan=2|REGISTER_ODDJOB_MISSION_PASSED
|874
!0
|colspan=8|
|-
!rowspan=2 colspan=2|CALL{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}
|rowspan=2|890
!rowspan=2|1+i+o
|rowspan=2|R
|colspan=7|AM
|-
|colspan=7|VLM
|-
!rowspan=2 colspan=2|CALLNOT{{ref|undarg|[*]}}{{ref|argvar|[*]}}{{ref|likely|[*]}}
|rowspan=2|891
!rowspan=2|1+i+o
|rowspan=2|R
|colspan=7|AM
|-
|colspan=7|VLM
|-
!colspan=2|SET_COLLECTABLE2_TOTAL
|1242
!1
|I||colspan=7|
|}
</div>

;Notes
:{{note|misdef}} A special [[#Mission scripts|mission]] directive which is never compiled;
:{{note|statem}} It is used to build the various [[#Control flows|control flows]] internally;
:{{note|defvar}} It is used to declare one or more variables;
:{{note|embdsc}} It embeds a variable scope;
:{{note|undarg}} It has an undefined amount of arguments;
:{{note|likely}} It is a likely definition of the standard command;
:{{note|posngs}} It should exist but its position is purely guessed;
:{{note|argvar}} Arguments amount varies when compiling.

{{incomplete}}

==Uncommon values==

Arguments of some commands keep uncommon [[#Value|values]] which look familiar after encoding:

<div width=100% style="overflow: auto; margin: -8px auto 8px">
{|class=wikitable style=text-align:center
|-
!rowspan=2|Command
!rowspan=2|Arg.<br/>ID
!rowspan=2|Value
!colspan=4|Encoded
|-
!Command!!Arg.<br/>ID!!Value!!Type
|-
|colspan=7|{{icon|t}} {{icon|lcs}} {{icon|vcs}}
|-
!GOTO
|1||Generic [[#Labels|label]]
!GOTO
|1||Positive/Negative [[#Offsets|offset]]||INT
|-
!GOTO_IF_FALSE
|1||Generic label
!GOTO_IF_FALSE
|1||Positive/Negative offset||INT
|-
!GOSUB
|1||[[#Gosubs|Gosub]] label
!GOSUB
|1||Positive/Negative offset||INT
|-
!rowspan=4|GOSUB_FILE
|1||Gosub label
!rowspan=4|GOSUB_FILE
|1||rowspan=2|Zero-based offset||rowspan=4|INT
|-
|2||[[#Foreign gosubs|Foreign gosub]] file||2
|-
|1||Gosub label||1||rowspan=2|Positive/Negative offset
|-
|2||Foreign gosub label||2
|-
!rowspan=2|START_NEW_SCRIPT
|1||[[#Scripts|Script]] label
!rowspan=2|START_NEW_SCRIPT
|1||Positive/Negative offset||INT
|-
|l||Passed [[#Local|locals]]||l||Passed locals||ANY_MULTI
|-
!rowspan=2|LAUNCH_MISSION
|rowspan=2|1||[[#Subscripts|Subscript]] file
!rowspan=2|LAUNCH_MISSION
|rowspan=2|1||Zero-based offset||rowspan=2|INT
|-
|Subscript label||Positive/Negative offset
|-
!rowspan=2|LOAD_AND_LAUNCH_MISSION
|rowspan=2|1||[[#Mission scripts|Mission script]] file
!LOAD_AND_LAUNCH_MISSION_INTERNAL
|rowspan=2|1||Mission [[#Identifiers|identifier]]||rowspan=2|INT
|-
|Mission script label
!LOAD_AND_LAUNCH_MISSION
|Positive/Negative offset
|-
|colspan=7|{{icon|3}} {{icon|lcs}} {{icon|vcs}}
|-
!GOTO_IF_TRUE
|1||Generic label
!GOTO_IF_TRUE
|1||Positive/Negative offset||INT
|-
|colspan=7|{{icon|vc}} {{icon|sa}}
|-
!rowspan=2|LOAD_AND_LAUNCH_MISSION_EXCLUSIVE
|rowspan=2|1||Mission script file
!LOAD_AND_LAUNCH_MISSION_INTERNAL
|rowspan=2|1||Negative mission identifier||rowspan=2|INT
|-
|Mission script label
!LOAD_AND_LAUNCH_MISSION_EXCLUSIVE
|Positive/Negative offset
|-
|colspan=7|{{icon|lcs}} {{icon|vcs}}
|-
!rowspan=6|CALL<br/>CALLNOT
|rowspan=4|1||rowspan=4|[[#Functions|Function]] label
!rowspan=6|CALL<br/>CALLNOT
|1||# of input arguments||rowspan=4|INT
|-
|2||# of output arguments
|-
|3||# of script locals
|-
|4||Positive/Negative offset
|-
|i||Input arguments||i||Input arguments||ANY_MULTI
|-
|o||Output arguments||o||Output arguments||HOLD_MULTI
|}
</div>

{{incomplete}}

==Compare flag==

The ''compare flag'' is an internal script-dependent flag which makes conditional '''GOTO'''s such as [[#GOTO_IF_TRUE|GOTO_IF_TRUE]] (unavailable in {{icon|t}}) and [[#GOTO_IF_FALSE|GOTO_IF_FALSE]] deciding whether to jump otherwise. It can handle up to ''8 checks'' per conditional statement and indicates you are verifying a single condition (0, see also [[#Optimization|Optimization]]) or multiple conditions with either '''AND''' (1 to 8) or '''OR''' (21 to 28) [[#Logical|logical operators]] (see also [[#ANDOR|ANDOR]]).

==Control flows analysis==

As an overview of the compiled source, [[#Control flows|control flows]] are literally nested meaning that the code is unoptimized. Furthermore, the jump of an embedded construct doesn't get merged with that of the construct itself, which consists of a benefit for the code parsing.

===IF===

As regards the [[#IF|IF]] control flow, if the whole check is true the ''consequence'' is performed and the code jumps to the end of the construct, otherwise it skips to the ''alternative'' (see also [[#Compare flag|Compare flag]]):

{|width=100%
!width=50%|Decompiled
!width=1px|{{icon|t}}
!width=1px|{{icon|lcs}}
!width=1px|{{icon|vcs}}
!Compiled
|-
|
IF [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
[ELSE
{alternative}]
ENDIF
|
{..214}
{.....}
{.....}
{...77}
{.....}
{....2}
-----
{.....}
-----
|
{..219}
{.....}
{.....}
{...77}
{.....}
{....2}
-----
{.....}
-----
|
{..120}
{.....}
{.....}
{...34}
{.....}
{....2}
-----
{.....}
-----
|
ANDOR {value}
[NOT] {condition0}
[[NOT] {condition8}]
GOTO_IF_FALSE ELSE
{consequence}
[GOTO ENDIF]
ELSE:
[{alternative}
ENDIF:]
|}

===IFNOT===

Not that much to say more than the preceding construct, the [[#IFNOT|IFNOT]] control flow is built nearly in the same way. In fact, the '''ELSE''' clause points to the ''alternative'', whereas the [[#GOTO|GOTO]] jumps to its end. The substantial difference consists in the substitution of [[#GOTO_IF_FALSE|GOTO_IF_FALSE]] with [[#GOTO_IF_TRUE|GOTO_IF_TRUE]]:

{|width=100%
!width=50%|Decompiled
!width=1px|{{icon|3}}
!width=1px|{{icon|lcs}}
!width=1px|{{icon|vcs}}
!Compiled
|-
|
IFNOT [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
[ELSE
{alternative}]
ENDIF
|
{..214}
{.....}
{.....}
{...76}
{.....}
{....2}
-----
{.....}
-----
|
{..219}
{.....}
{.....}
{...76}
{.....}
{....2}
-----
{.....}
-----
|
{..120}
{.....}
{.....}
{...33}
{.....}
{....2}
-----
{.....}
-----
|
ANDOR {value}
[NOT] {condition0}
[[NOT] {condition8}]
GOTO_IF_TRUE ELSE
{consequence}
[GOTO ENDIF]
ELSE:
[{alternative}
ENDIF:]
|}

===WHILE===

The [[#WHILE|WHILE]] control flow is built pretty much similarly to the previous, even though when the ''consequence'' is read the code is moved to the beginning of the construct:

{|width=100%
!width=50%|Decompiled
!width=1px|{{icon|t}}
!width=1px|{{icon|lcs}}
!width=1px|{{icon|vcs}}
!Compiled
|-
|
WHILE [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
ENDWHILE
|
-----
{..214}
{.....}
{.....}
{...77}
{.....}
{....2}
-----
|
-----
{..219}
{.....}
{.....}
{...77}
{.....}
{....2}
-----
|
-----
{..120}
{.....}
{.....}
{...34}
{.....}
{....2}
-----
|
WHILE:
ANDOR {value}
[NOT] {condition0}
[[NOT] {condition8}]
GOTO_IF_FALSE ENDWHILE
{consequence}
GOTO WHILE
ENDWHILE:
|}

===WHILENOT===

To say the least, [[#WHILENOT|WHILENOT]] control flow follows the same constitution of both [[#WHILE|WHILE]] and [[#IFNOT|IFNOT]] constructs, by exchanging [[#GOTO_IF_FALSE|GOTO_IF_FALSE]] with [[#GOTO_IF_TRUE|GOTO_IF_TRUE]]:

{|width=100%
!width=50%|Decompiled
!width=1px|{{icon|3}}
!width=1px|{{icon|lcs}}
!width=1px|{{icon|vcs}}
!Compiled
|-
|
WHILENOT [NOT] {condition0}
[AND|OR [NOT] {condition8}]
{consequence}
ENDWHILE
|
-----
{..214}
{.....}
{.....}
{...76}
{.....}
{....2}
-----
|
-----
{..219}
{.....}
{.....}
{...76}
{.....}
{....2}
-----
|
-----
{..120}
{.....}
{.....}
{...33}
{.....}
{....2}
-----
|
WHILENOT:
ANDOR {value}
[NOT] {condition0}
[[NOT] {condition8}]
GOTO_IF_TRUE ENDWHILE
{consequence}
GOTO WHILENOT
ENDWHILE:
|}

===REPEAT===

Seemingly, the [[#REPEAT|REPEAT]] control flow is the first construct ever optimized as a result of a possible R* compiler fault. Moreover, it sounds ambiguous as it loops at least once. This was probably the intention of R* programmers, that is iterating at least once else the construct is useless. However, there are few chance they decide to use such structure to avoid some conflict with some other constructs:

{|width=100%
!width=50%|Decompiled
!colspan=2|G/L {{icon|vc}} {{icon|sa}} {{icon|lcs}}
!width=1px|G/L {{icon|vcs}}
!Compiled
|-
|
REPEAT {times} {varname}
{consequence}
ENDREPEAT
|width=1px|
{....4}
-----
{.....}
{....8}
{...40}
{...77}
|width=1px|
{....5}
-----
{.....}
{....9}
{...41}
{...77}
|
{....4}
-----
{.....}
{....7}
{...21}
{...34}
|
{varname} = {value0}
LOOP:
{consequence}
++ {varname}
{varname} >= {valueN}
GOTO_IF_FALSE LOOP
|}

===SWITCH===

In {{icon|sa}}, the [[#SWITCH|SWITCH]] control flow is more complex and efficient because the game uses internally a [[Wikipedia:Binary_search_algorithm|binary search algorithm]] to jump at the [[#Labels|label]] that matches with the value of a particular case. This method requires a known amount of cases which is up to 75. When a case is true, a ''consequence'' is executed and the code jumps to the end of the construct, otherwise the ''alternative'' may be performed. As the code is unoptimized, the [[#GOTO|GOTO]] of the last case is still compiled even though its label points right after the command mentioned earlier:

{|width=100%
!width=20%|Decompiled
!width=1px|{{icon|sa}}
!Compiled
|-
|
SWITCH {varname}
CASE {value0}
{consequence}
BREAK
[CASE {valueN}
{consequence}
BREAK]
[DEFAULT
{alternative}
BREAK]
ENDSWITCH
|
{.2161}
{.2162}
-----
{.....}
{....2}
-----
{.....}
{....2}
-----
{.....}
{....2}
-----
|
SWITCH_START {varname} {numcases} {isdefault} DEFAULT {value0} CASE0 ...
[SWITCH_CONTINUED ... {valueN} CASEN [-1 ENDSWITCH]]
CASE0:
{consequence}
GOTO ENDSWITCH
[CASEN:
{consequence}
GOTO ENDSWITCH]
[DEFAULT:
{alternative}
GOTO ENDSWITCH]
ENDSWITCH:
|}

In {{icon|lcs}} and {{icon|vcs}}, such control flow is a set of nested [[#IF|IF]] constructs which causes a very slight loss of performance by considering that [[#ANDOR|ANDOR]] isn't compiled:

{|width=100%
!width=50%|Decompiled
!colspan=2|G/L {{icon|lcs}}
!width=1px|G/L {{icon|vcs}}
!Compiled
|-
|
SWITCH {varname}
CASE {value0}
{consequence}
BREAK]
[CASE {valueN}
{consequence}
BREAK]
[DEFAULT
{alternative}
BREAK]
ENDSWITCH
|width=1px|
-----
{...56}
{...77}
{.....}
{....2}
-----
{...56}
{...77}
{.....}
{....2}
-----
{.....}
-----
-----
|width=1px|
-----
{...57}
{...77}
{.....}
{....2}
-----
{...57}
{...77}
{.....}
{....2}
-----
{.....}
-----
-----
|
-----
{...27}
{...34}
{.....}
{....2}
-----
{...27}
{...34}
{.....}
{....2}
-----
{.....}
-----
-----
|
CASE0:
{varname} = {value0}
GOTO_IF_FALSE CASEN
{consequence}
GOTO ENDSWITCH0
CASEN:
[{varname} = {valueN}
GOTO_IF_FALSE DEFAULT
{consequence}
GOTO ENDSWITCHN
DEFAULT:
[{alternative}
ENDSWITCHN:]]
ENDSWITCH0:
|}

==Optimization==

In {{icon|lcs}} and {{icon|vcs}}, whenever a ''single condition'' is checked [[#ANDOR|ANDOR]] doesn't get compiled cause no [[#Logical|logical operator]] ('''AND''', '''OR''') is used and so they become really useless. Its lack increases the script efficiency a lot. However, the jump of the '''ELSE''' clause of an [[#IF|IF]] statement which points to the end of the construct is still compiled after a [[#GOTO|GOTO]]. Furthermore, ''Stories Games'' come with an improved data type managing which causes a considerable decrease of the compiled file size.

=Tools=

* [[SCRambl]] - an open-source tool provided by {{U|Deji}}
* [[Mission Scripting Tools]]

=See also=
* [[SCM language III/VC definitions]]

=External links=

*{{icon|2}} [http://gtamp.com/GTA2/gta2script.7z DMA's official GTA2script Compiler V9.6], [http://projectcerbera.com/gta/2/tutorials/scripting DMA's official GTA2script information] - found into the game copy
*{{icon|3}} [https://www.dropbox.com/s/bwxqe33c8ownfc8/gta3ta_source.rar GTA III 10th Anniversary source] - found into the ''iOS'' game copy
*{{icon|3}} [http://pastebin.com/Pfwscpeh GTA III unofficial main.sc] - Reconstruction of main.sc, missing from the iOS source code, by {{U|Link2012}}
*{{icon|3}} {{icon|vc}} [http://pastebin.com/raw.php?i=T73rCdDd GTA III/VC unavailable script commands (possibly NOP'd)] - some sort of information by {{U|Wesser}} as a result of the reverse-engineering applied to the [http://www.rockstargames.com/ Rockstar Games]' official '''GTA3 Script Compiler V413'''
*{{icon|3}} {{icon|vc}} [https://www.dropbox.com/s/7xgvqo8b9u1qw02/gta3sc_v413.rar Official GTA3 Script Compiler V413] - found into the ''GTA VC 10th Anniversary'' copy
*{{icon|3}} {{icon|vc}} [http://pastebin.com/raw.php?i=Pjb0Ezkx GTA3 Script Compiler V413 Compilation Strings] - a list by {{U|Wesser}} of all the error messages the compiler can throw and more
*{{icon|sa}} [http://pastebin.com/raw.php?i=Ra9JLLeN GTA SA PC/PS2/XBOX script commands], [http://pastebin.com/raw.php?i=kCwS6rdG GTA SA Mobile script commands] - taken directly from the ''Android'' application and rearranged by {{U|Wesser}}
*{{GTAF|441362|Reconstructing the III .sc language}} – a post by {{U|NTAuthority}}

{{N|SA|VC|3}}

[[Category:Mission Script]]

SCM Instruction

2019-01-13T05:11:46Z

Tomas.:

{{This|This article deals with the technical information on the opcode format. For the opcodes documentation see [[list of opcodes]]}}
Each script instruction is represented by a number called '''opcode''' or [[Wikipedia:Opcode|operation code]] which is implemented using an [[Wikipedia:UINT16|16 bit unsigned integer]]. By this number the game engine identifies an action to perform. Say, an opcode [[0001]] tells to wait for amount of time, [[0003]] shakes the camera, [[0053]] creates a player, etc.

__TOC__

== Format ==

Initially the instructions are written in a human-readable form. For example, a ''wait'' instruction could look like this:
wait 0
where the word ''wait'' is a compiler-dependent representation of the opcode 0001 and the number <code>0</code> is a single parameter for this particular instruction. When a mission script is assembled, the instructions are written back in raw byte form:

{{hint|0100|opcode}} {{hint|04|Data type}} {{hint|00|Parameter value}}

* First part is the opcode number in a [[Wikipedia:Endianness|little-endian]] format.
* Second part is the [[#Data types|data type]]
* Third part is the parameter value

As it has been said, an opcode is UINT16 number. It means the minimum opcode is [[0000]] and maximum opcode is 0xFFFF. However due to a specific of the [[SCM language]], any numbers above 0x7FFF denote negative [[Conditional statement|conditional opcodes]]. The original unmodded game supports a way smaller amount of opcodes (maximum [[0A4E]] for [[San Andreas]]), but there are tools adding new ones, most notably [[CLEO|CLEO Library]].

There could be zero or more instruction parameters following the opcode number{{Ref|05B6|[*]}}.

=== Parameters ===
The game engine knows amount of parameters for each instruction (1 for [[0001]], 2 for [[0004]], 13 for [[014B]], etc). If the script contains other number of parameters it causes a crash.

The value of a parameter could be one of following types:
* Immediate values
** integer numbers
** floating-point numbers
** [[#Strings|fixed-length strings]]
** {{icon|sa}} [[#Strings|variable-length strings]]
* Variables
** global variables
** local variables
* {{icon|sa}} {{icon|lcs}} {{icon|vcs}} [[#Arrays|arrays]]

A concrete type of the value is determined by a single byte written before it{{ref|vcstr|[*]}}. This byte is called a data type. The purpose of it is to tell to the game how much bytes to read and how to treat it.

==== Data types ====
A '''[[wikipedia:Data type|data type]]''' is a classification of identifying the type of a value. Types commonly used in GTA include integer numbers, floating-point numbers, and strings. The amount of data allowed to be stored is limited by the type and size of the data. For integers there are two ways to represent the data, signed and unsigned, whereas floating-point values are always signed. A signed data range includes negative numbers while unsigned do not include negatives. The following list shows the types and sizes of data in bytes.

{|class="mw-collapsible mw-collapsed wikitable"
!Data type<br/>(hex)
!Arg.<br/>length
!Target<br/>game
!Description 
|-
!colspan=6|Typified
|-valign="top"
|00||0||{{icon|3}} {{icon|vc}} {{icon|sa}}||End of argument list (EOAL, [[004F]] or [[0913]] and similar){{ref|partype0|[*]}}
|-valign="top"
|01||4||{{icon|3}} {{icon|vc}} {{icon|sa}}||Immediate 32-bit signed int
<source lang="cpp">scriptParam.m_iIntValue = *(int *)m_pScriptPC;
m_pScriptPC += 4;</source>
|-valign="top"
|02||2||{{icon|3}} {{icon|vc}} {{icon|sa}}||Global integer/floating-point variable
<source lang="cpp">scriptParam.m_usGlobalOffset = *(unsigned short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|03||2||{{icon|3}} {{icon|vc}} {{icon|sa}}||Local integer/floating-point variable
<source lang="cpp">scriptParam.m_sLocalVar = *(short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|04||1||{{icon|3}} {{icon|vc}} {{icon|sa}}||Immediate 8-bit signed int
<source lang="cpp">scriptParam.m_iIntValue = *(char *)m_pScriptPC++;</source>
|-valign="top"
|05||2||{{icon|3}} {{icon|vc}} {{icon|sa}}||Immediate 16-bit signed int
<source lang="cpp">scriptParam.m_iIntValue = *(short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|06||2||{{icon|3}}||Immediate 16-bit fixed-point (see [[Talk:Mission_Scripting_(Overview)#Fixed-point_remark|remark]])
<source lang="cpp">scriptParam.m_fFloatValue = (float)(*(short *)m_pScriptPC) / 16.0f;
m_pScriptPC += 2;</source>
|-valign="top"
|06||4||align="right"|{{icon|vc}} {{icon|sa}}||Immediate 32-bit floating-point
<source lang="cpp">scriptParam.m_fFloatValue = *(float *)m_pScriptPC;
m_pScriptPC += 4;</source>
|-valign="top"
|07||6||align="right"|{{icon|sa}}||Global integer/floating-point array{{ref|varray|[*]}}
<source lang="cpp">scriptParam.m_usGlobalOffset = *(unsigned short *)m_pScriptPC;
scriptParam.m_sArrayIndexVar = *(short *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 4);
scriptParam.m_arrayProperties = *(ArrayProperties *)(m_pScriptPC + 5);
m_pScriptPC += 6;</source>
|-valign="top"
|08||6||align="right"|{{icon|sa}}||Local integer/floating-point array{{ref|varray|[*]}}
<source lang="cpp">scriptParam.m_sLocalVar = *(short *)m_pScriptPC;
scriptParam.m_sArrayIndexVar = *(short *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 4);
scriptParam.m_arrayProperties = *(ArrayProperties *)(m_pScriptPC + 5);
m_pScriptPC += 6;</source>
|-valign="top"
|09||8||align="right"|{{icon|sa}}||Immediate 8-byte string{{ref|str8|[*]}}
<source lang="cpp">strcpy(scriptParam.m_szTextLabel, (char *)m_pScriptPC);
m_pScriptPC += 8;</source>
|-valign="top"
|0A||2||align="right"|{{icon|sa}}||Global 8-byte string variable
<source lang="cpp">scriptParam.m_usGlobalOffset = *(unsigned short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|0B||2||align="right"|{{icon|sa}}||Local 8-byte string variable
<source lang="cpp">scriptParam.m_sLocalVar = *(short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|0C||6||align="right"|{{icon|sa}}||Global 8-byte string array{{ref|varray|[*]}}
<source lang="cpp">scriptParam.m_usGlobalOffset = *(unsigned short *)m_pScriptPC;
scriptParam.m_sArrayIndexVar = *(short *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 4);
scriptParam.m_arrayProperties = *(ArrayProperties *)(m_pScriptPC + 5);
m_pScriptPC += 6;</source>
|-valign="top"
|0D||6||align="right"|{{icon|sa}}||Local 8-byte string array{{ref|varray|[*]}}
<source lang="cpp">scriptParam.m_sLocalVar = *(short *)m_pScriptPC;
scriptParam.m_sArrayIndexVar = *(short *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 4);
scriptParam.m_arrayProperties = *(ArrayProperties *)(m_pScriptPC + 5);
m_pScriptPC += 6;</source>
|-valign="top"
|0E||1 + (n - 1)||align="right"|{{icon|sa}}||Immediate variable-length string{{ref|str16|[*]}} (non null-terminated)
<source lang="cpp">char cStrLength = *(char *)m_pScriptPC++;
strncpy(scriptParam.m_szTextLabel, (char *)m_pScriptPC, cStrLength);
memset(&scriptParam.m_szTextLabel[cStrLength], '\0', ucMaxLength - cStrLength);
m_pScriptPC += cStrLength;</source>
|-valign="top"
|0F||16||align="right"|{{icon|sa}}||Immediate 16-byte string{{ref|sa16|[*]}}
<source lang="cpp">strcpy(scriptParam.m_szTextLabel, (char *)m_pScriptPC);
m_pScriptPC += 16;</source>
|-valign="top"
|10||2||align="right"|{{icon|sa}}||Global 16-byte string variable
<source lang="cpp">scriptParam.m_usGlobalOffset = *(unsigned short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|11||2||align="right"|{{icon|sa}}||Local 16-byte string variable
<source lang="cpp">scriptParam.m_sLocalVar = *(short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|12||6||align="right"|{{icon|sa}}||Global 16-byte string array{{ref|varray|[*]}}
<source lang="cpp">scriptParam.m_usGlobalOffset = *(unsigned short *)m_pScriptPC;
scriptParam.m_sArrayIndexVar = *(short *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 4);
scriptParam.m_arrayProperties = *(ArrayProperties *)(m_pScriptPC + 5);
m_pScriptPC += 6;</source>
|-valign="top"
|13||6||align="right"|{{icon|sa}}||Local 16-byte string array{{ref|varray|[*]}}
<source lang="cpp">scriptParam.m_sLocalVar = *(short *)m_pScriptPC;
scriptParam.m_sArrayIndexVar = *(short *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 4);
scriptParam.m_arrayProperties = *(ArrayProperties *)(m_pScriptPC + 5);
m_pScriptPC += 6;</source>
|-
!colspan=6|Untypified
|-valign="top"
|N/A||8||{{icon|3}} {{icon|vc}}||Immediate 8-byte string{{ref|vcstr|[*]}}
<source lang="cpp">strcpy(scriptParam.m_szTextLabel, (char *)m_pScriptPC);
m_pScriptPC += 8;</source>
|-valign="top"
|N/A||128||align="right"|{{icon|sa}}||Immediate 128-byte string
<source lang="cpp">strcpy(scriptParam.m_szString, (char *)m_pScriptPC);
m_pScriptPC += 128;</source>
|}

Depending of the preceeding data type, the parameter value compiled in two bytes <code>{{hint|02 00|Little-endian order}}</code>, could be treated either as the global variable <code style="color:blue">$2</code>, or a local variable <code style="color:blue">2@</code> or a number of <code style="color:maroon">2</code>. The data type allows the game to determine the correct parameter meaning.

Data types for [[Liberty City Stories]] and [[Vice City Stories]] are much different. First of all, many data types itself denote an immediate value. For example, data type 01 is a value of 0, data type 02 the value 0.0, etc. Floating-point values are packed (1, 2 or 3 bytes of length instead of the [[Wikipedia:IEEE_754-1985#Single-precision_32-bit|common 4]]). Some data types itself are somewhat the identifier of a variable.

{|class="mw-collapsible mw-collapsed wikitable"
!Data type<br/>(hex)
!Arg.<br/>length
!Target<br/>game
!Description 
|-
!colspan=5|Typified
|-valign="top"
|00||0||align="center"|{{icon|lcs}} {{icon|vcs}}||End of argument list (EOAL)
|-valign="top"
|01||0||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 8-bit signed integer constant 0
<source lang="cpp">scriptParam.m_iIntValue = 0;</source>
|-valign="top"
|02||0||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 8-bit floating-point constant 0.0
<source lang="cpp">scriptParam.m_fFloatValue = 0.0f;</source>
|-valign="top"
|03||1||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 8-bit packed floating-point
<source lang="cpp">unsigned int uiUnpackedFloat = *(unsigned char *)m_pScriptPC++ << 24;
scriptParam.m_fFloatValue = *(float *)&uiUnpackedFloat;</source>
|-valign="top"
|04||2||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 16-bit packed floating-point
<source lang="cpp">unsigned int uiUnpackedFloat = *(unsigned short *)m_pScriptPC << 16;
scriptParam.m_fFloatValue = *(float *)&uiUnpackedFloat;
m_pScriptPC += 2;</source>
|-valign="top"
|05||3||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 24-bit packed floating-point
<source lang="cpp">unsigned int uiUnpackedFloat
= (*(unsigned short *)m_pScriptPC << 16)
| (*(unsigned char *)(m_pScriptPC + 2) << 8);
scriptParam.m_fFloatValue = *(float *)&uiUnpackedFloat;
m_pScriptPC += 3;</source>
|-valign="top"
|06||4||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 32-bit signed integer
<source lang="cpp">scriptParam.m_iIntValue = *(int *)m_pScriptPC;
m_pScriptPC += 4;</source>
|-valign="top"
|07||1||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 8-bit signed integer
<source lang="cpp">scriptParam.m_iIntValue = *(char *)m_pScriptPC++;</source>
|-valign="top"
|08||2||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 16-bit signed integer
<source lang="cpp">scriptParam.m_iIntValue = *(short *)m_pScriptPC;
m_pScriptPC += 2;</source>
|-valign="top"
|09||4||align="center"|{{icon|lcs}} {{icon|vcs}}||Immediate 32-bit floating-point
<source lang="cpp">scriptParam.m_fFloatValue = *(float *)m_pScriptPC;
m_pScriptPC += 4;</source>
|-valign="top"
|0A||n + NUL||align="right"|{{icon|vcs}}||Immediate null-terminated string{{ref|strvcs|[*]}}
<source lang="cpp">strcpy(scriptParam.m_szTextLabel, (char *)m_pScriptPC);
m_pScriptPC += strlen((char *)m_pScriptPC) + 1;</source>
|-
!colspan=5|Untypified (script variables)
|-valign="top"
|T<0C||1||{{icon|lcs}}||Local timers (''TIMERA'', ''TIMERB'')
<source lang="cpp">scriptParam.m_sLocalVar = *(unsigned char *)m_pScriptPC++ + 0x5E;</source>
|-valign="top"
|T<0D||1||align="right"|{{icon|vcs}}||Local timers (''TIMERA'', ''TIMERB'')
<source lang="cpp">scriptParam.m_sLocalVar = *(unsigned char *)m_pScriptPC++ + 0x5D;</source>
|-valign="top"
|T<6C||1||{{icon|lcs}}||Local integer/floating-point variable
<source lang="cpp">scriptParam.m_sLocalVar = *(unsigned char *)m_pScriptPC++ - 0x0C;</source>
|-valign="top"
|T<6D||1||align="right"|{{icon|vcs}}||Local integer/floating-point variable
<source lang="cpp">scriptParam.m_sLocalVar = *(unsigned char *)m_pScriptPC++ - 0x0D;</source>
|-valign="top"
|T<CC||3||{{icon|lcs}}||Local integer/floating-point array
<source lang="cpp">scriptParam.m_sLocalVar = *(unsigned char *)m_pScriptPC - 0x6C;
scriptParam.m_sArrayIndex = *(unsigned char *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 3);
m_pScriptPC += 3;</source>
|-valign="top"
|T<CD||3||align="right"|{{icon|vcs}}||Local integer/floating-point array
<source lang="cpp">scriptParam.m_sLocalVar = *(unsigned char *)m_pScriptPC - 0x6D;
scriptParam.m_sArrayIndex = *(unsigned char *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 3);
m_pScriptPC += 3;</source>
|-valign="top"
|rowspan=2|T<E6||rowspan=2|2||{{icon|lcs}}||Global integer/floating-point variable
<source lang="cpp">unsigned short usBigEndianWord = *(unsigned short *)m_pScriptPC - 0x00CC;
scriptParam.m_sGlobalVar = (short)((usBigEndianWord << 8) | (usBigEndianWord >> 8));
m_pScriptPC += 2;</source>
|-valign="top"
|align="right"|{{icon|vcs}}||Global integer/floating-point variable
<source lang="cpp">unsigned short usBigEndianWord = *(unsigned short *)m_pScriptPC - 0x00CD;
scriptParam.m_sGlobalVar = (short)((usBigEndianWord << 8) | (usBigEndianWord >> 8));
m_pScriptPC += 2;</source>
|-valign="top"
|T>=E6||4||align="center"|{{icon|lcs}} {{icon|vcs}}||Global integer/floating-point array
<source lang="cpp">unsigned short usBigEndianWord = *(unsigned short *)m_pScriptPC - 0x00E6;
scriptParam.m_sGlobalVar = (short)((usBigEndianWord << 8) | (usBigEndianWord >> 8));
scriptParam.m_sArrayIndex = *(unsigned char *)(m_pScriptPC + 2);
scriptParam.m_ucArraySize = *(unsigned char *)(m_pScriptPC + 3);
m_pScriptPC += 4;</source>
|-valign="top"
|N/A||8||{{icon|lcs}}||Immediate 8-byte string
<source lang="cpp">strcpy(scriptParam.m_szTextLabel, (char *)m_pScriptPC);
m_pScriptPC += 8;</source>
|}

{{note|strvcs}} This type was introduced in VCS due to the presence of string variables.

All the data types above haven't been tested in a decompiling process yet, hence they still need a practical confirmation.

{{Incomplete}}

==== Integer numbers ====

An '''[[wikipedia:Integer (computer science)|integer]]''' is a number without a decimal or fractional component.

{| class="wikitable"
!rowspan="2"| Size<br>({{hint|bytes|Each byte is 4 bits}}) ||colspan="6"| Range
|-
! || Signed || Name || || Unsigned || Name
|-
| 1 || || -128 to 127 || INT8, [[wikipedia:Character_(computing)|CHAR]] || || 0 to 255 || UINT8, BYTE
|-
| 2 || || -32,768 to 32,767 || INT16, SHORT || || 0 to 65,535 || UINT16, [[wikipedia:Word (computer architecture)|WORD]], USHORT
|-
| 4 || || -2,147,483,648 to 2,147,483,647 || INT32, LONG || || 0 to 4,294,967,295 || UINT32, DWORD, ULONG
|}

==== Floating-point numbers ====
A '''[[wikipedia:Floating point|floating point]]''' is a number with a decimal component and can store extremely large or small numbers while sacrificing significant digits. This is achieved by internally using exponents in scientific notation.

{| class="wikitable"
! Size<br>({{hint|bytes|Each byte is 4 bits}}) || Range || Name
|-
| 4 || ±1.1754944×10<sup>-38</sup> to ±3.4028234×10<sup>38</sup> || [[wikipedia:Single precision floating-point format|SINGLE]], FLOAT
|}

==== Strings ====
A ''string'' is a sequence of characters not treated as numbers. Those include {{hint|letters|A..Z}}, {{hint|numbers|0..9}}, and other symbols like _ or @. Unlike other programming languages a string could start with any character, even a space.

There are two kinds of strings.

{{note|str8}} A '''fixed-length string''' or a null-terminated string. This is the most common type been used since [[GTA 3]]. The string length is fixed. When compiled these strings occupy 8 bytes of a [[SCM]] file even if they are actually shorter (the rest is filled with [[Wikipedia:null terminator|zero bytes]]).

{{note|sa16}} San Andreas introduces data type 15 for strings containing up to 15 symbols. They behave same as 8 bytes strings, but always occupy 16 bytes in a SCM file. These strings are only supported by [[Sanny Builder]].
{|{{Prettytable}}
!width="250px" align="left"|String
!width="250px" align="left"|Equivalent in SCM
|-
| <span style="color:red">'MAIN'</span>||{{hint|09|Data type}}   {{hint|4D 41 49 4E 00 00 00 00|ASCII code of string characters}}
|-
| <span style="color:red">'MODDING'</span>||{{hint|09|Data type}}   {{hint|4D 4F 44 44 49 4E 47 00|ASCII code of string characters}}
|-
| <span style="color:red">'SAVE_OUR_SOULS!'</span>||{{hint|0F|Data type}}   {{hint|53 41 56 45 5F 4F 55 52 5F 53 4F 55 4C 53 21 00|ASCII code of string characters}}
|}
{{note|str16}} A '''variable-length string'''. This type was first introduced in San Andreas. Maximum length depends on the instruction{{Ref|longstringslimits|[*]}} (the longest parameter ever read has got 40 characters).

{{Incomplete}}

==== Arrays ====
{{note|varray}} Native ''[[Wikipedia:Array|arrays]]'' support was introduced in GTA SA, however there were different implementations of [[VC_Arrays|arrays in Vice City]]. In SA SCM arrays are assembled as 2 ''UINT16''s, 1 ''INT8'' and a ''UINT8'':
2b - UINT16 - array offset{{ref|arrayoffset|[*]}}
2b - UINT16 - array index{{ref|arrayindex|[*]}}
1b - INT8 - array size
1b - UINT8 - array properties

{{note|arrayoffset}} An array offset is basically a variable number. If it's a global array, the offset is a global variable index from which the array begins. For example, if the global array offset is 150 (<code>{{hint|96 00|Little-endian order}}</code>) it means that the first element of the array is <span style="color:blue">$150</span>, the second one is <span style="color:blue">$151</span>, etc. Same valid for the local arrays (offset is a local variable index). 

{{note|arrayindex}} An array index is a variable number (global or local one) that holds the value of array index. For example, if array index is 3 (<code>{{hint|03 00|Little-endian order}}</code>), the game will read either global variable <span style="color:blue">$3</span> or local variable <span style="color:blue">3@</span> depending on the array properties (see below). This variable holds the number which is array element ID to work with. For example, if the array index is <span style="color:blue">$3</span>, and <span style="color:blue">$3</span> holds number <span style="color:maroon">5</span>, the game will read 5th element of the array.

===== Properties =====
Array properties describe the data type of each array element, held by the first 7 bits of the reference field, plus a flag which signals if the array was declared in a global scope, as the most significant bit indicates:

<source lang="cpp" style="margin-top: 8px">enum eArrayElementType
{
ELEMTYPE_INT,
ELEMTYPE_FLOAT,
ELEMTYPE_TEXT_LABEL,
ELEMTYPE_TEXT_LABEL16
};

struct ArrayProperties
{
unsigned char m_nElementType : 7;
unsigned char m_bIsIndexGlobalVar : 1;
};</source>

{|{{Prettytable}}
!width="250px" align="left"|Array
!width="250px" align="left"|Equivalent in SCM
|-
| <span style="color:blue">{{hint|$150(3@,6f)|Sanny Builder syntax}}</span>||{{hint|07|Data type}}   {{hint|96 00|Array offset}} {{hint|03 00|Array index}} {{hint|06|Array size}} {{hint|01|Array properties}}
|-
| <span style="color:blue">{{hint|10@(9@,5s)|Sanny Builder syntax}}</span>||{{hint|0D|Data type}}   {{hint|0A 00|Array offset}} {{hint|09 00|Array index}} {{hint|05|Array size}} {{hint|02|Array properties}}
|}

== Notes ==
{{note|vcstr}} In [[GTA 3]], [[Vice City]] and [[Liberty City Stories]] short strings (8 bytes) have no data type preceeding it. If the byte does not fit data type range (00-06 for GTA 3 and VC), it's recognized as a beginning of a string and next 8 bytes are read.

{{note|partype0}} Some instructions have variable amount of parameters. The most known one is [[004F]] that creates a new [[thread]] and passes arguments to it. The number of such parameters could vary, so the special data type denotes the end of parameters.

The maximum amount of parameters for any instruction is 16 for GTA 3 and VC, 32 for SA, LCS and VCS. However, those that admit an undefined amount of arguments can pass 18 parameters for GTA 3 and VC, 34 for SA, 106 for LCS and VCS (this information still needs confirmation).

{{note|05B6}} {{Icon|SA}} Opcode [[05B6]] is a special instruction that defines a table. Immediately after opcode number the stream of data (128 bytes) follows, without a data type.

{{note|longstringslimits}} {{GTAF|post|261006|3940262|Post by Seemann describing limits for the long strings in SA}}

== See also ==
* [[Mission Scripting (Overview)]]

{{N|SA|VC|3}}

Item Definition

2019-01-13T04:58:14Z

Tomas.:

{{IdeSection
| noheader = 1
}}
'''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 ==
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> (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).

=== Example ===
{{Pre|
# line comment
objs
# default style in objs section
200, ind_land101, pjs, 1, 127, 0
# valid style
200 ind_land101 pjs 1 127 0 # unread data
end
}}

== Format ==

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.

{|class="wikitable center-col-1 center-col-2" style="width: 100%;"
!style="width: 7em;"|Section
!style="width: 8em;"|Supported games
!Description
|-
|<code>[[OBJS|objs]]</code>||{{Icon|t}} {{Icon|4}}||Defines simple objects. They can be placed into the world through the <code>[[INST|inst]]</code> section of the [[IPL|item placement files]].
|-
|<code>[[TOBJ|tobj]]</code>||{{Icon|t}} {{Icon|4}}||Defines time objects. The section functions similarly to <code>objs</code> but has two additional parameters defining the in-game time range the object can get rendered. These objects can be placed into the world through the <code>inst</code> section of the item placement files.
|-
|<code>[[HIER|hier]]</code>||{{Icon|t}} {{Icon|4}}||Defines clump objects for use in cutscenes.
|-
|<code>[[CARS (IDE Section)|cars]]</code>||{{Icon|t}} {{Icon|4}}||Defines vehicle objects.
|-
|<code>[[PEDS|peds]]</code>||{{Icon|t}} {{Icon|4}}||Defines pedestrian objects (random [[wikipedia:Non-player character|NPC's]]).
|-
|<code>[[PATH (IDE Section)|path]]</code>||{{Icon|3}} {{Icon|VC|16||Vice City (unstable)}} {{Icon|SA}}||Adds path nodes to defined objects. This section is unstable in Vice City.
|-
|<code>[[2DFX|2dfx]]</code>||{{Icon|t}} {{Icon|4}}||Adds particle effects and simple ped behaviors to defined objects.
|-
|<code>[[WEAP|weap]]</code>||{{Icon|VC}} {{Icon|SA}} {{Icon|4}}||Defines weapon objects.
|-
|<code>[[ANIM|anim]]</code>||{{Icon|SA}} {{Icon|4}}||Defines animated objects. The section functions similarly to <code>objs</code> but has one additional parameter indicating an [[IFP]] or [[WAD]] animation file to assign an animation to the object. These objects can be placed into the world through the <code>inst</code> section of the item placement files.
|-
|<code>[[TXDP|txdp]]</code>||{{Icon|SA}} {{Icon|4}}||Used to virtually extend [[TXD|texture dictionaries]].
|-
|<code>[[TANM|tanm]]</code>||{{Icon|4}}||Used to combine <code>tobj</code> and <code>anim</code> sections.<br>Those objects get placed inside the <code>inst</code> section of the ''WPL''.
|-
|<code>[[TREE|tree]]</code>||{{Icon|4|16||GTA IV (not functional)}}||This section is not functional.
|-
|<code>[[VNOD|vnod]]</code>||{{Icon|4}}||–
|-
|<code>[[LINK|link]]</code>||{{Icon|4}}||–
|-
|<code>[[MLO|mlo]]</code>||{{Icon|4}}||Used to create [[interior]]s. This section does also contain information about portals (previous <code>[[ENEX|enex]]</code> connections) and dimensions of the interior which influences certain aspects, like the weather, for example. All objects are placed relative to an offset placed using <code>[[MLO+|mlo+]]</code> inside the [[IPL]] or [[WPL]] file.
|-
|<code>[[AMAT|amat]]</code>||{{Icon|4}}||This is Audio Materials. Possible Used to make a sound effect at the model. Usually used for dynamic objects.
|-
|<code>[[LODM|lodm]]</code>||{{Icon|4|16||GTA IV (not functional)}}||This section is not functional.
|-
|<code>[[AGRPS|agrps]]</code>||{{Icon|4}}||–
|-
|<code>[[HAND|hand]]</code>||VC Xbox/Mobile||–
|}

== 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.

=== {{Icon|3}} GTA III ===
{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Description !! Examples
|-
| 0 || 1 || 0x1 || - || Cull model if player doesn't look at it? Read, but ignored. || Fences
|-
| 1 || 2{{ref|1}} || 0x2 || DO_NOT_FADE || Do not fade the object when it is being loaded into or out of view. || Some lampposts
|-
| 2 || 4{{ref|1}} || 0x4 || DRAW_LAST || Model is transparent. Render this object after all opaque objects, allowing transparencies of other objects to be visible through this object. || Trees
|-
| 3 || 8 || 0x8 || ADDITIVE || Render with additive blending. Previous flag must be enabled too. ||
|-
| 4 || 16{{ref|1}} || 0x10 || IS_SUBWAY || Model is a tunnel, i.e. set the object as invisible unless the player enters [[Cullzone.dat|cull zone flag 128]]. This flag works only with static models. || Tunnels, some dynamic objects
|-
| 5 || 32 || 0x20 || IGNORE_LIGHTING || Don't use static lighting, we want dynamic if it's possible. || Some lampposts and trafficlights
|-
| 6 || 64{{ref|1}} || 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. Not implemented in the PS2 version. || Shadow
|}

=== {{Icon|VC}} GTA Vice City ===

{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Description !! Examples
|-
| 0 || 1 || 0x1 || IS_ROAD || Identifies objects to draw "wet reflections" on them. || Roads
|-
| 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. || Fences, trees
|-
| 3 || 8 || 0x8 || ADDITIVE || Render with additive blending. Previous flag will be enabled automatically. || Night windows
|-
| 4 || 16 || 0x10 || - || Read, but not used. || _dy, _dt objects
|-
| 5 || 32 || 0x20 || IGNORE_LIGHTING || Don't use static lighting, we want dynamic if it's possible. || Interior objects
|-
| 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 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
|-
| 9 || 512 || 0x200 || IS_GLASS_TYPE_1 || Breakable glass type 1: glass object changes its textures when breaking. || Small windows
|-
| 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || Breakable glass type 2: glass object doesn't change its textures when breaking. || Large windows
|}

==== Reference table ====

{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Model info flag !! Ref address !! Ref description
|-
| 0 || 1 || 0x1 || IS_ROAD || 0x04 || 0x4CA1D7 || <font face="Consolas"><b>CRenderer::RenderRoads()</b></font>
<source lang="cpp">if (CModelInfo::GetModelInfo(entity->m_nModelIndex)->m_nFlags & IS_ROAD)
entity->Render();</source>
|-
| 1 || 2 || 0x2 || DO_NOT_FADE || 0x20 || 0x4C7E03 || <font face="Consolas"><b>CRenderer::ShouldModelBeStreamed(CEntity *,CVector const&)</b></font>
<source lang="cpp">if (model->m_nFlags & DO_NOT_FADE) {
if (distance >= model->GetLargestLodDistance() + 30.0f)
return true;
}
else if ( distance >= model->GetLargestLodDistance() + 50.0f)
return true;</source>
|-
| 2 || 4 || 0x4 || DRAW_LAST || 0x40 || 0x56F4F3 || <font face="Consolas"><b>CSimpleModelInfo::SetupBigBuilding(int,int)</b></font>
<source lang="cpp">if (model->m_nFlags & DRAW_LAST) {
model->m_nFlags &= ~DRAW_LAST;
dbgprint("%s was draw last\n", model->m_szName);
}</source>
|-
| 3 || 8 || 0x8 || ADDITIVE || 0x80 || 0x582590 || <font face="Consolas"><b>CVisibilityPlugins::RenderFadingAtomic(RpAtomic *,float)</b></font>
<source lang="cpp">if (model->m_nFlags & ADDITIVE)
RwRenderStateSet(rwRENDERSTATEDESTBLEND, rwBLENDONE);</source>
|-
| 4 || 16 || 0x10 || - || 0x100 || - || -
|-
| 5 || 32 || 0x20 || IGNORE_LIGHTING || 0x200 || 0x56F7C4 || <font face="Consolas"><b>CSimpleModelInfo::SetAtomic(int,RpAtomic *)</b></font>
<source lang="cpp">if (model->m_nFlags & IGNORE_LIGHTING)
atomic->geometry->flags &= ~rpGEOMETRYLIGHT;</source>
|-
| 6 || 64 || 0x40 || NO_ZBUFFER_WRITE || 0x400 || 0x581390 || <font face="Consolas"><b>CVisibilityPlugins::RenderFadingEntities(CLinkList<CVisibilityPlugins::AlphaObjectInfo> &)</b></font>
<source lang="cpp">if (model->m_nType == MODEL_INFO_SIMPLE && model->m_nFlags & NO_ZBUFFER_WRITE)
RwRenderStateSet(rwRENDERSTATEZWRITEENABLE, FALSE);</source>
|-
| 7 || 128 || 0x80 || DONT_RECEIVE_SHADOWS || 0x800 || 0x48AF21 || <font face="Consolas"><b>CFileLoader::LoadObjectInstance(char const*)</b></font>
<source lang="cpp">if (model->m_nFlags & DONT_RECEIVE_SHADOWS)
entity->m_nFlags.bDontCastShadowsOn = true;</source>
|-
| 8 || 256 || 0x100 || IGNORE_DRAW_DISTANCE || 0x1000 || 0x487CDE || <font face="Consolas"><b>CEntity::SetupBigBuilding()</b></font>
<source lang="cpp">if (model->m_afLodDistances[0] > 2500.0f || model->m_nFlags & IGNORE_DRAW_DISTANCE)
entity->m_nLevel = 0;</source>
|-
| 9 || 512 || 0x200 || IS_GLASS_TYPE_1 || 0x2000 || 0x488CCD || <font face="Consolas"><b>CEntity::PreRender()</b>, probably in-lined <b>CModelInfo::IsGlassModel(int)</b> @0x488CAA</font>
<source lang="cpp">bool CModelInfo::IsGlassModel(int modelId) {
CBaseModelInfo *model = CModelInfo::GetModelInfo(modelId);
if (model->m_nType == MODEL_INFO_SIMPLE || model->m_nType == MODEL_INFO_TIME) {
CSimpleModelInfo *simpleModel = reinterpret_cast<CSimpleModelInfo *>(model);
return simpleModel->m_nFlags & IS_GLASS_TYPE_1 || simpleModel->m_nFlags & IS_GLASS_TYPE_2;
}
return false;
}</source>
|-
| 10 || 1024 || 0x400 || IS_GLASS_TYPE_2 || 0x4000 || 0x488CE7 || <font face="Consolas"><b>CEntity::PreRender()</b></font>
<source lang="cpp">if (CModelInfo::IsGlassModel(modelId)) {
if (!(CModelInfo::GetModelInfo(modelId)->m_nFlags & IS_GLASS_TYPE_2) ) {
CGlass::AskForObjectToBeRenderedInGlass(entity);
entity->m_nFlags.bIsVisible = false;
}
}</source>
|}

=== {{Icon|SA}} GTA San Andreas ===

{| class="wikitable"
! Bits !! Dec !! Hex !! Name !! Description !! Examples
|-
| 0 || 1 || 0x1 || IS_ROAD || This model is a road. || Roads
|-
| 1 || 2 || 0x2 || - || Not read, but present in IDE files. ||
|-
| 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
|-
| 4 || 16 || 0x10 || - || Not read, not present in IDE files. || -
|-
| 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
|-
| 7 || 128 || 0x80 || DONT_RECEIVE_SHADOWS || Do not draw shadows on this object. || Small objects, pickups, lamps, trees
|-
| 8 || 256 || 0x100 || - || Not read, not present in IDE files. || -
|-
| 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: 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
|-
| 12 || 4096 || 0x1000 || IS_DAMAGABLE || Model with ok/dam states. || Vehicle upgrades, barriers
|-
| 13 || 8192 || 0x2000 || IS_TREE || Trees and some plants. These objects move on wind. || Trees, some plants
|-
| 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
|-
| 16 || 65536 || 0x10000 || - || Not read, but present in IDE files. || Explosive things
|-
| 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 || - || 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
|-
| 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
|}

== 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]].

== Tools ==

* [[KEd]] – By {{U|JernejL}}
* [[MEd]] – By {{U|Tonywob}}
* {{GTAG|4817|IDEditor}} – By {{U|Xmen}}
* {{GTAF|402942|IDE-IV in GTA-IV script centre}} – by {{U|Gforce}}
* [http://www.aschratt.com/fileview.php?file=1004 FlagValue Calculator] – By {{U|Aschratt}} - Calculates all flagvalues (even those unknown).

== See also ==

* [[Item placement]]
* [[Map System]]
* [[Dynamic Object]]

== References ==

* {{note|2}} {{GTAF|post|102833|1067607073|Screenshots of flags in GTA III}}

== External links ==

* {{GTAF|102833|GTAVC IDE Definitions}} - topic by {{U|ODIE}} covering specific details of IDE files in GTA VC
* {{GTAF|118193|GTA3/VC Map File Documentation and Troubleshooting}} - topic by {{U|Opius}} covering general features of IDE files in GTA3 and GTA VC
* [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}}

[[Category:Map Formats]]

List of radio stations (VC)

2019-01-13T04:58:10Z

Tomas.:

__NOTOC__
This is a '''list of radio stations in Vice City''', including their file information. Radio stations are long stretches of audio that can be only heard while the player is in a vehicle. Some vehicles are restricted to only one station. In the PC version, radio station audio are in [[ADF]] format located in the <code>[[Audio directory (VC)|Audio]]</code> directory. In the PS2 version, they are in [[VB]] format located in the <code>audio\Music</code> directory. In the Xbox version, they are in standard [[wikipedia:Windows Media Audio|WMA]] format located in the <code>Audio</code> directory. Textures of radio icons as seen in the pause menu are located in the fronten2.txd file. [[Opcode]] [[041E]] is used to set the radio station in the [[script]].

{| class="wikitable sortable"
! Id
! Name
! Filename
! Size (bytes)
! Length<br>(HH:MM:SS)
! [[GXT]] entry
! Icon
|-
|rowspan="3" |0 ||rowspan="3" |Wildstyle ||WILD.adf ||75,457,831 ||rowspan="2" |01:18:36 ||rowspan="3" |FEA_FM0 ||rowspan="3" |[[Image:wildstyle.png|64px|Wildstyle]]
|-
|wild.vb ||150,175,744
|-
|WILD.wma ||33,262,697 ||01:08:32
|-
|rowspan="3" |1 ||rowspan="3" |Flash FM ||FLASH.adf ||57,405,441 ||00:59:47 ||rowspan="3" |FEA_FM1 ||rowspan="3" |[[Image:flash.png|64px|Flash FM]]
|-
|Flash.vb ||138,379,264 ||01:03:03
|-
|FLASH.wma ||29,054,093 ||00:59:52
|-
|rowspan="3" |2 ||rowspan="3" |KChat ||KCHAT.adf ||49,885,345 ||rowspan="3" |01:43:55 ||rowspan="3" |FEA_FM2 ||rowspan="3" |[[Image:kchat.png|64px|KChat]]
|-
|Kchat.vb ||114,049,024
|-
|KCHAT.wma ||50,427,553
|-
|rowspan="3" |3 ||rowspan="3" |Fever 105 ||FEVER.adf ||60,691,018 ||rowspan="2" |01:03:13 ||rowspan="3" |FEA_FM3 ||rowspan="3" |[[Image:fever.png|64px|Fever 105]]
|-
|fever.vb ||138,756,096
|-
|FEVER.wma ||30,715,305 ||01:03:18
|-
|rowspan="3" |4 ||rowspan="3" |Vrock ||VROCK.adf ||74,307,710 ||rowspan="2" |01:17:24 ||rowspan="3" |FEA_FM4 ||rowspan="3" |[[Image:vrock.png|64px|Vrock]]
|-
|vrock.vb ||169,771,008
|-
|VROCK.wma ||37,606,481 ||01:17:30
|-
|rowspan="3" |5 ||rowspan="3" |VCPR ||VCPR.adf ||41,474,017 ||rowspan="3" |01:26:24 ||rowspan="3" |FEA_FM5 ||rowspan="3" |[[Image:vcpr.png|64px|VCPR]]
|-
|vcpr.vb ||94,814,208
|-
|VCPR.wma ||41,929,237
|-
|rowspan="3" |6 ||rowspan="3" |Espantoso ||ESPANT.adf ||59,171,736 ||rowspan="2" |01:01:38 ||rowspan="3" |FEA_FM6 ||rowspan="3" |[[Image:espantoso.png|64px|Espantoso]]
|-
|espant.vb ||135,266,304
|-
|ESPANT.wma ||29,952,289 ||01:01:42
|-
|rowspan="3" |7 ||rowspan="3" |Emotion 98.3 ||EMOTION.adf ||56,749,245 ||rowspan="2" |00:59:06 ||rowspan="3" |FEA_FM7 ||rowspan="3" |[[Image:emotion.png|64px|Emotion 98.3]]
|-
|emotion.vb ||129,744,896
|-
|EMOTION.wma ||28,726,657 ||00:59:11
|-
|rowspan="3" |8 ||rowspan="3" |Wave 103 ||WAVE.adf ||63,468,356 ||rowspan="2" |01:06:06 ||rowspan="3" |FEA_FM8 ||rowspan="3" |[[Image:wave103.png|64px|Wave 103]]
|-
|wave.vb ||145,063,936
|-
|WAVE.wma ||32,124,181 ||01:06:11
|-
|9 ||MP3 Player ||– ||– ||– ||FEA_MP3 ||[[Image:mp3.png|64px|MP3 Player]]
|}

=== Additional radio stations ===
{| class="wikitable sortable"
! Id
! Name
! Filename
! Size (bytes)
! Length<br>(HH:MM:SS)
! [[GXT]] entry
! Icon
|-
|10 ||Off ||– ||– ||– ||– ||–
|-
|rowspan="3" |23 ||rowspan="3" |Police radio ||police.mp3 ||14,196,819 ||rowspan="3" |00:29:34 ||rowspan="3" |– ||rowspan="3" |–
|-
|police.vb ||32,440,320
|-
|police.wav ||44,021,136
|-
|rowspan="3" |24 ||rowspan="3" |Kaufman Cabs radio ||taxi.mp3 ||11,041,854 ||rowspan="3" |00:23:00 ||rowspan="3" |– ||rowspan="3" |–
|-
|TAXI.VB ||50,135,040
|-
|taxi.wav ||34,238,280
|}

== Version differences ==
* Flash FM: [[wikipedia:Running with the Night|"Running with the Night"]] by Lionel Richie is missing since the release of the PC version.

==See also==
* [[List of radio stations (GTA4)]]

==External links==
* [http://web.archive.org/web/*/http://www.vicecityradio.com/ Official Vice City Soundtrack] – retrieved from archive.org
* [http://raptor.cestiny.cz/download/download_b0.html Radio Station Audio Converter] – by {{U|Raptor}}

{{N|VC}}[[Category:Audio Formats]][[Category:Mission Script]]

Scrollbar

2019-01-12T00:19:32Z

Tomas.:

{{TocRight}}
A '''scrollbar''' is a horizontal text-based display formed using LED bulbs that scroll sideways, usually located on the sides of structures. It can be seen in GTA III, Vice City, Liberty City Stories, and GTA IV.

== GTA III ==
GTA III has a plethora of scrollbars, some of which display actual news of the current state of the islands. The type of scrollbar determines which text to display. The width and height columns are the scaling of the scrollbar; a negative value mirrors the text usually for intended reading on the opposite side. The bulb column is the scale of individual LED bulbs; the larger the value, the larger the dots. All scrollbar text is copied as is, including spaces.

{| class="wikitable"
! Location || Coordinates || Type || Width || Height || Color || Bulb
|-
| Shopping Mall || 228.3, -669.0, 39.0 || [[#Type 0: Biz|0]] || 0.5 || 0.5 || style="background-color: #FF8000;" | #FF8000 || 0.3
|-
| Porter Tunnel || 772.0, 164.0, -9.5 || [[#Type 1: Traffic|1]] || 0.5 || 0.25 || style="background-color: #80FF00;" | #80FF00 || 0.3
|-
| FIA Terminal A rear entrance || -1089.61, -584.224, 13.246 || [[#Type 3: Airport Doors|3]] || -0.1706 || 0.107 || style="background-color: #FF0000;" | #FF0000 || 0.11
|-
| FIA Terminal B rear entrance || -1089.61, -602.046, 13.246 || [[#Type 3: Airport Doors|3]] || -0.1706 || 0.107 || style="background-color: #00FF00;" | #00FF00 || 0.11
|-
| FIA Terminal C rear entrance || -1089.61, -619.817, 13.246 || [[#Type 3: Airport Doors|3]] || -0.1706 || 0.107 || style="background-color: #FF8000;" | #FF8000 || 0.11
|-
| FIA front left || -754.578, -633.509, 18.411 || [[#Type 4: Airport Front|4]] || 0.591 || 0.52 || style="background-color: #6464FF; color: white;" | #6464FF || 0.3
|-
| FIA front right || -754.578, -586.672, 18.411 || [[#Type 4: Airport Front|4]] || 0.591 || 0.52 || style="background-color: #6464FF; color: white;" | #6464FF || 0.3
|-
| Bedford Point || 85.473, -1069.512, 30.5 || [[#Type 5: Store|5]] || -0.3125 || 0.727 || style="background-color: #6464FF; color: white;" | #6464FF || 0.5
|-
| Bedford Point || 74.823, -1086.879, 31.495 || [[#Type 2: Entertainment|2]] || 0.1041 || 0.5 || style="background-color: #FFFF80;" | #FFFF80 || 0.3
|-
| Bedford Point || -36.459, -1031.237, 32.534 || [[#Type 2: Entertainment|2]] || 0.0721 || 0.229 || style="background-color: #96FF32;" | #96FF32 || 0.3
|-
| Capital Autos || 1208.0, -62.208, 19.157 || [[#Type 6: Used Cars|6]] || -0.20365 || 0.229 || style="background-color: #FF8000;" | #FF8000 || 0.3
|}

=== Type 0: Biz ===
Includes the following and [[#Tunnel|Tunnel]], [[#Bridge|Bridge]], and [[#Clock|Clock]].
{{Pre|
SHARES UYE↑10% DWD↑20% NDWE↓22% . . .
}}
{{Pre|
CRIME WAVE HITS LIBERTY CITY . . .
}}
{{Pre|
SHARES OBR↓29% MADD↑76% LEZ↑11% ADAMSKI↓53% AAG↓110%. . .
}}

If the language is not French or German:
{{Pre|
WWW.GRANDTHEFTAUTO3.COM
}}

=== Type 1: Traffic ===
Includes the following and [[#Tunnel|Tunnel]], [[#Bridge|Bridge]], and [[#Clock|Clock]].
{{Pre|
DRIVE CAREFULLY . . .
}}
{{Pre|
RECENT WAVE OF CARJACKINGS. KEEP YOUR DOORS LOCKED !!!
}}
{{Pre|
CHECK YOUR SPEED . . .
}}
{{Pre|
KEEP YOUR EYES ON THE ROAD AND NOT ON THIS SIGN
}}

If the [[weather]] is not foggy or rainy:
{{Pre|
ENJOY YOUR TRIP
}}

If the weather is foggy:
{{Pre|
POOR VISIBILITY !
}}

If the weather is rainy:
{{Pre|
ROADS ARE SLIPPERY !
}}

=== Type 2: Entertainment ===
Includes the following and [[#Tunnel|Tunnel]], [[#Bridge|Bridge]], and [[#Clock|Clock]].
{{Pre|
'69TH STREET' STILL HOLDS TOP POSITION THIS MONTH AT THE BOX-OFFICE WITH 'MY FAIR LADYBOY' JUST CREEPING UP BEHIND.
}}
{{Pre|
TALKING OF 'FANNIE'. THERE IS STILL TIME TO CATCH THIS LOVELY FAMILY MUSICAL, ABOUT THE ORPHAN WHO IS SO EASILY TAKEN IN BY ANY MAN WITH LOADS OF MONEY.
}}
{{Pre|
DO NOT MISS 'GTA3, THE MUSICAL' . . .
}}
{{Pre|
STILL RUNNING ARE 'RATS' AND 'GUYS AND DOGS', BETWEEN THEN THEY SHOULD HAVE THE LEGS TO LAST TILL THE AND OF THE YEAR. . . ALSO FOR FOUR LEGGED FANS, THE STAGE VERSION OF THE GRITTY REALISTIC 'SATERDAY NIGHT BEAVER' OPENED LAST WEEKEND, AND I FOR ONE CERTAINLY ENJOYED THAT.
}}
{{Pre|
NOW SHOWING STATE-WIDE, ARNOLD STEELONE, HOLLYWOODS BEST LIVING SPECIAL EFFECT, APPEARS AGAIN AS A HALF_MAN, HALF ANDROID IN THE HALF-BAKED ROMP, 'TOP DOWN CITY'. AN HOMAGE TO HIS EARLIER TWO MULTI_MILLION MAKING MOVIES, IN WHICH HE PLAYED TWO-DEE, AN OUT OF CONTROL MONSTER, INTENT ON CORRUPTING CIVILISATION!
}}
{{Pre|
ALSO APPEARING THIS WEEK 'HALF-COCKED' SEES CHUCK SCHWARTZ UP TO HIS USUAL NONSENSE AS HE TAKES ON HALF OF LIBERTY CITY IN AN ATTEMPT TO SAVE HIS CROSS-DRESSING LADY-BOY SIDEKICK, 'MISS PING-PONG', FROM A GANG OF RUTHLESS COSMETIC SURGEONS.
}}
{{Pre|
STILL SHOWING: 'SOLDIERS OF MISFORTUNE', ATTROCIOUS ACTING WHICH SEES BOYZ 2 GIRLZ' TRANSITION FROM THE CHARTS TO THE BIG SCREEN, AT LEAST THEY ALL DIE AT THE END. . .
}}
{{Pre|
'BADFELLAS' IS STILL GOING STRONG WITH CROWDS ALMOST BEING PUSHED INTO CINEMAS TO SEE THIS ONE. ANOTHER ONE WORTH LOOKING INTO IS 'THE TUNNEL'.
}}
{{Pre|
WWW.ROCKSTARGAMES.COM
}}

=== Type 3: Airport Doors ===
Includes the following and [[#Clock|Clock]].
{{Pre|
WELCOME TO LIBERTY CITY . . .
}}
{{Pre|
PLEASE HAVE YOUR PASSPORT READY . . .
}}
{{Pre|
PLACE KEYS, FIREARMS, CHANGE AND OTHER METAL OBJECTS ON THE TRAY
}}

Original PS2 version only:
{{Pre|
WWW.DMA-DESIGN.COM/GTA3/SECRET.HTM
}}

=== Type 4: Airport Front ===
Includes the following and [[#Clock|Clock]].
{{Pre|
WELCOME TO FRANCIS INTERNATIONAL AIRPORT . . .
}}
{{Pre|
PLEASE DO NOT LEAVE LUGGAGE UNATTENDED . . .
}}
{{Pre|
FOLLOW 1 FOR LONG AND SHORT TERM PARKING
}}

=== Type 5: Store ===
Includes the following and [[#Clock|Clock]].

If not original PS2 version:
{{Pre|
WWW.ROCKSTARGAMES.COM
}}

If original PS2 version:
{{Pre|
WWW.DMA-DESIGN.COM
}}

{{Pre|
GTA3 OUT NOW . . .
}}
{{Pre|
OUR STUFF IS CHEAP CHEAP CHEAP
}}
{{Pre|
BUY 12 CDS GET ONE FREE . . .
}}
{{Pre|
APPEARING IN SHOP SOON, 'THE BLOODY CHOPPERS', WITH THEIR NEW ALBUM, 'IS THAT MY DAUGHTER?'
}}
{{Pre|
THIS MONTH IS OUR CRAZY CLEAROUT MONTH, EVERYTHING MUST GO, CDS, DVDS, STAFF, EVEN OUR CARPETS!
}}
{{Pre|
OUT THIS WEEK: THE THEME TUNE TO 'BOYS TO GIRLS' FIRST MOVIE 'SOLDIERS OF MISFORTUNE', THE SINGLE 'LET ME IN YOU'RE BODY-BAG' IS TAKEN FROM THE SOUNDTRACK ALBUM, 'BOOT CAMP BOYS'. ALSO INCLUDES THE SMASH SINGLE, 'PRAY IT GOES OK'.
}}
{{Pre|
ALBUMS OUT THIS WEEK: MARYDANCING, 'MUTHA O' CHRIST', FEATURING THE SINGLE 'WASH HIM OFF', ALSO CRAIG GRAYS' DEBUT, 'FADE AWAY', INCLUDES THE SINGLE OF THE SAME NAME. . .
}}
{{Pre|
ON THE FILM FRONT, A NELY COMPILED COMPILATION OF ARNOLD STEELONES GREATEST MOVIES ON DVD. THE PACK INCLUDES THE EARLY 'BY-CEP', THE CULT CLASSIC 'FUTURE ANNHILATOR', AND THE HILARIOUS CROSS-DRESSING COMEDY 'SISTERS'. ONE FOR ALL THE FAMILY. . .
}}

Original PS2 version only:
{{Pre|
WWW.DMA-DESIGN.COM/GTA3/HIDDEN.HTM
}}

=== Type 6: Used Cars ===
Includes the following and [[#Clock|Clock]].
{{Pre|
QUICK, TAKE A LOOK AT OUR CURRENT STOCK 'CAUSE THESE AUTOS ARE MOVIN' FAST . . .
}}
{{Pre|
THAT'S RIGHT, HERE AT 'CAPITAL AUTO SALES' OUR VEHICLES ARE SO GOOD THAT THEY PRACTICALLY DRIVE THEMSELVES OFF OUR LOT . . .
}}
{{Pre|
EASY CREDIT ON ALL CARS . . .
}}
{{Pre|
FEEL LIKE A STUD IN ONE OF OUR STALLIONS OR TEST-DRIVE OUR BANSHEE, IT'S A REAL STEAL!!!
}}
{{Pre|
TRY OUR HARDY PERENNIAL, IT'LL LAST YOU THE WHOLE YEAR. OUR BOBCATS AIN'T NO PUSSIES EITHER!!!
}}
{{Pre|
IF IT'S A GUARANTEE YOU RE AFTER, GO SOMEWHERE ELSE, 'CAPITAL' CARS ARE THAT GOOD THEY DON'T NEED GUARANTEES!!!
}}
{{Pre|
TOP DOLLAR OFFERED FOR YOUR OLD WHEELS, NOT YOUR CAR, JUST IT'S WHEELS. . .
}}
{{Pre|
THAT'S RIGHT WE'RE CAR SILLY. TEST DRIVE ANY CAR, YOU WON'T WANT TO BRING IT BACK!!!
}}
{{Pre|
FREE FLUFFY DICE WITH ALL PURCHASES. . .
}}

If the language is not French or German:
{{Pre|
[http://www.rockstargames.com/grandtheftauto3/flash/capitalAutos/ HTTP://ROCKSTARGAMES.COM/GRANDTHEFTAUTO3/CAPITALAUTOS]
}}

Original PS2 version only:
{{Pre|
WWW.DMA-DESIGN.COM/GTA3/BONUS.HTM
}}

=== Tunnel ===
{{Pre|
FIRST PHASE LIBERTY TUNNEL ABOUT TO BE COMPLETED . . .
}}

If opcode [[034A]] is called:
{{Pre|
FIRST PHASE LIBERTY TUNNEL HAS BEEN COMPLETED . . .
}}

If opcode [[034B]] is called:
{{Pre|
LIBERTY TUNNEL HAS BEEN OPENED TO ALL TRAFFIC . . .
}}

=== Bridge ===
{{Pre|
CHAOS AS CALLAHAN BRIDGE IS UNDER REPAIR. . .
}}

If opcode [[034A]] is called:
{{Pre|
LONG DELAYS BEHIND US AS CALLAHAN BRIDGE IS FIXED . . . STAUNTON LIFT BRIDGE STUCK OPEN
}}

If opcode [[034B]] is called:
{{Pre|
STAUNTON LIFT BRIDGE IS OPERATIONAL AGAIN
}}

=== Clock ===
{{Pre|
THE TIME IS {{Hint|HH|Hour}}:{{Hint|MM|Minute}}
}}

== Vice City ==
Vice City uses only one scrollbar located at the Hyman Memorial Stadium to display the current event at the stadium. The scrollbar is defined by two coordinate points rather than one point with a width and a height.

* Coordinates: (-1069.209, 1320.126, 18.848), (-1069.209, 1342.299, 22.612)
* Color: <span style="background-color: #80FF00; padding: 0.2em;">#80FF00</span>
* Bulb: 0.3

If opcode [[054D]] is set to 0:
{{Pre|
MAIN EVENT TONIGHT: CAR RACING . . .
}}
{{Pre|
FOR TICKETS TO THE HOT RING EVENT CALL 555-3764 . . .
}}

If opcode 054D is set to 1:
{{Pre|
MAIN EVENT TONIGHT: DESTRUCTION DERBY . . .
}}
{{Pre|
FOR TICKETS TO THE BLOOD RING EVENT CALL 555-3765 . . .
}}

If opcode 054D is set to 2:
{{Pre|
MAIN EVENT TONIGHT: BIKE RACING . . .
}}
{{Pre|
FOR TICKETS TO THE DIRT RING EVENT CALL 555-3766 . . .
}}

Regardless of opcode 054D:
{{Pre|
HYMAN MEMORIAL STADIUM. HOME TO SOME OF THE BIGGEST EVENTS OF THE WESTERN HEMISPHERE. ALSO AVAILABLE FOR CHILDREN PARTIES. . .
}}

== Liberty City Stories ==
Liberty City Stories continues GTA III's usage of the scrollbars and their behaviors with changes to the text to reflect the game's setting.

=== Type 0 ===
Includes the following and [[#Tunnel_2|Tunnel]], [[#Bridge_2|Bridge]], and [[#Clock_2|Clock]].
{{Pre|
SHARES DAV↑15% JLI↓18% MAM↓32% STH↑80%. . .
}}
{{Pre|
GANG WAR RAGES IN LIBERTY CITY . . .
}}
{{Pre|
SHARES MJD↓23% CJW↑5% RAMMAN↑7% HNTR↓43% NJM↓12% AAG↓110%. . .
}}

=== Type 2 ===
Includes the following and [[#Tunnel_2|Tunnel]], [[#Bridge_2|Bridge]], and [[#Clock_2|Clock]].
{{Pre|
THE TECHNICOLOR SPECTACULAR 'JESUS, MARY AND JOSEPH!' IS A GODSEND! BEING SUNG ENTIRELY IN ARAMAIC, THE MUSICAL MAY BE DIFFICULT TO FOLLOW, BUT BOY THERE SURE ARE SOME SANDAL-TAPPING TUNES IN THERE !
}}
{{Pre|
THE MUSICAL 'WINGDING, SONS OF A BITCH TAKE FLIGHT' IS SLAYING THEM IN THEATERS ACROSS TOWN. CRITICS HAVE DESCRIBED IT AS 'BLOWING THE COBWEBS OFF THE MUSICAL GENRE LIKE A DIVINE WIND' . . . IT'S AN EVENING OF MUSIC, DANCE, DEATH AND DESTRUCTION! INCLUDES THE HIT SONG 'ALL YOUR BASE ARE BELONG TO USA'. YOU ARE SURE TO LEAVE WITH A SMILE ON YOUR FAT FACE . . .
}}
{{Pre|
THE UNMISSABLE 'GTA3, THE MUSICAL' IS STILL RUNNING IN LIBERTY CITY THEATERS AFTER 250 WEEKS . . . CONTROVERSY HAS PLAGUED THE PRODUCTION AFTER PRESSURE GROUPS URGED CONCERN OVER A POSSIBLE CAUSAL LINK BETWEEN THE PLAY AND THE END OF THE WORLD . . .
}}
{{Pre|
THE OPERA IS MAKING A COMEBACK IN LIBERTY CITY AS PLANS ARE UNDERWAY TO STAGE MALBOLOKOV'S 'THE PEARLFISHER'S NECKLACE' . . .A TALE ABOUT A BOY, WHO IS REALLY A GIRL, THAT DANCES FOR A SUPPER OF PHEASANTS, THAT ARE REALLY HER BROTHER'S SHOES. ART CRITIC MORGAN MERRIWEATHER DESCRIBES IT AS 'A DELIGHT . . . BOMBASTIC OCCLUSIONS ASIDE, IT'S AN INDULGENCE OF DIZZYING WONDERMENT' . . . L.C.TONIGHT SAYS, 'SHE'S A HOTTIE!'
}}
{{Pre|
NOW PLAYING 'HEAVY WEAPONS' BUFF T AND SUCK WILD REUNITE IN THE SEQUEL TO 'WEAPONS OF ASS DISTRACTION'. THE CHIPS ARE DOWN AND SO ARE THE IQ'S IN THIS SUMMER'S MONSTER BLOCKBUSTER. . . THE PRESIDENT'S ASS IS ON THE LINE. HE NEEDS A PLAN TO STOP FREEDOM BEING STOLEN BY THE BAD GUYS. STEP UP BUFF AND SUCK! IT'S TIME TO UNLEASH THE HEAVY WEAPONS AND 'SUCK IT TO 'EM!'
}}
{{Pre|
COMING SOON . . . A SPECIAL PREVIEW NIGHT OF 'FUBAR'. AN EPIC URBAN BIOPIC ABOUT LIFE IN THE GHETTO WHEN YOU'RE A MILLIONAIRE GANGSTA RAPPER JUST TRYING TO GET BY AND KEEP IT REAL . . . STARS DB-P, FAITH W, AND BLACK LIGHTMAN . . . SEATS STILL AVAILABLE . . .
}}
{{Pre|
STILL SHOWING: 'BAD MAN RETURNS - THIS TIME IT'S POOR' . . . THE CHILDHOOD PSYCHOLOGICAL SCARS OF POTTY TRAINING TURNED MILLIONAIRE PLAYBOY BRUTE LAME INTO 'BAD MAN', THE CRAP CRUSADER. CLOAKED IN DARKNESS, HE TRACKS DOWN ALL GRIME IN THE CITY! . . . IF YOU DON'T FLUSH, HE'LL FLUSH YOU!
}}
{{Pre|
THIS WEEKEND'S MUST SEE MOVIE IS 'LET'S MAKE FORMULA'. THE HUGELY SUCCESSFUL COMEDY, ROMANCE, BUDDY-BUDDY, ACTION MOVIE SERIES CONTINUES WITH THE LATEST INSTALLMENT - 'HONEY, I SHRUNK MY SKIDS'. . . AND CATCH THIS ONE IF YOU CAN, 'THE COMMON COLD'. . .
}}
{{Pre|
WWW.ROCKSTARGAMES.COM
}}

=== Type 5 ===
Includes the following and [[#Clock_2|Clock]].
{{Pre|
WWW.ROCKSTARGAMES.COM
}}
{{Pre|
'GRAND THEFT PORTO' OUT NOW . . .
}}
{{Pre|
OUR STUFF IS CHEAPER THAN CHEAP . . .
}}
{{Pre|
BUY 12 DVDS GET 1 VIDEO CASSETTE FREE . . .
}}
{{Pre|
WE'RE CLOSING DOWN AGAIN! . . . YES! WE DID SO MUCH TRADE AT OUR LAST CLOSING DOWN SALE THAT WE'VE MANAGED TO STAY IN BUSINESS LONG ENOUGH TO HAVE ANOTHER ONE . . .
}}
{{Pre|
SPECIAL OFFERS . . . SPECIAL OFFERS . . . SPECIAL OFFERS . . .
}}
{{Pre|
APPLY FOR A STORE CARD AND GET 0% OFF YOUR FIRST PURCHASE . . .
}}
{{Pre|
RELEASED THIS WEEK: 'NEW SKIDS ON THE POT' GREATEST HITS CD,'NUKED IDS': INCLUDES THEIR BIG CHART HITS 'PUPPY PHAT LUVA' AND 'BANGING STUFF' . . .
}}
{{Pre|
CHECK IN-STORE FOR THE PRODUCERS CUT DVD RELEASE OF THE CLASSIC SCIFI MOVIE 'TOTAL REHAB' STARRING ARNOLD STEELONE. IT'S NOT VERY GOOD BUT IT CAME OUT ON TIME . . .
}}
{{Pre|
WWW.ROCKSTARLEEDS.COM
}}

=== Tunnel ===
{{Pre|
FIRST PHASE LIBERTY TUNNEL ABOUT TO BE COMPLETED . . .
}}

If opcode [[034A]] is called:
{{Pre|
FIRST PHASE LIBERTY TUNNEL HAS BEEN COMPLETED . . .
}}

If opcode [[034B]] is called:
{{Pre|
LIBERTY TUNNEL HAS BEEN OPENED TO ALL TRAFFIC . . .
}}

=== Bridge ===
{{Pre|
THE GRAND OPENING OF CALLAHAN BRIDGE IS ONLY DAYS AWAY. . .
}}

If opcode [[034A]] is called:
{{Pre|
LONG DELAYS BEHIND US AS CALLAHAN BRIDGE IS NEARLY COMPLETED . . .
}}

If opcode [[034B]] is called:
{{Pre|
WORK SHY STRIKERS RETURN TO THEIR JOBS . . . STAUNTON LIFT BRIDGE IS OPERATIONAL AGAIN
}}

=== Clock ===
{{Pre|
THE TIME IS {{Hint|HH|Hour}}:{{Hint|MM|Minute}}
}}

== Symbols ==
The following is a list of symbols that can be displayed on a scrollbar in both GTA III and Vice City. Each dot represents an LED bulb in the display. The size of each symbol in the display is 5×5 bulbs.

{|class="wikitable center-col-2"
!Hex || Display || LED Display
|-
|0x20 ||(space) ||
<pre>

</pre>
|-
|0x21 ||! ||
<pre>
•
•
•

•
</pre>
|-
|0x22 ||(space) ||
<pre>

</pre>
|-
|0x23 ||# ||
<pre>
• •
• • • • •
• •
• • • • •
• •
</pre>
|-
|0x24 ||$ ||
<pre>
• •
• •
•
• •
• •
</pre>
|-
|0x25 ||% ||
<pre>
• •
• •

• •
• •
</pre>
|-
|0x26 ||(space) ||
<pre>

</pre>
|-
|0x27 ||(space) ||
<pre>

</pre>
|-
|0x28 ||/ ||
<pre>
•
•
•
•
•
</pre>
|-
|0x29 ||' ||
<pre>
•
•

</pre>
|-
|0x2A ||* ||
<pre>
• • •
•
• • • • •
•
• • •
</pre>
|-
|0x2B ||+ ||
<pre>

•
• • •
•

</pre>
|-
|0x2C ||, ||
<pre>

•
•
</pre>
|-
|0x2D ||- ||
<pre>

• • •

</pre>
|-
|0x2E ||. ||
<pre>

•
</pre>
|-
|0x2F ||(space) ||
<pre>

</pre>
|-
|0x30 ||0 ||
<pre>
• • •
• •
• •
• •
• • •
</pre>
|-
|0x31 ||1 ||
<pre>
•
• •
•
•
• • • • •
</pre>
|-
|0x32 ||2 ||
<pre>
• • •
•
• • •
•
• • • • •
</pre>
|-
|0x33 ||3 ||
<pre>
• • • •
•
• •
•
• • • •
</pre>
|-
|0x34 ||4 ||
<pre>
•
• •
• •
• • • • •
•
</pre>
|-
|0x35 ||5 ||
<pre>
• • • • •
•
• • • •
•
• • • •
</pre>
|-
|0x36 ||6 ||
<pre>
• • • •
•
• • • •
• •
• • •
</pre>
|-
|0x37 ||7 ||
<pre>
• • • • •
• •
•
•
•
</pre>
|-
|0x38 ||8 ||
<pre>
• • •
• •
• • •
• •
• • •
</pre>
|-
|0x39 ||9 ||
<pre>
• • •
• •
• • • •
•
• • •
</pre>
|-
|0x3A ||: ||
<pre>

•

•

</pre>
|-
|0x3B ||% ||
<pre>
• •
• •

• •
• •
</pre>
|-
|0x3C ||↑ ||
<pre>
•
• • •
• • •
•
•
</pre>
|-
|0x3D ||= ||
<pre>

• • •

• • •

</pre>
|-
|0x3E ||↓ ||
<pre>
•
•
• • •
• • •
•
</pre>
|-
|0x3F ||? ||
<pre>
• • • • •
•
• • •

• •
</pre>
|-
|0x40 ||° ||
<pre>
• • •
• •
• • •

</pre>
|-
|0x41 ||A ||
<pre>
• • •
• •
• •
• • • • •
• •
</pre>
|-
|0x42 ||B ||
<pre>
• • • •
• •
• • • •
• •
• • • •
</pre>
|-
|0x43 ||C ||
<pre>
• • •
• •
•
• •
• • •
</pre>
|-
|0x44 ||D ||
<pre>
• • • •
• •
• •
• •
• • • •
</pre>
|-
|0x45 ||E ||
<pre>
• • • • •
•
• • •
•
• • • • •
</pre>
|-
|0x46 ||F ||
<pre>
• • • • •
•
• • •
•
•
</pre>
|-
|0x47 ||G ||
<pre>
• • •
•
• • • •
• •
• • •
</pre>
|-
|0x48 ||H ||
<pre>
• •
• •
• • • • •
• •
• •
</pre>
|-
|0x49 ||I ||
<pre>
• • • • •
•
•
•
• • • • •
</pre>
|-
|0x4A ||J ||
<pre>
•
•
•
• •
• • •
</pre>
|-
|0x4B ||K ||
<pre>
• •
• •
• • •
• •
• •
</pre>
|-
|0x4C ||L ||
<pre>
•
•
•
•
• • • • •
</pre>
|-
|0x4D ||M ||
<pre>
• •
• • • •
• • •
• • •
• •
</pre>
|-
|0x4E ||N ||
<pre>
• •
• • •
• • •
• • •
• •
</pre>
|-
|0x4F ||O ||
<pre>
• • •
• •
• •
• •
• • •
</pre>
|-
|0x50 ||P ||
<pre>
• • • •
• •
• •
• • • •
•
</pre>
|-
|0x51 ||Q ||
<pre>
• • •
• •
• •
• • •
• •
</pre>
|-
|0x52 ||R ||
<pre>
• • • •
• •
• • • •
• •
• •
</pre>
|-
|0x53 ||S ||
<pre>
• • •
•
• • •
•
• • • •
</pre>
|-
|0x54 ||T ||
<pre>
• • • • •
•
•
•
•
</pre>
|-
|0x55 ||U ||
<pre>
• •
• •
• •
• •
• • •
</pre>
|-
|0x56 ||V ||
<pre>
• •
• •
• •
• •
•
</pre>
|-
|0x57 ||W ||
<pre>
• •
• •
• • •
• • •
• •
</pre>
|-
|0x58 ||X ||
<pre>
• •
• •
•
• •
• •
</pre>
|-
|0x59 ||Y ||
<pre>
• •
• •
• •
•
•
</pre>
|-
|0x5A ||Z ||
<pre>
• • • • •
•
•
•
• • • • •
</pre>
|-
|0x5F ||{{Hint|(invalid)|Any hex values above 0x5A display invalid symbols but Rockstar used one outside the range in GTA III.}} ||
<pre>
• •
•
• • • •
•
•
</pre>
|}

Random columns on the display are replaced with the following three cases: all bulbs off, top three bulbs off with bottom two on, and all bulbs switched to their opposite state. It is used to artificially create imperfections on the LED display. Using the second column of the "A" symbol for example:
* Case 1:
<pre style="display: table-cell;">
• •
• •
• •
• • • •
• •
</pre>

* Case 2:
<pre style="display: table-cell;">
• •
• •
• •
• • • • •
• • •
</pre>

* Case 3:
<pre style="display: table-cell;">
• •
• • •
• • •
• • • •
• • •
</pre>

== External links ==
* [http://www.gta.ru/forums/gta_3/modding/scrollbar_editor-778114/ Scrollbars Editor for GTA3]

{{N|LCS|VC|3}}
[[Category:Documentation]]

022B

2019-01-11T16:21:39Z

Tomas.:

{{TocRight}}
{{OpCode
| games = {{Icon|t}}
| command = SWITCH_PED_ROADS_OFF
| description = Prevents pedestrians from spawning or traversing in an area
| syntax1 = {{Icon|SA}} 022B: switch_ped_roads_off [''flt1''] [''flt2''] [''flt3''] to [''flt4''] [''flt5''] [''flt6'']
| syntax2 = {{Icon|III}} {{Icon|VC}} 022B: create_forbidden_for_peds_cube [''flt1''] [''flt2''] [''flt3''] [''flt4''] [''flt5''] [''flt6'']
| p1t = [''flt1'']
| p1d = Top Left X-Coordinate
| p2t = [''flt2'']
| p2d = Top Left Y-Coordinate
| p3t = [''flt3'']
| p3d = Top Left Z-Coordinate
| p4t = [''flt4'']
| p4d = Bottom Right X-Coordinate
| p5t = [''flt5'']
| p5d = Bottom Right Y-Coordinate
| p6t = [''flt6'']
| p6d = Bottom Right Z-Coordinate
| native = [[SWITCH_PED_ROADS_OFF]]
}}

This opcode is used to temporarily disables nodes from the pedestrians path, which causes them to not spawn in these locations.

== Example ==

This will prevent pedestrians from spawning in the Cochrane Dam area (the part where "The Exchange" takes place)

{{Pre|class=sb-code|1=
022B: create_forbidden_for_peds_cube -942.5625 337.0 10.0 -953.5625 361.375 30.0
}}

== Keywords ==
forbid, peds, lock, road

Saves (GTA 3)

2019-01-11T16:20:07Z

Tomas.:

{{Research}}
{{TocRight}}
This article deals with the format of a '''save game file''' for the PC version of [[GTA 3]].

==Location==
By default, the game places its save game files into the folder "GTA3 User Files" which is located in the current user's Documents folder. The location of this folder varies depending upon the version of Windows installed.

The save files themselves are named in the format '''GTA3sfX.b''' where '''X''' represents the in-game slot number. There are 8 slots available in the game (1-8).

==Format Details (PC)==
* Save files are always 0x3145C (201820) bytes long.
* Byte order is [https://en.wikipedia.org/wiki/Endianness#Little-endian little endian]. For example, the number 3452 (0x0D7C) is represented as 0x7C 0x0D in little endian.
* File is divided into 20 blocks, followed by [[#Padding|padding]] and ends with a 4-byte [[#Checksum|checksum]].

===Data Blocks===
A DWORD value precedes each block of data that indicates the size of the block.

====Block 0: Simple Vars====
Game "meta-information" giving the overall state of things. Also includes 'TheScripts' sub-block.

{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||wchar_t[24]||save name (long names are truncated on the save/load screen)
|-
|0x0030 ||word ||SYSTEMTIME wYear
|-
|0x0032 ||word ||SYSTEMTIME wMonth
|-
|0x0034 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0036 ||word ||SYSTEMTIME wDay
|-
|0x0038 ||word ||SYSTEMTIME wHour
|-
|0x003A ||word ||SYSTEMTIME wMinute
|-
|0x003C ||word ||SYSTEMTIME wSecond
|-
|0x003E ||word ||SYSTEMTIME wMilliseconds
|-
|0x0040 ||dword ||unknown (constant 0x031401)
|-
|0x0044 ||enum ||current island (1=Portland; 2=Staunton; 3=Shoreside Vale)
|-
|0x0048 ||float[3] ||camera coordinates (x,y,z)
|-
|0x0054 ||dword ||length (ms) of in-game minute
|-
|0x0058 ||dword ||last clock tick (weather timer)
|-
|0x005C ||byte ||game hour
|-
|0x005D ||byte[3] ||(align)
|-
|0x0060 ||byte ||game minute
|-
|0x0061 ||byte[3] ||(align)
|-
|0x0064 ||word ||current pad mode
|-
|0x0066 ||byte[2] ||(align)
|-
|0x0068 ||dword ||time in milliseconds (global timer)
|-
|0x006C ||float ||[[015D|time scale]]
|-
|0x0070 ||float ||time step (frame delta time)
|-
|0x0074 ||float ||time step (not clipped)
|-
|0x0078 ||dword ||number of the frames processed from the beginning of the game
|-
|0x007C ||float ||time step #2 (constant 1.0, unused)
|-
|0x0080 ||float ||frames per update (constant 1.0, unused)
|-
|0x0084 ||float ||time scale (constant 1.0, unused)
|-
|0x0088 ||word ||old weather type
|-
|0x008A ||byte[2] ||(align)
|-
|0x008C ||word ||new weather type
|-
|0x008E ||byte[2] ||(align)
|-
|0x0090 ||word ||forced weather type
|-
|0x0092 ||byte[2] ||(align)
|-
|0x0094 ||float ||weather interpolation value
|-
|0x0098 ||byte[24] ||compilation date and time (unused, always 0)
|-
|0x00B0 ||dword ||weather type in list
|-
|0x00B4 ||float ||(unknown, camera related)
|-
|0x00B8 ||float ||(unknown, camera related)
|-
|0x00BC ||dword ||block size
|-
|0x00C0 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'SCR\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||script global variable space size (n)
|-
|0x0004 ||dword[n/4] ||script global variables dump
|-
|0x0004 + n ||dword ||block size (always 0x03C8)
|-
|0x0008 + n ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||[[0180|$onmission]] offset in global variable space
|-
|0x0004 ||ContactInfo[16] ||8 bytes each, contact info
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+ContactInfo
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 || dword || [[0181|mission flag]]
|-
|0x0004 || dword || [[0182|base brief]]
|}
</div>

{|class="wikitable"
|-
|0x0084 ||Unknown[4] ||(unknown)
|-
|0x0184 ||dword ||last mission passed time
|-
|0x0188 ||BuildingSwap[25] ||16 bytes each, building model replacements
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+BuildingSwap
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 || dword || type
|-
|0x0004 || dword || building handle
|-
|0x0008 || dword || new model
|-
|0x000C ||dword || old model
|}
</div>

{|class="wikitable"
|-
|0x0318 ||InvisibliltySetting[20] ||8 bytes each, invisible objects
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+InvisibilitySetting
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 || dword || type
|-
|0x0004 || dword || handle
|}
</div>

{|class="wikitable"
|-
|0x03B8 ||byte ||already running a mission script flag (0 = false, 1 = true)
|-
|0x03B9 ||byte[3] ||(align)
|-
|0x03BC ||dword ||size of the MAIN section in the main.scm
|-
|0x03C0 ||dword ||size of largest mission
|-
|0x03C4 ||word ||number of exclusive mission scripts
|-
|0x03C6 ||byte[2] ||(align)
|}
</div>

{|class="wikitable"
|-
|0x03D0 + n ||dword ||number of active scripts (n2)
|-
|0x03D4 + n ||CRunningScript[n2] ||136 bytes each, active scripts
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+CRunningScript
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 || CRunningScript * || next script pointer
|-
|0x0004 || CRunningScript * || previous script pointer
|-
|0x0008 || char[8] || name
|-
|0x0010 || dword || current ip
|-
|0x0014 || dword[6] || return stack
|-
|0x002C || word || stack counter
|-
|0x002E || word || (align)
|-
|0x0030 || dword[16] || local variables
|-
|0x0070 || dword || timerA
|-
|0x0074 || dword || timerB
|-
|0x0078 || byte || if result
|-
|0x0079 || byte || is mission script ([[00D7]],[[0417]])
|-
|0x007A || byte || is active
|-
|0x007B || byte || (align)
|-
|0x007C || dword || wake time
|-
|0x0080 || word || if number
|-
|0x0082 || byte || not flag (negative condition)
|-
|0x0083 || byte || wasted_busted check enabled ([[0111]])
|-
|0x0084 || byte || wasted_busted check result
|-
|0x0085 || byte || mission flag ([[0417]])
|-
|0x0086 || byte[2] || (align)
|}
</div>
</div>
</div>
</div>

====Block 1: Player Peds====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||players count (n)
|-
|0x0004 ||PlayerPed[n] ||player peds array
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+PlayerPed
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||unknown
|-
|0x0004 ||word ||unknown
|-
|0x0006 ||dword ||(unknown) ped reference
|-
|0x000A ||CPed ||CPed dump (0x05F0 bytes)
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+CPed
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||byte[52] ||unknown
|-
|0x0034 ||float[3] ||position (X, Y, Z)
|-
|0x0040 ||byte[640] ||unknown
|-
|0x02C0 ||float ||player health
|-
|0x02C4 ||float ||player armor
|-
|0x02C8 ||byte[148] ||unknown
|-
|0x035C ||WeaponSlot[13] ||weapon slots (0x18 bytes each)
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+WeaponSlot
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||weapon ID
|-
|0x0004 ||dword ||unknown
|-
|0x0008 ||dword ||bullets in clip
|-
|0x000C ||dword ||bullets total
|-
|0x0010 ||dword ||unknown
|-
|0x0014 ||dword ||unknown
|}
</div>

{|class="wikitable"
|0x0494 ||byte[348] ||unknown
|}
</div>

{|class="wikitable"
|0x05FA ||dword ||max wanted level
|-
|0x05FE ||dword ||max chaos level
|-
|0x0602 ||char[24] ||model name
|-
|0x061A ||byte[2] ||(align)
|}
</div>
</div>
</div>

====Block 2: Garages====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}
<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}
<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||garages count (n)
|-
|0x0004 ||dword ||[[021D|free bombs]]
|-
|0x0008 ||dword ||[[0335|free resprays]]
|-
|0x000C ||dword ||cars collected (unused)
|-
|0x0010 ||dword ||bank vans collected ([[Garage#GTA_III|Securicar garage]])
|-
|0x0014 ||dword ||police cars collected (unused)
|-
|0x0018 ||dword ||[[03D4#GTA_III|Portland IE status (bitstring)]]
|-
|0x001C ||dword ||Shoreside IE status
|-
|0x0020 ||dword ||unused IE status
|-
|0x0024 ||dword ||time when [[Text#GTA_III|'GA_21']] was last shown
|-
|0x0028 ||StoredCar[18] ||40 bytes each, stored cars
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+StoredCar
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||model ID
|-
|0x0004 ||float[3] ||position (X, Y, Z)
|-
|0x0010 ||float[3] ||vector rotation
|-
|0x001C ||dword ||immunities (bitstring) (see below)
|-
|0x0020 ||byte ||primary color ID
|-
|0x0021 ||byte ||secondary color ID
|-
|0x0022 ||byte ||radio station ID (see below)
|-
|0x0023 ||byte ||model variation A
|-
|0x0024 ||byte ||model variation B
|-
|0x0025 ||byte ||bomb type ID (see below)
|-
|0x0026 ||byte[2] ||(align)
|}

</div>
{|class="wikitable"
|0x02F8 ||Garage[n] ||140 bytes each, garages
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+Garage
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||byte ||garage [[Garage#GTA_III|type ID]]
|-
|0x0001 ||byte ||garage state
|-
|0x0002 ||byte ||(unknown)
|-
|0x0003 ||byte ||closing without target car
|-
|0x0004 ||byte ||deactivated
|-
|0x0005 ||byte ||respray happened
|-
|0x0006 ||byte[2] ||(align)
|-
|0x0008 ||dword ||target vehicle model index
|-
|0x000C ||dword ||door 1 pointer
|-
|0x0010 ||dword ||door 2 pointer
|-
|0x0014 ||byte ||is door 1 pool index
|-
|0x0015 ||byte ||is door 2 pool index
|-
|0x0016 ||byte ||is door 1 object
|-
|0x0017 ||byte ||is door 2 object
|-
|0x0018 ||byte ||(unknown)
|-
|0x0019 ||byte ||rotated door
|-
|0x001A ||byte ||camera follows player
|-
|0x001B ||byte ||(align)
|-
|0x001C ||float[6] ||position (x1, x2, y1, y2, z1, z2)
|-
|0x0034 ||float ||door open start (z coord) (how far door is open when garage is loaded into view)
|-
|0x0038 ||float ||door open (z coord) (how far door can open)
|-
|0x003C ||float[2] ||door 1 x,y coord
|-
|0x0044 ||float[2] ||door 2 x,y coord
|-
|0x004C ||float ||door 1 position (z coord)
|-
|0x0050 ||float ||door 2 position (z coord)
|-
|0x0054 ||dword ||door last open time
|-
|0x0058 ||byte ||collected cars state
|-
|0x0059 ||byte[3] ||(align)
|-
|0x005C ||dword ||target vehicle pointer (used during missions)
|-
|0x0060 ||dword ||(unknown)
|-
|0x0064 ||StoredCar ||(unknown)
|}
</div>
</div>
</div>

Vehicle immunities:
*0b0000000'''1''' = bulletproof
*0b000000'''1'''0 = fireproof
*0b00000'''1'''00 = explosion-proof
*0b0000'''1'''000 = collision-proof
*0b000'''1'''0000 = ?
Radio stations:
*0 = Head Radio
*1 = Double Clef FM
*2 = Jah Radio
*3 = Rise FM
*4 = Lips 106
*5 = Game FM
*6 = MSX FM
*7 = Flashback 95.6
*8 = Chatterbox 109
*9 = User track player (if user tracks loaded, random station otherwise)
*10 = Police radio
*11 = Radio off
Bomb types:
*0 = no bomb
*1 = timer bomb
*2 = ignition bomb
*3 = remote bomb
*4 = timer bomb (armed)
*5 = ignition bomb (armed)

====Block 3: Vehicles====
{|class="wikitable"
!TYPE
!OFFSET
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!TYPE
!OFFSET
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!TYPE
!OFFSET
!DESCRIPTION
|-
|0x0000 ||dword ||number of vehicles (n)
|-
|0x0004 ||dword ||number of boats (n2)
|-
|0x0008 ||Vehicle[n] ||1458 bytes each, vehicles array
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+Vehicle
!TYPE
!OFFSET
!DESCRIPTION
|-
|0x0000 ||dword ||unknown
|-
|0x0004 ||word ||model ID
|-
|0x0006 ||dword ||unknown
|-
|0x000A ||CVehicle ||CVehicle dump
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+CVehicle
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||byte[52] ||unknown
|-
|0x0034 ||float[3] ||position (X, Y, Z)
|-
|0x0040 ||byte[1384] ||unknown
|}
</div>
</div>

{|class="wikitable"
|0x0000 + (1458 * n) ||Boat[n2] ||1166(?) bytes each, boats array
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+Boat
!TYPE
!OFFSET
!DESCRIPTION
|-
|0x0000 ||dword ||unknown
|-
|0x0004 ||word ||model ID
|-
|0x0006 ||dword ||unknown
|-
|0x000A ||CBoat ||CBoat dump
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+CBoat
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||byte[52] ||unknown
|-
|0x0034 ||float[3] ||position (X, Y, Z)
|-
|0x0040 ||byte[1092] ||unknown
|}
</div>
</div>
</div>
</div>

====Block 4: Objects====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||number of objects (n)
|-
|0x0004 ||CObject[n] ||Objects
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+CObject
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||word ||model id
|-
|0x0002 ||dword ||object reference
|-
|0x0006 ||float[3] ||pos
|-
|0x0012 ||byte[12] ||unknown
|-
|0x001E ||float ||unknown
|-
|0x0022 ||float[3] ||unknown
|-
|0x002E ||byte[12] ||unknown
|-
|0x003A ||byte ||unknown
|-
|0x003B ||byte ||unknown
|-
|0x003C ||byte ||unknown
|-
|0x003D ||byte ||unknown
|-
|0x003E ||byte ||unknown
|-
|0x003F ||byte ||unknown
|-
|0x0040 ||byte ||unknown
|-
|0x0041 ||byte ||unknown
|-
|0x0042 ||float ||unknown
|-
|0x0046 ||byte ||unknown
|-
|0x0047 ||byte ||unknown
|-
|0x0048 ||dword ||unknown
|-
|0x004C ||dword ||unknown
|-
|0x0050 ||dword ||unknown
|}
</div>
</div>
</div>

====Block 5: Path Find====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||number of entries (n)
|-
|0x0004 ||byte[n/2] ||[[022B|disabled ped path nodes]]
|-
|0x4 + n/2 ||byte[n/2] ||[[01E8|disabled car path nodes]]
|}
</div>
* Note: each byte in these arrays represents 8 path nodes with a bitmask. If a bit is set, the node is disabled, otherwise it is enabled.
</div>

====Block 6: Cranes====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||number of cranes (n)
|-
|0x0004 ||dword ||[[03EC|cars collected by military crane]]
|-
|0x0008 ||Crane[8] ||[[Crane]] data
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+Crane
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword || index in static objects pool
|-
|0x0004 ||dword || crane hook object index in objects pool
|-
|0x0008 ||dword || audio entity index
|-
|0x000C ||float ||pickup zone x1 ([[01EE|crane opcode]] parameter 3)
|-
|0x0010 ||float ||pickup zone x2 (crane opcode parameter 5)
|-
|0x0014 ||float ||pickup zone y1 (crane opcode parameter 6)
|-
|0x0018 ||float ||pickup zone y2 (crane opcode parameter 4)
|-
|0x001C ||float ||drop off point x (crane opcode parameter 7)
|-
|0x0020 ||float ||drop off point y (crane opcode parameter 8)
|-
|0x0024 ||float ||drop off point z (crane opcode parameter 9)
|-
|0x0028 ||float ||drop off heading in radians (crane opcode parameter 10)
|-
|0x002C ||float ||crane arm pick up rotation in radians
|-
|0x0030 ||float ||crane arm drop off rotation in radians
|-
|0x0034 ||float ||crane arm pick up distance from center of crane
|-
|0x0038 ||float ||crane arm drop off distance from center of crane
|-
|0x003C ||float ||crane arm pick up height
|-
|0x0040 ||float ||crane arm drop off height
|-
|0x0044 ||float ||crane arm current rotation in radians
|-
|0x0048 ||float ||crane arm current distance from center of crane
|-
|0x004C ||float ||crane arm current height
|-
|0x0058 ||float[3] ||crane hook initial x, y, z
|-
|0x005C ||float[3] ||crane hook current x, y, z
|-
|0x0068 ||float[2] ||unknown
|-
|0x0070 ||dword ||pointer to vehicle to pick up
|-
|0x0074 ||dword ||current game time + 10000 (only updates when crane has finished lifting car)
|-
|0x0078 ||byte ||crane activity
* 0 = idle crane
* 1 = crusher/military crane active
* 2 = crane inactive
|-
|0x0079 ||byte ||crane status
* 0 = idle
* 1 = crane moving to pick up
* 3 = moving upwards from pick up
* 2 = moving to destination
* 4 = moving downwards to drop off
* 5 = moving upwards from drop off
|-
|0x007A ||byte ||number of vehicles collected
|-
|0x007B ||byte ||is [[02FB|crusher crane]]
|-
|0x007C ||byte ||is [[0368|military crane]]
|-
|0x007D ||byte ||unknown
|-
|0x007E ||byte ||model is not doc_crane_cab
|-
|0x007F ||byte ||(align)
|}
</div>
</div>
</div>

====Block 7: Pickups====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||Pickup[336] ||[[pickup]]s structures -- each is 0x1C bytes in size; see details below
|}
<div style="margin-left: 6em;">
{|class="wikitable"
|+Pickup
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||byte ||[[0213#Pickup types|type]]
|-
|0x0001 ||byte ||has been picked up
|-
|0x0002 ||word ||ammo (for [[032B|weapon pickups]])
|-
|0x0004 ||dword ||index in objects pool
|-
|0x0008 ||dword ||regeneration time
|-
|0x000C ||word ||[[model]] id
|-
|0x000E ||word ||flags
|-
|0x0010 ||float[3] || x,y,z position
|}
</div>
{|class="wikitable"
|0x24C0 ||word ||collected index for below, always between 0 and 19
|-
|0x24C2 ||byte[2] ||(align)
|-
|0x24C4 ||PickupsCollected[20] ||pickup index, latest collected pickup pointed by collected index from above
|}
</div>
</div>

====Block 8: Phone Info====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||number of phones (n)
|-
|0x0004 ||dword ||number of active phones
|-
|0x0008 ||PhoneInfo[n] ||52 bytes each, phone info structs
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+PhoneInfo
|-
|0x0000 ||float[3] ||position (X, Y, Z)
|-
|0x000C ||dword[6] ||pointer to phone message string
|-
|0x0024 ||dword ||game time when phone message ends for states 5 and 6
|-
|0x0028 ||dword ||static index
|-
|0x002C ||dword ||phone state
* 3 = no ringing
* 4 = ringing, message just once
* 5 = ringing, message repeated, phone was never picked up
* 6 = ringing, message repeated, phone was picked up before
* 7 = no ringing, finished state of state 4
* 8 = no ringing, finished state of states 5 and 6
* 9 = only ringing
|-
|0x0030 ||byte ||is player within range of phone
|-
|0x0031 ||byte[3] ||(align)
|}
</div>
</div>
</div>

====Block 9: Restarts====

{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size (constant 0x128)
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size (constant 0x124)
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'RST\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||RestartPoint[8] ||restart point after wasted
|-
|0x0080 ||RestartPoint[8] ||restart point after busted
|-
|0x0100 ||word ||wasted restart points count
|-
|0x0102 ||word ||busted restart points count
|-
|0x0104 ||byte ||override next restart flag ([[016E]], [[0255]])
|-
|0x0105 ||byte[3] ||(align)
|-
|0x0108 ||RestartPoint ||overriden restart point ([[016E]], [[0255]])
|-
|0x0118 ||byte || [[040F|fade in after next death]] flag
|-
|0x0119 ||byte || [[040E|fade in after next arrest]] flag
|-
|0x011A ||byte || [[041F|override hospital level]] flag
|-
|0x011B ||byte || [[0420|override police level]] flag
|}

<div style="margin-left: 3em;">
{|class="wikitable"
|+RestartPoint
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||float[3] ||x,y,z coordinates
|-
|0x000C ||float ||[[Angle|z_angle]]
|}
</div>
</div>
</div>
</div>

====Block 10: Radar====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'RDR\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||RadarBlip[32] ||radar blips structures -- each is 0x30 bytes in size, see below
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+RadarBlip
|-
|0x0000 ||dword || [[0165|color]]
|-
|0x0004 ||dword || type
*0 = none
*1 = car
*2 = char
*3 = object/pickup
*4 = coord
*5 = contact point
|-
|0x0008 ||dword || entity ([[0161|car]], [[0162|char]], [[0163|object]]) handle (0 = not an entity)
|-
|0x000C ||float[2] || position x,y
|-
|0x0014 ||float[3] || position x,y,z
|-
|0x0020 ||word || index
|-
|0x0022 ||byte || [[0166|brightness]]
|-
|0x0023 ||byte || is visible
|-
|0x0024 ||float || debug sphere cross offset{{ref|1}}
|-
|0x0028 ||word || [[0168|scale]]
|-
|0x002A ||word || [[018B|display]]
|-
|0x002C ||word || blip [[Blip#GTA_III|sprite]]
|-
|0x002E ||word || (align)
|}
</div>
</div>
</div>

====Block 11: Zones====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'ZNS\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword || current zone index
|-
|0x0004 ||dword || current level (1: Portland, 2: Staunton Island, 3: Shoreside Vale)
|-
|0x0008 ||word || find index (index of last search invoked by a script)
|-
|0x000A ||word || (align)
|-
|0x000C ||Zone[50] || navigation zones (from [[ZONE#gta3.zon|gta3.zon]])
|-
|0x0AFC ||ZoneInfo[100] || day/night pairs for each Zone
|-
|0x21A4 ||word || total number of navigation zones
|-
|0x21A6 ||word || total number of zone infos
|-
|0x21A8 ||Zone[25] || map zones (from [[ZONE#map.zon|map.zon]])
|-
|0x2720 ||AudioZone[36] || audio zones
|-
|0x2768 ||word || total number of map zones
|-
|0x276A ||word || total number of audio zones
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+Zone
|-
|0x0000 ||char[8] || zone name
|-
|0x0008 ||float[3] || zone coord A
|-
|0x0014 ||float[3] || zone coord B
|-
|0x0020 ||dword || zone type (0, 1, 2 or 3 for MapZone)
|-
|0x0024 ||dword || zone level (1: Portland, 2: Staunton Island, 3: Shoreside Vale)
|-
|0x0028 ||word || zone info id night
|-
|0x002A ||word || zone info id day
|-
|0x002C ||dword || child zone index
|-
|0x0030 ||dword || parent zone index
|-
|0x0034 ||dword || sibling zone index
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+ZoneInfo
|-
|0x0000 ||word || density
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+AudioZone
|-
|0x0000 ||word || zone id
|}
</div>
</div>
</div>

====Block 12: Gangs====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'GNG\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||Gang[9] ||gang structures -- each is 0x14 bytes in size, see below
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+Gang
|-
|0x0000 ||dword || car model id
|-
|0x0004 ||byte || [[0410|ped model override]] flag
|-
|0x0005 ||byte[3] || (align)
|-
|0x0008 ||dword || primary weapon id
|-
|0x0010 ||dword || secondary weapon id
|}
</div>
</div>
</div>

====Block 13: Car Generators====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'CGN\0' signature
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size (constant 0x0C)
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||car generators count (n)
|-
|0x0004 ||dword ||active car generators count
|-
|0x0008 ||byte ||process counter
|-
|0x0009 ||byte ||generate even if player is close counter
|-
|0x000A ||byte[2] ||(align)
|}
</div>
{|class="wikitable"
|0x0010 ||dword ||size of car generator structs
|-
|0x0014 ||CarGenerator[n] ||72 bytes each, car generator structs
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+CarGenerator
|-
|0x0000 ||dword ||model ID
|-
|0x0004 ||float[3] ||position (X, Y, Z)
|-
|0x0010 ||float ||z angle
|-
|0x0014 ||word ||primary color ID
|-
|0x0016 ||word ||secondary color ID
|-
|0x0018 ||byte ||force spawn
|-
|0x0019 ||byte ||alarm (percentage)
|-
|0x001A ||byte ||locked (percentage)
|-
|0x001B ||byte ||(align)
|-
|0x001C ||word ||min delay
|-
|0x001E ||word ||max delay
|-
|0x0020 ||dword ||timestamp (time last stolen?)
|-
|0x0024 ||dword ||vehicle pool index, -1 if not spawned
|-
|0x0028 ||word ||[[014C|uses remaining]] (0 = disabled)
|-
|0x002A ||byte ||is blocking (used internally to prevent two cars spawning close to each other)
|-
|0x002B ||byte || (align)
|-
|0x002C ||float[3] ||vecInf (unused)
|-
|0x0038 ||float[3] ||vecSup (unused)
|-
|0x0044 ||dword ||(unknown) (unused)
|}
</div>
</div>
</div>
</div>

====Block 14: Particles====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword || number of particles (n);
|-
|0x0004 ||Particle[n] ||particle structures -- each is 0x88 bytes in size, see below
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+Particle
|-
|0x0000 ||dword || unknown
|-
|0x0004 ||float || unknown
|-
|0x0008 ||dword || unknown
|-
|0x000C ||dword || unknown
|-
|0x0010 ||dword || unknown
|-
|0x0014 ||dword || unknown
|-
|0x0018 ||float || unknown
|-
|0x001C ||dword || unknown
|-
|0x0020 ||dword || unknown
|-
|0x0024 ||dword || unknown
|-
|0x0028 ||dword || unknown
|-
|0x002C ||float || unknown
|-
|0x0030 ||dword || unknown
|-
|0x0034 ||float[3] || unknown x,y,z
|-
|0x0040 ||dword || unknown
|-
|0x0044 ||dword || unknown
|-
|0x0048 ||dword || unknown
|-
|0x004C ||pNext || pointer to the next particle struct
|-
|0x0050 ||pPrev || pointer to the prev particle struct
|-
|0x0054 ||dword || unknown
|-
|0x0058 ||dword || unknown time
|-
|0x005C ||dword || unknown
|-
|0x0060 ||dword || unknown
|-
|0x0064 ||byte || unknown
|-
|0x0065 ||byte || unknown
|-
|0x0066 ||word || unknown
|-
|0x0068 ||word || unknown
|-
|0x006A ||byte[2] || (align)
|-
|0x006C ||float || unknown
|-
|0x0070 ||float || unknown
|-
|0x0074 ||float || unknown
|-
|0x0078 ||float || unknown
|-
|0x007C ||float || unknown
|-
|0x0080 ||byte || unknown
|-
|0x0081 ||byte || unknown
|-
|0x0082 ||byte || unknown
|-
|0x0083 ||byte || unknown
|-
|0x0084 ||byte || unknown
|-
|0x0085 ||byte || unknown
|-
|0x0086 ||byte[2] || (align)
|}
</div>
</div>

====Block 15: Audio Script Objects====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'AUD\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword || number of audio script objects (n);
|-
|0x0004 ||AudioScriptObject[n] ||audio script object structures -- each is 0x18 bytes in size, see below
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+AudioScriptObject
|-
|0x0000 ||dword || index?
|-
|0x0004 ||word || [[018D#GTA_III|audio index]]
|-
|0x0006 ||byte[2] || (align)
|-
|0x0008 ||float[3] || position x,y,z
|-
|0x0014 ||dword || (unknown)
|}
</div>
</div>
</div>

====Block 16: Player Info====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword || player money
|-
|0x0004 ||byte || wasted/busted state
|-
|0x0005 ||dword || wasted/busted time
|-
|0x0009 ||word || [[gta3.ini|traffic multiplier]]
|-
|0x000B ||float || [[gta3.ini|road density]]
|-
|0x000F ||dword || money amount on screen
|-
|0x0013 ||dword || number of [[hidden package]]s picked up
|-
|0x0017 ||dword || [[02ED|total number of hidden packages]]
|-
|0x001B ||byte || [[0330|player never gets tired]] flag
|-
|0x001C ||byte || [[0331|player fast reload]] flag
|-
|0x001D ||byte || [[0413|get out of jail free]] flag
|-
|0x001E ||byte || [[0414|free health care]] flag
|-
|0x001F ||byte[70] || unknown
|}
</div>
</div>

====Block 17: Stats====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword || people wasted by player
|-
|0x0004 ||dword || people wasted by others
|-
|0x0008 ||dword || cars exploded
|-
|0x000C ||dword || shots made
|-
|0x0010 ||dword[23] || peds of [[pedtype|type]] wasted
|-
|0x006C ||dword || helicopters destroyed
|-
|0x0070 ||dword || [[030C|player progress]]
|-
|0x0074 ||dword || [[030D|progress total]]
|-
|0x0078 ||dword || kgs explosives used
|-
|0x007C ||dword || bullets fired
|-
|0x0080 ||dword || bullets that hit
|-
|0x0084 ||dword || cars crushed
|-
|0x0088 ||dword || headshots made
|-
|0x008C ||dword || times busted
|-
|0x0090 ||dword || hospital visits
|-
|0x0094 ||dword || days passed
|-
|0x0098 ||dword || mm rain fallen
|-
|0x009C ||float || max insane jump distance
|-
|0x00A0 ||float || max insane jump height
|-
|0x00A4 ||dword || max insane jump flips
|-
|0x00A8 ||dword || max insane jump rotation
|-
|0x00AC ||dword || best stunt so far (see table below)
|-
|0x00B0 ||dword || [[0313|unique stunt jumps found]]
|-
|0x00B4 ||dword || [[0314|unique stunt jumps total]]
|-
|0x00B8 ||dword || [[0317|missions attempts]]
|-
|0x00BC ||dword || [[0318|missions passed]]
|-
|0x00C0 ||dword || [[0315|passengers dropped off]]
|-
|0x00C4 ||dword || [[0316|cash made in taxi]]
|-
|0x00C8 ||dword || [[034A|Portland passed]]
|-
|0x00CC ||dword || [[034B|Staunton Island passed]]
|-
|0x00D0 ||dword || [[034C|Shoreside Vale passed]]
|-
|0x00D4 ||dword || [[03E2|Best 'Turismo' time in secs]]
|-
|0x00D8 ||float || distance travelled on foot
|-
|0x00DC ||float || distance travelled in car
|-
|0x00E0 ||dword || [[03FD|'Patriot Playground' in secs]]
|-
|0x00E4 ||dword || [[03FE|'A Ride In The Park' in secs]]
|-
|0x00E8 ||dword || [[03FF|'Gripped!' in secs]]
|-
|0x00EC ||dword || [[0400|'Multistorey Mayhem' in secs]]
|-
|0x00F0 ||dword || [[0401|people saved in an ambulance]]
|-
|0x00F4 ||dword || [[0402|criminals killed on vigilante mission]]
|-
|0x00F8 ||dword || [[0403|highest paramedic mission level]]
|-
|0x00FC ||dword || [[0404|total fires extinguished]]
|-
|0x0100 ||dword || [[0406|longest flight in dodo]]
|-
|0x0104 ||dword || [[0407|best time bomb defusal]]
|-
|0x0108 ||dword || [[041B|rampages passed]]
|-
|0x010C ||dword || [[0408|total number rampages]]
|-
|0x0110 ||dword || [[042C|total number missions]]
|-
|0x0114 ||dword[16] || [[042E|fastest time record]] (unused)
|-
|0x0154 ||dword[16] || [[042F|highest score record]]
|-
|0x0194 ||dword || people killed since last checkpoint
|-
|0x0198 ||dword || people killed no wasted/busted
|-
|0x019C ||char[8] ||last mission passed gxt key
|}

<div style="margin-left: 6em;">
{|class="wikitable"
|+List of stunts
!Id
!Description
|-
|0 ||no insane stunts completed
|-
|1 ||insane stunt
|-
|2 ||perfect insane stunt
|-
|3 ||double insane stunt
|-
|4 ||perfect double insane stunt
|-
|5 ||triple insane stunt
|-
|6 ||perfect triple insane stunt
|-
|7 ||[[quadruple insane stunt]]
|-
|8 ||perfect quadruple insane stunt
|}
</div>
</div>
</div>
''See also:'' [[List_of_statistics_(III)]]

====Block 18: Streaming====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||byte[200] || unknown
|}
</div>

</div>

====Block 19: Ped Types====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||block size (constant 0x2E8)
|-
|0x0004 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||char[4] ||'PTP\0' signature
|-
|0x0004 ||dword ||block size
|-
|0x0008 ||- ||start of block, data below
|}

<div style="margin-left: 3em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||PedType[23] ||PedType structures -- each is 0x20 bytes in size, see below
|}
</div>

<div style="margin-left: 6em;">
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|+PedType
|-
|0x0000 ||dword || unknown
|-
|0x0004 ||float || unknown
|-
|0x0008 ||float || unknown
|-
|0x000C ||float || unknown
|-
|0x0010 ||float || unknown
|-
|0x0014 ||float || unknown
|-
|0x0018 ||dword || unknown
|-
|0x001C ||dword || unknown
|}
</div>
</div>
</div>

=== Padding ===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x3145C bytes in length this padding is necessary to fill the space between the data blocks which start the file and the checksum value which ends it. There could be up to 4 padding blocks, each one is up to 55,000 bytes in length.

=== Checksum ===
The final four bytes of a save file are an unsigned integer checksum value. This checksum is simply the sum of all the preceding 0x3145C bytes. If the checksum value does not match the calculated sum of those bytes, the game will consider the save file to be "corrupted" and refuse to load it. Thus, any time you make any changes to a save file you must remember to update the checksum when you are finished.

== Tools ==
* {{GTAF|784598|GTA III Save File Editor}} – by {{U|thehambone}}

==Notes==
{{Note|1}} {{GTAF|post|871359|1069163696}} – a post by {{U|Seemann}} describing debug spheres

==External links==
* {{GTAF|758692|GTA III Save File Documentation}}
* [https://github.com/thehambone93/FileFormats/blob/master/gta/saves/gta-III_save_multi.bt 010 Editor binary template for the GTA III save file format]

{{Savegame-navi}}
{{N|3}}

022B

2019-01-11T16:20:00Z

Tomas.: Tomas. moved page 022b to 022B

{{TocRight}}
{{OpCode
| games = {{Icon|t}}
| command = SWITCH_PED_ROADS_OFF
| description = Prevents pedestrians from spawning or traversing in an area
| syntax1 = {{Icon|SA}} 022b: switch_ped_roads_off [''flt1''] [''flt2''] [''flt3''] to [''flt4''] [''flt5''] [''flt6'']
| syntax2 = {{Icon|III}} {{Icon|VC}} 022b: create_forbidden_for_peds_cube [''flt1''] [''flt2''] [''flt3''] [''flt4''] [''flt5''] [''flt6'']
| p1t = [''flt1'']
| p1d = Top Left X-Coordinate
| p2t = [''flt2'']
| p2d = Top Left Y-Coordinate
| p3t = [''flt3'']
| p3d = Top Left Z-Coordinate
| p4t = [''flt4'']
| p4d = Bottom Right X-Coordinate
| p5t = [''flt5'']
| p5d = Bottom Right Y-Coordinate
| p6t = [''flt6'']
| p6d = Bottom Right Z-Coordinate
| native = [[SWITCH_PED_ROADS_OFF]]
}}

This opcode is used to temporarily disables nodes from the pedestrians path, which causes them to not spawn in these locations.

== Example ==

This will prevent pedestrians from spawning in the Cochrane Dam area (the part where "The Exchange" takes place)

{{Pre|class=sb-code|1=
022B: create_forbidden_for_peds_cube -942.5625 337.0 10.0 -953.5625 361.375 30.0
}}

== Keywords ==
forbid, peds, lock, road

022b

2019-01-11T16:20:00Z

Tomas.: Tomas. moved page 022b to 022B

#REDIRECT [[022B]]

Template:IdeSection

2019-01-11T16:10:26Z

Tomas.:

<includeonly><table cellspacing="4" cellpadding="2" style="border: 1px solid #424242; background-color: #ddeae1; clear: right; float: right; text-align: left; font-size: 88%; line-height: 1.5em; margin: .5em 0 .5em 1em"><caption style="font-size: 125%; font-weight: bold;">{{{name|{{PAGENAME}}}}}{{#ifexpr: {{{noheader|0}}}=1|| [[Item Definition|(IDE section)]]}}</caption>{{#if:{{{game|}}}|<tr><th width="120">Supported games:</th><td>{{{game}}}</td></tr>}}{{#if:{{{description|}}}|<tr><th width="120">Brief description:</th><td><i>{{{description}}}</i></td></tr>}}<tr><td colspan="2" align="center"><span style="font-size: 80%">IDE Sections:
{|style="background:#ddeae1"
|[[2DFX]] •
|[[AMAT]] •
|[[ANIM]] •
|[[CARS (IDE Section)|CARS]] •
|[[HIER]] •
|[[HAND]] •
|[[MLO]] •
|[[OBJS]]
|}
{|style="background:#ddeae1"
|[[PATH_(IDE_Section)|PATH]] •
|[[PEDS]] •
|[[TANM]] •
|[[TOBJ]] •
|[[TREE]] •
|[[TXDP]] •
|[[WEAP]]
|}
</span></td></tr></table>[[Category:Map_Formats]]</includeonly><noinclude>The '''IdeSection''' template can be used to display information of an section inside an [[IDE|Item definition file]]:
<pre>
{{IdeSection
| noheader = 1 to leave out "IDE Sections" link, otherwise leave blank
| name = name of section (leave blank to use page's name)
| game = games the section is used in
| description = brief description of section
}}
</pre>

Example:
{{IdeSection
| noheader = 1
| name = TEST
| game = –
| description = Example
}}
</noinclude>

Template:IplSection

2019-01-11T15:49:00Z

Tomas.:

<includeonly><table cellspacing="4" cellpadding="2" style="width:350px; border: 1px solid #424242; background-color: #ddeae1; clear: right; float: right; text-align: left; font-size: 88%; line-height: 1.5em; margin: .5em 0 .5em 1em"><caption style="font-size: 125%; font-weight: bold;">{{{name|{{PAGENAME}}}}}{{#ifexpr: {{{noheader|0}}}=1|| [[Item Placement|(IPL section)]]}}</caption>{{#if:{{{description|}}}|<tr><th width="120">Short description:</th><td><i>{{{description}}}</i></td></tr>}}{{#if:{{{game|}}}|<tr><th width="120">Supported games:</th><td>{{{game}}}</td></tr>}}<tr><td colspan="2" align="center"><span style="font-size: 80%">IPL Sections:
{|style="background:#ddeae1"
|[[2DFX (IPL Section)|2DFX]] •
|[[AUZO]] •
|[[BLOK]] •
|[[CARS (IPL Section)|CARS]] •
|[[CULL]] •
|[[ENEX]] •
|[[GRGE]]
|}
{|style="background:#ddeae1"
|[[INST]] •
|[[JUMP]] •
|[[LINK]] •
|[[LODM]] •
|[[MLO+]] •
|[[MULT]] •
|[[OCCL]]
|}
{|style="background:#ddeae1"
|[[PATH]] •
|[[PICK]] •
|[[RTFX]] •
|[[SLOW]] •
|[[TCYC]] •
|[[VNOD]] •
|[[ZONE]]
|}
</span></td></tr></table>[[Category:Map_Formats]]</includeonly><noinclude>The '''IplSection''' template can be used to display information of an section inside an [[IPL|Item placement file]]:
<pre>
{{IplSection
| noheader = 1 to leave out "IPL Sections" link, otherwise leave blank
| name = name of section (leave blank to use page's name)
| game = games the section is used in
| description = brief description of section
}}
</pre>

Example:
{{IplSection
| noheader = 1
| name = TEST
| game = –
| description = Example
}}
</noinclude>

Template:Github

2019-01-11T15:43:12Z

Tomas.:

<includeonly>[[File:GitHub-Mark-32px.png|16px]] [https://github.com/{{{1|}}} {{{2|Source code}}}] on GitHub</includeonly><noinclude>
GitHub link template.

Usage:

<nowiki>{{Github|path|description (optional)}}</nowiki>

Example:

<nowiki>{{Github|cleolibrary/III.VC.CLEO|CLEO for GTA III and Vice City}}</nowiki>

produces:
{{Github|cleolibrary/III.VC.CLEO|CLEO for GTA III and Vice City}}