GTAMods Wiki - User contributions [en]

0874

2020-07-08T03:57:06Z

OrionSR:

{{OpCode
| games = {{Icon|SA}}
| command = SET_ZONE_POPULATION_RACE
| description = Bitflags that enable racial groups within the [[zone]]
| syntax1 = {{Icon|SA}} 0874: set_zone_population_race '[''string'']' to [''int1'']
| syntax2 = {{Icon|SA}} 0874: set_zone_ped_population_type '[''string'']' to [''int1'']
| syntax3 = {{Icon|SA}} 0874: set_zone 'CHC1A' popcycle_group_for_peds_to 9
| p1t = '[''string'']'
| p1d = [[GXT]] ID for the [[zone]]
| p2t = [''int1'']
| p2d = The sum of all enabled bitflags
| native = [[SET_ZONE_POPULATION_RACE]]
}}

Bitflags
PedRace_Black = 1
PedRace_White = 2
PedRace_Asian = 4
PedRace_Hispanic = 8

A ped model's race is determined by the first letter of the ped ID.
Black = B
White = W
Asian = O,I
Hispanic = H

In a zone with a PedRace setting of 0, only peds that are neither Black, White, Asian, nor Hispanic will spawn; like MALE01, SFYPRO, SMYST1, SMYST2.

Dealer ped streamer logic:
1) current weather zone is 2 -> entry 3 from dealer ped group is selected (biker in SF)
2) population race & 1 != 0 -> entry 0 is selected (black)
3) population race & 2 != 0 -> entry 1 is selected (white)
4) otherwise, entry 2 is selected (hispanic)

0874

2020-07-08T03:41:18Z

OrionSR:

{{OpCode
| games = {{Icon|SA}}
| command = SET_ZONE_PED_POPULATION_TYPE
| description = Bitflags that enable racial groups within the [[zone]]
| syntax1 = {{Icon|SA}} 0874: set_zone_ped_population_race '[''string'']' to [''int1'']
| syntax2 = {{Icon|SA}} 0874: set_zone_ped_population_type '[''string'']' to [''int1'']
| syntax3 = {{Icon|SA}} 0874: set_zone 'CHC1A' popcycle_group_for_peds_to 9
| p1t = '[''string'']'
| p1d = [[GXT]] ID for the [[zone]]
| p2t = [''int1'']
| p2d = The sum of all enabled bitflags
| native = [[SET_ZONE_POPULATION_RACE]]
}}

Bitflags
PedRace_Black = 1
PedRace_White = 2
PedRace_Asian = 4
PedRace_Hispanic = 8

A ped model's race is determined by the first letter of the ped ID.
Black = B
White = W
Asian = O,I
Hispanic = H

In a zone with a PedRace setting of 0, only peds that are neither Black, White, Asian, nor Hispanic will spawn; like MALE01, SFYPRO, SMYST1, SMYST2.

Dealer ped streamer logic:
1) current weather zone is 2 -> entry 3 from dealer ped group is selected (biker in SF)
2) population race & 1 != 0 -> entry 0 is selected (black)
3) population race & 2 != 0 -> entry 1 is selected (white)
4) otherwise, entry 2 is selected (hispanic)

0874

2020-07-08T03:38:57Z

OrionSR: Created page with "{{OpCode | games = {{Icon|SA}} | command = SET_ZONE_PED_POPULATION_TYPE | description = Bitflags that enable racial groups within the zone | syntax1 = {{Icon..."

{{OpCode
| games = {{Icon|SA}}
| command = SET_ZONE_PED_POPULATION_TYPE
| description = Bitflags that enable racial groups within the [[zone]]
| syntax1 = {{Icon|SA}} 0874: set_zone_ped_population_race '[''string'']' to [''int1'']
| syntax2 = {{Icon|SA}} 0874: set_zone_ped_population_type '[''string'']' to [''int1'']
| syntax3 = {{Icon|SA}} 0874: set_zone_ped_population_type 'CHC1A' to 9
| p1t = '[''string'']'
| p1d = [[GXT]] ID for the [[zone]]
| p2t = [''int1'']
| p2d = The sum of all enabled bitflags
| native = [[SET_ZONE_POPULATION_RACE]]
}}

Bitflags
PedRace_Black = 1
PedRace_White = 2
PedRace_Asian = 4
PedRace_Hispanic = 8

A ped model's race is determined by the first letter of the ped ID.
Black = B
White = W
Asian = O,I
Hispanic = H

In a zone with a PedRace setting of 0, only peds that are neither Black, White, Asian, nor Hispanic will spawn; like MALE01, SFYPRO, SMYST1, SMYST2.

Dealer ped streamer logic:
1) current weather zone is 2 -> entry 3 from dealer ped group is selected (biker in SF)
2) population race & 1 != 0 -> entry 0 is selected (black)
3) population race & 2 != 0 -> entry 1 is selected (white)
4) otherwise, entry 2 is selected (hispanic)

Saves (GTA SA)

2015-09-16T09:45:52Z

OrionSR: /* Block 25: ENEX Connections */

{{TocRight}}
This article deals with the format of a '''save game file''' for [[GTA San Andreas]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTA SA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* <code>C:\My Documents\GTA San Andreas User Files</code> – ''Windows 98'' Example
* <code>C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files</code> – ''Windows XP'' Example
* <code>C:\Users\Fred\Documents\GTA San Andreas User Files</code> – ''Windows Vista'' Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for [[#Padding|padding]] and then ending with [[#Checksum|a checksum value]]. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Simple Vars====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||version ID (checksum of a string describing the time of compilation){{Ref|1}}
|-
|0x0004 ||char[100]||save name (long names are truncated on the save/load screen){{Ref|2}}
|-
|0x0068 ||byte ||current [[Mission_Pack|mission pack]]
|-
|0x0069 ||byte[3] ||(Align)
|-
|0x006C ||dword ||current town (island) (used when a replay playback is started/finished)
|-
|0x0070 ||float[3] ||camera coordinates (x,y,z)
|-
|0x007C ||dword ||length (ms) of in-game minute
|-
|0x0080 ||dword ||weather timer
|-
|0x0084 ||byte ||current in-game month
|-
|0x0085 ||byte ||current in-game month day
|-
|0x0086 ||byte ||game hour
|-
|0x0087 ||byte ||game minute
|-
|0x0088 ||byte ||weekday
|-
|0x0089 ||byte ||current in-game month (copy)
|-
|0x008A ||byte ||current in-game month day (copy)
|-
|0x008B ||byte ||game hour (copy)
|-
|0x008C ||byte ||game minute (copy)
|-
|0x008D ||byte ||Boolean: time copy flag{{Ref|3}}
|-
|0x008E ||word ||pad mode
|-
|0x0090 ||byte ||Boolean: has ever cheated flag
|-
|0x0091 ||byte[3]||(Align)
|-
|0x0094 ||dword ||global timer
|-
|0x0098 ||float ||game speed
|-
|0x009C ||float ||frame delta time
|-
|0x00A0 ||float ||tick time (time of an iteration of the major game loop)
|-
|0x00A4 ||dword ||number of the frames processed from the beginning of the game
|-
|0x00A8 ||word ||previous weather ID
|-
|0x00AA ||word ||current weather ID
|-
|0x00AC ||word ||forced weather ID
|-
|0x00B0 ||dword ||weather interpolation value
|-
|0x00B4 ||dword ||weather type in list
|-
|0x00B8 ||float ||amount of rain
|-
|0x00BC ||dword ||vehicle camera view (opcode [[09AD]])
|-
|0x00C0 ||dword ||onfoot camera view
|-
|0x00C4 ||dword ||current interior
|-
|0x00C8 ||byte ||Boolean: invert look (unused on PC)
|-
|0x00CC ||dword ||extra (interior) color ID
|-
|0x00D0 ||byte ||extra (interior) color toggle state
|-
|0x00D4 ||float ||extra (interior) color interpolation value
|-
|0x00D8 ||dword ||extra (interior) color weather ID
|-
|0x00DC ||dword ||current water configuration (always 0)
|-
|0x00E0 ||byte ||Boolean: riot mode flag (opcode [[06C8]])
|-
|0x00E1 ||byte ||Boolean: unknown, related to riots (always 0)
|-
|0x00E4 ||dword ||max wanted level (opcode [[01F0]])
|-
|0x00E8 ||dword ||max chaos{{Ref|4}}
|-
|0x00EC ||byte ||is french language set (does nothing)
|-
|0x00ED ||byte ||is german game (opcode [[040C]]; not affected by the language)
|-
|0x00EE ||byte ||censore flag{{Ref|5}}
|-
|0x011C ||byte ||times left to display a cinematic camera help{{Ref|6}}
|-
|0x011E ||word ||[http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
|-
|0x0120 ||word ||SYSTEMTIME wMonth
|-
|0x0122 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0124 ||word ||SYSTEMTIME wDay
|-
|0x0126 ||word ||SYSTEMTIME wHour
|-
|0x0128 ||word ||SYSTEMTIME wMinute
|-
|0x012A ||word ||SYSTEMTIME wSecond
|-
|0x012C ||word ||SYSTEMTIME wMilliseconds
|-
|0x0130 ||dword ||Player target marker handle (handle of the red target icon in the map menu)
|-
|0x0134 ||byte ||Boolean: the vehicle stealing help was shown{{Ref|7}}
|-
|0x0135 ||byte ||Boolean: All taxis have nitro (opcode [[0572]] flag)
|-
|0x0136 ||byte ||Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
|-
|0x0137 ||byte ||(Align)
|}

Notes: 
{{Note|1}} Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition) 
{{Note|2}} While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16. 
{{Note|3}} Time copy flag shows whether the time data was saved using opcode [[0253]]. 
{{Note|4}} Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level. 
{{Note|5}} When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1. 
{{Note|6}} This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling. 
{{Note|7}} This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again. 

====Block 1: Script ====
Information pertaining to the [[mission script]]s in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word chance of initialization (in percents)
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte Boolean: is active
0xC5 byte Boolean: 'if' statement result
0xC6 byte Boolean: uses mission cleanup
0xC7 byte Boolean: is external
0xC8 byte Boolean: overrides text box
0xC9 byte External script attach type
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word Boolean: 'if' check result
0xD2 byte Boolean: 'not' flag
0xD3 byte Boolean: is Wasted/Busted check active
0xD4 byte Boolean: is Wasted/Busted
0xD5 byte[3] (Align)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Boolean: is mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword [[Ped type]]

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for Hands model
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)
* The CRC32 is calculated of the uppercase filename without extension. After calculation the bits are inverted. The files/filenames can be found in data/shopping.dat and by extracting models/player.img. For example, for White Tank the value is 0xffffffff-crc32("VEST") = 0xbb1ca4cc for both model and texture.

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword Cars collected (unused III/VC leftover)
0x000B dword Bank vans collected (unused III leftover)
0x000F dword Police cars collected (unused III leftover)
0x0013 dword[4] Car types collected (unused VC leftover)
0x0023 dword Last time garage help message was displayed
0x0027 StoredCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 SaveGarage[] SaveGarage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (StoredCar):
0x00 float[3] Coordinates (x,y,z)
0x0C dword Car Handling Flags
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station [see below]
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

SaveGarage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 collision proof
0x10 melee proof
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

Radio Stations
0x00 vehicle has no radio
0x01 playback fm
0x02 k rose
0x03 k-dst
0x04 bounce fm
0x05 sf-ur
0x06 radio los santos
0x07 radio x
0x08 csr 103.9
0x09 k-jah west
0x0a master sounds 98.3
0x0b wctr
0x0c user track player
0x0d radio off

====Block 4: Game Logic====
Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of after death start points (unused by the game)
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte Game state (wasted/busted/on a rampage etc.)
0x07 dword Time of last event
0x0B AfterDeathStart[] array of after death start points (unused) -- see details below

AfterDeathStart structure:
0x00 float[3] X, Y, Z
0x0C float Angle

====Block 5: Paths====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword timer
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: Phone Info====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte Boolean: override restart
0x01 float[3] Override next restart coordinates (opcode [[016E]])
0x0D byte Boolean: fade in after next death (always 1)
0x0E byte Boolean: fade in after next arrest (always 1)
0x0F float[3] Override next hospital restart coordinates (opcode [[08DF]])
0x1B float Override next hospital restart radius{{Ref|8}}
0x1F float Override next hospital restart heading
0x23 float[3] Override next police restart coordinates (opcode [[08E0]])
0x2F float Override next police restart radius{{Ref|8}}
0x33 float Override next police restart heading

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

Notes: 
{{Note|8}} Player has to die/be arrested within this radius in order for an override to happen. 

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gangs====
OFFSET TYPE DESCRIPTION
0x0000 CGangInfo[10] CGangInfo structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

CGangInfo[]
0x00 byte gang ped model override (-1 to disable; unused)
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte [[Binary IPL|IPL stream]] of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: Ped Generators====
(Usually Empty)

====Block 14: Audio Script Object ====
(Usually Empty)

====Block 15: Player Info====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] [[List_of_statistics_(SA)|float stats]] (numbered 0..81 in scm)
0x0148 dword[223] [[List_of_statistics_(SA)|int stats]] (numbered 120..342 in scm)
0x04C4 dword[32] num peds killed of the type [id]
0x0544 char[8] last mission passed (gxt key)
0x054C dword[14] num times played radio station [id]
0x0584 dword[100] num mission attempts for mission [id]
0x0714 byte[128] has displayed stat message [id] (id as in statdisp.dat line number)
0x0794 end

====Block 17: Set Pieces====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Relationships====
OFFSET TYPE DESCRIPTION
0x000 PedRelationship[32] PedRelationship structures, each is 20 bytes in size -- see details below
0x280 end

PedRelationship -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedRelationship[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedRelationship[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The relationship flags could be changed using opcode [[0746]] and similar.

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256, value of ID IPL limit
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang Wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] XYZ: players location during a "3rd Kill" (gang war trigger)
0x24 dword attack/war gang ID
0x28 dword war gang 2 ID
0x2C dword gang strength (0 to 2, 3 is unused)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 float next attack timer (counts down)
0x3C float[3] XYZ: center of warzone
0x48 dword hood attack timeout (counts down)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float previous territories under control ([[08E2]])
0x58 float current territories under control ([[08E2]])
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of [[JUMP|Unique Stunt Jumps]] (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 disable door task Disable "walk through door" task
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 no fadein Don't fade in after teleport
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: 3D Markers====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||C3dMarker[5]||entrance markers [[0A40]]
|-
|0x8C||end||
|}

{|class="wikitable"
|+C3dMarker struct
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||dword||existance status
|-
|0x04||float[3]||position
|-
|0x10||dword||color R
|-
|0x14||dword||color G
|-
|0x18||dword||color B
|-
|0x1C||end||
|}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://www.sweetscape.com/010editor/ 010 Editor], by {{U|Seemann}}: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v3.0 by Paul Breeuwsma: http://www.paulinternet.nl/sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
* GTA:SA Save Game Tool v1.0 http://home.comcast.net/~shamblertm/pages/gtasa_sgt.html

==External links==
* http://www.paulinternet.nl/sadoc - some documentation of the savegame file used by the savegame editor of Paul Breeuwsma
* {{GTAF|204807|Early documentation topic}}
* {{GTAF|348331|SA Save File Glitch Detection and Repair}} - a topic by {{U|OrionSR}}
* {{GTAF|406480|Save File Conversion: PS2 to PC}} - a topic by {{U|marshmallow1304}}

{{Savegame-navi}}
{{SA-navi}}

Saves (GTA SA)

2015-09-16T09:43:12Z

OrionSR: syncing enex flags with opcode descriptions

{{TocRight}}
This article deals with the format of a '''save game file''' for [[GTA San Andreas]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTA SA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* <code>C:\My Documents\GTA San Andreas User Files</code> – ''Windows 98'' Example
* <code>C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files</code> – ''Windows XP'' Example
* <code>C:\Users\Fred\Documents\GTA San Andreas User Files</code> – ''Windows Vista'' Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for [[#Padding|padding]] and then ending with [[#Checksum|a checksum value]]. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Simple Vars====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||version ID (checksum of a string describing the time of compilation){{Ref|1}}
|-
|0x0004 ||char[100]||save name (long names are truncated on the save/load screen){{Ref|2}}
|-
|0x0068 ||byte ||current [[Mission_Pack|mission pack]]
|-
|0x0069 ||byte[3] ||(Align)
|-
|0x006C ||dword ||current town (island) (used when a replay playback is started/finished)
|-
|0x0070 ||float[3] ||camera coordinates (x,y,z)
|-
|0x007C ||dword ||length (ms) of in-game minute
|-
|0x0080 ||dword ||weather timer
|-
|0x0084 ||byte ||current in-game month
|-
|0x0085 ||byte ||current in-game month day
|-
|0x0086 ||byte ||game hour
|-
|0x0087 ||byte ||game minute
|-
|0x0088 ||byte ||weekday
|-
|0x0089 ||byte ||current in-game month (copy)
|-
|0x008A ||byte ||current in-game month day (copy)
|-
|0x008B ||byte ||game hour (copy)
|-
|0x008C ||byte ||game minute (copy)
|-
|0x008D ||byte ||Boolean: time copy flag{{Ref|3}}
|-
|0x008E ||word ||pad mode
|-
|0x0090 ||byte ||Boolean: has ever cheated flag
|-
|0x0091 ||byte[3]||(Align)
|-
|0x0094 ||dword ||global timer
|-
|0x0098 ||float ||game speed
|-
|0x009C ||float ||frame delta time
|-
|0x00A0 ||float ||tick time (time of an iteration of the major game loop)
|-
|0x00A4 ||dword ||number of the frames processed from the beginning of the game
|-
|0x00A8 ||word ||previous weather ID
|-
|0x00AA ||word ||current weather ID
|-
|0x00AC ||word ||forced weather ID
|-
|0x00B0 ||dword ||weather interpolation value
|-
|0x00B4 ||dword ||weather type in list
|-
|0x00B8 ||float ||amount of rain
|-
|0x00BC ||dword ||vehicle camera view (opcode [[09AD]])
|-
|0x00C0 ||dword ||onfoot camera view
|-
|0x00C4 ||dword ||current interior
|-
|0x00C8 ||byte ||Boolean: invert look (unused on PC)
|-
|0x00CC ||dword ||extra (interior) color ID
|-
|0x00D0 ||byte ||extra (interior) color toggle state
|-
|0x00D4 ||float ||extra (interior) color interpolation value
|-
|0x00D8 ||dword ||extra (interior) color weather ID
|-
|0x00DC ||dword ||current water configuration (always 0)
|-
|0x00E0 ||byte ||Boolean: riot mode flag (opcode [[06C8]])
|-
|0x00E1 ||byte ||Boolean: unknown, related to riots (always 0)
|-
|0x00E4 ||dword ||max wanted level (opcode [[01F0]])
|-
|0x00E8 ||dword ||max chaos{{Ref|4}}
|-
|0x00EC ||byte ||is french language set (does nothing)
|-
|0x00ED ||byte ||is german game (opcode [[040C]]; not affected by the language)
|-
|0x00EE ||byte ||censore flag{{Ref|5}}
|-
|0x011C ||byte ||times left to display a cinematic camera help{{Ref|6}}
|-
|0x011E ||word ||[http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
|-
|0x0120 ||word ||SYSTEMTIME wMonth
|-
|0x0122 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0124 ||word ||SYSTEMTIME wDay
|-
|0x0126 ||word ||SYSTEMTIME wHour
|-
|0x0128 ||word ||SYSTEMTIME wMinute
|-
|0x012A ||word ||SYSTEMTIME wSecond
|-
|0x012C ||word ||SYSTEMTIME wMilliseconds
|-
|0x0130 ||dword ||Player target marker handle (handle of the red target icon in the map menu)
|-
|0x0134 ||byte ||Boolean: the vehicle stealing help was shown{{Ref|7}}
|-
|0x0135 ||byte ||Boolean: All taxis have nitro (opcode [[0572]] flag)
|-
|0x0136 ||byte ||Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
|-
|0x0137 ||byte ||(Align)
|}

Notes: 
{{Note|1}} Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition) 
{{Note|2}} While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16. 
{{Note|3}} Time copy flag shows whether the time data was saved using opcode [[0253]]. 
{{Note|4}} Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level. 
{{Note|5}} When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1. 
{{Note|6}} This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling. 
{{Note|7}} This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again. 

====Block 1: Script ====
Information pertaining to the [[mission script]]s in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word chance of initialization (in percents)
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte Boolean: is active
0xC5 byte Boolean: 'if' statement result
0xC6 byte Boolean: uses mission cleanup
0xC7 byte Boolean: is external
0xC8 byte Boolean: overrides text box
0xC9 byte External script attach type
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word Boolean: 'if' check result
0xD2 byte Boolean: 'not' flag
0xD3 byte Boolean: is Wasted/Busted check active
0xD4 byte Boolean: is Wasted/Busted
0xD5 byte[3] (Align)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Boolean: is mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword [[Ped type]]

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for Hands model
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)
* The CRC32 is calculated of the uppercase filename without extension. After calculation the bits are inverted. The files/filenames can be found in data/shopping.dat and by extracting models/player.img. For example, for White Tank the value is 0xffffffff-crc32("VEST") = 0xbb1ca4cc for both model and texture.

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword Cars collected (unused III/VC leftover)
0x000B dword Bank vans collected (unused III leftover)
0x000F dword Police cars collected (unused III leftover)
0x0013 dword[4] Car types collected (unused VC leftover)
0x0023 dword Last time garage help message was displayed
0x0027 StoredCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 SaveGarage[] SaveGarage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (StoredCar):
0x00 float[3] Coordinates (x,y,z)
0x0C dword Car Handling Flags
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station [see below]
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

SaveGarage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 collision proof
0x10 melee proof
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

Radio Stations
0x00 vehicle has no radio
0x01 playback fm
0x02 k rose
0x03 k-dst
0x04 bounce fm
0x05 sf-ur
0x06 radio los santos
0x07 radio x
0x08 csr 103.9
0x09 k-jah west
0x0a master sounds 98.3
0x0b wctr
0x0c user track player
0x0d radio off

====Block 4: Game Logic====
Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of after death start points (unused by the game)
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte Game state (wasted/busted/on a rampage etc.)
0x07 dword Time of last event
0x0B AfterDeathStart[] array of after death start points (unused) -- see details below

AfterDeathStart structure:
0x00 float[3] X, Y, Z
0x0C float Angle

====Block 5: Paths====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword timer
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: Phone Info====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte Boolean: override restart
0x01 float[3] Override next restart coordinates (opcode [[016E]])
0x0D byte Boolean: fade in after next death (always 1)
0x0E byte Boolean: fade in after next arrest (always 1)
0x0F float[3] Override next hospital restart coordinates (opcode [[08DF]])
0x1B float Override next hospital restart radius{{Ref|8}}
0x1F float Override next hospital restart heading
0x23 float[3] Override next police restart coordinates (opcode [[08E0]])
0x2F float Override next police restart radius{{Ref|8}}
0x33 float Override next police restart heading

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

Notes: 
{{Note|8}} Player has to die/be arrested within this radius in order for an override to happen. 

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gangs====
OFFSET TYPE DESCRIPTION
0x0000 CGangInfo[10] CGangInfo structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

CGangInfo[]
0x00 byte gang ped model override (-1 to disable; unused)
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte [[Binary IPL|IPL stream]] of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: Ped Generators====
(Usually Empty)

====Block 14: Audio Script Object ====
(Usually Empty)

====Block 15: Player Info====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] [[List_of_statistics_(SA)|float stats]] (numbered 0..81 in scm)
0x0148 dword[223] [[List_of_statistics_(SA)|int stats]] (numbered 120..342 in scm)
0x04C4 dword[32] num peds killed of the type [id]
0x0544 char[8] last mission passed (gxt key)
0x054C dword[14] num times played radio station [id]
0x0584 dword[100] num mission attempts for mission [id]
0x0714 byte[128] has displayed stat message [id] (id as in statdisp.dat line number)
0x0794 end

====Block 17: Set Pieces====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Relationships====
OFFSET TYPE DESCRIPTION
0x000 PedRelationship[32] PedRelationship structures, each is 20 bytes in size -- see details below
0x280 end

PedRelationship -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedRelationship[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedRelationship[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The relationship flags could be changed using opcode [[0746]] and similar.

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256, value of ID IPL limit
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang Wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] XYZ: players location during a "3rd Kill" (gang war trigger)
0x24 dword attack/war gang ID
0x28 dword war gang 2 ID
0x2C dword gang strength (0 to 2, 3 is unused)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 float next attack timer (counts down)
0x3C float[3] XYZ: center of warzone
0x48 dword hood attack timeout (counts down)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float previous territories under control ([[08E2]])
0x58 float current territories under control ([[08E2]])
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of [[JUMP|Unique Stunt Jumps]] (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Disable "walk through door" task
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Don't fade in after teleport
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: 3D Markers====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||C3dMarker[5]||entrance markers [[0A40]]
|-
|0x8C||end||
|}

{|class="wikitable"
|+C3dMarker struct
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||dword||existance status
|-
|0x04||float[3]||position
|-
|0x10||dword||color R
|-
|0x14||dword||color G
|-
|0x18||dword||color B
|-
|0x1C||end||
|}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://www.sweetscape.com/010editor/ 010 Editor], by {{U|Seemann}}: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v3.0 by Paul Breeuwsma: http://www.paulinternet.nl/sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
* GTA:SA Save Game Tool v1.0 http://home.comcast.net/~shamblertm/pages/gtasa_sgt.html

==External links==
* http://www.paulinternet.nl/sadoc - some documentation of the savegame file used by the savegame editor of Paul Breeuwsma
* {{GTAF|204807|Early documentation topic}}
* {{GTAF|348331|SA Save File Glitch Detection and Repair}} - a topic by {{U|OrionSR}}
* {{GTAF|406480|Save File Conversion: PS2 to PC}} - a topic by {{U|marshmallow1304}}

{{Savegame-navi}}
{{SA-navi}}

Saves (GTA SA)

2015-06-11T16:50:13Z

OrionSR: Updated Car Flag immunities

{{TocRight}}
This article deals with the format of a '''save game file''' for [[GTA San Andreas]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTA SA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* <code>C:\My Documents\GTA San Andreas User Files</code> – ''Windows 98'' Example
* <code>C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files</code> – ''Windows XP'' Example
* <code>C:\Users\Fred\Documents\GTA San Andreas User Files</code> – ''Windows Vista'' Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for [[#Padding|padding]] and then ending with [[#Checksum|a checksum value]]. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Simple Vars====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||version ID (checksum of a string describing the time of compilation){{Ref|1}}
|-
|0x0004 ||char[100]||save name (long names are truncated on the save/load screen){{Ref|2}}
|-
|0x0068 ||byte ||current [[Mission_Pack|mission pack]]
|-
|0x0069 ||byte[3] ||(Align)
|-
|0x006C ||dword ||current town (island) (used when a replay playback is started/finished)
|-
|0x0070 ||float[3] ||camera coordinates (x,y,z)
|-
|0x007C ||dword ||length (ms) of in-game minute
|-
|0x0080 ||dword ||weather timer
|-
|0x0084 ||byte ||current in-game month
|-
|0x0085 ||byte ||current in-game month day
|-
|0x0086 ||byte ||game hour
|-
|0x0087 ||byte ||game minute
|-
|0x0088 ||byte ||weekday
|-
|0x0089 ||byte ||current in-game month (copy)
|-
|0x008A ||byte ||current in-game month day (copy)
|-
|0x008B ||byte ||game hour (copy)
|-
|0x008C ||byte ||game minute (copy)
|-
|0x008D ||byte ||Boolean: time copy flag{{Ref|3}}
|-
|0x008E ||word ||pad mode
|-
|0x0090 ||byte ||Boolean: has ever cheated flag
|-
|0x0091 ||byte[3]||(Align)
|-
|0x0094 ||dword ||global timer
|-
|0x0098 ||float ||game speed
|-
|0x009C ||float ||frame delta time
|-
|0x00A0 ||float ||tick time (time of an iteration of the major game loop)
|-
|0x00A4 ||dword ||number of the frames processed from the beginning of the game
|-
|0x00A8 ||word ||previous weather ID
|-
|0x00AA ||word ||current weather ID
|-
|0x00AC ||word ||forced weather ID
|-
|0x00B0 ||dword ||weather interpolation value
|-
|0x00B4 ||dword ||weather type in list
|-
|0x00B8 ||float ||amount of rain
|-
|0x00BC ||dword ||vehicle camera view (opcode [[09AD]])
|-
|0x00C0 ||dword ||onfoot camera view
|-
|0x00C4 ||dword ||current interior
|-
|0x00C8 ||byte ||Boolean: invert look (unused on PC)
|-
|0x00CC ||dword ||extra (interior) color ID
|-
|0x00D0 ||byte ||extra (interior) color toggle state
|-
|0x00D4 ||float ||extra (interior) color interpolation value
|-
|0x00D8 ||dword ||extra (interior) color weather ID
|-
|0x00DC ||dword ||current water configuration (always 0)
|-
|0x00E0 ||byte ||Boolean: riot mode flag (opcode [[06C8]])
|-
|0x00E1 ||byte ||Boolean: unknown, related to riots (always 0)
|-
|0x00E4 ||dword ||max wanted level (opcode [[01F0]])
|-
|0x00E8 ||dword ||max chaos{{Ref|4}}
|-
|0x00EC ||byte ||is french language set (does nothing)
|-
|0x00ED ||byte ||is german game (opcode [[040C]]; not affected by the language)
|-
|0x00EE ||byte ||censore flag{{Ref|5}}
|-
|0x011C ||byte ||times left to display a cinematic camera help{{Ref|6}}
|-
|0x011E ||word ||[http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
|-
|0x0120 ||word ||SYSTEMTIME wMonth
|-
|0x0122 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0124 ||word ||SYSTEMTIME wDay
|-
|0x0126 ||word ||SYSTEMTIME wHour
|-
|0x0128 ||word ||SYSTEMTIME wMinute
|-
|0x012A ||word ||SYSTEMTIME wSecond
|-
|0x012C ||word ||SYSTEMTIME wMilliseconds
|-
|0x0130 ||dword ||Player target marker handle (handle of the red target icon in the map menu)
|-
|0x0134 ||byte ||Boolean: the vehicle stealing help was shown{{Ref|7}}
|-
|0x0135 ||byte ||Boolean: All taxis have nitro (opcode [[0572]] flag)
|-
|0x0136 ||byte ||Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
|-
|0x0137 ||byte ||(Align)
|}

Notes: 
{{Note|1}} Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition) 
{{Note|2}} While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16. 
{{Note|3}} Time copy flag shows whether the time data was saved using opcode [[0253]]. 
{{Note|4}} Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level. 
{{Note|5}} When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1. 
{{Note|6}} This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling. 
{{Note|7}} This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again. 

====Block 1: Script ====
Information pertaining to the [[mission script]]s in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word chance of initialization (in percents)
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte Boolean: is active
0xC5 byte Boolean: 'if' statement result
0xC6 byte Boolean: uses mission cleanup
0xC7 byte Boolean: is external
0xC8 byte Boolean: overrides text box
0xC9 byte External script attach type
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word Boolean: 'if' check result
0xD2 byte Boolean: 'not' flag
0xD3 byte Boolean: is Wasted/Busted check active
0xD4 byte Boolean: is Wasted/Busted
0xD5 byte[3] (Align)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Boolean: is mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword [[Ped type]]

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for Hands model
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)
* The CRC32 is calculated of the uppercase filename without extension. After calculation the bits are inverted. The files/filenames can be found in data/shopping.dat and by extracting models/player.img. For example, for White Tank the value is 0xffffffff-crc32("VEST") = 0xbb1ca4cc for both model and texture.

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword Cars collected (unused III/VC leftover)
0x000B dword Bank vans collected (unused III leftover)
0x000F dword Police cars collected (unused III leftover)
0x0013 dword[4] Car types collected (unused VC leftover)
0x0023 dword Last time garage help message was displayed
0x0027 StoredCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 SaveGarage[] SaveGarage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (StoredCar):
0x00 float[3] Coordinates (x,y,z)
0x0C dword Car Handling Flags
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station [see below]
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

SaveGarage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 collision proof
0x10 melee proof
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

Radio Stations
0x00 vehicle has no radio
0x01 playback fm
0x02 k rose
0x03 k-dst
0x04 bounce fm
0x05 sf-ur
0x06 radio los santos
0x07 radio x
0x08 csr 103.9
0x09 k-jah west
0x0a master sounds 98.3
0x0b wctr
0x0c user track player
0x0d radio off

====Block 4: Game Logic====
Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of after death start points (unused by the game)
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte Game state (wasted/busted/on a rampage etc.)
0x07 dword Time of last event
0x0B AfterDeathStart[] array of after death start points (unused) -- see details below

AfterDeathStart structure:
0x00 float[3] X, Y, Z
0x0C float Angle

====Block 5: Paths====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword timer
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: Phone Info====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte Boolean: override restart
0x01 float[3] Override next restart coordinates (opcode [[016E]])
0x0D byte Boolean: fade in after next death (always 1)
0x0E byte Boolean: fade in after next arrest (always 1)
0x0F float[3] Override next hospital restart coordinates (opcode [[08DF]])
0x1B float Override next hospital restart radius{{Ref|8}}
0x1F float Override next hospital restart heading
0x23 float[3] Override next police restart coordinates (opcode [[08E0]])
0x2F float Override next police restart radius{{Ref|8}}
0x33 float Override next police restart heading

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

Notes: 
{{Note|8}} Player has to die/be arrested within this radius in order for an override to happen. 

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gangs====
OFFSET TYPE DESCRIPTION
0x0000 CGangInfo[10] CGangInfo structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

CGangInfo[]
0x00 byte gang ped model override (-1 to disable; unused)
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte [[Binary IPL|IPL stream]] of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: Ped Generators====
(Usually Empty)

====Block 14: Audio Script Object ====
(Usually Empty)

====Block 15: Player Info====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] [[List_of_statistics_(SA)|float stats]] (numbered 0..81 in scm)
0x0148 dword[223] [[List_of_statistics_(SA)|int stats]] (numbered 120..342 in scm)
0x04C4 dword[32] num peds killed of the type [id]
0x0544 char[8] last mission passed (gxt key)
0x054C dword[14] num times played radio station [id]
0x0584 dword[100] num mission attempts for mission [id]
0x0714 byte[128] has displayed stat message [id] (id as in statdisp.dat line number)
0x0794 end

====Block 17: Police Trigger Zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Relationships====
OFFSET TYPE DESCRIPTION
0x000 PedRelationship[32] PedRelationship structures, each is 20 bytes in size -- see details below
0x280 end

PedRelationship -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedRelationship[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedRelationship[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The relationship flags could be changed using opcode [[0746]] and similar.

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256, value of ID IPL limit
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang Wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] XYZ: players location during a "3rd Kill" (gang war trigger)
0x24 dword attack/war gang ID
0x28 dword war gang 2 ID
0x2C dword gang strength (0 to 2, 3 is unused)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 float next attack timer (counts down)
0x3C float[3] XYZ: center of warzone
0x48 dword hood attack timeout (counts down)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float previous territories under control ([[08E2]])
0x58 float current territories under control ([[08E2]])
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of [[JUMP|Unique Stunt Jumps]] (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance Markers====
{|class="wikitable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||CEntranceMarker[5]||entrance markers, can be created by opcode [[0A40]]
|-
|0x8C||end||
|}

{|class="wikitable"
|+CEntranceMarker struct
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||dword||existance status
|-
|0x04||float[3]||position
|-
|0x10||dword||color R
|-
|0x14||dword||color G
|-
|0x18||dword||color B
|-
|0x1C||end||
|}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://www.sweetscape.com/010editor/ 010 Editor], by {{U|Seemann}}: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v3.0 by Paul Breeuwsma: http://www.paulinternet.nl/sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
* GTA:SA Save Game Tool v1.0 http://home.comcast.net/~shamblertm/pages/gtasa_sgt.html

==External links==
* http://www.paulinternet.nl/sadoc - some documentation of the savegame file used by the savegame editor of Paul Breeuwsma
* {{GTAF|204807|Early documentation topic}}
* {{GTAF|348331|SA Save File Glitch Detection and Repair}} - a topic by {{U|OrionSR}}
* {{GTAF|406480|Save File Conversion: PS2 to PC}} - a topic by {{U|marshmallow1304}}

{{Savegame-navi}}
{{SA-navi}}

Saves (GTA SA)

2011-04-30T10:42:07Z

OrionSR: /* Block 23: Gang wars */

{{TocRight}}
This article deals with the format of a '''save game file''' for [[GTA San Andreas]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTA SA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* <code>C:\My Documents\GTA San Andreas User Files</code> – ''Windows 98'' Example
* <code>C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files</code> – ''Windows XP'' Example
* <code>C:\Users\Fred\Documents\GTA San Andreas User Files</code> – ''Windows Vista'' Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
{|{{Prettytable}} class="sortable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||version ID (checksum of a string describing the time of compilation){{Ref|1}}
|-
|0x0004 ||char[100]||save name (long names are truncated on the save/load screen){{Ref|2}}
|-
|0x0068 ||byte ||current [[Mission_Pack|mission pack]]
|-
|0x0069 ||byte[3] ||(Align)
|-
|0x006C ||dword ||current town (island) (used when a replay playback is started/finished)
|-
|0x0070 ||float[3] ||camera coordinates (x,y,z)
|-
|0x007C ||dword ||length (ms) of in-game minute
|-
|0x0080 ||dword ||weather timer
|-
|0x0084 ||byte ||current in-game month
|-
|0x0085 ||byte ||current in-game month day
|-
|0x0086 ||byte ||game hour
|-
|0x0087 ||byte ||game minute
|-
|0x0088 ||byte ||weekday
|-
|0x0089 ||byte ||current in-game month (copy)
|-
|0x008A ||byte ||current in-game month day (copy)
|-
|0x008B ||byte ||game hour (copy)
|-
|0x008C ||byte ||game minute (copy)
|-
|0x008D ||byte ||Boolean: time copy flag{{Ref|3}}
|-
|0x008E ||word ||(unknown)
|-
|0x0090 ||byte ||Boolean: has ever cheated flag
|-
|0x0091 ||byte[3]||(Align)
|-
|0x0094 ||dword ||global timer
|-
|0x0098 ||float ||game speed
|-
|0x009C ||float ||(unknown)
|-
|0x00A0 ||float ||tick time (time of an iteration of the major game loop)
|-
|0x00A4 ||dword ||number of the frames processed from the beginning of the game
|-
|0x00A8 ||word ||(unknown)
|-
|0x00AA ||word ||(unknown)
|-
|0x00AC ||word ||weather ID
|-
|0x00B0 ||dword ||(unknown)
|-
|0x00B4 ||dword ||(unknown)
|-
|0x00B8 ||dword ||(unknown)
|-
|0x00BC ||dword ||vehicle camera view (opcode [[09AD]])
|-
|0x00C0 ||dword ||onfoot camera view
|-
|0x00C4 ||dword ||current interior
|-
|0x00C8 ||byte ||(unknown)
|-
|0x00CC ||dword ||original interior color (?)
|-
|0x00D0 ||byte ||interior color flag (?)
|-
|0x00D4 ||float ||(unknown)
|-
|0x00D8 ||dword ||changed interior color (?)
|-
|0x00DC ||dword ||(unknown)
|-
|0x00E0 ||byte ||Boolean: riot mode flag (opcode [[06C8]])
|-
|0x00E1 ||byte ||(unknown)
|-
|0x00E4 ||dword ||max wanted level (opcode [[01F0]])
|-
|0x00E8 ||dword ||max chaos{{Ref|4}}
|-
|0x00EC ||byte ||(unknown)
|-
|0x00ED ||byte ||is german lang (?) (opcode [[040C]])
|-
|0x00EE ||byte ||censore flag{{Ref|5}}
|-
|0x011C ||byte ||times left to display a cinematic camera help{{Ref|6}}
|-
|0x011E ||word ||[http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
|-
|0x0120 ||word ||SYSTEMTIME wMonth
|-
|0x0122 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0124 ||word ||SYSTEMTIME wDay
|-
|0x0126 ||word ||SYSTEMTIME wHour
|-
|0x0128 ||word ||SYSTEMTIME wMinute
|-
|0x012A ||word ||SYSTEMTIME wSecond
|-
|0x012C ||word ||SYSTEMTIME wMilliseconds
|-
|0x0130 ||dword ||Player target marker handle (handle of the red target icon in the map menu)
|-
|0x0134 ||byte ||Boolean: the vehicle stealing help was shown{{Ref|7}}
|-
|0x0135 ||byte ||Boolean: All taxis have nitro (opcode [[0572]] flag)
|-
|0x0136 ||byte ||Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
|-
|0x0137 ||byte ||(Align)
|}

Notes: 
{{Note|1}} Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition) 
{{Note|2}} While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16. 
{{Note|3}} Time copy flag shows whether the time data was saved using opcode [[0253]]. 
{{Note|4}} Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level. 
{{Note|5}} When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1. 
{{Note|6}} This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling. 
{{Note|7}} This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again. 

====Block 1: Script ====
Information pertaining to the [[mission script]]s in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword [[Ped type]]

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for Hands model
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)
* The CRC32 is calculated of the uppercase filename without extension. After calculation the bits are inverted. The files/filenames can be found in data/shopping.dat and by extracting models/player.img. For example, for White Tank the value is 0xffffffff-crc32("VEST") = 0xbb1ca4cc for both model and texture.

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station [see below]
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

Radio Stations
0x00 vehicle has no radio
0x01 playback fm
0x02 k rose
0x03 k-dst
0x04 bounce fm
0x05 sf-ur
0x06 radio los santos
0x07 radio x
0x08 csr 103.9
0x09 k-jah west
0x0a master sounds 98.3
0x0b wctr
0x0c user track player
0x0d radio off

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword timer
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte [[Binary IPL|IPL stream]] of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] XYZ: players location during a "3rd Kill" (gang war trigger)
0x24 dword attack/war gang ID
0x28 dword war gang 2 ID
0x2C dword gang strength (0 to 2, 3 is unused)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 float next attack timer (counts down)
0x3C float[3] XYZ: center of warzone
0x48 dword hood attack timeout (counts down)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float previous territories under control ([[08E2]])
0x58 float current territories under control ([[08E2]])
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of [[JUMP|Unique Stunt Jumps]] (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{|{{Prettytable}}
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||CEntranceMarker[5]||entrance markers, can be created by opcode [[0A40]]
|-
|0x8C||end||
|}

{|{{Prettytable}}
|+CEntranceMarker struct
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||dword||existance status
|-
|0x04||float[3]||position
|-
|0x10||dword||color R
|-
|0x14||dword||color G
|-
|0x18||dword||color B
|-
|0x1C||end||
|}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://www.sweetscape.com/010editor/ 010 Editor], by {{U|Seemann}}: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v3.0 by Paul Breeuwsma: http://www.paulinternet.nl/sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
* GTA:SA Save Game Tool v1.0 http://home.comcast.net/~shamblertm/pages/gtasa_sgt.html

==External links==
* http://www.paulinternet.nl/sadoc - some documentation of the savegame file used by the savegame editor of Paul Breeuwsma
* {{GTAF|204807|Early documentation topic}}
* {{GTAF|348331|SA Save File Glitch Detection and Repair}} - a topic by {{U|OrionSR}}
* {{GTAF|406480|Save File Conversion: PS2 to PC}} - a topic by {{U|marshmallow1304}}

{{SA-navi}}
[[Category:Save Formats]]

Saves (GTA SA)

2011-04-27T10:25:53Z

OrionSR: /* Block 23: Gang wars */

{{TocRight}}
This article deals with the format of a '''save game file''' for [[GTA San Andreas]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTA SA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* <code>C:\My Documents\GTA San Andreas User Files</code> – ''Windows 98'' Example
* <code>C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files</code> – ''Windows XP'' Example
* <code>C:\Users\Fred\Documents\GTA San Andreas User Files</code> – ''Windows Vista'' Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
{|{{Prettytable}} class="sortable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||version ID (checksum of a string describing the time of compilation){{Ref|1}}
|-
|0x0004 ||char[100]||save name (long names are truncated on the save/load screen){{Ref|2}}
|-
|0x0068 ||byte ||current [[Mission_Pack|mission pack]]
|-
|0x0069 ||byte[3] ||(Align)
|-
|0x006C ||dword ||current town (island) (used when a replay playback is started/finished)
|-
|0x0070 ||float[3] ||camera coordinates (x,y,z)
|-
|0x007C ||dword ||length (ms) of in-game minute
|-
|0x0080 ||dword ||weather timer
|-
|0x0084 ||byte ||current in-game month
|-
|0x0085 ||byte ||current in-game month day
|-
|0x0086 ||byte ||game hour
|-
|0x0087 ||byte ||game minute
|-
|0x0088 ||byte ||weekday
|-
|0x0089 ||byte ||current in-game month (copy)
|-
|0x008A ||byte ||current in-game month day (copy)
|-
|0x008B ||byte ||game hour (copy)
|-
|0x008C ||byte ||game minute (copy)
|-
|0x008D ||byte ||Boolean: time copy flag{{Ref|3}}
|-
|0x008E ||word ||(unknown)
|-
|0x0090 ||byte ||Boolean: has ever cheated flag
|-
|0x0091 ||byte[3]||(Align)
|-
|0x0094 ||dword ||global timer
|-
|0x0098 ||float ||game speed
|-
|0x009C ||float ||(unknown)
|-
|0x00A0 ||float ||tick time (time of an iteration of the major game loop)
|-
|0x00A4 ||dword ||number of the frames processed from the beginning of the game
|-
|0x00A8 ||word ||(unknown)
|-
|0x00AA ||word ||(unknown)
|-
|0x00AC ||word ||weather ID
|-
|0x00B0 ||dword ||(unknown)
|-
|0x00B4 ||dword ||(unknown)
|-
|0x00B8 ||dword ||(unknown)
|-
|0x00BC ||dword ||vehicle camera view (opcode [[09AD]])
|-
|0x00C0 ||dword ||onfoot camera view
|-
|0x00C4 ||dword ||current interior
|-
|0x00C8 ||byte ||(unknown)
|-
|0x00CC ||dword ||original interior color (?)
|-
|0x00D0 ||byte ||interior color flag (?)
|-
|0x00D4 ||float ||(unknown)
|-
|0x00D8 ||dword ||changed interior color (?)
|-
|0x00DC ||dword ||(unknown)
|-
|0x00E0 ||byte ||Boolean: riot mode flag (opcode [[06C8]])
|-
|0x00E1 ||byte ||(unknown)
|-
|0x00E4 ||dword ||max wanted level (opcode [[01F0]])
|-
|0x00E8 ||dword ||max chaos{{Ref|4}}
|-
|0x00EC ||byte ||(unknown)
|-
|0x00ED ||byte ||is german lang (?) (opcode [[040C]])
|-
|0x00EE ||byte ||censore flag{{Ref|5}}
|-
|0x011C ||byte ||times left to display a cinematic camera help{{Ref|6}}
|-
|0x011E ||word ||[http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
|-
|0x0120 ||word ||SYSTEMTIME wMonth
|-
|0x0122 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0124 ||word ||SYSTEMTIME wDay
|-
|0x0126 ||word ||SYSTEMTIME wHour
|-
|0x0128 ||word ||SYSTEMTIME wMinute
|-
|0x012A ||word ||SYSTEMTIME wSecond
|-
|0x012C ||word ||SYSTEMTIME wMilliseconds
|-
|0x0130 ||dword ||Player target marker handle (handle of the red target icon in the map menu)
|-
|0x0134 ||byte ||Boolean: the vehicle stealing help was shown{{Ref|7}}
|-
|0x0135 ||byte ||Boolean: All taxis have nitro (opcode [[0572]] flag)
|-
|0x0136 ||byte ||Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
|-
|0x0137 ||byte ||(Align)
|}

Notes: 
{{Note|1}} Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition) 
{{Note|2}} While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16. 
{{Note|3}} Time copy flag shows whether the time data was saved using opcode [[0253]]. 
{{Note|4}} Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level. 
{{Note|5}} When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1. 
{{Note|6}} This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling. 
{{Note|7}} This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again. 

====Block 1: Script ====
Information pertaining to the [[mission script]]s in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword [[Ped type]]

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for Hands model
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)
* The CRC32 is calculated of the uppercase filename without extension. After calculation the bits are inverted. The files/filenames can be found in data/shopping.dat and by extracting models/player.img. For example, for White Tank the value is 0xffffffff-crc32("VEST") = 0xbb1ca4cc for both model and texture.

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station [see below]
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

Radio Stations
0x00 vehicle has no radio
0x01 playback fm
0x02 k rose
0x03 k-dst
0x04 bounce fm
0x05 sf-ur
0x06 radio los santos
0x07 radio x
0x08 csr 103.9
0x09 k-jah west
0x0a master sounds 98.3
0x0b wctr
0x0c user track player
0x0d radio off

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword timer
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte [[Binary IPL|IPL stream]] of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] XYZ: players location during a "3rd Kill" (gang war trigger)
0x24 dword attack/war gang ID
0x28 dword war gang 2 ID
0x2C dword gang strength (0 to 2, 3 is unused)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 float next attack timer (counts down)
0x3C float[3] XYZ: center of warzone
0x48 dword hood attack timeout target (ms)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float previous territories under control ([[08E2]])
0x58 float current territories under control ([[08E2]])
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of [[JUMP|Unique Stunt Jumps]] (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{|{{Prettytable}}
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||CEntranceMarker[5]||entrance markers, can be created by opcode [[0A40]]
|-
|0x8C||end||
|}

{|{{Prettytable}}
|+CEntranceMarker struct
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||dword||existance status
|-
|0x04||float[3]||position
|-
|0x10||dword||color R
|-
|0x14||dword||color G
|-
|0x18||dword||color B
|-
|0x1C||end||
|}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://www.sweetscape.com/010editor/ 010 Editor], by {{U|Seemann}}: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v3.0 by Paul Breeuwsma: http://www.paulinternet.nl/sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
* GTA:SA Save Game Tool v1.0 http://home.comcast.net/~shamblertm/pages/gtasa_sgt.html

==External links==
* http://www.paulinternet.nl/sadoc - some documentation of the savegame file used by the savegame editor of Paul Breeuwsma
* {{GTAF|204807|Early documentation topic}}
* {{GTAF|348331|SA Save File Glitch Detection and Repair}} - a topic by {{U|OrionSR}}
* {{GTAF|406480|Save File Conversion: PS2 to PC}} - a topic by {{U|marshmallow1304}}

{{SA-navi}}
[[Category:Save Formats]]

Saves (GTA SA)

2010-02-09T06:23:51Z

OrionSR: /* Block 2: Players & Objects */

This article deals with the format of a '''save game file''' for [[GTA San Andreas]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTA SA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* <code>C:\My Documents\GTA San Andreas User Files</code> – ''Windows 98'' Example
* <code>C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files</code> – ''Windows XP'' Example
* <code>C:\Users\Fred\Documents\GTA San Andreas User Files</code> – ''Windows Vista'' Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
{|{{Prettytable}} class="sortable"
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x0000 ||dword ||version ID (checksum of a string describing the time of compilation){{Ref|1}}
|-
|0x0004 ||char[100]||save name (long names are truncated on the save/load screen){{Ref|2}}
|-
|0x0068 ||byte ||current [[Mission_Pack|mission pack]]
|-
|0x0069 ||byte[3] ||(Align)
|-
|0x006C ||dword ||current town (island) (used when a replay playback is started/finished)
|-
|0x0070 ||float[3] ||camera coordinates (x,y,z)
|-
|0x007C ||dword ||length (ms) of in-game minute
|-
|0x0080 ||dword ||weather timer
|-
|0x0084 ||byte ||current in-game month
|-
|0x0085 ||byte ||current in-game month day
|-
|0x0086 ||byte ||game hour
|-
|0x0087 ||byte ||game minute
|-
|0x0088 ||byte ||weekday
|-
|0x0089 ||byte ||current in-game month (copy)
|-
|0x008A ||byte ||current in-game month day (copy)
|-
|0x008B ||byte ||game hour (copy)
|-
|0x008C ||byte ||game minute (copy)
|-
|0x008D ||byte ||Boolean: time copy flag{{Ref|3}}
|-
|0x008E ||word ||(unknown)
|-
|0x0090 ||byte ||Boolean: has ever cheated flag
|-
|0x0091 ||byte[3]||(Align)
|-
|0x0094 ||dword ||global timer
|-
|0x0098 ||float ||game speed
|-
|0x009C ||float ||(unknown)
|-
|0x00A0 ||float ||tick time (time of an iteration of the major game loop)
|-
|0x00A4 ||dword ||number of the frames processed from the beginning of the game
|-
|0x00A8 ||word ||(unknown)
|-
|0x00AA ||word ||(unknown)
|-
|0x00AC ||word ||weather ID
|-
|0x00B0 ||dword ||(unknown)
|-
|0x00B4 ||dword ||(unknown)
|-
|0x00B8 ||dword ||(unknown)
|-
|0x00BC ||dword ||vehicle camera view (opcode [[09AD]])
|-
|0x00C0 ||dword ||onfoot camera view
|-
|0x00C4 ||dword ||current interior
|-
|0x00C8 ||byte ||(unknown)
|-
|0x00CC ||dword ||original interior color (?)
|-
|0x00D0 ||byte ||interior color flag (?)
|-
|0x00D4 ||float ||(unknown)
|-
|0x00D8 ||dword ||changed interior color (?)
|-
|0x00DC ||dword ||(unknown)
|-
|0x00E0 ||byte ||Boolean: riot mode flag (opcode [[06C8]])
|-
|0x00E1 ||byte ||(unknown)
|-
|0x00E4 ||dword ||max wanted level (opcode [[01F0]])
|-
|0x00E8 ||dword ||max chaos{{Ref|4}}
|-
|0x00EC ||byte ||(unknown)
|-
|0x00ED ||byte ||is german lang (?) (opcode [[040C]])
|-
|0x00EE ||byte ||censore flag{{Ref|5}}
|-
|0x011C ||byte ||times left to display a cinematic camera help{{Ref|6}}
|-
|0x011E ||word ||[http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
|-
|0x0120 ||word ||SYSTEMTIME wMonth
|-
|0x0122 ||word ||SYSTEMTIME wDayOfWeek
|-
|0x0124 ||word ||SYSTEMTIME wDay
|-
|0x0126 ||word ||SYSTEMTIME wHour
|-
|0x0128 ||word ||SYSTEMTIME wMinute
|-
|0x012A ||word ||SYSTEMTIME wSecond
|-
|0x012C ||word ||SYSTEMTIME wMilliseconds
|-
|0x0130 ||dword ||Player target marker handle (handle of the red target icon in the map menu)
|-
|0x0134 ||byte ||Boolean: the vehicle stealing help was shown{{Ref|7}}
|-
|0x0135 ||byte ||Boolean: All taxis have nitro (opcode [[0572]] flag)
|-
|0x0136 ||byte ||Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
|-
|0x0137 ||byte ||(Align)
|}

Notes: 
{{Note|1}} Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition) 
{{Note|2}} While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16. 
{{Note|3}} Time copy flag shows whether the time data was saved using opcode [[0253]]. 
{{Note|4}} Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level. 
{{Note|5}} When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1. 
{{Note|6}} This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling. 
{{Note|7}} This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again. 

====Block 1: Script ====
Information pertaining to the [[mission script]]s in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword [[Ped type]]

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)
* The CRC32 is calculated of the uppercase filename without extension. After calculation the bits are inverted. The files/filenames can be found in data/shopping.dat and by extracting models/player.img. For example, for White Tank the value is 0xffffffff-crc32("VEST") = 0xbb1ca4cc for both model and texture.

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station [see below]
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

Radio Stations
0x00 vehicle has no radio
0x01 playback fm
0x02 k rose
0x03 k-dst
0x04 bounce fm
0x05 sf-ur
0x06 radio los santos
0x07 radio x
0x08 csr 103.9
0x09 k-jah west
0x0a master sounds 98.3
0x0b wctr
0x0c user track player
0x0d radio off

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword timer
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte [[Binary IPL|IPL stream]] of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of [[JUMP|Unique Stunt Jumps]] (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{|{{Prettytable}}
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||CEntranceMarker[5]||entrance markers, can be created by opcode [[0A40]]
|-
|0x8C||end||
|}

{|{{Prettytable}}
|+CEntranceMarker struct
!OFFSET
!TYPE
!DESCRIPTION
|-
|0x00||dword||existance status
|-
|0x04||float[3]||position
|-
|0x10||dword||color R
|-
|0x14||dword||color G
|-
|0x18||dword||color B
|-
|0x1C||end||
|}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

==Savegame Editor documentation==
The source code and documentation of the Savegame Editor of Paul Breeuwsma is put online.
You can [http://www.paulinternet.nl/#sa download it] or [http://www.paulinternet.nl/sadoc/ view the documentation online].
Feel free to use/copy/edit it if you want to.

==Tools==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://en.wikipedia.org/wiki/010_Editor 010 Editor], by [[User:Seemann|Seemann]]: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v2.8 by Paul Breeuwsma: http://www.paulinternet.nl/#sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
* GTA:SA Save Game Tool v1.0 http://home.comcast.net/~shamblertm/pages/gtasa_sgt.html

{{SA-navi}}
[[Category:Save Formats]]

Item Placement

2009-08-06T21:58:55Z

OrionSR: Door type info was removed from linked page. Updated with new link.

{{Cleanup-rewrite}}

'''Item placement''' files, known by the extension '''.ipl''', are map files used to place objects into the GTA world, as well as define zones, paths, garages, interior portals, and a lot more. Most IPL files can easily be opened and edited using any text-editing program like [[Wikipedia:Notepad|Notepad]]. In San Andreas there are also [[Binary_IPL|binary IPL]] files which are located in the [[IMG|IMG archives]] of the game. Those you can only open using a special [[Item_Placement#Useful_Tools|editor]].

==Structure==
The <code>.ipl</code> files are split up into many sections. Not all of them have to be used, leaving them empty works as well. Each section starts with a section identifier and ends with the keyword "end", both in a separate line.

Example:
inst
...
end

===INST===
Locations and properties for instances of static and [[Dynamic_Object|dynamic map objects]].

''GTA3 format''
id, name, x, y, z, sx, sy, sz, rx, ry, rz, rw

''Vice City format''
id, name, int, x, y, z, sx, sy, sz, rx, ry, rz, rw

''San Andreas format''
id, name, int, x, y, z, rx, ry, rz, rw, lod

;ID: Unique object identifier. Must match in [[IDE]] file identifier. (integer)
;Name: Usually same as the <code>.dff</code> [[model file]], without extension. (string)
;int: [[Interior#List|Interior number]]; zero for outside. (integer)
;x, y, z: Item placement coordinates. (floating point numbers)
;sx, sy, sz: Item scale, scales visible model only, doesn't scale the [[collision model]]. (floating point numbers)
;rx, ry, rz, rw: Item rotations. Defined as [[Wikipedia:quaternion|quaternion]], quite sophisticated math is needed to translate it to [[Wikipedia:Euler angles|Euler angles]]. A map editing program should be used to edit these.
;lod: San Andreas only. This is the line number in the current IPL file for the [[LOD]] which belongs to this object. The first item in IPL file is line number 0, second is number 1 and so on. A value of -1 means no LOD is used. (integer)

===CULL===
This creates rainfree zones, wastefree zones, map reflections, TV screens, and temporary fixed camera positions.

''GTA3 and Vice City format''
x1, y1, z1, x2, y2, z2, x3, y3, z3, flag, 0
;x2, y2, z2: lower-left corner of the areabox
;x3, y3, z3: upper-right corner of the areabox
''San Andreas format 1''
centerX, centerY, centerZ, 0 (some kind of rotation), Ywidth, bottomZ, Xwidth, 0 (some kind of rotation), topZ, Flag, Flag 2
''San Andreas format 2''
centerX, centerY, centerZ, 0 (some kind of rotation), Ywidth, bottomZ, Xwidth, 0 (some kind of rotation), topZ, Flag, Vx, Vy, Vz, Cm
Cull zone boundaries in San Andreas are aligned to the nearest world unit. 
Flags: 
1 Camera close in into player using closest third-person view camera mode, does not close in if in first person or cinematic mode, camera mode cannot be changed while in the zone 
2 camera remotely placed outside the zone, no control of camera, camera mode cannot be changed while in the zone 
4 Unknown 
8 Rain-free, police helicopter-free zone 
4096 5-star military zone

===PATH===
''Vice City only''

'''Ped, Car and Boat Paths''', defines paths relative to the world centre. Only used in GTA VC, this format is much easier than in GTA3 where the paths were stored in IDE files, and GTA-SA paths which are stored in **nodes.dat inside gta3.img. This is a quite complicated format and hardly usable without an editing program (such as [[Ked]]).

GTA SA uses [[GTA SA Paths|compiled binary files]] for its paths.

===GRGE===
This creates [[Garage|garages]] for the <code>[[main.scm]]</code> to use. Only used in San Andreas.

''San Andreas format''
X1, Y1, Z1, frontX, frontY, X2, Y2, Z2, Door, Type, Name
;X1, Y1, Z1: Lower left front
;frontX, frontY: Lower right front
;X2, Y2, Z2: Upper left rear
;Door: [[Grge#Types_of_doors|Types of doors]]
;Type: [[Garage#San_Andreas|Type of garage]]
;Name: [[Garage#San_Andreas_2|Used to edit garage through the SCM]]

===ENEX===
This creates entrances to exits or [[interior]] connections to real world by placing yellow markers on the map for CJ to walk through. Note that changes to the flags and links of existing markers are not updated by the text files after the save is created so maintaining the proper sequence of enex lines is a primary concern. New connections can be added to an existing save if temporary (burglary) connections are not present in the save data. Indoor saves generally have no temporary enex data. Add the markers at the very end of the <code>[[gta.dat]]</code> else it can negatively affect currently placed markers. 376 of 400 possible enex connections are used in a standard game.

''San Andreas format''
X1, Y1, Z1, ROT, W1, W2, C8, X2, Y2, Z2, Rot2, Int, Flag, Name, Sky, I2, Time On, Time Off
;X1, Y1, Z1: entrance location
;ROT: ???
;W1: X width of entry
;W2: Y width of entry
;C8: constant 8
;X2, Y2, Z2: exit location
;Rot2: exit rotation in degrees
;Int: The target interior number
;Flag: The type of marker
;Name: [[Interior#San_Andreas_2|Interior name]], used to find the counterpart and to identify via mission script
;Sky: Sky color changer
;I2: unknown integer flags, could be weather related
;Time On: enables the marker at this time
;Time Off: disables the marker at this time

====San Andreas Enex Flags====
{|
! Flag
! Name
! Description
|-
| 1
| unknown interior
| Only used for interior markers
|-
| 2
| unknown pairing
| Used mostly for interior markers; also Big Ear & LS Skyscraper
|-
| 4
| Create linked pair
| Pair with unflagged mate during new game start
|-
| 8
| Reward interior
| Sets flag 0010 on pair mate when used
|-
| 16
| Used reward entrance
| Set by accessing reward interior
|-
| 32
| Cars and aircraft
| Enable for cars and aircraft
|-
| 64
| Bikes and motorcycles
| Enable for bikes and motorcycles
|-
| 128
| Disable on foot
| No foot traffic. Use for cars and/or bikes only
|-
| 256
| Accept NPC group
| Group members accepted at destination of pair (passengers stripped)
|-
| 512
| Food date flag
| Set and cleared by food date (cut-scene related)
|-
| 1024
| unknown burglary
| Set on Bayside and Temporary Burglary doors
|-
| 2048
| Disable exit
| Player can enter but cannot exit a two-way pair
|-
| 4096
| Burglary access
| Enabled and disabled during Burglary
|-
| 8192
| Entered without exit
| Set by Entrance, Cleared by Exit; Applies to one side of a two
|-
| 16384
| Enable access
| Enabled by default; often cleared by scripts
|-
| 32768
| Delete enex
| Enex is deleted when used
|}

====San Andreas Enex Sky Colors====
{|
! Sky Color
! Descriptions
|-
| 0
| blue sky
|-
| 1
| white fading to black
|-
| 2
| Black with yellow lights.
|-
| 3
| same as 1
|-
| 4
| same as 2
|-
| 5
| white fading to purple fading to black with yellow lights
|-
| 6
| white fading to black with yellow lights.
|-
| 7
| white fading to green fading to black with yellow light (probably clouds)
|-
| 8
| same as 6
|-
| 9
| same as 6
|-
| 10
| same as 2
|-
| 11
| Purple (gay) retarded shadows not much sight.
|-
| 12
| same as 6
|-
| 13
| same as 6
|-
| 14
| same as 7 only green is ocean blue
|-
| 15
| same as 6
|-
| 16
| same as 2.....
|-
| 17
| Nightly Mist
|-
| 18
| Blue fading yellow (sunrise i think)
|-
| 19
| Blue air with white clouds
|-
| 20
| darker blue air with lightblue clouds
|-
| 21
| Darker Blue air with white clouds
|-
| 22
| Orange with white clouds
|-
| 23
| Orange fading gray with orange clouds (weird)
|-
| 24
| this is red fading PURPLE with no seeing rang that you can't even see yourself
|-
| 25
| Dark Purple to grey with nice sun reflection
|-
| 27
| same as 19
|-
| 28
| the best one: big sun white clouds and blue air
|-
| 29
| Blue air white clouds HUGE SUN
|-
| 30
| Orange with dark orange clouds
|}

===PICK===
This creates permanent [[weapon]] pickups. Rockstar only used this to create fire extinguisher pickups at fast food restaurants.

''San Andreas format''
Weapon ID, X, Y, Z

====San Andreas Pick Weapon IDs====
{|
! ID
! Weapon Name
! Ammo
|-
| 4
| Brass Knuckles
| -
|-
| 5
| Nightstick
| -
|-
| 6
| Knife
| -
|-
| 7
| *Nothing*
| -
|-
| 8
| *Nothing*
| -
|-
| 9
| Golf Club
| -
|-
| 10
| Bat
| -
|-
| 11
| Shovel
| -
|-
| 12
| Pool Cue
| -
|-
| 13
| Katana
| -
|-
| 14
| Chainsaw
| -
|-
| 15
| Molotov
| 8
|-
| 16
| Grenades
| 8
|-
| 17
| Satchels
| 5
|-
| 18
| 9mm Pistol
| 30
|-
| 19
| Silenced 9mm
| 10
|-
| 20
| Desert Eagle
| 10
|-
| 21
| Shotgun
| 15
|-
| 22
| SPAS Shotgun
| 10
|-
| 23
| Tec 9
| 60
|-
| 24
| Micro SMG
| 60
|-
| 25
| MP5
| 60
|-
| 26
| AK47
| 80
|-
| 27
| M4
| 80
|-
| 28
| Country Rifle
| 20
|-
| 29
| Sniper Rifle
| 10
|-
| 30
| *Nothing*
| -
|-
| 31
| Flamethrower
| 100
|-
| 32
| Minigun
| 500
|-
| 33
| Large Purple Dildo
| -
|-
| 34
| Small White Dildo
| -
|-
| 35
| Large White Vibrator
| -
|-
| 36
| Small Black Vibrator
| -
|-
| 37
| Flowers
| -
|-
| 38
| Cane
| -
|-
| 39
| Ringbox
| -
|-
| 40
| Necklace Box
| -
|-
| 41
| Cellphone
| -
|-
| 42
| *Nothing*
| -
|-
| 43
| Teargas
| 8
|-
| 44
| Minigun (Duplicate)
| 500
|-
| 45
| SPAS Shotgun (Duplicate)
| 10
|-
| 46
| Rocket Launcher
| 4
|-
| 47
| Heat Seeking Rocket Launcher
| 3
|-
| 48
| Detonator
| -
|-
| 49
| Spray can
| 500
|-
| 50
| Fire Extinguisher
| 500
|-
| 51
| Camera
| 36
|-
| 52
| Nightvision Goggles
| -
|-
| 53
| Infrared Goggles
| -
|-
| 54
| Jetpack
| -
|-
| 55
| Parachute
| -
|}

===JUMP===
Creates a Unique Stunt Jump based on the minimum and maximum coordinates for the starting and landing zones. This format conforms with the encoding provided by opcode [[0814]].

''San Andreas format''
startXmin, startYmin, startZmin, startXmax, startYmax, startZmax, landXmin, landYmin, landZmin,
landXmax, landYmax, landZmax, camX, camY, camZ, reward

===TCYC===
Creates black sky if you enter the zone. Also exists for all towns in countryside. Probably custom weather?

''San Andreas format''
X1, Y1, Z1, X2, Y2, Z2, ?, ?, ?, ?, ?

===AUZO===
This creates an audio if you enter the zone.

''San Andreas format type 1''
Name, ID, Switch, X1, Y1, Z1, X2, Y2, Z2
;Name: Name of the zone
;ID: Sound played in this zone
;Switch: Makes it always on or always off. Can be forced using the main.scm using opcode [[0917]]

''San Andreas format type 2''
Name, ID, Switch, X, Y, Z, Volume
;Name: Name of the zone
;ID: Sound played in this zone
;Switch: Makes it always on or always off. Can be forced using the main.scm using opcode [[0917]]
;Volume: The distance the sound will be heard

====San Andreas Auzo Audio IDs====
{|
! ID
! What sound it plays
! Description of sound in the unmodified audio streams
|-
| 4
| Ambience track 9
| St Mark's violin music
|-
| 5
| Ambience track 6
| Beach party bkgd song
|-
| 8
| Ambience track 31
| Unused loud hum
|-
| 10
| Ambience track 5
| Awards ceremony music
|-
| 12
| Ambience track 34
| Loud hum heard on ships
|-
| 13
| Ambience track 23
| Low Rider Challenge bkgd song
|-
| 15
| Ambience track 30
| Static sound heard on military bases
|-
| 17
| Ambience track 12
| Casino bkgd medley
|-
| 19
| Ambience track 4
| Quiet hum heard in Area 69
|-
| 20
| Ambience track 2
| Fan-like clicking heard in Abattoir
|-
| 21
| Ambience track 1
| Quiet hum heard in 24-7s
|-
| 23
| Ambience track 14
| Loud hum heard in Dam interior
|-
| 24
| Ambience track 25
| Racing sounds heard in ITB lobby
|-
| 25
| Ambience track 24
| Quiet hum heard in Planning Dept
|-
| 26
| Ambience track 20
| Quiet hum heard in safe houses
|-
| 28
| Ambience track 13
| Dance Club bkgd medley
|-
| 29
| Ambience track 13
| Dance Club bkgd medley
|-
| 30
| Favorite Radio Station
| Stream or User Tracks Player
|-
| 34
| Ambience track 28
| Pleasure Domes bkgd medley
|-
| 36
| Ambience track 21
| Loud hum heard in Jet interior
|-
| 37
| Ambience track 10
| Muzak-type bkgd heard in unused diner interiors
|-
| 39
| Ambience track 29
| Quiet hum heard in police stations
|-
| 41
| Ambience track 35
| Stadium event bkgd medley
|-
| 44
| Ambience track 18
| Fast Food Joint bkgd sounds
|-
| 48
| Ambience track 3
| Ammunation PA loop
|-
| 50
| Ambience track 39
| Quiet hum heard in warehouses
|-
| 51
| Ambience track 22
| Very loud hum heard in cargo plane?
|-
| 52
| Radio stream CH
| Playback FM
|-
| 53
| Radio stream CO
| K-ROSE
|-
| 54
| Radio stream CR
| KDST
|-
| 55
| Radio stream DS
| Bounce FM
|-
| 56
| Radio stream HC
| SFUR
|-
| 57
| Radio stream MH
| Radio Los Santos
|-
| 58
| Radio stream MR
| Radio X
|-
| 59
| Radio stream NJ
| CSR
|-
| 60
| Radio stream RE
| K-JAH West
|-
| 61
| Radio stream RG
| MasterSounds
|-
| 62
| Radio stream TK
| WCTR
|-
| 64
| Ambience track 17
| Unused quiet hum
|-
| 66
| Ambience track 36
| Strip Club bkgd medley
|-
| 67
| Ambience track 37
| Unused bkgd medley
|}
Notes: Any ID value from 0-70 inclusive not listed above generated no background sound. 
Audio 4 type two only 
Audios 5, 10, 12, and 13 disabled by default, can be re-enabled

===MULT===
''San Andreas and GTA4 only''

In San Andreas, this was never used in the game. This section is currently unknown and may never be known; it is ignored by the game.

===CARS===
Only used in San Andreas, this creates permanent parked vehicles around the state. This section is similar to the opcode [[014B]], the only difference to the opcode is that an IPL-Spawned car got an check if another car is already parked in an specific radius at this position. Rockstar used it only in [[Binary_IPL|binary IPL]]s but it can also be used in regular IPLs. 

''San Andreas format''
X, Y, Z, angle, car id, primary color, secondary color, force_spawn,
alarm_probability, door_lock_probability, unknown (word), unknown (word)

Angle is in radian units: degrees/~57.2958 
Car ID can be random: -1 
Vehicles spawn more reliably if force_spawn is true: 1

===OCCL===
This creates [[occlusion]] boxes around Vice City and San Andreas.

''Vice City and San Andreas format''
direct mid x, direct mid y, bottom height z, width x, width y, height from bottom height to top,
rotation

===ZONE===
Although technically an IPL section, this is usually only used in [[zone]] files (extension <code>.zon</code>).

===BLOK===
''GTA4 only''

===VNOD===
''GTA4 only''

===LINK===
''GTA4 only''

===MLO+===
''GTA4 only''

===RTFX===
''GTA4 only''

===LODM===
''GTA4 only''

===SLOW===
''GTA4 only''

===2DFX===
''GTA4 only''

==Useful Tools==
* {{GTAF|315944|IPL Helper}} - by {{U|Xmen}}
* [http://www.gta.ocram-net.de/index_all.php?downloadsa=11 Binary (De-)Compiler] - By {{U|ocram88}}

==External Links==
* {{GTAF|118193|GTA3/VC Map File Documentation and Troubleshooting}} - Topic by {{U|Opius}} covering general features of IPL files in GTA3 and GTA VC.
* {{GTAF|93990|Paths Documentation for SA, VC and GTA3}} - Topic by {{U|REspawn}} detailing Vice City's paths
* {{GTAF|202532|GTA SA IPL Documentation}} - Topic by {{U|spaceeinstein}} covering details of the IPL format in GTA SA.
* {{GTAF|331835|Enex Documentation}} - Topic by {{U|OrionSR}}
* {{GTAF|post|188549|3177288|Explanation of GTA SA LOD System}} - Post by {{U|steve-m}} explaining the [[LOD]] system for IPL files in GTA SA.
* [http://projectcerbera.com/gta/vc/tutorials/paths Explanation of the path-section in a VC IPL] - by {{U|Cerbera}}

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

[[Category:Map Formats]][[Category:GTA 3]][[Category:GTA VC]][[Category:GTA SA]]

Saves (GTA SA)

2008-10-02T11:54:41Z

OrionSR: /* Block 22: Shopping */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte censore flag (see note 5 below)
0x011C byte times left to display a cinematic camera help (see note 6 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 7 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# When the censore flag is set to 0, some actions are disabled in the game, such as money drop from the killed people, no more headshots, etc. This flag is controlled by what language you are using. If it's English, this flag is set to 1.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; see details below
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes:
# The ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.
# Map Fog Array: Each byte denotes the state of the certain map sector (00 = not visited / 01 = visited); byte order = N to S (10 rows), then E to W (10 cols).

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte IPL stream of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes
Each byte represents the shopping items listed in the order of "section prices" at the beginning of shopping.dat. A short summary of the 544 flags is: CarMods, Clothes (torso, legs, shoes, necklace, watch, glasses, hats), Haircuts, Tattoos, Food, and Weapons.

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

==Savegame Editor documentation==
The source code and documentation of the Savegame Editor of Paul Breeuwsma is put online.
You can [http://www.paulinternet.nl/#sa download it] or [http://www.paulinternet.nl/sadoc/ view the documentation online].
Feel free to use/copy/edit it if you want to.

==Tools==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://en.wikipedia.org/wiki/010_Editor 010 Editor], by [[User:Seemann|Seemann]]: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v2.8 by Paul Breeuwsma: http://www.paulinternet.nl/#sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
[[Category:Save Formats]] [[Category:GTA SA]]

Memory Addresses (SA)

2008-09-11T19:30:41Z

OrionSR: /* Garages and Parking */

'''Note that all offsets thus posted have been confirmed for GTA San Andreas (GTA_SA.EXE) version 1.0.'''
This is ''not'' for Function-Memadresses, for these look into [[Function Memory Addresses (SA)|Function Memory Addresses (SA)]].

'''Note:''' None of the memory addresses below will work for GTA: San Andreas v2.0. All address in v2.0 have been changed or moved. Thus inaccessible.

= Base Memory adresses =

==No category yet==
* 0xA49D54 - [dword] Timer for driving/flying missions (in ms)
* 0xA51974 - [dword] Timer for boat/bike missions (in ms)
* 0xA51A3C - Timer for Bloodring race
* 0xB7CE50 - [dword] Money
* 0xBAA420 - Wanted Level
* 0x8CDEE4 - [dword] Max wanted level
* 0xB79038 - [dword] How many days have passed in game
* 0xB70153 - [byte] Current Hour
* 0xB70152 - [byte] Current Minute
* 0xB7014E - [byte] Current Weekday (1 through 7)
* 0x8CB7A5 - [byte] Current Radiostation-ID
* 0xB700F0 - [dword] Current Car ID (from vehicle.ide) - not for bikes
* 0x863984 - [float] Gravity
* 0xB7CB84 - [dword] A global timer in ms
* 0xB7CB64 - [float] Game speed in percent
* 0xB70158 - [dword] Timer related to weather and time in ms
* 0xB7015C - [dword] Defines how many ms (1 second... default 1000, set to 1 for a headache, number of ms per sec)
* 0xB7CEE4 - [byte/boolean] Is infinite run
* 0xB7CEE6 - [byte/boolean] Is player fireproof
* 0x96C009 - [byte/boolean] Is paynspray free
* 0xA444A4 - [byte/boolean] Is radar grey'd out
* 0x8D2530 - [float] Pedestrian density multiplier
* 0x8A5B20 - [float] Vehicle density multiplier
* 0xB6F065 - [byte/boolean] Widescreen (the view that is displayed during cutscenes, not the display option)
* 0xA4A948 - Lowrider hydrailics score
* 0xA4EC20 - Minigames dancing score
* 0xB790B8 - [byte] Photographs taken number (4 bytes)
* 0xA9AD74 - [byte] Tags number (4 bytes)
* 0xB791E4 - [byte] Horseshoes number (4 bytes)
* 0xB791EC - [byte] Oysters number (4 bytes)

'''Note:'''
For those number above if you change it to maximum amount they appear to pop a message and gives a bonus like weapons in cj savehouses.

* 0x716642 - [float] Change solid clouds
* 0x716655 - [float] Disable solid clouds

'''Note:'''
Both values default to 200. If you change one of them to 100,000 you get very few clouds, a much nicer effect. If you change both of them to 100,000 you never get the clouds.

* 0xB79078 - [byte] People dropped off in taxi (number used for the stats, 4 bytes)
* 0xA49C30 - [byte] People dropped off in taxi (number used for giving your reward, 4 bytes)
* 0xB79040 - [byte] Safehouse visits number (4 bytes)
* 0xA49EFC - [dword] Denise Progress
* 0xA49F00 - [dword] Michelle Progress
* 0xA49F04 - [dword] Helena Progress
* 0xA49F08 - [dword] Barbara Progress
* 0xA49F0C - [dword] Katie Progress
* 0xA49F10 - [dword] Millie Progress

'''Note:'''
These above six addresses are within the scm block, and valid only for original scm. setting a value to 100 (ie. 100 pct) gives you all gifts of that GF (ie. car keys, wardrobe etc.).

* 0xB79108 - Number of girls dated
* 0xB79100 - Current number of girlfriends
* 0xB79104 - Number of disastrous dates
* 0xB79110 - Number of successfull dates
* 0xB79060 - Unique jumps found number
* 0xB79064 - Unique jumps done number
* 0xBA6774 - Map target:
** 0 = disabled
** 1 = enabled
* 0x86329C - List of valid command names
* 0xC17054 - Main game window HWND
* 0xC97C28 - IDirect3DDevice9 pointer

==Stats==
* 0xB793D4 - [float] Fat stat
* 0xB793D8 - [float] Stamina stat
* 0xB793DC - [float] Muscle stat
* 0xB793E0 - [float] Health stat
* 0xB793E4 - [float] Sex Appeal stat
* 0xB79496 - [float] Pistol stat
* 0xB79498 - [float] Silenced pistol stat
* 0xB7949C - [float] Desert eagle stat
* 0xB794A0 - [float] Shotgun stat
* 0xB794A4 - [float] Sawn-off shotgun stat
* 0xB794A8 - [float] Combat shotgun stat
* 0xB794AC - [float] Machine pistol stat
* 0xB794B0 - [float] SMG stat
* 0xB794B4 - [float] AK47 stat
* 0xB794B8 - [float] M4 stat

==HTML Stats File==
* 0x8663A0 - File Name ( Default : 'stats.html' )
* 0x86636C - File Title ( Default : '<title>Grand Theft Auto San Andreas Stats</title>' )

==Cheats==
[byte] Can be either on (1) or off (0).
* 0x969130 - Weapon Set 1
* 0x969131 - Weapon Set 2
* 0x969132 - Weapon Set 3
* 0x969133 - Health+Armor+250K
* 0x969134 - Increase Wanted Level 2 Stars
* 0x969135 - Clear Wanted Level
* 0x969136 - Sunny Weather
* 0x969137 - Very Sunny Weather
* 0x969138 - Overcast Weather
* 0x969139 - Rainy Weather
* 0x96913A - Foggy Weather
* 0x96913B - Faster Clock
* 0x96913C - Faster Gameplay
* 0x96913D - Slower Gameplay
* 0x96913E - Peds Attack Eachother with Golfclub
* 0x96913F - Have Bounty on Head
* 0x969140 - Everyone is Armed
* 0x969141 - ''Spawn Rhino ('''Not Tested!''')''
* 0x969142 - ''Spawn Bloodring Banger ('''Not Tested!''')''
* 0x969143 - ''Spawn Rancher ('''Not Tested!''')''
* 0x969144 - ''Spawn Racecar A ('''Not Tested!''')''
* 0x969145 - ''Spawn Racecar B ('''Not Tested!''')''
* 0x969146 - ''Spawn Romero ('''Not Tested!''')''
* 0x969147 - ''Spawn Stretch ('''Not Tested!''')''

* 0x96914A - Blow up All Cars
* 0x96914B - Wheels Only (Invisible Cars)
* 0x96914C - Perfect Handling
* 0x96914D - Suicide
* 0x96914E - All Green Lights
* 0x96914F - Aggressive Drivers
* 0x969150 - Pink Traffic
* 0x969151 - Black Traffic
* 0x969153 - Boats Can Fly
* 0x969154 - CJ is Fat
* 0x969155 - Max Muscle
* 0x969156 - CJ is Skinny
* 0x969157 - Elvis Everywhere
* 0x969158 - Peds attack with rockets
* 0x969159 - Beach Theme
* 0x96915A - Gang Members everywhere
* 0x96915B - Gangs control the streets
* 0x96915C - Ninja Theme
* 0x96915D - Slut Magnet
* 0x96915E - Traffic is Cheap Cars
* 0x96915F - Traffic is Fast Cars
* 0x969160 - Cars can Fly
* 0x969161 - Huge Bunny Hop
* 0x969162 - ''Spawn Hydra ('''Not Tested!''')''
* 0x969163 - ''Spawn Vortex Hovercraft ('''Not Tested!''')''
* 0x969164 - Tank Mode/Smash'n Boom
* 0x969165 - All cars have nitro
* 0x969166 - Cars Float Away when hit
* 0x969167 - Always Midnight
* 0x969168 - Stop Game Clock - Orange Sky
* 0x969169 - Thunderstorm
* 0x96916A - Sandstorm
* 0x96916C - Mega Jump
* 0x96916D - Infinite Health
* 0x96916E - Infinite Oxygen
* 0x96916F - Get Parachute
* 0x969170 - Get Jetpack
* 0x969171 - Never Wanted
* 0x969172 - Six Star Wanted Level
* 0x969173 - Mega Punch
* 0x969174 - Never get Hungry
* 0x969175 - Peds Riot (Chaos Mode)
* 0x969176 - Funhouse Theme
* 0x969177 - Slower Gameplay
* 0x969178 - Infinite Ammo, No Reload
* 0x969179 - Full Weapon Aiming while driving
* 0x96917A - Decreased Traffic
* 0x96917B - Traffic is Country vehicles
* 0x96917C - Recruit Anyone (9mm)
* 0x96917D - Country Theme
* 0x96917E - Recruit Anyone (Rockets)
* 0x96917F - Max Respect
* 0x969180 - Max Sex Appeal
* 0x969181 - Max Stamina
* 0x969183 - Hitman in All Weapons
* 0x969184 - ''Spawn Hunter ('''Not Tested!''')''
* 0x969185 - ''Spawn Quad ('''Not Tested!''')''
* 0x969186 - ''Spawn Tanker Truck ('''Not Tested!''')''
* 0x969187 - ''Spawn Dozer ('''Not Tested!''')''
* 0x969188 - ''Spawn Stunt Plane ('''Not Tested!''')''
* 0x969189 - ''Spawn Monster ('''Not Tested!''')''

[dword]
* 0x96918C - Has ever Cheated or not
* 0xBAA472 - Has now Cheated or not
* 0xB79044 - Cheated Count

[byte]
* 0x96918C - 'Cheated' state:
** 0 = disabled
** 1 = enabled

'''Note:'''
If it's set to 1 you'll get a warning message when saving a game. But this byte doesn't get set if you use a cheat enabler.

==Display Settings==
* 0xBA6784 - [dword] Brightness
* 0xBA6792 - [byte] Legend
* 0xBA676C - [byte] Radar Mode
* 0xBA6769 - [byte] Hud Mode
* 0xBA678C - [byte] Subtitles
* 0xBA6830 - [byte] Store gallery photos
* 0xBA6788 - [float] Draw Distance
* 0xBA6794 - [byte] Frame limiter
* 0xBA6793 - [byte] Widescreen
* 0xA9AE54 - [byte] Visual FX Quality
* 0xBA680C - [byte] Mip Mapping
* 0xBA6814 - [byte] Antialiasing values:
** 1 = 0x (off)
** 2 = 1x
** 3 = 2x
** 4 = 3x
* 0xBA6820 - [byte] Resolution values:
** 11 = 640x480
** 12 = 800x400
** 13 = 800x600
** 15 = 1024x768
:(Depends on the graphic driver/hardware.)

==Sound Configuration==
* 0xBA6798 - [byte] Radio Volume [0 through 64]
* 0xBA6797 - [byte] SFX Volume [0 through 64]
* 0xBA6799 - [byte] Radio Equalizer
* 0xBA6795 - [byte] Radio Auto-tune
* 0xBA67F8 - [byte] Usertrack/Play mode values:
** 0 = radio
** 1 = random
* 0xBA680D - [byte] Usertrack/Automatic Media Scan
* 0xBA679A - [byte] Radio Station ID values:
** 1 to 12 (see below for station names according to ID)
*** 1 = "Playback FM"
*** 2 = "K Rose"
*** 3 = "K-DST"
*** 4 = "Bounce FM"
*** 5 = "SF-UR"
*** 6 = "Radio Los Santos"
*** 7 = "Radio X"
*** 8 = "CSR 103.9"
*** 9 = "K-JAH West"
*** 10 = "Master Sounds 98.3"
*** 11 = "WCTR Talk Radio"
*** 12 = "User Track Player"
*** 13 = "Radio Off"

AlienX:
Seems that the Radio Station ID is just a menu identifier, this does not acctually change the radio station while in-game!

Another note... The opcode for switching players radio stations does not work in line with the station ID's, i have yet to figure out what station ID's are for the SCM code - Dont try to use the above ID's for the SCM Operation Code, it just wont work

Thanks to AlienX For the station names and ID's

==Controller Configuration==
* 0xBA6818 - [byte] Controller Configuration values:
** 0 = mouse + keys
** 1 = joypad
* 0xB6EC1C - [float] Mouse sensivity
* 0xC1CC02 - [byte] Steer with mouse
* 0xC1CC03 - [byte] Invert mouse vertically

*0xB6EC2E - REAL aiming mode offset, not menu:
**0 = joypad
**1 = mouse + keys

==Other Dynamic Memory Addresses (non-static)==

==Pedestrians==
===General===
* 0xB6F5F0 - Player pointer (CPed)
* 0xB7CD98 - Player pointer, direct offset to the ped pool start (CPed)
* 0xB74498 - CPeds maximum number (normally 140)
* 0xB74490 - Contains a pointer to a pointer
This pointer:
* +0 = Contains a pointer to the first element in the pool
* +4 = Contains a pointer to a byte map indicating which elements are in use
* +8 = [dword] Is the maximum number of elements in the pool
* +12 = [dword] Is the current number of elements in the pool

Each ped object is 1988 (0x7C4) bytes.

For each ped in the pool:

In most cases, you can use even the dword of playeraddress as CPed value
* CPed +0x14 = Pointer to XYZ position structure (and rotation)
** (CPed+0x14) +0x0 to +0x2C = [dword] Is the rotation matrix
** (CPed+0x14) +0x30 = [dword] XPos
** (CPed+0x14) +0x34 = [dword] YPos
** (CPed+0x14) +0x38 = [dword] ZPos
* CPed +0x2F = [byte] Location status:
** 0 = outside
** 3 = inside a building
* CPed +0x42 = [float] Is the BP/EP/FP/DP (special flags) status of the player as follows: Add these values, and write the sum into +66 (0x42).
** 1 = makes ped soft (ie. can move through walls and everything) (noclip in other words)
** 2 = freezes ped (ie. ped cannot walk)
** 4 = bullet-proof
** 8 = flame-proof
** 16 = ?
** 32 = ?
** 64 = damage-proof (from collisions etc)
** 128 = explosion-proof
* CPed +0xC0 = [dword] Pointer to nearest car
* CPed +0x15C = Some anim states:
** 0 = landing from jump
** 61 = punching
** 102 = stopped
** 154 = sprint
** 205 = run
* Cped +0x46C = [byte] Player check:
** 0 = in air/water
** 1 = in car
** 2 = entering interior
** 3 = on foot
* CPed +0x46D = Jump state:
** 32 = landed/idle
** 34 = in air
** 36 = landing
* CPed +0x46F = Crouch state:
** 128 = stand
** 132 = crouched
* CPed +0x47C = Pointer to anim struct
* CPed +0x4DF = Current anim play-state:
** 0 = nothing
** 61 = starting/stopping
** 62 = looping
* CPed +0x504 = [word] Muzzle flash intensity:
** 0 to 10000 = on
** 65536 = off
* CPed +0x530 = [dword] State:
** 0 = leaving a car, falling down from a bike or something like this
** 1 = normal case
** 50 = driving
** 55 = wasted
** 63 = busted
* CPed +0x534 = Runningstate:
** 0 = while driving
** 1 = standing still
** 4 = start to run
** 6 = running
** 7 = running fast (sprinting) by pressing sprint key
* CPed +0x540 = [float] Health
* CPed +0x544 = [float] Max health
* CPed +0x548 = [float] Armor
* CPed +0x558 = [float] Z angle
* CPed +0x568 = [dword] Current Car you are in contact with
* CPed +0x584 = [dword] Current Entity you are in contact with
* CPed +0x58C = [dword] Last or Current Driven Car (CarPointer)
* CPed +0x598 = [byte] PLayer lock (set to 1 to lock player controls, can't move)
* CPed +0x5A0 = [byte] Start of weapon data (28 bytes) (See structures: WeaponSlot)
* CPed +0x5D8 = [dword] Pistol weapon type:
** 22 = 9mm
** 23 = silenced 9mm
** 24 = desert eagle
* CPed +0x5DC = [dword] Pistol state
* CPed +0x5E0 = [dword] Pistol ammo in clip
* CPed +0x5E4 = [dword] Pistol total ammo (including clip)
* CPed +0x5F4 = [dword] Shotgun weapon type:
** 25 = shotgun
** 26 = sawn-off shotgun
** 27 = spas-12
* CPed +0x5F8 = [dword] Shotgun state:
** 1 = firing?
** 2 = reloading
* CPed +0x5FC = [dword] Shotgun ammo in clip
* CPed +0x600 = [dword] Shotgun total ammo (including clip)
* CPed +0x718 = [byte] Current weapon slot (1 byte)
* CPed +0x740 = Current Weapon ID (from [[default.dat]])
* CPed +0x760 = [dword] Weapon you were killed with
* CPed +0x764 = [dword] Pointer to the ped that killed you

===Structures===
WeaponSlot // Total 28Bytes
DWORD type // + 0
DWORD state // + 4 (0 idle, 1 firing, 2 reloading)
DWORD AmmoInClip // + 8
DWORD AmmoRemaining // +12
FLOAT unknown // +16 (increases each time you fire your weapon, 0 when weapon not active,
probably used to count bullets fired to know when to reload?)
UNKNOWN 0..7 Bytes // +20 (unknown - goggle mode, 0 off and 256 on)...+27

WeaponSlot.type
(Slot0: No Weapon) (Slot2: Handguns)
0 - Fist 22 - Pistol
1 - Brass Knuckles 23 - Silenced Pistol
(Slot1: Melee) 24 - Desert Eagle
2 - Golf Club (Slot3: Shotguns)
3 - Nitestick 25 - Shotgun
4 - Knife 26 - Sawn-Off Shotgun
5 - Baseball Bat 27 - SPAS-12
6 - Shovel (Slot4: Sub-Machineguns)
7 - Pool Cue 28 - Micro Uzi
8 - Katana 29 - MP5
9 - Chainsaw 32 - TEC-9
15 - Cane
(Slot5: Machineguns) (Slot10: Gifts)
30 - AK47 14 - Flowers
31 - M4 (Slot9:Special1)
(Slot6: Rifles) 42 - Fire Extinguisher
33 - Country Rifle 43 - Camera
34 - Sniper Rifle (Slot11:Special2)
(Slot7: Heavy Weapons) 44 - NV Goggles
35 - Rocket Launcher 45 - IR Goggles
36 - Heat Seaking RPG 46 - Parachute
37 - Flame Thrower (Slot12:Detonators)
38 - Minigun 40 - Detonator(for remote explosives)
(Slot8: Projectiles)
16 - Grenade
18 - Molotov Cocktail
39 - Remote Explosives
(No slot: Fired from hunter / hydra / missile launcher)
(This type is stored in the rocket pool as rocket type, but is the continuation of this list)
19 - Normal rockets
20 - Heatseeking rockets
58 - Flares

==Cars==
* 0xB6F980 - Is the direct pointer to the pool start (CVehicle)
* 0xB74494 - Contains a pointer
This pointer:
* +0 = Contains a pointer to the first element in the pool
* +4 = Contains a pointer to a byte map indicating which elements are in use
* +8 = [dword] Is the maximum number of elements in the pool
* +12 = [dword] Is the current number of elements in the pool

Each vehicle object is 2584 (0xA18) bytes. It starts at 0xC502AA0.

For each vehicle in the pool:

* +20 = [byte] Contains a pointer to the rotation/position matrix (84 bytes):
** +0 = [float] X-axis Rotation (Grad)
** +4 = [float] Y-axis Rotation (Grad)
** +8 = [float] Z-axis Rotation (Grad)
** +16 = [float] X-axis Rotation (Looking)
** +20 = [float] Y-axis Rotation (Looking)
** +24 = [float] Z-axis Rotation (Looking)
** +48 = [float] X-axis Position
** +52 = [float] Y-axis Position
** +56 = [float] Z-axis Position
* +34 = [word] Vehicle ID from vehicles.ide
* +66 = [byte] Is the BP/EP/DP/DP (Special Flags) status of the car as follows: Add these values, and write the sum into +66
** 1 = n/a
** 2 = n/a
** 4 = bullet-proof
** 8 = fire-proof
** 16 = damage-proof (from collisions etc)
** 32 = n/a
** 64 = n/a
** 128 = explosion-proof
* +68 = [float] X (East-West) speed
* +72 = [float] Y (North-South) speed
* +76 = [float] Z (Up-Down) speed
* +80 = [float] X (NS) Spin
* +84 = [float] Y (EW) Spin
* +88 = [float] Z (NW) Spin

'''Note:'''
Do not get confused about the Spin Angles, these are NOT rotations but the angles of how fast your vehicle is turning in the given axis direction...

(Car addresses continued:)
* +140 = [float] Mass (kg) from handling.cfg
* +144 = [float] Turn Mass from handling.cfg
* +148 = [float] Grip Divider:
** 1.0 = 1 x gGrip
** 10.1 = 10 x gGrip
** 100.0 = g / 100Grip
* +152 = [float] Mass-to-Grip Multiplier. Ie. G Force when flying/during suspension/driving (acceleration towards ground)
* +160 = [float] Normalized Grip Level
* +164 = [float] CoM X
* +168 = [float] CoM Y
* +172 = [float] CoM Z
* +1064 = [byte] Engine State (whether the engine is running or stalled):
** 0 = stalled
** 16 = ok
* +1069 = [byte] Siren on/off
* +1076 = [byte] Body Color (as in [[carcolors.dat]], black being the 0)
* +1077 = [byte] Stripe Color (as in [[carcolors.dat]], black being the 0)
* +1078 = [byte] Body Color #2
* +1079 = [byte] Stripe Color #2
* +1080 = [dword] modding data as in garage info (Not working?)
* +1084 = [dword] modding data as in garage info (Not working?)
* +1088 = [dword] modding data as in garage info (Not working?)
* +1092 = [dword] modding data as in garage info (Not working?)
* +1096 = [dword] modding data as in garage info (Not working?)
* +1100 = [dword] modding data as in garage info (Not working?)
* +1104 = [dword] modding data as in garage info (Not working?)
* +1108 = [dword] modding data as in garage info (Not working?)
* +1112 = [float] Car Wheel Size from vehicle.ide
* +1116 = [dword] Time left for car alarm to sound in ms
* +1120 = [dword] Pointer to driver
* +1124 = [dword] Pointer to passenger 1 (Front-right seat)
* +1128 = [dword] Pointer to passenger 2 (Rear-left seat)
* +1132 = [dword] Pointer to passenger 3 (Rear-right seat)
* +1136 = [dword] Pointer to passenger 4 (Used for buses)
* +1140 = [dword] Pointer to passenger 5 (Used for buses)
* +1144 = [dword] Pointer to passenger 6 (Used for buses)
* +1148 = [dword] Pointer to passenger 7 (Used for buses)
* +1152 = [dword] Pointer to passenger 8 (Used for buses)
* +1156 = [dword] Pointer to passenger 9 (Used for buses)
* +1172 = [float] Steer angle 1
* +1176 = [float] Steer angle 2
* +1180 = [float] Gas pedal
* +1184 = [float] Brake pedal
* +1192 = [byte] Places a car-bomb:
** 0 = no bomb
** 1 = car has bomb, but not armed
** 4 = car has bomb, and is armed

'''Note:'''
You can set the above values to 0 and 1 to give the car a bomb. Some other flags get set when you arm the bomb. So if you set this value to 4, or actually arm the bomb thru normal gameplay, it does not help to change this value back.

* +1216 = [float] Health/Car Damage Left:
** <250.0 = on fire
** 1000.0 = undamaged
* +1272 = [dword] Car Door Locked State:
** 1 = open
** 2 = locked
* +1300 = [dword] Alternate siren (honking):
** 0 = off
** 1 = on
* +1412 = [dword] Headlights switch:
** 0 = off
** 1 = on
* +1424 = [byte] Car type:
** 0 = car/plane
** 5 = boat
** 6 = train
** 9 = bike
* +1444 = [float] Train speed:
** -0.1 = is forward
** 0.1 = is reverse
* +1445 = [byte] Car Tire (Left-Front) Status:
** 0 = ok
** 1 = flat
** 2 = Used by planes when landing gear is up
* +1446 = [byte] Car Tire (Left-Rear) Status:
** 0 = ok
** 1 = flat
** 2 = Used by planes when landing gear is up
* +1447 = [byte] Car Tire (Right-Front) Status:
** 0 = ok
** 1 = flat
** 2 = Used by planes when landing gear is up
* +1448 = [byte] Car Tire (Right-Rear) Status:
** 0 = ok
** 1 = flat
** 2 = Used by planes when landing gear is up
* +1628 = [byte] Bike Tire (Front) Status:
** 0 = ok
** 1 = flat
* +1629 = [byte] Bike Tire (Rear) Status:
** 0 = ok
** 1 = flat
* +1630 = [byte] Bicycle Tire (Front) Status:
** 0 = ok
** 1 = shot
* +1631 = [byte] Bicycle Tire (Rear) Status:
** 0 = ok
** 1 = shot

'''Note:'''
You cannot actually shoot the wheels of bmx. If you set the value 1 at above two offsets, it rides as if the wheels were shot. They probably not work.

* +1736 = [byte] Is the bike identifier. Gets set to 1 if this vehicle is a bike (or bmx)
* +2020 = [float] Front-Left suspension height
* +2024 = [float] Rear-Left suspension height
* +2028 = [float] Front-Right suspension height
* +2032 = [float] Rear-Right suspension height
* +2276 = [float] Burn Timer (in ms)

Let's say, the Car Position of this given car starts at 0xC5F5DB4:
* +0 = X Level to the ground
* +4 = Y Level to the ground
* +8 = Z Level to the ground
* +16 = X Where am I looking
* +20 = Y Where am I looking
* +24 = Z Where am I looking
* +32 = Dyn flight data
* +36 = Dyn flight data
* +40 = Dyn flight data
* +48 = CarPosX
* +52 = CarPosY
* +56 = CarPosZ

Following offsets are Floats, as positions of doors and other car parts that gets detached by damage. We need to recalculate and set their locations if we warp a car from one location to another. Otherwise the car spins uncontrollably:
* +1828 = Detachables1 Pos X
* +1832 = Detachables1 Pos Y
* +1836 = Detachables1 Pos Z
* +1872 = Detachables2 Pos X
* +1876 = Detachables2 Pos Y
* +1880 = Detachables2 Pos Z
* +1916 = Detachables3 Pos X
* +1920 = Detachables3 Pos Y
* +1924 = Detachables3 Pos Z
* +1960 = Detachables4 Pos X
* +1964 = Detachables4 Pos Y
* +1968 = Detachables4 Pos Z

The locations of the detachable objects are different for cars and bikes. This is merely because bike object is actually smaller than the car object. The car object is used for all vehicles (including heli) but the bikes.

Offsets for Detachables:
* +1532 = BikeDetachPosAdr(0)
* +1632 = BikeDetachPosAdr(1)
* +1676 = BikeDetachPosAdr(2)
* +1720 = BikeDetachPosAdr(3)
* +1764 = BikeDetachPosAdr(4)

* +1828 = CarDetachPosAdr(0)
* +1872 = CarDetachPosAdr(1)
* +1916 = CarDetachPosAdr(2)
* +1960 = CarDetachPosAdr(3)

The trailer of the tanker is handled the same way as the vehicles. Its pointer gets set at offset:
* +0x4C8
To the car object start. When warping vehicles that has trailer, we need to warp this 'vehicle' as well.
The same pointer is used also when you are towing other vehicles as well.

==Wanted==
0xB7CD9C - Wanted pool start (CWanted). Each slot has 668 bytes of data.

* +0x0 = Is the counter for how pissed the cops are:
** above 50 = 1 star
** above 180 = 2 stars
** above 550 = 3 stars
** above 1200 = 4 stars
** above 2400 = 5 stars
** above 4600 = 6 stars
* +0x2C = [dword] Current wanted level
* +0x19 = [byte] Number of cops simultaniously shooting at you

'''Note:'''
Helicopters will still shoot if you change this to 0.

==Camera==
* 0xB6F028 - Camera Block Start (CCamera)
* 0x52B730 - Start of camera 'MOVer' subroutine:
** 0xC3 = lock camera (retn)
* 0xB6F0DC - [dword] Current View:
** 0 = bumper View
** 1 = close external view
** 2 = middle external view
** 3 = furthest external view
** 4 = nothing = same as last?
** 5 = cinematic view
** 6 to INF = same as 4?
* 0xB6F0E0 - [float] Car View Distance (arm length)
* 0xB6F0E8 - [float] True View Distance (true arm length)

==Ignored==
0xB7CD9C - Ignored pointer (CIgnored).

* +0x1E = [byte/boolean] Is player ignored by cops
* +0x298 = [byte/boolean] Is player ignored by everyone

==Pools==
See the [[Data Pools]] funtions in the [[Function Memory Addresses (SA)]] section.

0x550F10 - AllocatePools function.

* 00B74484 - PtrNode Single
* 00B74488 - PtrNode Double
* 00B7448C - EntryInfoNode
* 00B74490 - Peds
* 00B74494 - Vehicles
* 00B74498 - Buildings
* 00B7449C - Objects
* 00B744A0 - Dummys
* 00B744A4 - ColModel
* 00B744A8 - Task
* 00B744AC - Event
* 00B744B0 - PointRoute
* 00B744B4 - PatrolRoute
* 00B744B8 - NodeRoute
* 00B744CC - TaskAllocator
* 00B744C0 - PedIntelligence
* 00B744C4 - PedAttractors

==Target==
0xB6F3B8 = Pointer to Target.

* +0x79C = Targetted CPed:
** 0 = no cped targetted
* +0xC0 = Pointer to last object (ped, car, maybe others) you collided with

==Handling==
0xC2B9DC - Handling Block Start. Each slot has 224 bytes of data.

* +0x0 = [dword] Index/Identifier
* +0x4 = fMass
* +0x8 = 1.0 / fMass
* +0xC = fTurnMass
* +0x10 = fDragMult
* +0x14 = CentreOfMass.x
* +0x18 = CentreOfMass.y
* +0x1C = CentreOfMass.z
* +0x20 = [byte] nPercentSubmerged
* +0x24 = fMass * 8.0000001e-1 / nPercentSubmerged
* +0x28 = fTractionMultiplier
* +0x74 = [byte] TransmissionData.nDriveType
* +0x75 = [byte] TransmissionData.nEngineType
* +0x76 = [byte] TransmissionData.nNumberOfGears
* +0x7C = TransmissionData.fEngineAcceleration (Multiplied by 3.9999999e-4)
* +0x80 = TransmissionData.fEngineInertia
* +0x84 = TransmissionData.fMaxVelocity (Multiplied by 5.5555599e-3)
* +0x94 = fBrakeDeceleration (Multiplied by 3.9999999e-4)
* +0x98 = fBrakeBias
* +0x9C = [byte] bABS
* +0xA0 = fSteeringLock
* +0xA4 = fTractionLoss
* +0xA8 = fTractionBias
* +0xAC = fSuspensionForceLevel
* +0xB0 = fSuspensionDampingLevel
* +0xB4 = fSuspensionHighSpdComDamp
* +0xB8 = Suspension upper limit
* +0xBC= Suspension lower limit
* +0xC0 = Suspension bias between front and rear
* +0xC4 = Suspension anti-dive multiplier
* +0xC8 = fCollisionDamageMultiplier (multiplier not yet found)
* +0xCC = [hex] modelFlags
* +0xD0 = [hex] handlingFlags
* +0xD4 = fSeatOffsetDistance
* +0xD8 = [dword] nMonetaryValue
* +0xDC = [byte] Front lights
* +0xDD = [byte] Rear lights
* +0xDE = [byte] Vehicle anim group

==Controls==
0xB73458 - Start of controls block.

* +0x20 = [word] Accelerate:
** 0 = off
** 255 = on
* +0x22 = [word] Brake

==Rockets==
The rocket pool contains info on launched rockets (for example, Hydra rockets).

0xC891A8 - Rocket pool start. Each slot has 36 bytes of data. There are 32 elements in the pool.

* +0 = [dword] Rocket type:
** 16 = none
** 19 = normal
** 20 = heatseeking
** 58 = flare
* +4 = [dword] Pointer to launching vehicle
* +8 = [dword] Pointer to target vehicle (when heatseeking), 0 otherwise
* +16 = [byte] Does rocket exist?
** 0 = exploded/does not exist
** 1 = travelling
* +20 = [float] X-axis position
* +24 = [float] Y-axis position
* +28 = [float] Z-axis position

==Race Checkpoints==
The checkpoints block that are used in the "illegal street racing" mini-games.

0xC7F158 - Checkpoint block start. Each block is 38 bytes, but theres always only two at a time.

* +0 = [byte] Type of checkpoint
* +2 = [byte] RGBA color value
* +4 = [float] X-axis Position
* +8 = [float] Y-axis Position
* +12 = [float] Z-axis Position
* +16 to +24 = [float] Rotation Matrix (direction from this checkpoint to the next, all floats)
* +32 = [float] Checkpoint radius

==Garages and Parking==
'''Note, that the memory location of garages can vary depending on the scm script you use.'''

There are [[Garage#San_Andreas_2|50 garages]] in the game. Each garage has:-
* Position
* Details
* Usage information
* Location in game
* Location of door
* Width
* Depth
* Height
* Direction it looks
* Coordinates of lower left corner
* Coordinates of upper right corner,
* Usable by the player
* Which property (safe house) it belongs
* Number of vehicles which can be parked inside
* The door state (closed, opening, open and closing)

These are found in the garage object of 212 bytes. The memory locations where the garages start are:
* 0x96C048 (start of first garage)
* +0xD4 (offset for second garage - offset this much again for third garage, again for fourth, etc.)
* 0x96C120 (start of final garage)

(Tested using non-patched original v1.0 German EXE with English language option selected, and original SCM file.)

(UZI-I Tested Player Garage and Pay'n'Spray using Hoodlum Crack EXE with an Blank SCM)

Here is the known garage offsets:
* +0 = [float] X Coord of the Garage Lower Left corner
* +4 = [float] Y Coord of the Garage Lower Left corner
* +8 = [float] Z Coord of the Garage Lower Left corner
* +12 = [float] X Value of direction vector 1
* +16 = [float] Y Value of direction vector 1
* +20 = [float] X Value of direction vector 2
* +24 = [float] Y Value of direction vector 2
* +28 = [float] Top Z Coord. of the garage
* +32 = [float] Normalized Width of the garage
* +36 = [float] Normalized Depth of the garage
* +40 = [float] Left Border (X) corrdinate
* +44 = [float] Right Border (X) corrdinate
* +48 = [float] Front Border (Y) corrdinate
* +52 = [float] Back Border (Y) corrdinate
* +56 = [float] Garage Door Position
* +60 = [dword] unknown (Timer)
* +64 = [dword] unknown (not saved)
* +68 = [chars] Garage Name (7 bytes + nul)
* +76 = [byte] Garage Type
* +77 = [byte] Garage Door State values:
** 0 = closed
** 1 = open
** 2 = closing
** 3 = opening
* +78 = [byte] Door Flags
** 0x01 used mod shop (?)
** 0x02 inactive door
** 0x04 used Pay'n'Spray (?)
** 0x08 small door (reflective?)
** 0x10 up and in door
** 0x20 camera follows player
** 0x40 door is closed flag
** 0x80 girlfriend PnS
* +79 = [byte] Original Type
The direction vector 3 is completely left out, I think because the garages are always even to the ground. I think that is also why the Z values of the direction vectors are also left-out.
Note: Direction Vectors marked above may be Quaternions.

Here are the static Addresses of the Garage Blocks, and to which garage they belong:
* 0x96C048 - Commerce Region, Loading Bay Garage (Life's a Beach)
* 0x96C120 - LSPD Police Impound Garage
* 0x96C1F8 - Mission Garage near El Corona (Los Desperados)
* 0x96C2D0 - Eight Ball Autos near El Corona
* 0x96C3A8 - Mission Garage near El Corona (Cesar Vialpando)
* 0x96C480 - Player Garage: El Corona
* 0x96C558 - LS Burglary Garage near Playe del Seville
* 0x96C630 - LowRider Tuning Garage in Willowfield
* 0x96C708 - Pay 'n' Spray in Idlewood
* 0x96C7E0 - Player Garage: Johnson House
* 0x96C8B8 - Pay 'n' Spray in Temple
* 0x96C990 - Transfender in Temple
* 0x96CA68 - Pay 'n' Spray in Santa Maria Beach
* 0x96CB40 - Player Garage: Santa Maria Beach
* 0x96CC18 - Player Garage: Mulholland
* 0x96CCF0 - Wheel Archangels in Ocean Flats
* 0x96CDC8 - Mission Garage in Ocean Flats (T-Bone Mendez)
* 0x96CEA0 - Player Garage: Hashbury
* 0x96CF78 - Transfender near Wang Cars in Doherty
* 0x96D050 - Pay 'n' Spray near Wang Cars in Doherty
* 0x96D128 - SF Burglary Garage, Loading Bay near Doherty
* 0x96D200 - Player Garage: Doherty
* 0x96D2D8 - Mission Garage in Doherty Garage
* 0x96D3B0 - Woozie's Mission Garage in Chinatown (Ran Fa Li)
* 0x96D488 - Michelle's Pay 'n' Spray in Downtown
* 0x96D560 - Player Garage: Calton Heights
* 0x96D638 - SFPD Police Impound Garage
* 0x96D710 - Pay 'n' Spray in Juniper Hollow
* 0x96D7E8 - Player Garage: Paradiso
* 0x96D8C0 - LVPD Police Impound Garage
* 0x96D998 - Airport Plane Garage in Las Venturas
* 0x96DA70 - LV Burglary Garage near Camel's Toe
* 0x96DB48 - Pay 'n' Spray near Royal Casino
* 0x96DC20 - Transfender in come-a-lot
* 0x96DCF8 - Player Garage: Rockshore West
* 0x96DDD0 - Welding Wedding Bomb-workshop in Emerald Isle
* 0x96DEA8 - Pay 'n' Spray in Redsands East
* 0x96DF80 - Player Garage: Redsands West
* 0x96E058 - Player Garage: Prickle Pine
* 0x96E130 - Player Garage: Whitewood Estates
* 0x96E208 - Pay 'n' Spray in El Quebrados
* 0x96E2E0 - Pay 'n' Spray in Fort Carson
* 0x96E3B8 - Player Garage: Fort Carson
* 0x96E490 - Player Garage: Verdant Meadows
* 0x96E568 - Mission Garage in El Castillo del Diablo (Interdiction)
* 0x96E640 - Airport Garage in Verdant Meadows
* 0x96E718 - Mission Garage in Angel Pine (Puncture Wounds)
* 0x96E7F0 - Pay 'n' Spray in Dillimore
* 0x96E8C8 - Player Garage: Palomino Creek
* 0x96E9A0 - Player Garage: Dillimore

Static Mem. Locations for garages:
* 0x96ABD8 - Johnson House Car 1
* 0x96AC18 - Johnson House Car 2
* 0x96AC58 - Johnson House Car 3
* 0x96AC98 - Johnson House Car 4
* 0x96ACD8 - Santa Maria Beach Car 1
* 0x96AD18 - Santa Maria Beach Car 2
* 0x96AD58 - Santa Maria Beach Car 3
* 0x96AD98 - Santa Maria Beach Car 4
* 0x96ADD8 - Rockshore West Car 1
* 0x96AE18 - Rockshore West Car 2
* 0x96AE58 - Rockshore West Car 3
* 0x96AE98 - Rockshore West Car 4
* 0x96AED8 - Fort Carson Car 1
* 0x96AF18 - Fort Carson Car 2
* 0x96AF58 - Fort Carson Car 3
* 0x96AF98 - Fort Carson Car 4
* 0x96AFD8 - Verdant Meadows Car 1
* 0x96B018 - Verdant Meadows Car 2
* 0x96B058 - Verdant Meadows Car 3
* 0x96B098 - Verdant Meadows Car 4
* 0x96B0D8 - Dillimore Car 1
* 0x96B118 - Dillimore Car 2
* 0x96B158 - Dillimore Car 3
* 0x96B198 - Dillimore Car 4
* 0x96B1D8 - Prickle Pine Car 1
* 0x96B218 - Prickle Pine Car 2
* 0x96B258 - Prickle Pine Car 3
* 0x96B298 - Prickle Pine Car 3
* 0x96B2D8 - Whitewood Estates Car 1
* 0x96B318 - Whitewood Estates Car 2
* 0x96B358 - Whitewood Estates Car 3
* 0x96B398 - Whitewood Estates Car 4
* 0x96B3D8 - Palomino Creek Car 1
* 0x96B418 - Palomino Creek Car 2
* 0x96B458 - Palomino Creek Car 3
* 0x96B498 - Palomino Creek Car 4
* 0x96B4D8 - Redlands West Car 1
* 0x96B518 - Redlands West Car 2
* 0x96B558 - Redlands West Car 3
* 0x96B598 - Redlands West Car 4
* 0x96B5D8 - El Corona Car 1
* 0x96B618 - El Corona Car 2
* 0x96B658 - El Corona Car 3
* 0x96B698 - El Corona Car 4
* 0x96B6D8 - MulHolland Car 1
* 0x96B718 - MulHolland Car 2
* 0x96B758 - MulHolland Car 3
* 0x96B798 - MulHolland Car 4
* 0x96B7D8 - LSPD Impound Car 1
* 0x96B818 - LSPD Impound Car 2
* 0x96B858 - LSPD Impound Car 3
* 0x96B898 - LSPD Impound unused
* 0x96B8D8 - SFPD Impound Car 1
* 0x96B918 - SFPD Impound Car 2
* 0x96B958 - SFPD Impound Car 3
* 0x96B998 - SFPD Impound unused
* 0x96B9D8 - LVPD Impound Car 1
* 0x96BA18 - LVPD Impound Car 2
* 0x96BA58 - LVPD Impound Car 3
* 0x96BA98 - LVPD Impound usued
* 0x96BAD8 - Calton Heights Car 1
* 0x96BB18 - Calton Heights Car 2
* 0x96BB58 - Calton Heights Car 3
* 0x96BB98 - Calton Heights Car 4
* 0x96BBD8 - Paradiso Car 1
* 0x96BC18 - Paradiso Car 2
* 0x96BC58 - Paradiso Car 3
* 0x96BC98 - Paradiso Car 4
* 0x96BCD8 - Doherty Car 1
* 0x96BD18 - Doherty Car 2
* 0x96BD58 - Doherty Car 3
* 0x96BD98 - Doherty Car 4
* 0x96BDD8 - Hashbury Car 1
* 0x96BE18 - Hashbury Car 2
* 0x96BE58 - Hashbury Car 3
* 0x96BE98 - Hashbury Car 4
* 0x96BED8 - Verdant Meadows Airport Car 1
* 0x96BF18 - Verdant Meadows Airport Car 2
* 0x96BF58 - Verdant Meadows Airport Car 3
* 0x96BF98 - Verdant Meadows Airport Car 4

==Interface==
* 0xBAB22C - [byte] Health bar/red text/enemy marker/anything red color (RGBA, 4 bytes)
* 0xBAB230 - [byte] Money font color/vehicle entry name/green text/anything green color (RGBA, 4 bytes)
* 0xBAB238 - [byte] White text color (RGBA, 4 bytes)
* 0xBAB240 - [byte] Main menu title border (RGBA, 4 bytes)
* 0xBAB244 - [byte] Wanted level/yellow text color (RGBA, 4 bytes)
* 0xBAB24C - [byte] Radio station text color (RGBA, 4 bytes)

==Menu==
The following addresses have been found:

0xBA6748 - Base address.

* +0x15D = [byte] Current Menu ID
* +0x78D = [byte] Show menu item hover
* +0x54 = [dword] Selected menu item

* +0xE9 = [byte] Main menu switch (startup menu/menu when playing)
* +0x84 = [dword] Language
* +0x15F = [byte] Selected savegame
* +0x24 = [dword] Radar mode

* +0x64 = [float] Map zoom
* +0x68 = [float] Map x position
* +0x6C = [float] Map y position

* +0x5C = [byte] Player in menu?

==Menu IDs==
Known Menu IDs (get ID at 0xBA68A5):
* 0 = Stats
* 1 = Start game
* 2 = Brief
* 3 = Audio options
* 4 = Display settings
* 5 = Map
* 6 = Question start new game
* 7 = Game selection
* 8 = Question load mission pack
* 9 = Load game
* 10 = Delete game
* 11 = Question load save game
* 12 = Question delete game
* 13 = Loads first savegame? *crash
* 14 = Delete successful
* 15 = Delete successful
* 16 = Save game
* 17 = Question save
* 18 = Save successful
* 19 = Save successful
* 20 = Save game ok
* 21 = Load game ok
* 22 = Game affected, do not save
* 23 = Display default settings
* 24 = Audio default settings
* 25 = Controller default settings
* 26 = User track options
* 28 = Language
* 29 = Save game ok
* 30 = Save unsuccessful
* 31 = Load game (save unsuccessful)
* 32 = Load unsuccessful, file corrupted
* 33 = Options
* 34 = Main menu
* 35 = Quit game
* 36 = Controller setup
* 37 = Redefine controls
* 38 = Foot/vehicle controls
* 39 = Mouse settings
* 40 = Joypad settings
* 41 = Game running main menu
* 42 = Quit game
* 43 = Empty

== SCM related ==
* 0xA49960 - Start of the SCM block (0xA49960 + (4 * varnumber) is that particular variable)
* 0xA7A6A0 - Start of the mission block (69000 bytes)
* 0x464080 - GetOpcodeParameters()
* 0xA447F4 - Command count
* 00469F00 - CRunningScript_ProcessOneCommand
* 0x464080 - CRunningScript_CollectParameters
* 0x4859D0 - CRunningScript_UpdateCompareFlag
* 0x469390 - Game_Script_Thread struct
* 0xA43C78 - Where the routine above stores opcode parameters values. Max 16 paramters for an opcode it seems
* 0x8A6168 - "Master" jumptable, each dword points to one of 27 different functions, each one handling approx 100 opcodes
* 0x466C50 - Opcodes 0000 - 0063. Array of dword, each pointing to the function for that opcode
* 0x468364 - Opcodes 0064 - 00C4. Array of dword, each pointing to the function for that opcode
* 0x469E4C - Opcodes 00D6 - 0129. Array of byte, each byte is an index for the array of dword at 0x469DD4, which points to the opcode function
* 0x47D1B4 - Opcodes 0137 - 018F. Array of byte, each byte is an index for the array of dword at 0x47D0F4, which points to the opcode function
* 0x47DFE0 - Opcodes 0190 - 01F3. Array of byte, each byte is an index for the array of dword at 0x47DF58, which points to the opcode function
* 0x47F304 - Opcodes 01F4 - 0256. Array of byte, each byte is an index for the array of dword at 0x47F24C, which points to the opcode function
* 0x47FA04 - Opcodes 0292 - 02B8. Array of byte, each byte is an index for the array of dword at 0x47F9BC, which points to the opcode function
* 0x480FD8 - Opcodes 02BE - 031D. Array of byte, each byte is an index for the array of dword at 0x480F10, which points to the opcode function
* 0x4836B8 - Opcodes 0320 - 0382. Array of byte, each byte is an index for the array of dword at 0x483600, which points to the opcode function
(No time to finish now, will finish later)

===Threads===
0xA8B430 - Start of the threads pool. There are two queues: the active threads and inactive ones. 
0xA8B42C - Pointer to the first active SCM thread. 
0xA8B428 - Pointer to the first inactive SCM thread.

Each thread has size of 224 (0xE0) bytes.

* +0 = [void*] Pointer to the next thread in a queue
* +4 = [void*] Pointer to the previous thread in a queue
* +8 = [char] Thread name given by the opcode [[03A4]], char 8
* +16 = [dword] Thread base IP (used in the missions and [[External_Script|external scripts]] to calculate a global address of a local jump offset)
* +20 = [dword] Current IP
* +24 = [dword] Return stack (stores the current IP when a gosub executed, dword 8)
* +56 = [word] Last item index of the return stack
* +60 = [dword] Local variables array, dword 32
* +188 = [dword] Automatically incrementing timers, dword 2
* +196 = [boolean] Thread active flag
* +197 = [boolean] IF result
* +198 = [boolean] Mission flag
* +199 = [boolean] External script flag
* +200 = [boolean] Unknown flag (in menu?). Used in [[03E5]]
* +201 = [boolean] Unknown flag (ID of an assigned script?)
* +204 = [dword] Wakeup time (set by [[0001]])
* +208 = [word] IF number (set by [[00D6]])
* +210 = [boolean] Not flag (if a condition to check is negative – any opcodes higher than 0x7FFF)
* +211 = [boolean] Wasted or busted check enabled flag (set by [[0111]]); '''only for missions'''
* +212 = [boolean] Player is wasted or busted flag; '''only for missions'''
* +216 = [dword] Skip scene IP (used by opcodes [[0707]], [[0701]])
* +220 = [boolean] Mission flag

===External Scripts Info===
0xA47B60 – Start of the external scripts info pool. There are 82 elements with 32 bytes of size each
* +0 = [dword] Script IP
* +4 = [word] Status (can be obtained by [[0926]])
* +6 = [word] Index in SCM (a number as defined in the scm header)
* +8 = [char] Name, char 20
* +28 = [dword] Size

0xA485A0 – [dword] Size of the largest external script 
0xA485A4 – [dword] Total scripts count

===Misc===
0xA4892C – Start of the pool stored the flipped vehicles handles. There are 6 elements in there, with each of them:
* +0 = [dword] Vehicle handle to check if it flipped. Stored by opcode [[0190]].
* +4 = [dword] Time in ms passed from the moment a vehicle flipped. Used by opcode [[018F]]

00A90850 – Start of the mission cleanup list. This list keeps the handles of any entities created during a mission. When the opcode [[00D8]] executed (normally it happens at the end of any mission), the game reads this list and destroys everything being stored there. Maximum of the items in the list is 75. Each item has the following structure:
* +0 = [byte] Entity type:
** 1 - vehicle
** 2 - actor
** 3 - object
** 4 - particle
** 5 – group ([[062F]])
** 7 – AS_origin ([[061D]])
** 8 - action_sequence
** 9 - decision maker
** 11 - searchlight
** 13 - txd_dictionary
* +4 = [dword] entity handle (an index in the proper pool)

= Weather Codes=
0xC81318 - [word] Weather lock (by AlienX). 
0xC8131C - [word] Upcoming weather. 
0xC81320 - [word] Current weather. 
 
The following values tie up with the sections in data/[[timecycp.dat]]. There are several different kinds of weathers (including underwater), and the current weather affects viewing distance, sky colour, fog intensity, and other things like that. The appearance of each weather is time-dependent too.
 

Weather Values:

* 0 = EXTRASUNNY_LA
* 1 = SUNNY_LA
* 2 = EXTRASUNNY_SMOG_LA
* 3 = SUNNY_SMOG_LA
* 4 = CLOUDY_LA
* 5 = SUNNY_SF
* 6 = EXTRASUNNY_SF
* 7 = CLOUDY_SF
* 8 = RAINY_SF
* 9 = FOGGY_SF
* 10 = SUNNY_VEGAS
* 11 = EXTRASUNNY_VEGAS (heat waves)
* 12 = CLOUDY_VEGAS
* 13 = EXTRASUNNY_COUNTRYSIDE
* 14 = SUNNY_COUNTRYSIDE
* 15 = CLOUDY_COUNTRYSIDE
* 16 = RAINY_COUNTRYSIDE
* 17 = EXTRASUNNY_DESERT
* 18 = SUNNY_DESERT
* 19 = SANDSTORM_DESERT
* 20 = UNDERWATER (greenish, foggy)
* 21 = EXTRACOLOURS_1 (very dark, gradiented skyline, purple) Used for interiors?
* 22 = EXTRACOLOURS_2 (very dark, gradiented skyline, green) Used for interiors?

 The following are not mentioned in that file, make of them what you will:

* 23 to 26 = variations of pale orange
* 27 to 29 = variations of fresh blue
* 30 to 32 = variations of dark, cloudy, teal
* 33 = dark, cloudy, brown
* 34 = blue/purple, regular
* 35 = dull brown
* 36 to 38 = bright, foggy, orange
* 39 = extremely bright
* 40 to 42 = blue/purple cloudy
* 43 = dark toxic clouds
* 44 = black/white sky
* 45 = black/purple sky

'''Warning: Setting these values to anything higher will result in things like black screen, flickering, really red, etc.'''

= Dependencies=
* Car ptr = player ptr when on foot.
['''Note''': This depends on which address for the pointer is being used, if the car pointer appears to be the same as the player pointer on foot, then you may be using a camera-related target pointer.]
* CPed block size = 0x7C4 bytes.
* CVehicle block size = 0x0A18 bytes.

=External Links=
* [http://www.gtaforums.com/index.php?showtopic=194199 GTASA Memory Addresses] - a topic on GTAForums.

[[Category:Memory Addresses]]

Item Placement

2008-08-15T08:43:19Z

OrionSR: /* ENEX */

'''I'''tem '''PL'''acement files are map files used to place objects into the GTA world, as well as define zones, paths, garages, interior portals, and a lot more. IPL files can easily be opened using any text-editing program like Notepad.

==Structure==
The <code>.ipl</code> files are split up into many sections. Not all of them have to be used, leaving them empty works as well. Each section starts with a section identifier and ends with the keyword "end", both in a separate line.

Example:
inst
...
end

===INST===
Locations and properties for instances of static and dynamic ([[object.dat]]) map objects.

'''GTA3 format:'''
id, name, x, y, z, sx, sy, sz, rx, ry, rz, rw

'''GTAVC format:'''
id, name, int, x, y, z, sx, sy, sz, rx, ry, rz, rw

'''GTASA format:'''
id, name, int, x, y, z, rx, ry, rz, rw, lod

;ID: Unique object identifier. Must match in [[IDE]] file identifier. (integer)
;Name: Usually same as the <code>.dff</code> [[model file]], without extension. (string)
;int: [[Interior#List|Interior number]]; zero for outside. (integer)
;x, y, z: Item placement coordinates. (floating point numbers)
;sx, sy, sz: Item scale, scales visible model only, doesn't scale the [[collision model]]. (floating point numbers)
;rx, ry, rz, rw: Item rotations. Defined as [[Wikipedia:quaternion|quaternion]], quite sophisticated math is needed to translate it to [[Wikipedia:Euler angles|Euler angles]]. A map editing program should be used to edit these.
;lod: San Andreas only. This is the line number in the current IPL file for the [[LOD]] which belongs to this object. The first item in IPL file is line number 0, second is number 1 and so on. A value of -1 means no LOD is used. (integer)

===CULL===
This creates rainfree zones, wastefree zones, map reflections, TV screens, and temporary fixed camera positions. 
''GTA3 and VC format:''
x1, y1, z1, x2, y2, z2, x3, y3, z3, flag, 0
;x2, y2, z2: lower-left corner of the areabox
;x3, y3, z3: upper-right corner of the areabox
''SA format 1:''
centerX, centerY, centerZ, 0 (some kind of rotation), Ywidth, bottomZ, Xwidth, 0 (some kind of rotation), topZ, Flag, Flag 2
''SA format 2:''
centerX, centerY, centerZ, 0 (some kind of rotation), Ywidth, bottomZ, Xwidth, 0 (some kind of rotation), topZ, Flag, Vx, Vy, Vz, Cm
Cull zone boundaries in San Andreas are aligned to the nearest world unit. 
Flags: 
1 Camera close in into player using closest third-person view camera mode, does not close in if in first person or cinematic mode, camera mode cannot be changed while in the zone 
2 camera remotely placed outside the zone, no control of camera, camera mode cannot be changed while in the zone 
4 Unknown 
8 Rain-free, police helicopter-free zone 
4096 5-star military zone

===PATH===
'''Ped, Car and Boat Paths''', defines paths relative to the world centre. Only used in GTA VC, this format is much easier than in GTA3 where the paths were stored in IDE files, and GTA-SA paths which are stored in **nodes.dat inside gta3.img. This is a quite complicated format and hardly usable without an editing program (such as [[Ked]]).

GTA SA uses [[GTA SA Paths|compiled binary files]] for its paths.

===GRGE===
This creates [[Garage|garages]] for the main.scm to use. Only used in San Andreas. 
''SA only:''
X1, Y1, Z1, frontX, frontY, X2, Y2, Z2, Door, Type, Name
;X1, Y1, Z1: Lower left front
;frontX, frontY: Lower right front
;X2, Y2, Z2: Upper left rear
;Door: [[Garage#Grge Door Types|Type of door]]
;Type: [[Garage#San_Andreas|Type of garage]]
;Name: [[Garage#San_Andreas_2|Used to edit garage through the SCM]]

===ENEX===
This creates entrances to exits or [[interior]] connections to real world by placing yellow markers on the map for CJ to walk through. Note that changes to the flags and links of existing markers are not updated by the text files after the save is created so maintaining the proper sequence of enex lines is a primary concern. New connections can be added to an existing save if temporary (burglary) connections are not present in the save data. Indoor saves generally have no temporary enex data. Add the markers at the very end of the <code>[[gta.dat]]</code> else it can negatively affect currently placed markers. 376 of 400 possible enex connections are used in a standard game. 

''SA only:''
X1, Y1, Z1, ROT, W1, W2, C8, X2, Y2, Z2, Rot2, Int, Flag, Name, Sky, I2, Time On, Time Off
;X1, Y1, Z1: entrance location
;ROT: ???
;W1: X width of entry
;W2: Y width of entry
;C8: constant 8
;X2, Y2, Z2: exit location
;Rot2: exit rotation in degrees
;Int: The target interior number
;Flag: The type of marker
;Name: [[Interior#San_Andreas_2|Interior name]], used to find the counterpart and to identify via mission script
;Sky: Sky color changer
;I2: unknown integer flags, could be weather related
;Time On: enables the marker at this time
;Time Off: disables the marker at this time

====Enex Flags====
{|
! Flag
! Name
! Description
|-
| 1
| unknown interior
| Only used for interior markers
|-
| 2
| unknown pairing
| Used mostly for interior markers; also Big Ear & LS Skyscraper
|-
| 4
| Create linked pair
| Pair with unflagged mate during new game start
|-
| 8
| Reward interior
| Sets flag 0010 on pair mate when used
|-
| 16
| Used reward entrance
| Set by accessing reward interior
|-
| 32
| Cars and aircraft
| Enable for cars and aircraft
|-
| 64
| Bikes and motorcycles
| Enable for bikes and motorcycles
|-
| 128
| Disable on foot
| No foot traffic. Use for cars and/or bikes only
|-
| 256
| Accept NPC group
| Group members accepted at destination of pair (passengers stripped)
|-
| 512
| Food date flag
| Set and cleared by food date (cut-scene related)
|-
| 1024
| unknown burglary
| Set on Bayside and Temporary Burglary doors
|-
| 2048
| Disable exit
| Player can enter but cannot exit a two-way pair
|-
| 4096
| Burglary access
| Enabled and disabled during Burglary
|-
| 8192
| Entered without exit
| Set by Entrance, Cleared by Exit; Applies to one side of a two
|-
| 16384
| Enable access
| Enabled by default; often cleared by scripts
|-
| 32768
| Delete enex
| Enex is deleted when used
|}

====Enex Sky Colors====
{|
! Sky Color
! Descriptions
|-
| 0
| blue sky
|-
| 1
| white fading to black
|-
| 2
| Black with yellow lights.
|-
| 3
| same as 1
|-
| 4
| same as 2
|-
| 5
| white fading to purple fading to black with yellow lights
|-
| 6
| white fading to black with yellow lights.
|-
| 7
| white fading to green fading to black with yellow light (probably clouds)
|-
| 8
| same as 6
|-
| 9
| same as 6
|-
| 10
| same as 2
|-
| 11
| Purple (gay) retarded shadows not much sight.
|-
| 12
| same as 6
|-
| 13
| same as 6
|-
| 14
| same as 7 only green is ocean blue
|-
| 15
| same as 6
|-
| 16
| same as 2.....
|-
| 17
| Nightly Mist
|-
| 18
| Blue fading yellow (sunrise i think)
|-
| 19
| Blue air with white clouds
|-
| 20
| darker blue air with lightblue clouds
|-
| 21
| Darker Blue air with white clouds
|-
| 22
| Orange with white clouds
|-
| 23
| Orange fading gray with orange clouds (weird)
|-
| 24
| this is red fading PURPLE with no seeing rang that you can't even see yourself
|-
| 25
| Dark Purple to grey with nice sun reflection
|-
| 27
| same as 19
|-
| 28
| the best one: big sun white clouds and blue air
|-
| 29
| Blue air white clouds HUGE SUN
|-
| 30
| Orange with dark orange clouds
|}

===PICK===
This creates permanent [[weapon]] pickups. Rockstar only used this to create fire extinguisher pickups at fast food restaurants. 
''SA only:''
Weapon ID, X, Y, Z

====Pick Weapon IDs====
{|
! ID
! Weapon Name
! Ammo
|-
| 4
| Brass Knuckles
| -
|-
| 5
| Nightstick
| -
|-
| 6
| Knife
| -
|-
| 7
| *Nothing*
| -
|-
| 8
| *Nothing*
| -
|-
| 9
| Golf Club
| -
|-
| 10
| Bat
| -
|-
| 11
| Shovel
| -
|-
| 12
| Pool Cue
| -
|-
| 13
| Katana
| -
|-
| 14
| Chainsaw
| -
|-
| 15
| Molotov
| 8
|-
| 16
| Grenades
| 8
|-
| 17
| Satchels
| 5
|-
| 18
| 9mm Pistol
| 30
|-
| 19
| Silenced 9mm
| 10
|-
| 20
| Desert Eagle
| 10
|-
| 21
| Shotgun
| 15
|-
| 22
| SPAS Shotgun
| 10
|-
| 23
| Tec 9
| 60
|-
| 24
| Micro SMG
| 60
|-
| 25
| MP5
| 60
|-
| 26
| AK47
| 80
|-
| 27
| M4
| 80
|-
| 28
| Country Rifle
| 20
|-
| 29
| Sniper Rifle
| 10
|-
| 30
| *Nothing*
| -
|-
| 31
| Flamethrower
| 100
|-
| 32
| Minigun
| 500
|-
| 33
| Large Purple Dildo
| -
|-
| 34
| Small White Dildo
| -
|-
| 35
| Large White Vibrator
| -
|-
| 36
| Small Black Vibrator
| -
|-
| 37
| Flowers
| -
|-
| 38
| Cane
| -
|-
| 39
| Ringbox
| -
|-
| 40
| Necklace Box
| -
|-
| 41
| Cellphone
| -
|-
| 42
| *Nothing*
| -
|-
| 43
| Teargas
| 8
|-
| 44
| Minigun (Duplicate)
| 500
|-
| 45
| SPAS Shotgun (Duplicate)
| 10
|-
| 46
| Rocket Launcher
| 4
|-
| 47
| Heat Seeking Rocket Launcher
| 3
|-
| 48
| Detonator
| -
|-
| 49
| Spray can
| 500
|-
| 50
| Fire Extinguisher
| 500
|-
| 51
| Camera
| 36
|-
| 52
| Nightvision Goggles
| -
|-
| 53
| Infrared Goggles
| -
|-
| 54
| Jetpack
| -
|-
| 55
| Parachute
| -
|}

===JUMP===
Creates a Unique Stunt Jump based on the minimum and maximum coordinates for the starting and landing zones. This format conforms with the encoding provided by opcode [[0814]]. 
''SA only:''
startXmin, startYmin, startZmin, startXmax, startYmax, startZmax, landXmin, landYmin, landZmin,
landXmax, landYmax, landZmax, camX, camY, camZ, reward

===TCYC===
Creates black sky if you enter the zone. Also exists for all towns in countryside. Probably custom weather? 
''SA only:''
X1, Y1, Z1, X2, Y2, Z2, ?, ?, ?, ?, ?

===AUZO===
This creates an audio if you enter the zone. 
''SA Type 1:''
Name, ID, Switch, X1, Y1, Z1, X2, Y2, Z2
;Name: Name of the zone
;ID: Sound played in this zone
;Switch: Makes it always on or always off. Can be forced using the main.scm using opcode [[0917]] 
''SA Type 2:''
Name, ID, Switch, X, Y, Z, Volume
;Name: Name of the zone
;ID: Sound played in this zone
;Switch: Makes it always on or always off. Can be forced using the main.scm using opcode [[0917]]
;Volume: The distance the sound will be heard

====Auzo Audio IDs====
{|
! ID
! What sound it plays
! Description of sound in the unmodified audio streams
|-
| 4
| Ambience track 9
| St Mark's violin music
|-
| 5
| Ambience track 6
| Beach party bkgd song
|-
| 8
| Ambience track 31
| Unused loud hum
|-
| 10
| Ambience track 5
| Awards ceremony music
|-
| 12
| Ambience track 34
| Loud hum heard on ships
|-
| 13
| Ambience track 23
| Low Rider Challenge bkgd song
|-
| 15
| Ambience track 30
| Static sound heard on military bases
|-
| 17
| Ambience track 12
| Casino bkgd medley
|-
| 19
| Ambience track 4
| Quiet hum heard in Area 69
|-
| 20
| Ambience track 2
| Fan-like clicking heard in Abattoir
|-
| 21
| Ambience track 1
| Quiet hum heard in 24-7s
|-
| 23
| Ambience track 14
| Loud hum heard in Dam interior
|-
| 24
| Ambience track 25
| Racing sounds heard in ITB lobby
|-
| 25
| Ambience track 24
| Quiet hum heard in Planning Dept
|-
| 26
| Ambience track 20
| Quiet hum heard in safe houses
|-
| 28
| Ambience track 13
| Dance Club bkgd medley
|-
| 29
| Ambience track 13
| Dance Club bkgd medley
|-
| 30
| Favorite Radio Station
| Stream or User Tracks Player
|-
| 34
| Ambience track 28
| Pleasure Domes bkgd medley
|-
| 36
| Ambience track 21
| Loud hum heard in Jet interior
|-
| 37
| Ambience track 10
| Muzak-type bkgd heard in unused diner interiors
|-
| 39
| Ambience track 29
| Quiet hum heard in police stations
|-
| 41
| Ambience track 35
| Stadium event bkgd medley
|-
| 44
| Ambience track 18
| Fast Food Joint bkgd sounds
|-
| 48
| Ambience track 3
| Ammunation PA loop
|-
| 50
| Ambience track 39
| Quiet hum heard in warehouses
|-
| 51
| Ambience track 22
| Very loud hum heard in cargo plane?
|-
| 52
| Radio stream CH
| Playback FM
|-
| 53
| Radio stream CO
| K-ROSE
|-
| 54
| Radio stream CR
| KDST
|-
| 55
| Radio stream DS
| Bounce FM
|-
| 56
| Radio stream HC
| SFUR
|-
| 57
| Radio stream MH
| Radio Los Santos
|-
| 58
| Radio stream MR
| Radio X
|-
| 59
| Radio stream NJ
| CSR
|-
| 60
| Radio stream RE
| K-JAH West
|-
| 61
| Radio stream RG
| MasterSounds
|-
| 62
| Radio stream TK
| WCTR
|-
| 64
| Ambience track 17
| Unused quiet hum
|-
| 66
| Ambience track 36
| Strip Club bkgd medley
|-
| 67
| Ambience track 37
| Unused bkgd medley
|}
Notes: Any ID value from 0-70 inclusive not listed above generated no background sound. 
Audio 4 type two only 
Audios 5, 10, 12, and 13 disabled by default, can be re-enabled

===MULT===
San Andreas only, this was never used in the game. This section is currently unknown and may never be known; it is ignored by the game.

===CARS===
Only used in San Andreas, this creates permanent parked vehicles around the state. This section is similar to the opcode [[014B]], the only difference to the opcode is that an IPL-Spawned car got an check if another car is already parked in an specific radius at this position. Rockstar used it only in binary IPLs but it can also be used in regular IPLs. 

''SA only:''
X, Y, Z, angle, car id, primary color, secondary color, force_spawn,
alarm_probability, door_lock_probability, unknown (word), unknown (word)

Angle is in radian units: degrees/~57.2958 
Car ID can be random: -1 
Vehicles spawn more reliably if force_spawn is true: 1

===OCCL===
This creates [[occlusion]] boxes around Vice City and San Andreas. 
''VC and SA only:''
direct mid x, direct mid y, bottom height z, width x, width y, height from bottom height to top,
rotation

===ZONE===
Although technically an IPL section, this is usually only used in [[zone]] files (extension <code>.zon</code>).

==Useful Tools==
* [http://www.gtaforums.com/index.php?showtopic=315944 IPL Helper] - by Xmen

==External Links==
* [http://www.gtaforums.com/index.php?showtopic=202532 GTA SA IPL Documentation] - Topic by spaceeinstein covering details of the IPL format in GTA SA.
* [http://www.gtaforums.com/index.php?showtopic=188549&view=findpost&p=3177288 Explanation of GTA SA LOD System] - GTA Forums message by Steve-M, explaining the [[LOD]] system for IPL files in GTA SA.
* [http://projectcerbera.com/tutorials/vc_paths-definition.html Explantation of the path-section in a VC IPL] - by Cerbera
* [http://www.gtaforums.com/index.php?showtopic=331835 Enex Documentation]

[[Category:Map Formats]][[Category:GTA 3]][[Category:GTA VC]][[Category:GTA SA]]

Saves (GTA SA)

2008-08-15T07:23:45Z

OrionSR: /* Block 25: ENEX Connections */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte IPL stream of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used
New enex connections can be added to the save after the save is created if temporary (burglary) connections are not present (indoor or isolated saves). The flags and links for existing connections will not be updated by changes in the IPL file. If the enex structure is removed from the block (except for the -1 terminator) the game will remap all connections based on the current IPL configuration.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://en.wikipedia.org/wiki/010_Editor 010 Editor], by [[User:Seemann|Seemann]]: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v2.8 by Paul Breeuwsma: http://www.paulinternet.nl/#sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-08-15T06:58:29Z

OrionSR: /* Block 25: ENEX Connections */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte IPL stream of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path. The enex path is used to display the zone name for the destination before CJ arrives in the zone.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://en.wikipedia.org/wiki/010_Editor 010 Editor], by [[User:Seemann|Seemann]]: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v2.8 by Paul Breeuwsma: http://www.paulinternet.nl/#sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-08-08T18:52:36Z

OrionSR: /* Block 25: ENEX Connections */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0x22 0xCC 0x31 0x5D -- Version 2.00 (German)
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 16.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3A byte[2] (Align)
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x224 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte unknown
0x0193 byte (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0230 dword (Align)

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48 (size of the following data)
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 dword pointer to CObject
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word index
0x1C byte type
0x1D byte flags
0x1E byte[2] (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 byte icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word number of cars to generate (101 or higher means unlimited generation)
0x1E byte IPL stream of binary generators (non-zero records are not saved)
0x1F byte allocation flag (when game adds a new parked car it searches for the allocation = 0;
then sets it to 1 and never set back to 0).
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags (count)
0x04 byte[count] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 word[count] source index of enex path (unused)
----
Structure:
0 word source index (break loop if value = -1)
2 word flags
4 word destination index
----
Enex Path: Normally 0 for outdoor saves, or 1 with the source index of the enex used to access the interior where the game was saved. The enex path may be longer on modified saves. Additional links are appended to the path.

ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair (strips passengers)
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

===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 0x317FC 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==
Available tools for editing of the save file content:
* GTA:SA Save Template for [http://en.wikipedia.org/wiki/010_Editor 010 Editor], by [[User:Seemann|Seemann]]: http://sannybuilder.com/dev/SaveTool.rar
Allows editing of any save data directly in the hex editor. Also contains the script to recalculate the checksum.
* GTA SA Savegame Editor v2.8 by Paul Breeuwsma: http://www.paulinternet.nl/#sa
* GTA:SA Save Game Editor v1.0 by Ryosuke: http://gtasamod.web.fc2.com/tool/sase/index.html
[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-05-27T18:09:41Z

OrionSR: /* Block 12: Car Generators */ found some details in memory dumps from PS2

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0x10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Players
0x04 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x00 dword Number of Objects
0x04 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] (Align)

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0C byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E byte[2] (Align?)
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x00 dword Number of Block4Struct structures
0x04 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x05 byte Boolean: Lose stuff after busted (opcode 08DE)
0x06 byte unknown Wasted_Busted Flag
0x07 dword unknown Wasted_Busted time
0x0B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x00 byte[12] (unknown)
0x0C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 ---- unknown
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word unknown (handle?)
0x1C byte type
0x1D byte unknown (flags?)
0x1E byte (Align?)

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
* When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x00 word Wasted structures number
0x02 Restart[] Wasted structures
0x00 word Busted structures number
0x02 Restart[] Busted structures
0x00 byte (Unknown)
0x01 byte[12] (Unknown)
0x0D byte (Unknown)
0x0E byte (Unknown)
0x0F byte[12] (Unknown)
0x1B dword (Unknown)
0x1F dword (Unknown)
0x23 byte[12] (Unknown)
0x2F dword (Unknown)
0x33 dword (Unknown)

Restart structure:
0x00 float[3] coords
0x0C float heading
0x10 dword town (island)
0x14 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x00 dword color
0x04 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x08 float[3] position X,Y,Z
0x14 word index?
0x16 byte[2] (Align)
0x18 float sphere radius
0x1C word icon size
0x1E byte[2] (Align)
0x20 dword (unknown)
0x24 dword Icon ID
0x25 byte[2] unknown flags
0x27 byte (Align)
0x28 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00A0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0C dword weaponID C
0x10 (end)

Notes:
* Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte unknown counter (0..3)
0x05 byte unknown counter (0..20); when it's non-zero, the game doesn't check the timer (0x16)
0x06 CarGen[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

CarGen structure:
0x00 word index (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word cars to generate
0x1E byte IPL stream of binary generators (non-zero records are not saved)
0x1F byte unknown flag (usually 01, 00 are not saved)
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle (index)
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0x0000 float[82] float stats (numbered 0..81 in scm)
0x0148 dword[223] int stats (numbered 120..342 in scm)
0x04C4 dword[32]
0x0544 char[8] last mission passed (gxt key)
0x054C byte[56]
0x0584 dword[100]
0x0714 byte[128]
0x0794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x00 dword police trigger last activation time
0x04 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x08 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x0C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x10 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x14 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x18 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x1C byte police trigger type; see details below
0x1D byte[3] (Align)
0x20 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused) (ignore?)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0x00 dword total number of the tags
0x04 byte[] tags paint status (0-255)

====Block 21: IPL====

0x0000 dword constant 256
0x0004 byte[255] Flags to enable binary IPLs (see notes below)
0x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-05-25T20:29:19Z

OrionSR: /* Block 12: Car Generators */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E (align) ?
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 ---- unknown
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word unknown (handle?)
0x1C byte type
0x1D byte unknown (flags?)
0x1E (Allign) ?

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 byte[4] unknown (align?)
0x06 cargenstruct[count] see details below
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

Car generator structure:
0x00 word handle (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word cars to generate
0x1E byte[2] unknown control (flags?)
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword constant 256
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-05-25T20:21:47Z

OrionSR: /* Block 12: Car Generators */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E (align) ?
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 ---- unknown
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word unknown (handle?)
0x1C byte type
0x1D byte unknown (flags?)
0x1E (Allign) ?

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 (align) ?
0x06 car generators
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

Car generator structure:
0x00 word handle (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word cars to generate
0x1E byte[2] unknown control (flags?)
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword constant 256
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-05-25T20:21:25Z

OrionSR: /* Block 12: Car Generators */ forgot to preview

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E (align) ?
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 ---- unknown
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word unknown (handle?)
0x1C byte type
0x1D byte unknown (flags?)
0x1E (Allign) ?

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 (align) ?
0x06 car generators
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

Car generator structure:
0x00 word handle (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word cars to generate
0x1E byte[2] unknown control (flags?)
0x20 byte[2] unknown (align?)

0x22 end

Numplate structure:
0x00 dword car generator handle
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword constant 256
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-05-25T20:19:53Z

OrionSR: /* Block 12: Car Generators */ filling in missing details

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums] or use [http://www.gtaforums.com/index.php?act=ST&f=223&t=322330 Save Game Path Editor]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0C float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2C float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3C float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4C word (Unknown) Possibly Original Type
0x4E (align) ?
0x50 end

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)

====Block 5: Disabled Pathnode Cubes====
0x00 dword count
0x04 Entry[count] entries --0x1C size

Entry structure:
0x00 float[6] x1,x2,y1,y2,z1,z2
0x18 byte[4] bools that somehow indicate which pathtypes are enabled

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups --Size 0x20
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0x00 float current asset value
0x04 ---- unknown
0x08 dword ammo (or max asset value)
0x0C dword unknown (timer?)
0x10 word[3] x,y,z, all multiplied by 8
0x16 word asset rate
0x18 word model
0x1A word unknown (handle?)
0x1C byte type
0x1D byte unknown (flags?)
0x1E (Allign) ?

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0x00 dword count
0x04 (align) ?
0x06 car generators
---- numberplates:
0x00 dword num entries used
0x04 Numplate[15] number plates
0xf4 end

Car generator structure:
0x00 word handle (0..499)
0x02 word model
0x04 byte[2] colors
0x06 word[3] x,y,z, all multiplied by 8
0x0C byte heading/360*256
0x0D byte alarm chance
0x0E byte locked chance
0x0F byte flags: bit 2=force spawn, bit 8=player owned
0x10 word unknown setting (IPL field 11, scm field 7)
0x12 word monetary value (unused?)
0x14 bytes[2] unknown (align?)
0x16 dword timer
0x1A word unknown activity
0x1C word cars to generate
0x1E byte[2] unknown control (flags?)
0x20 byte[2] unknown (align?)
0x22 end

Numplate structure:
0x00 dword car generator handle
0x04 char[8] numberplate string
0x0C byte[4] unknown (align?)
0x10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword constant 256
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-04-26T07:25:44Z

OrionSR: Added Enex Flag information - still a few unknowns

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword constant 256
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
ENEX Flags
BIT HEX DEC NAME DESCRIPTION
00 0001 1 unknown interior Only used for interior markers
01 0002 2 unknown pairing Used mostly for interior markers; also Big Ear & LS Skyscraper
02 0004 4 create linked pair Pair with unflagged mate during new game start
03 0008 8 reward interior Sets flag 0010 on pair mate when used
04 0010 16 used reward entrance Set by accessing reward interior
05 0020 32 cars and aircraft Enable for cars and aircraft
06 0040 64 bikes and motorcycles Enable for bikes and motorcycles
07 0080 128 disable on foot No foot traffic (use for cars and/or bikes only)

08 0100 256 accept NPC group Group members accepted at destination of pair
09 0200 512 food date flag Set and cleared by food date (cut-scene related)
10 0400 1024 unknown burglary Set on Bayside and Temporary Burglary doors
11 0800 2048 disable exit Player can enter but cannot exit a two-way pair
12 1000 4096 burglary access Enabled and disabled during Burglary
13 2000 8192 entered without exit Set by Entrance, Cleared by Exit; Applies to one side of a two-way pair
14 4000 16384 enable access Enabled by default; often cleared by scripts
15 8000 32768 delete enex Enex is deleted when used

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-04-11T01:55:29Z

OrionSR: /* Block 0: Miscellaneous */ updated with PS2 IDs

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
#* 0xF6 0x8D 0x14 0xFD -- PS2 Version 2 (Greatest Hits)
#* 0x4C 0xDC 0x1D 0x64 -- PS2 Version 1 (Original Edition)

# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword unknown (size of data +1?)
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-04-11T01:15:29Z

OrionSR: /* Block 21: IPL */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword unknown (size of data +1?)
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5
Usage: PCv1 can control the PCv2 carter objects by calling vegasn_stream2

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2008-04-11T01:08:46Z

OrionSR: /* Block 21: IPL */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0906 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 float Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 dword (Unknown)
0x000B dword (Unknown)
0x000F dword (Unknown)
0x0013 dword[4] (Unknown)
0x0023 dword (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte (Unknown)
0x001 byte[12] (Unknown)
0x00D byte (Unknown)
0x00E byte (Unknown)
0x00F byte[12] (Unknown)
0x01B dword (Unknown)
0x01F dword (Unknown)
0x023 byte[12] (Unknown)
0x02F dword (Unknown)
0x033 dword (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes [[0186]], [[0187]], etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[100] map fog array; each byte denotes state of the certain map sector (visited/not visited)
0x0064 dword number of opened map sectors

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 28h)
0x04 dword money
0x08 word (unknown)
0x0A byte is wasted_or_busted flag
0x0B byte (Align)
0x0C float (unknown)
0x10 dword amount of money shown on screen
0x14 byte (unknown)
0x15 byte[3] (Align)
0x18 dword (unused) hidden packages left
0x1C dword (unused) total hidden packages
0x20 byte infinite run (opcode [[0330]])
0x21 byte fast reload (opcode [[0331]])
0x22 byte fireproof ([[055D]])
0x23 byte max health
0x24 byte max armor (opcode [[055F]])
0x25 byte free busted once
0x26 byte free wasted once (opcode [[0414]])
0x27 byte enable driveby (opcode [[0501]])
0x28 byte (unknown)
0x29 byte (Align)
0x2A word (unknown)
0x2C end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
OFFSET TYPE DESCRIPTION
0x0000 byte[26316] (unknown)
0x66CC end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

x0000 dword unknown (size of data +1?)
x0004 byte[255] Flags to enable binary IPLs (see notes below)
x0103 end

Notes: The order of the flags corresponds to the order the IPLs appear in gta3.img. These flags only affect non-stream IPLs; stream IPLs are always enabled regardless of flag value. (*plus something on the opcodes used to enable/disable the flags*)

IPL Version Map:
Hex Dec PCv1 PCv2v3 PS2v1v2
05 5 barriers1 countryn_stream0 levelmap_stream1
06 6 barriers2 countryn_stream1 countryn_stream0
2D 45 countryw_stream5 crack sfe_stream2
31 49 truthsfarm sfse_stream3 sfs_stream0
3E 62 crack truthsfarm crack
3F 63 sfse_stream0 barriers1 sfse_stream0
40 64 sfse_stream1 barriers2 sfse_stream1
52 82 vegasn_stream2 carter countryw_stream7
55 85 vegasn_stream5 lae2_stream2 truthsfarm
56 86 vegasn_stream6 lae2_stream3 barriers1
57 87 vegasn_stream7 lae2_stream4 barriers2
70 112 vegasw_stream6 lawn_stream3 carter
7F 127 carter countrye_stream5 lae_stream5

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
OFFSET TYPE DESCRIPTION
0x00 dword size of block (always 58h)
0x04 byte enable gang wars (opcode [[0879]])
0x05 byte[3] (Align)
0x08 dword current gang war stage
0: no war
1: war provoked
2: first wave
3: first wave passed
4: second wave
5: second wave passed
6: third wave
0x0C dword time when last stage started
0x10 dword index of warzone in [[#Block_10:_Zones|ZonePop array]]
0x14 dword index of warzone in [[#Block_10:_Zones|ZoneInfo array]]
0x18 float[3] unknown XYZ
0x24 dword (unknown)
0x28 dword (unknown)
0x2C dword (unknown)
0x30 dword unknown time
0x34 dword hood under attack stage (?)
0x38 dword next attack time (?)
0x3C float[3] unknown XYZ
0x48 dword hood attack notify time (?)
0x4C dword hood attack marker handle (?)
0x50 byte (unknown)
0x51 byte[3] (Align)
0x54 float territories under control ([[08E2]])
0x58 float same as above (0x54)
0x5C end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Radio Data====
This block contains data relating to various radio stations. The bulk of the block is an array of data structures for each station. Not much is known about these structures currently but part of the data seems to be a record of which tracks have played recently. Following this array of structures there is a collection of byte flags which are related to high-number player Stats. These Stats are used to trigger different episodes and radio clips throughout the game. Note that the "set by" comments refer to missions in the original, unmodified game and they can obviously be set at different times instead.

0x0000 StationInfo[14] State info for radio stations; each is 0x110 in size -- see details below
0x0EE0 byte Cities Unlocked (stat 181)
0x0EE1 byte (stat 327; set by "Learning to Fly")
0x0EE2 byte (stat 328; set by "The Meat Business")
0x0EE3 byte (stat 329; set by "St. Mark's Bistro")
0x0EE4 byte I Say / You Say Ep#2 (stat 318; set by "Local Liquor Store")
0x0EE5 byte (stat 320; set by "Monster")
0x0EE6 byte (stat 330; set by "Interdiction")
0x0EE7 byte (stat 331; set by "Learning to Fly")
0x0EE8 byte (stat 332; set by "Black Project")
0x0EE9 byte (stat 333; set by "Green Goo")
0x0EEA byte (stat 311; set by "Mike Toreno")
0x0EEB byte (stat 323; set by "Green Sabre")
0x0EEC byte News Ep#9 (stat 308; set by "Vertical Bird")
0x0EED byte (stat 310; set by "OG Loc")
0x0EEE byte (stat 335; set by "Riot")
0x0EEF byte (stat 336; set by "555 We Tip")
0x0EF0 byte (stat 337; set by "House Party")
0x0EF1 byte (stat 302; set by "Drive-Thru")
0x0EF2 byte (stat 338; set by "Are you going to San Fierro?")
0x0EF3 byte (stat 339; set by "High Noon")
0x0EF4 byte (stat 340; set by "The Green Sabre")
0x0EF5 byte (stat 341; set by "Small Town Bank")
0x0EF6 byte (stat 342; set by "Farewell My Love")
0x0EF7 byte month day when the stats above were updated
0x0EF8 byte hour when the stats above were updated
0x0EF9 byte hours to the next stats update (commonly 24 or 168)
0x0EFA byte updating flag (1,2,3)
0x0EFB byte last updated stat (in accordance with the given order)
0x0EFC (end)

StationInfo Structure:
0x000 byte[20] Possibly a stack of indices of recently-played tracks
0x014 dword[8] (Unknown)
0x034 dword[40] (Unknown)
0x0D4 dword[15] (Unknown)
0x110 (end)

Order of Stations for the StationInfo Structure Array
IDX Stream Description
0 AA Emergency Band
1 CH Playback FM
2 CO KROSE
3 CR K-DST
4 DS Bounce
5 HC SFUR
6 MH Radio Los Santos
7 MR Radio X
8 NJ CSR
9 RE K-JAH West
10 RG Master Sounds
11 TK WCTR
12 -- User Track Player
13 ?? (Unknown)

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-22T06:57:38Z

OrionSR: /* Block 15: Player data */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0004 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 dword Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 byte[32] (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte[55] (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes 0186, 0187, etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[104] (Unknown)

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
00 dword size of block (always 28h)
04 dword money
08 word (unknown)
0A byte is wasted_or_busted flag
0C dword (unknown)
10 dword amount of money shown on screen
...
20 byte infinite run (opcode [[0330]])
21 byte fast reload (opcode [[0331]])
22 byte fireproof ([[055D]])
23 byte unknown(health)
24 byte max armor (opcode [[055F]])
25 byte (unknown)
26 byte free treatment once (opcode [[0414]])
27 byte enable driveby (opcode [[0501]])
...
2c end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
66cc end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

00 dword
04 byte[255] (mostly unknown)
05 byte BARRIERS1 v1 Barriers to SF
06 byte BARRIERS2 v1 Barriers to LV
2D byte CRACK v2 Pre-Yay Ka-Boom Boom Factory (45)
31 byte TRUTHSFARM v1 Crops at Truth's Farm (49)
3E byte CRACK v1 Pre-Yay Ka-Boom Boom Factory (62)
3E byte TRUTHSFARM v2 Crops at Truth's Farm (62)
3F byte BARRIERS1 v2 Barriers to SF (63)
40 byte BARRIERS2 v2 Barriers to LV (64)
52 byte CARTER v2 1st Floor of Smoke's Palace (82)
7F byte CARTER v1 1st Floor of Smoke's Palace (127)
103 end

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
0 dword size of block (always 58h)
4 byte enable gang wars (opcode [[0879]])
5c end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Missions data====
0x000 Structure[14] -- see details below
0xEE0 byte availables cities number (stat 181)
0xEE1 byte least favorite radio (stat 327)
0xEE2 byte current weapon skill (stat 328)
0xEE3 byte weapon skill levels (stat 329)
0xEE4 byte "Local Liquor Store" mission accomplished (stat 318)
0xEE5 byte playing time (stat 320)
0xEE6 byte pilot ranking (stat 330)
0xEE7 byte strongest gang (stat 331)
0xEE8 byte 2nd strongest gang (stat 332)
0xEE9 byte 3rd strongest gang (stat 333)
0xEEA byte "Mike Toreno" mission accomplished (stat 311)
0xEEB byte least favorite gang (stat 323)
0xEEC byte "A Home In The Hills" mission accomplished (stat 308)
0xEED byte "Robbing Uncle Sam" mission accomplished (stat 310)
0xEEE byte (stat 335)
0xEEF byte gang strength (stat 336)
0xEF0 byte territory under control (stat 337)
0xEF1 byte "Drive-thru" mission accomplished (stat 302)
0xEF2 byte "Are you going to San Fierro?" mission accomplished (stat 338)
0xEF3 byte "High Noon" mission accomplished (stat 339)
0xEF4 byte "The Green Sabre" mission accomplished (stat 340)
0xEF5 byte (stat 341)
0xEF6 byte (stat 342)
0xEF7 byte month day when the stats above were updated
0xEF8 byte hour when the stats above were updated
0xEF9 byte hours to the next stats update (commonly 24 or 168)
0xEFA byte updating flag (1,2,3)
0xEFB byte last updated stat (in accordance with the given order)
0xEFC end

Structure:
0x000 byte[20]
0x014 dword[8]
0x034 dword[40]
0x0D4 dword[15]
0x110 end

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-22T06:55:01Z

OrionSR: /* Block 15: Player data */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte Boolean: time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte Boolean: has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode [[09AD]])
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 float (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte Boolean: riot mode flag (opcode [[06C8]])
0x00E1 byte (unknown)
0x00E4 dword max wanted level (opcode [[01F0]])
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode [[040C]])
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode [[0572]] flag)
0x0136 byte Boolean: Prostitutes pay you (opcode [[0A3D]] flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0004 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 dword Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 byte[32] (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte[55] (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes 0186, 0187, etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[104] (Unknown)

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
00 dword size of block (always 28h)
04 dword money
08 word (unknown)
0A byte is wasted_or_busted flag
0C dword (unknown)
10 dword amount of money shown on screen
...
20 byte infinite run (opcode [[0330]])
21 byte fast reload (opcode [[0331]])
22 byte fireproof ([[055D]])
23 byte unknown(health)
24 byte max armor (opcode [[055F]])
25 byte unknown
26 byte free treatment once (opcode [[0414]])
27 byte enable driveby (opcode [[0501]])
...
2c end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
66cc end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

00 dword
04 byte[255] (mostly unknown)
05 byte BARRIERS1 v1 Barriers to SF
06 byte BARRIERS2 v1 Barriers to LV
2D byte CRACK v2 Pre-Yay Ka-Boom Boom Factory (45)
31 byte TRUTHSFARM v1 Crops at Truth's Farm (49)
3E byte CRACK v1 Pre-Yay Ka-Boom Boom Factory (62)
3E byte TRUTHSFARM v2 Crops at Truth's Farm (62)
3F byte BARRIERS1 v2 Barriers to SF (63)
40 byte BARRIERS2 v2 Barriers to LV (64)
52 byte CARTER v2 1st Floor of Smoke's Palace (82)
7F byte CARTER v1 1st Floor of Smoke's Palace (127)
103 end

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
0 dword size of block (always 58h)
4 byte enable gang wars (opcode [[0879]])
5c end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Missions data====
0x000 Structure[14] -- see details below
0xEE0 byte availables cities number (stat 181)
0xEE1 byte least favorite radio (stat 327)
0xEE2 byte current weapon skill (stat 328)
0xEE3 byte weapon skill levels (stat 329)
0xEE4 byte "Local Liquor Store" mission accomplished (stat 318)
0xEE5 byte playing time (stat 320)
0xEE6 byte pilot ranking (stat 330)
0xEE7 byte strongest gang (stat 331)
0xEE8 byte 2nd strongest gang (stat 332)
0xEE9 byte 3rd strongest gang (stat 333)
0xEEA byte "Mike Toreno" mission accomplished (stat 311)
0xEEB byte least favorite gang (stat 323)
0xEEC byte "A Home In The Hills" mission accomplished (stat 308)
0xEED byte "Robbing Uncle Sam" mission accomplished (stat 310)
0xEEE byte (stat 335)
0xEEF byte gang strength (stat 336)
0xEF0 byte territory under control (stat 337)
0xEF1 byte "Drive-thru" mission accomplished (stat 302)
0xEF2 byte "Are you going to San Fierro?" mission accomplished (stat 338)
0xEF3 byte "High Noon" mission accomplished (stat 339)
0xEF4 byte "The Green Sabre" mission accomplished (stat 340)
0xEF5 byte (stat 341)
0xEF6 byte (stat 342)
0xEF7 byte month day when the stats above were updated
0xEF8 byte hour when the stats above were updated
0xEF9 byte hours to the next stats update (commonly 24 or 168)
0xEFA byte updating flag (1,2,3)
0xEFB byte last updated stat (in accordance with the given order)
0xEFC end

Structure:
0x000 byte[20]
0x014 dword[8]
0x034 dword[40]
0x0D4 dword[15]
0x110 end

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-21T23:54:33Z

OrionSR: /* Block 3: Garages */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown) (FPS?)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode 09AD)
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 dword (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte riot mode flag (opcode 06C8)
0x00E1 byte (unknown)
0x00E4 dword max wanted level
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode 040C)
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode 0572 flag)
0x0136 byte Boolean: Prostitutes pay you (opcode 0A3D flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0004 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 dword Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages disabled (opcode [[0A14]])
0x0007 byte[32] (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte[55] (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes 0186, 0187, etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[104] (Unknown)

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
00 dword size of block (always 28h)
04 dword money
08 word (unknown)
0A byte is wasted_or_busted flag
0C dword (unknown)
10 dword amount of money shown on screen
...
20 byte infinite run (opcode [[0330]])
21 byte fast reload (opcode [[0331]])
22 byte fireproof ([[055D]])
23 byte unknown(health)
24 byte max armor (opcode [[055F]])
...
2c end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
66cc end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

00 dword
04 byte[255] (mostly unknown)
05 byte BARRIERS1 v1 Barriers to SF
06 byte BARRIERS2 v1 Barriers to LV
2D byte CRACK v2 Pre-Yay Ka-Boom Boom Factory (45)
31 byte TRUTHSFARM v1 Crops at Truth's Farm (49)
3E byte CRACK v1 Pre-Yay Ka-Boom Boom Factory (62)
3E byte TRUTHSFARM v2 Crops at Truth's Farm (62)
3F byte BARRIERS1 v2 Barriers to SF (63)
40 byte BARRIERS2 v2 Barriers to LV (64)
52 byte CARTER v2 1st Floor of Smoke's Palace (82)
7F byte CARTER v1 1st Floor of Smoke's Palace (127)
103 end

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
0 dword size of block (always 58h)
4 byte enable gang wars (opcode [[0879]])
5c end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Missions data====
0x000 Structure[14] -- see details below
0xEE0 byte availables cities number (stat 181)
0xEE1 byte least favorite radio (stat 327)
0xEE2 byte current weapon skill (stat 328)
0xEE3 byte weapon skill levels (stat 329)
0xEE4 byte "Local Liquor Store" mission accomplished (stat 318)
0xEE5 byte playing time (stat 320)
0xEE6 byte pilot ranking (stat 330)
0xEE7 byte strongest gang (stat 331)
0xEE8 byte 2nd strongest gang (stat 332)
0xEE9 byte 3rd strongest gang (stat 333)
0xEEA byte "Mike Toreno" mission accomplished (stat 311)
0xEEB byte least favorite gang (stat 323)
0xEEC byte "A Home In The Hills" mission accomplished (stat 308)
0xEED byte "Robbing Uncle Sam" mission accomplished (stat 310)
0xEEE byte (stat 335)
0xEEF byte gang strength (stat 336)
0xEF0 byte territory under control (stat 337)
0xEF1 byte "Drive-thru" mission accomplished (stat 302)
0xEF2 byte "Are you going to San Fierro?" mission accomplished (stat 338)
0xEF3 byte "High Noon" mission accomplished (stat 339)
0xEF4 byte "The Green Sabre" mission accomplished (stat 340)
0xEF5 byte (stat 341)
0xEF6 byte (stat 342)
0xEF7 byte month day when the stats above were updated
0xEF8 byte hour when the stats above were updated
0xEF9 byte hours to the next stats update (commonly 24 or 168)
0xEFA byte updating flag (1,2,3)
0xEFB byte last updated stat (in accordance with the given order)
0xEFC end

Structure:
0x000 byte[20]
0x014 dword[8]
0x034 dword[40]
0x0D4 dword[15]
0x110 end

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-20T11:34:41Z

OrionSR: /* Block 17: Police trigger zones */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown) (FPS?)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode 09AD)
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 dword (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte riot mode flag (opcode 06C8)
0x00E1 byte (unknown)
0x00E4 dword max wanted level
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode 040C)
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word [http://msdn2.microsoft.com/en-us/library/ms724950.aspx SYSTEMTIME] wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode 0572 flag)
0x0136 byte Boolean: Prostitutes pay you (opcode 0A3D flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0004 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 dword Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[2] (Align)
0x0194 dword unknown (ENEX related)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages enabled (opcode [[0A14]])
0x0007 byte[32] (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte[55] (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes 0186, 0187, etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[104] (Unknown)

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
00 dword size of block (always 28h)
04 dword money
08 word (unknown)
0A byte is wasted_or_busted flag
0C dword (unknown)
10 dword amount of money shown on screen
...
20 byte infinite run (opcode [[0330]])
21 byte fast reload (opcode [[0331]])
22 byte fireproof ([[055D]])
23 byte unknown(health)
24 byte max armor (opcode [[055F]])
...
2c end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword police trigger last activation time
0x0004 word[2] police trigger zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] police trigger zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle A starting point (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle A initial direction (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle B starting point (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle B initial direction (x,y) -- all multiplied by 8
0x001C byte police trigger type; see details below
0x001D byte[3] (align)
0x0020 end

Police Trigger Types
* 1 - On Foot with 1 star spawns 2 cop cars moving slowly
* 2 - In Vehicle with 2 stars spawns 1 cop car moving quickly
* 3 - In Vehicle with 2 stars spawns 1 cop car at medium speed
* 4 - On Foot with 1 star spawns 1 cop pedestrian
* 5 - On Foot with 1 star spawns 2 cop pedestrians
* 6 - In Vehicle with 2 stars spawns 2 cop cars moving quickly before hitting breaks
* 7 - In Vehicle with 2 stars spawns 2 cop cars moving quickly
* 8 - On Foot with 1 star spawns 2 cop cars at medium speed

Notes:
# Police Triggers are a special zone consisting of a rectangle defined by 2 ends of the rectangle diagonal, and two rays defined by a starting point and point along the ray indicating the initial direction of travel.
# When the player is in the police trigger rectangle and meets the requirements of the police trigger type, then a cop will spawn at the endpoint of ray A headed in the direction of the 2nd defined point.
# If the police trigger type includes 2 police, then a cop will also spawn along ray B.
# The police are not bound to continue in the specified direction after their initial spawn.
# In order to trigger In Vehicle trigger types the vehicle must be moving.
# Police trigger zones are activated only once per 40 seconds (the first field is used to control this).
# Police trigger zones can be created using opcode [[04F8]]
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
66cc end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

00 dword
04 byte[255] (mostly unknown)
05 byte BARRIERS1 v1 Barriers to SF
06 byte BARRIERS2 v1 Barriers to LV
2D byte CRACK v2 Pre-Yay Ka-Boom Boom Factory (45)
31 byte TRUTHSFARM v1 Crops at Truth's Farm (49)
3E byte CRACK v1 Pre-Yay Ka-Boom Boom Factory (62)
3E byte TRUTHSFARM v2 Crops at Truth's Farm (62)
3F byte BARRIERS1 v2 Barriers to SF (63)
40 byte BARRIERS2 v2 Barriers to LV (64)
52 byte CARTER v2 1st Floor of Smoke's Palace (82)
7F byte CARTER v1 1st Floor of Smoke's Palace (127)
103 end

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
0 dword size of block (always 58h)
4 byte enable gang wars (opcode [[0879]])
5c end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Missions data====
0x000 Structure[14] -- see details below
0xEE0 byte availables cities number (stat 181)
0xEE1 byte least favorite radio (stat 327)
0xEE2 byte current weapon skill (stat 328)
0xEE3 byte weapon skill levels (stat 329)
0xEE4 byte "Local Liquor Store" mission accomplished (stat 318)
0xEE5 byte playing time (stat 320)
0xEE6 byte pilot ranking (stat 330)
0xEE7 byte strongest gang (stat 331)
0xEE8 byte 2nd strongest gang (stat 332)
0xEE9 byte 3rd strongest gang (stat 333)
0xEEA byte "Mike Toreno" mission accomplished (stat 311)
0xEEB byte least favorite gang (stat 323)
0xEEC byte "A Home In The Hills" mission accomplished (stat 308)
0xEED byte "Robbing Uncle Sam" mission accomplished (stat 310)
0xEEE byte (stat 335)
0xEEF byte gang strength (stat 336)
0xEF0 byte territory under control (stat 337)
0xEF1 byte "Drive-thru" mission accomplished (stat 302)
0xEF2 byte "Are you going to San Fierro?" mission accomplished (stat 338)
0xEF3 byte "High Noon" mission accomplished (stat 339)
0xEF4 byte "The Green Sabre" mission accomplished (stat 340)
0xEF5 byte (stat 341)
0xEF6 byte (stat 342)
0xEF7 byte month day when the stats above were updated
0xEF8 byte hour when the stats above were updated
0xEF9 byte hours to the next stats update (commonly 24 or 168)
0xEFA byte updating flag (1,2,3)
0xEFB byte last updated stat (in accordance with the given order)
0xEFC end

Structure:
0x000 byte[20]
0x014 dword[8]
0x034 dword[40]
0x0D4 dword[15]
0x110 end

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-15T03:42:16Z

OrionSR: /* Block 10: Zones */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown) (FPS?)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode 09AD)
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 dword (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte riot mode flag (opcode 06C8)
0x00E1 byte (unknown)
0x00E4 dword max wanted level
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode 040C)
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word SYSTEMTIME wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode 0572 flag)
0x0136 byte Boolean: Prostitutes pay you (opcode 0A3D flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0004 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 dword Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[6] (unknown)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages enabled (opcode [[0A14]])
0x0007 byte[32] (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte[55] (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes 0186, 0187, etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[104] (Unknown)

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])* see notes below
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

Notes: the ZonePop byte at offset 0x0F appears to use the upper 3 bits for flags. Bit 0x20 will be set if gangs are present in the zone and cleared if no gangs are present. Bit 0x40 is unobserved, and cleared if set manually. Bit 0x80 is set with opcode 09B7 and disables the footcops in that zone.

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
00 dword size of block (always 28h)
04 dword money
08 word (unknown)
0A byte is wasted_or_busted flag
0C dword (unknown)
10 dword amount of money shown on screen
...
20 byte infinite run (opcode [[0330]])
21 byte fast reload (opcode [[0331]])
22 byte fireproof ([[055D]])
23 byte unknown(health)
24 byte max armor (opcode [[055F]])
...
2c end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword trigger last activation time
0x0004 word[2] player vehicle zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] player vehicle zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle 1 zone point 1 (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle 1 zone point 2 (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle 2 zone point 1 (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle 2 zone point 2 (x,y) -- all multiplied by 8
0x001C byte type -- unknown meaning, various requirements for the trigger to be activated
0x001D byte[3] (align)
0x0020 end

Notes:
# Police trigger zone is a special zone consisting of 3 rectangles. When player drive into the first rectangle (defined by 2 ends of the rectange diagonal set by the first 2 XY pairs) having a certain wanted level (depends on the 'type' field), two police cars appear there: one in the second rectangle, the second car in the third rectangle. These rectangles are defined in the same manner as the player's one.
# Trigger zone can be created using opcode [[04F8]]
# Trigger zone is activated only once per 40 seconds (the first field is used to control this).
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
66cc end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

00 dword
04 byte[255] (mostly unknown)
05 byte BARRIERS1 v1 Barriers to SF
06 byte BARRIERS2 v1 Barriers to LV
2D byte CRACK v2 Pre-Yay Ka-Boom Boom Factory (45)
31 byte TRUTHSFARM v1 Crops at Truth's Farm (49)
3E byte CRACK v1 Pre-Yay Ka-Boom Boom Factory (62)
3E byte TRUTHSFARM v2 Crops at Truth's Farm (62)
3F byte BARRIERS1 v2 Barriers to SF (63)
40 byte BARRIERS2 v2 Barriers to LV (64)
52 byte CARTER v2 1st Floor of Smoke's Palace (82)
7F byte CARTER v1 1st Floor of Smoke's Palace (127)
103 end

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
0 dword size of block (always 58h)
4 byte enable gang wars (opcode [[0879]])
5c end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Missions data====
0x000 Structure[14] -- see details below
0xEE0 byte availables cities number (stat 181)
0xEE1 byte least favorite radio (stat 327)
0xEE2 byte current weapon skill (stat 328)
0xEE3 byte weapon skill levels (stat 329)
0xEE4 byte "Local Liquor Store" mission accomplished (stat 318)
0xEE5 byte playing time (stat 320)
0xEE6 byte pilot ranking (stat 330)
0xEE7 byte strongest gang (stat 331)
0xEE8 byte 2nd strongest gang (stat 332)
0xEE9 byte 3rd strongest gang (stat 333)
0xEEA byte "Mike Toreno" mission accomplished (stat 311)
0xEEB byte least favorite gang (stat 323)
0xEEC byte "A Home In The Hills" mission accomplished (stat 308)
0xEED byte "Robbing Uncle Sam" mission accomplished (stat 310)
0xEEE byte (stat 335)
0xEEF byte gang strength (stat 336)
0xEF0 byte territory under control (stat 337)
0xEF1 byte "Drive-thru" mission accomplished (stat 302)
0xEF2 byte "Are you going to San Fierro?" mission accomplished (stat 338)
0xEF3 byte "High Noon" mission accomplished (stat 339)
0xEF4 byte "The Green Sabre" mission accomplished (stat 340)
0xEF5 byte (stat 341)
0xEF6 byte (stat 342)
0xEF7 byte month day when the stats above were updated
0xEF8 byte hour when the stats above were updated
0xEF9 byte hours to the next stats update (commonly 24 or 168)
0xEFA byte updating flag (1,2,3)
0xEFB byte last updated stat (in accordance with the given order)
0xEFC end

Structure:
0x000 byte[20]
0x014 dword[8]
0x034 dword[40]
0x0D4 dword[15]
0x110 end

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-15T03:15:44Z

OrionSR: /* Block 10: Zones */

==Introduction==
This article deals with the format of a saved game file for [[:Category:GTA SA|Grand Theft Auto: San Andreas (GTASA)]]. It is specifically geared towards the PC version(s) but much of it may be applicable to console versions too.

==Location and Format Overview==
By default, GTASA places its saved game files into the folder "GTA San Andreas 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. Some typical locations for a user with an account named "Fred" would be:
* C:\My Documents\GTA San Andreas User Files -- Windows 98 Example
* C:\Documents and Settings\Fred\My Documents\GTA San Andreas User Files -- Windows XP Example
* C:\Users\Fred\Documents\GTA San Andreas User Files -- Windows Vista Example
Obviously those locations can vary based upon different Windows configurations or installation options. Note also that the executable can be modified to use a different file location through the use of a hex editor and special registry key in a process outlined at [http://www.gtaforums.com/index.php?showtopic=194371 GTAForums]

The save files themselves are named in the format '''GTASAsfX.b''' where '''X''' represents the in-game slot number. So, the game saved in slot 1 will be stored in the save file '''GTASAsf1.b''' and the game saved in slot 5 will be stored in the save file '''GTASAsf5.b'''. There are 8 slots available in the game (1-8). GTASA save files are always 0x31800 bytes long (202,752 in decimal) and are not compressed or encoded in any way.

==Format Details==
A GTASA save file consists of 28 "blocks" of data followed by some duplicated data for padding and then ending with a checksum value. Each of these elements is described below.

===Data Blocks===
Each data block consists of the 5 characters '''BLOCK''' followed by a variable amount of data; in general, each block has its own unique internal format. The format descriptions in this article only deal with those internal block formats which follow the initial '''BLOCK''' identifier and all offsets start at the byte following the '''BLOCK''' identifier for the given block.

Note that many of the blocks contain data structures. These structures are aligned along 4-byte boundaries; thus if there's a field with size 1 or 2 bytes in the end of structure, there are also additional unused bytes present at the end of the structure which pad it to fill the remaining space. This type of gap can also occur in the middle of a structure. The convention used by this article is to mark such gaps as an array of bytes with the description '''(Align)''' .

====Block 0: Miscellaneous====
Game "meta-information" giving the overall state of things. This block has a constant length of 0x138 bytes
OFFSET TYPE DESCRIPTION
0x0000 dword version ID (checksum of a string describing the time of compilation. See note 1 below)
0x0004 char[100] save name (long names are truncated on the save/load screen. See note 2 below)
0x0068 byte current mission pack
0x0069 byte[3] (Align)
0x006C dword current town (island) (used when a replay playback is started/finished)
0x0070 float[3] camera coordinates (x,y,z)
0x007C dword length (ms) of in-game minute
0x0080 dword weather timer
0x0084 byte current in-game month
0x0085 byte current in-game month day
0x0086 byte game hour
0x0087 byte game minute
0x0088 byte weekday
0x0089 byte current in-game month (copy)
0x008A byte current in-game month day (copy)
0x008B byte game hour (copy)
0x008C byte game minute (copy)
0x008D byte time copy flag (See note 3 below)
0x008E word (unknown)
0x0090 byte has ever cheated flag
0x0091 byte[3] (Align)
0x0094 dword global timer
0x0098 float game speed
0x009C float (unknown) (FPS?)
0x00A0 float tick time (time of an iteration of the major game loop)
0x00A4 dword number of the frames processed from the beginning of the game
0x00A8 word (unknown)
0x00AA word (unknown)
0x00AC word weather ID
0x00B0 dword (unknown)
0x00B4 dword (unknown)
0x00B8 dword (unknown)
0x00BC dword vehicle camera view (opcode 09AD)
0x00C0 dword onfoot camera view
0x00C4 dword current interior
0x00C8 byte (unknown)
0x00CC dword original interior color (?)
0x00D0 byte interior color flag (?)
0x00D4 dword (unknown)
0x00D8 dword changed interior color (?)
0x00DC dword (unknown)
0x00E0 byte riot mode flag (opcode 06C8)
0x00E1 byte (unknown)
0x00E4 dword max wanted level
0x00E8 dword max chaos (See note 4 below)
0x00EC byte (unknown)
0x00ED byte is german lang (?) (opcode 040C)
0x00EE byte (unknown)
0x011C byte times left to display a cinematic camera help (see note 5 below)
0x011E word SYSTEMTIME wYear
0x0120 word SYSTEMTIME wMonth
0x0122 word SYSTEMTIME wDayOfWeek
0x0124 word SYSTEMTIME wDay
0x0126 word SYSTEMTIME wHour
0x0128 word SYSTEMTIME wMinute
0x012A word SYSTEMTIME wSecond
0x012C word SYSTEMTIME wMilliseconds
0x0130 dword Player target marker handle (handle of the red target icon in the map menu)
0x0134 byte Boolean: the vehicle stealing help was shown (See note 6 below)
0x0135 byte Boolean: All taxis have nitro (opcode 0572 flag)
0x0136 byte Boolean: Prostitutes pay you (opcode 0A3D flag)
0x0137 byte (Align)

Notes:
# Version 2.0 of GTASA will not load a save file if the Version ID String does not match its own Version ID String. Thus if a game was played on a version 1.x exe using the exact same set of mission scripts as a version 2.0 installation, the version 2.0 game will refuse to load the save unless this ID is changed. Version 1.x exes make no Version ID String check and will attempt to load any non-corrupted save. Some known Version ID String values (listed as consecutive bytes):
#* 0x75 0x81 0xDA 0x35 -- Version 1.00 Unmodified EXE
#* 0x83 0xE5 0xF3 0x65 -- Version 1.00 Modified EXE
#* 0x58 0xBE 0x6E 0x9A -- Version 1.01 Unmodified EXE
#* 0x5E 0x76 0x45 0x93 -- Version 1.01 Modified EXE
#* 0xF6 0x8D 0x14 0xFD -- Version 2.00 Unmodified EXE
# While the save name can be changed here to pretty much anything, that name will not persist the next time the game is saved, even if no missions were completed during the play session. This is because each time the game is saved this name string is reset based upon the [[GXT]] entry for the Last Mission Passed key stored in Block 15.
# Time copy flag shows whether the time data was saved using opcode [[0253]].
# Chaos is a value need to be gained to get one more star. MaxChaos is a limit for current wanted level.
# This is a number of how much times the cinematic camera help (about switching display modes) will be shown. Initially this value equals to 2. When it reaches zero, the help does not appear on cinematic camera enabling.
# This is a flag, which is set to 1 when player first time stealing a vehicle and get a help message about it, to prevent displaying this message again.

====Block 1: Script ====
Information pertaining to the [[:Category:Mission_Scripting|Mission Scripts]] in use when the game was saved. Includes all global variables and information about running threads including thread pointers and local variables. A minor size difference between the MAIN section of the version 1 and version 2 scripts is the primary cause of incompatibility between version 1 and version 2 saves because it forces the other threads to be at slightly different memory locations. One can adjust the thread pointers in this block and (if converting from 1 to 2) the Version ID String from block 0 to convert a save between the two versions; this applies to either completely unmodded or identically-modded installations of v1 and v2.

As the first section in this block can vary in size, offsets given are from the current section.

OFFSET TYPE DESCRIPTION
0x0000 dword Size of Global Variable space
0x0004 dword[] Global Variable Space -- every var is 4 bytes; the types can vary
...
0x0000 ExternalScriptTrigger[70] each is 0x14 bytes in size; see details below
0x0578 dword OnMissionFlag offset -- address of the global variable set by opcode 0180
0x057C dword time when last mission was passed (when either opcode 0318 or 0595 is executed)
0x0580 StaticReplacement[25] each is 0x10 bytes in size; see details below
0x0710 InvisibleObject[20] each is 8 bytes in size; see details below
0x07B0 dword[20] keeps model identifiers which are excluded from
the carparking generation (similar to opcode [[03C5]]). Unused.
0x0800 LodAssignment[10] each is 8 bytes in size; see details below
0x0850 ScriptAssignment[8] each is 0x14 bytes in size; see details below
0x08F0 byte Boolean: unknown flag (UNUSED)
0x08F1 byte Boolean: unknown flag (UNUSED)
0x08F2 dword scm size
0x08F6 dword max mission size
0x08FA dword missions number
0x08FE dword highest local variable ever in a mission
0x0902 dword Number of Running Threads (nThreads)
0x0004 Thread[nThreads] Thread structures -- each is 0x106 bytes in size; see details below

ExternalScriptTrigger
0x00 word Index in the script.img
0x02 byte Attach type (actor or object)
0x03 byte Type? -- only for ObjectTrigger
0x04 dword Status?
0x08 dword Radius -- vary only for ObjectTrigger (ActorTrigger uses a pre-defined radius of 5.0)
0x0C word modelID
0x0E word priority
0x10 dword (unknown)
0x14 end

Note:
* These triggers are created with opcodes [[0928]], [[0929]]

Thread Structure:
0x00 word Index/Handle
0x02 byte[224] Thread Memory Dump -- see details below
0xE2 byte[36] Relative Addresses -- see details below

Thread Memory Dump:
0x00 dword Next Pointer
0x04 dword Previous Pointer
0x08 char[8] Thread Name
0X10 dword Absolute Base Address
0x14 dword Absolute IP
0x18 dword[8] Absolute Return Stack
0x38 word Stack Pointer
0x3C dword[32] Local Variables
0xBC dword[2] Local Timers
0xC4 byte (Unknown)
0xC5 byte 'if' statement result
0xC6 byte (Unknown)
0xC7 byte Is External Script
0xC8 byte (Unknown)
0xC9 byte (Unknown)
0xCA byte[2] (Align)
0xCC dword Wakeup Time
0xD0 word 'if' parameter
0xD2 byte 'not' flag
0xD3 byte 'wb_check' flag
0xD4 byte[4] (Unknown)
0xD8 dword Skip Scene Pos (opcode [[0707]])
0xDC byte Is Mission
0xDD byte[3] (Align)
0xE0 end

Relative Addresses -- Necessary here because the absolute addresses used in-game depend on memory layout
0x00 dword Relative IP
0x04 dword[8] Relative Return Stack

StaticReplacement
0x00 dword type (always = 2)
0x04 dword handle of the static object (building)
0x08 dword new modelID
0x0C dword old modelID

Note: this structure related to opcode [[03B6]].

InvisibleObject
0x00 dword type
0x04 dword handle of the object

This structure contains handle and type of an object created as invisible one. There are 3 kinds of the types: 2 - static object; 3 - dynamic object; 4 - dummy. Via [[:Category:Mission_Scripting|mission scripting]] it's only possible to create a first kind of such object (static) - using opcode [[0363]], so normally the 'type' parameter is equal to 2.

LodAssignment
0x00 dword Handle of the object
0x04 dword Handle of the LOD object

This structure related to opcode [[0827]].

ScriptAssignment
0x00 dword modelID of the actor we assing the external script to
0x04 char[8] external script handle as created with opcode [[0884]]
0x0C dword unknown
0x10 dword unknown

This structure related to opcode [[08E8]].

====Block 2: Players & Objects ====
Information about players (commonly only one) and mission-script placed objects such as doors, etc.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Players
0x0004 Player[] Player structures -- each is 0x228 bytes in size; see details below
0x0000 dword Number of Objects
0x0004 Object[] Object structures -- each is 0x3C bytes in size; see details below

Player Structure:
0x0000 dword Handle of a player actor
0x0004 dword Model ID
0x0008 dword PedType

0x000C dword size of the following data (0x18C)
0x0010 float[3] X, Y, Z
0x001C float Health
0x0020 float Armor
0x0024 Weapon[13] Weapon Structure -- each is 0x1C in size; see details below
0x0190 byte Ped reference (normally 2)
0x0191 byte Current weapon slot
0x0192 byte[6] (unknown)
0x0198 byte melee style 1?
0x0199 byte melee style 2?
0x019A byte[2] (Align)

0x019C dword size of the following data (0x84)
0x01A0 dword chaos
0x01A4 byte wanted level
0x01A5 byte[3] (Align)
0x01A8 dword CRC32 of filename for Torso model
0x01AC dword CRC32 of filename for Head model
0x01B0 dword CRC32 of filename for (unknown)
0x01B4 dword CRC32 of filename for Legs model
0x01B8 dword CRC32 of filename for Feet model
0x01BC dword CRC32 of filename for Chain model
0x01C0 dword CRC32 of filename for Watch model
0x01C4 dword CRC32 of filename for Shades model
0x01C8 dword CRC32 of filename for Hat model
0x01CC dword CRC32 of filename for Special model
0x01D0 dword CRC32 of filename for Torso texture
0x01D4 dword CRC32 of filename for Head texture
0x01D8 dword CRC32 of filename for Legs texture
0x01DC dword CRC32 of filename for Feet texture
0x01E0 dword CRC32 of filename for Upper Left Arm Tattoo texture
0x01E4 dword CRC32 of filename for Lower Left Arm Tattoo texture
0x01E8 dword CRC32 of filename for Upper Right Arm Tattoo texture
0x01EC dword CRC32 of filename for Lower Right Arm Tattoo texture
0x01F0 dword CRC32 of filename for Back Tattoo texture
0x01F4 dword CRC32 of filename for Left Chest Tattoo texture
0x01F8 dword CRC32 of filename for Right Chest Tattoo texture
0x01FC dword CRC32 of filename for Stomach Tattoo texture
0x0200 dword CRC32 of filename for Lower Back Tattoo texture
0x0204 dword CRC32 of filename for Chain texture
0x0208 dword CRC32 of filename for Watch texture
0x020C dword CRC32 of filename for Shades texture
0x0210 dword CRC32 of filename for Hat texture
0x0214 dword CRC32 of filename for Special texture
0x0218 float Body Fat (used for current body type)
0x022C float Body Muscle (used for current body type)
0x0224 byte[4] Align

Weapon Structure:
0x00 dword Weapon Type
0x04 dword (unknown) possibly Weapon state
0x08 dword (unknown) possibly Ammo in clip
0x0C dword Weapon Ammo
0x10 dword (unknown) possibly Shots fired
0x14 byte[8] (unknown)

Object Structure:
0x00 dword Handle
0x04 dword Model ID
0x08 dword constant 48
0x0C float[3] X, Y, Z
0x18 byte[3] CXYZ.right.xyz
0x1B byte[3] CXYZ.top.xyz
0x1E byte[30] (unknown)

====Block 3: Garages====
Information defining all garages (including bomb shops, pay & sprays, etc.) and also describing the cars stored in safehouse garages. This block can vary in size although in the unmodified game it will always be 0x23C7 bytes because there are 50 garages defined. The 80 saved vehicles (4 each in 20 garages) is a fixed number and probably cannot be exceeded. Also, the arrangement of the Garage Car structures in the save is non-intuitive: they follow the pattern Garage 1/Car 1, Garage 2/Car 1, ... Garage 20/Car 1, Garage 1/Car 2, Garage 2/Car 2 ...

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Garages
0x0004 byte Free Bombs
0x0005 byte Free Resprays (opcode [[0335]])
0x0006 byte Boolean: Respray Garages enabled (opcode [[0A14]])
0x0007 byte[32] (Unknown)
0x0027 GrgCar[20][4] Garage Car structures -- each is 0x40 bytes in size; see details below
0x1427 Garage[] Garage structures -- each is 0x50 bytes in size; see details below

Garage Car Structure (GrgCar):
0x00 float[3] Coordinates (x,y,z)
0x0c byte[4] (Unknown)
0x10 byte Car Flags
0x11 byte (Unknown)
0x12 word Vehicle Model ID
0x14 word[15] Installed Vehicle Mods (see veh_mods.ide)
0x32 byte[4] Primary Color, Secondary Color, Tertiary Color, (Unknown) Quaternary Color?
0x36 byte Radio Station
0x37 byte[2] Vehicle Variation
0x39 byte Bomb Type
0x3A byte Paintjob
0x3B byte Nitrous Count
0x3C byte[3] Vector Rotation
0x3F byte (unknown) Align

Garage Structure:
0x00 byte Garage Type
0x01 byte[2] Door Flags
0x03 byte (Unknown) Align
0x04 float X Coordinate for Lower Left Front
0x08 float Y Coordinate for Lower Left Front
0x0c float Z Coordinate for Floor
0x10 float[4] Rotation (Quaternion Rx, Ry, Rz, Rw)
0x20 float Z Coordinate for Ceiling
0x24 float Width (dimension parallel to door in xy plane)
0x28 float Depth (dimension perpendicular to door in xy plane)
0x2c float Minimum X Coordinate
0x30 float Maximum X Coordinate
0x34 float Minimum Y Coordinate
0x38 float Maximum Y Coordinate
0x3c float Door is Open = 1
0x40 float (Unknown)door timer/timestamp?
0x44 char[8] Garage Name -- can be used by mission script to access garage
0x4c word (Unknown) Possibly Original Type

Door Flags (hex value of bit)
offset 0x01
0x01 door is open flag (0x3c changes door)
offset 0x02
0x01 used mod shop (?)
0x02 inactive door
0x04 used Pay'n'Spray (?)
0x08 small door (reflective?)
0x10 up and in door
0x20 camera follows player
0x40 door is closed flag (0x3c changes door)
0x80 girlfriend PnS

Car Flags (hex value of bit)
0x01 bulletproof
0x02 fireproof
0x04 explosion proof
0x08 damage proof
0x10 5th immunity
0x20 bass boost
0x40 hydraulics
0x80 nitrous flag

Bomb Types
1 5 sec detonator (garage type 2)
2 ignition bomb unarmed (garage type 3)
3 remote detonator (garage type 4)
5 ignition bomb armed (garage type 3)

====Block 4: Wasted/Busted====
Unknown data. Block can vary in size depending on number of entries; number of entries may be zero.

OFFSET TYPE DESCRIPTION
0x0000 dword Number of Block4Struct structures
0x0004 byte Boolean: Lose stuff after wasted (opcode 08DD)
0x0005 byte Boolean: Lose stuff after busted (opcode 08DE)
0x0006 byte unknown Wasted_Busted Flag
0x0007 dword unknown Wasted_Busted time
0x000B Block4Struct[] unknown structures (UNUSED?) -- see details below

Block4Struct structure:
0x0000 byte[12] (unknown)
0x000C byte[4] (unknown)
0x0010 end

====Block 5: Disabled Pathnode Cubes====
0 dword count
4 entries

Entry structure:
0 float[6] x1,x2,y1,y2,z1,z2
18 byte[4] bools that somehow indicate which pathtypes are enabled
1c end

* Note: these structures somehow related to opcodes [[0606]], [[0607]]

====Block 6: Pickups====

0x0000 Pickup[620] Pickups
0x4D80 word Number of pickups being picked up (up to 20)
0x4D82 byte Weapon pickup message counter (see note 1 below)
0x4D83 dword[20] Pickups being picked up (they don't exist, but could be checked by opcode [[0214]]
0x4DD3 end

Pickup structure:
0 float current asset value
8 dword ammo (or max asset value)
c dword unknown (timer?)
10 word[3] x,y,z, all multiplied by 8
16 word asset rate
18 word model
1a word unknown (handle?)
1c byte type
1d byte unknown (flags?)
20 end

Flags:
*0x01 used pickups?
*0x02 dropped jetpack?
*0x04 switched weapon?
*0x08 collected pickup?
*0x10 can buy property
*0x20 can't buy property

Notes:
# When you walk across over a weapon pickup having a weapon of same type, the game will propose you to replace this slot with new weapon by pressing Action key. Initially number of this message showing times equals to 10. Each time you see the message, this counter is decreased. This field stores how much times left to display the message.

====Block 7: (Unused)====
(Usually empty)

====Block 8: Restart Locations====

OFFSET TYPE DESCRIPTION
0x000 word Wasted structures number
0x002 Restart[] Wasted structures
0x000 word Busted structures number
0x002 Restart[] Busted structures
0x000 byte[55] (Unknown)

Restart structure:
0x000 float[3] coords
0x00C float heading
0x010 dword town (island)
0x014 end

====Block 9: Markers====
OFFSET TYPE DESCRIPTION
0x0000 Markers[175] Marker structures -- each is 0x28 bytes in size, see details below
0x1B58 end

Marker structure:
0x000 dword color
0x004 dword entity handle this marker is attached to (opcodes 0186, 0187, etc)
0x008 float[3] position X,Y,Z
0x014 word index?
0x016 byte[2] (Align)
0x018 float sphere radius
0x01C word icon size
0x01E byte[2] (Align)
0x020 dword (unknown)
0x024 dword Icon ID
0x025 byte[2] unknown flags
0x027 byte (Align)
0x028 end

====Block 10: Zones====
This block contains information about map zones in three arrays. The first array is for size and location information for the zones as initially defined in the data file [[Zone|info.zon]]. The second array contains entries for each of the uniquely-named zones defined in the first array and stores information about things like gang densities and [[popcycle.dat]] group info for each zone. Much of this info is set by specific opcodes such as [[076C]], [[076A]], [[0767]], and [[0874]].) The ID number for a given entry in the first array refers to an entry in the second array. The third array is another size/location array similar to the first but based on the data file [[Zone|map.zon]].

One interesting note about this block is that a small amount of corruption here causes the "Taxi Glitch" situation where the taxi mission always tells you there are no fares nearby no matter where you are. The problem is that the first entry of the first array (the '''SAN_AND''' zone describing the entire map) gets mangled and the taxi mission references that zone to pick a passenger. For more on this glitch and how to fix it, see the [http://www.gtaforums.com/index.php?showtopic=257759 GTAForums thread on it].

OFFSET TYPE DESCRIPTION
0x0000 dword current town (island)
0x0004 word Number of entries for first ZoneInfo Array
0x0006 word Number of entries for ZonePop Array
0x0008 word Number of entries for second ZoneInfo Array
0x000A ZoneInfo[] Array populated from file data/info.zon
...
0x0000 ZonePop[] Array of gang density and popcycle info
...
0x0000 ZoneInfo[] Array populated from file data/map.zon
...
0x0000 byte[104] (Unknown)

ZoneInfo Structure:
0x00 char[8] zone name
0x08 char[8] zone gxt key (for name displayed on-screen)
0x10 word[3] x1,y1,z1 (rounded to ints)
0x16 word[3] x2,y2,z2 (rounded to ints)
0x1C word id
0x1E byte type
0x1F byte island
0x20 (end)

ZonePop Structure:
0x00 byte Gang 0 Density (set by opcode [[076C]])
0x01 byte Gang 1 Density (set by opcode 076C)
0x02 byte Gang 2 Density (set by opcode 076C)
0x03 byte Gang 3 Density (set by opcode 076C)
0x04 byte Gang 4 Density (set by opcode 076C)
0x05 byte Gang 5 Density (set by opcode 076C)
0x06 byte Gang 6 Density (set by opcode 076C)
0x07 byte Gang 7 Density (set by opcode 076C)
0x08 byte Gang 8 Density (set by opcode 076C)
0x09 byte Gang 9 Density (set by opcode 076C)
0x0A byte Dealer Density (set by opcode [[076A]])
0x0B byte[4] RBGA color of zone on map/radar
0x0F byte Popcycle Group (set by opcode [[0767]])
0x10 byte Ped-related (set by opcode [[0874]])
0x11 (end)

====Block 11: Gang Weapons====
OFFSET TYPE DESCRIPTION
0x0000 GangWeapons[10] GangWeapons structures -- each is 0x10 bytes in size; see details below
0x00a0 (end)

GangWeapons[]
0x00 byte[4] unused
0x04 dword weaponID A
0x08 dword weaponID B
0x0c dword weaponID C
0x10 (end)

Notes:
# Data can be changed by opcode 0237

====Block 12: Car Generators====
0 dword count
6 car generators
---- numberplates:
0 dword num entries used
4 Numplate[15] number plates
f4 end

Car generator structure:
0 word handle (0..499)
2 word model
4 byte[2] colors
6 word[3] x,y,z, all multiplied by 8
c byte heading/360*256
d byte alarm chance
e byte locked chance
f byte flags: bit 2=force spawn, bit 8=player owned
12 word monetary value
16 dword timer
1c word cars to generate
22 end

Numplate structure:
0 dword car generator handle
4 char[8] numberplate string
10 end

====Block 13: (Unused)====
(Usually Empty)

====Block 14: (Unused)====
(Usually Empty)

====Block 15: Player data====
00 dword size of block (always 28h)
04 dword money
08 word (unknown)
0A byte is wasted_or_busted flag
0C dword (unknown)
10 dword amount of money shown on screen
...
20 byte infinite run (opcode [[0330]])
21 byte fast reload (opcode [[0331]])
22 byte fireproof ([[055D]])
23 byte unknown(health)
24 byte max armor (opcode [[055F]])
...
2c end

====Block 16: Stats====
0 float[82] float stats (numbered 0..81 in scm)
148 dword[223] int stats (numbered 120..342 in scm)
4c4 dword[32]
544 char[8] last mission passed (gxt key)
54c byte[56]
584 dword[100]
714 byte[128]
794 end

====Block 17: Police trigger zones====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Police trigger zones
0x0004 PoliceTriggerZone[210] Trigger structures -- each is 0x20 bytes in size; see details below
0x1A44 end

PoliceTriggerZone
0x0000 dword trigger last activation time
0x0004 word[2] player vehicle zone point 1 (x,y) -- all multiplied by 8
0x0008 word[2] player vehicle zone point 2 (x,y) -- all multiplied by 8
0x000C word[2] police vehicle 1 zone point 1 (x,y) -- all multiplied by 8
0x0010 word[2] police vehicle 1 zone point 2 (x,y) -- all multiplied by 8
0x0014 word[2] police vehicle 2 zone point 1 (x,y) -- all multiplied by 8
0x0018 word[2] police vehicle 2 zone point 2 (x,y) -- all multiplied by 8
0x001C byte type -- unknown meaning, various requirements for the trigger to be activated
0x001D byte[3] (align)
0x0020 end

Notes:
# Police trigger zone is a special zone consisting of 3 rectangles. When player drive into the first rectangle (defined by 2 ends of the rectange diagonal set by the first 2 XY pairs) having a certain wanted level (depends on the 'type' field), two police cars appear there: one in the second rectangle, the second car in the third rectangle. These rectangles are defined in the same manner as the player's one.
# Trigger zone can be created using opcode [[04F8]]
# Trigger zone is activated only once per 40 seconds (the first field is used to control this).
# http://www.gtaforums.com/index.php?showtopic=260803

====Block 18: Models====
66cc end

====Block 19: Ped Acquaintances====
OFFSET TYPE DESCRIPTION
0x000 PedAcquaintance[32] PedAcquaintance structures, each is 20 bytes in size -- see details below
0x280 end

PedAcquaintance -- See notes below
0x00 dword respect bitmask
0x04 dword like bitmask
0x08 dword (unused)
0x0C dword dislike bitmask
0x10 dword hate bitmask

* This structure stores information about how a ped of given pedtype (each entry in PedAcquaintance[32] is separate pedtype, starting from 0 (PLAYER1) to 31 (MISSION8)) behaves toward any ped of other type. Five dwords in this structure (only four of them are used) are the bitmasks, where a bit sets a flag of acquaintance type (respect, like, dislike, hate) to the pedtype of given index (=number of bit). Say, if the 4th bit (counting from zero) in PedAcquaintance[5].respect is set, it means that a ped of type CIVFEMALE (pedtype=5) respects a ped of type CIVMALE (pedtype=4).
* These structures are filled with data from the file [[ped.dat]]. The acquaintances flags could be changed via scripts (using opcode [[0746]] and similar).

====Block 20: Tags====
0 dword total number of the tags
4 byte[] tags paint status (0-255)

====Block 21: IPL====

00 dword
04 byte[255] (mostly unknown)
05 byte BARRIERS1 v1 Barriers to SF
06 byte BARRIERS2 v1 Barriers to LV
2D byte CRACK v2 Pre-Yay Ka-Boom Boom Factory (45)
31 byte TRUTHSFARM v1 Crops at Truth's Farm (49)
3E byte CRACK v1 Pre-Yay Ka-Boom Boom Factory (62)
3E byte TRUTHSFARM v2 Crops at Truth's Farm (62)
3F byte BARRIERS1 v2 Barriers to SF (63)
40 byte BARRIERS2 v2 Barriers to LV (64)
52 byte CARTER v2 1st Floor of Smoke's Palace (82)
7F byte CARTER v1 1st Floor of Smoke's Palace (127)
103 end

====Block 22: Shopping====
0 dword count
4 entries (8 bytes each)
----
0 dword size
4 bytes

====Block 23: Gang wars====
0 dword size of block (always 58h)
4 byte enable gang wars (opcode [[0879]])
5c end

====Block 24: Unique Stunt Jumps====
OFFSET TYPE DESCRIPTION
0x0000 dword Number of Unique Stunt Jumps (USJ)
0x0004 StuntJump[] Jump structures -- each is 0x44 bytes in size; see details below

StuntJump -- See note below
0x00 float[3] Start zone point 1 (x,y,z)
0x0C float[3] Start zone point 2 (x,y,z)
0x18 float[3] Land zone point 1 (x,y,z)
0x24 float[3] Land zone point 2 (x,y,z)
0x30 float[3] Camera coordinates (x,y,z)
0x3C dword Reward amount (can be negative)
0x40 byte Boolean: is USJ done
0x41 byte Boolean: is USJ found
0x42 byte[2] (Align)

The starting and landing zones are cubes; each is defined by 2 points -- point 1 is the lower, left, front of the cube and point 2 is the upper, right, rear. These cubes are aligned with the coordinate axes and not rotated at all. If a vehicle enters the starting zone while airborne, the USJ triggers (and is marked as 'found'); if the vehicle then lands inside the landing zone, the USJ is successful (and is marked as 'done') and the reward is given.

====Block 25: ENEX Connections====
0 dword count
4 array of words
----
Structure:
0 word source id
2 word flags
4 word destination id
----
Followed by a weird array:
1. Read a word.
2. If it is -1, you've reached the end of this block.
3. Otherwise, it's an index. Read two more words for this entry and go back to 1.

====Block 26: Missions data====
0x000 Structure[14] -- see details below
0xEE0 byte availables cities number (stat 181)
0xEE1 byte least favorite radio (stat 327)
0xEE2 byte current weapon skill (stat 328)
0xEE3 byte weapon skill levels (stat 329)
0xEE4 byte "Local Liquor Store" mission accomplished (stat 318)
0xEE5 byte playing time (stat 320)
0xEE6 byte pilot ranking (stat 330)
0xEE7 byte strongest gang (stat 331)
0xEE8 byte 2nd strongest gang (stat 332)
0xEE9 byte 3rd strongest gang (stat 333)
0xEEA byte "Mike Toreno" mission accomplished (stat 311)
0xEEB byte least favorite gang (stat 323)
0xEEC byte "A Home In The Hills" mission accomplished (stat 308)
0xEED byte "Robbing Uncle Sam" mission accomplished (stat 310)
0xEEE byte (stat 335)
0xEEF byte gang strength (stat 336)
0xEF0 byte territory under control (stat 337)
0xEF1 byte "Drive-thru" mission accomplished (stat 302)
0xEF2 byte "Are you going to San Fierro?" mission accomplished (stat 338)
0xEF3 byte "High Noon" mission accomplished (stat 339)
0xEF4 byte "The Green Sabre" mission accomplished (stat 340)
0xEF5 byte (stat 341)
0xEF6 byte (stat 342)
0xEF7 byte month day when the stats above were updated
0xEF8 byte hour when the stats above were updated
0xEF9 byte hours to the next stats update (commonly 24 or 168)
0xEFA byte updating flag (1,2,3)
0xEFB byte last updated stat (in accordance with the given order)
0xEFC end

Structure:
0x000 byte[20]
0x014 dword[8]
0x034 dword[40]
0x0D4 dword[15]
0x110 end

====Block 27: Entrance markers====
{{ClassTableHeader}}
|0x00||CEntranceMarker[5]||entrance markers||can be created by opcode [[0A40]]
{{ClassTableFooter|0x8C}}

CEntranceMarker
{{ClassTableHeader}}
|0x00||dword||existance status
|-
|0x04||float[3]||position||
|-
|0x10||dword||color R||
|-
|0x14||dword||color G||
|-
|0x18||dword||color B||
{{ClassTableFooter|0x1C}}

===Padding===
Following the last data block is a variable amount of padding. Since every save file is exactly 0x31800 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. Because GTASA internally uses a buffer of 0xC800 bytes for writing a save, each byte of padding data is simply a repetition of the data located 0xC800 bytes before it. While it is not strictly necessary to follow this convention for the padding when writing a modified save file, it is consistent with the original game and makes modifications harder to detect.

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

[[Category:Save Formats]] [[Category:GTA SA]]

Saves (GTA SA)

2007-12-05T19:26:57Z

OrionSR: /* Block 2: Objects */

Saves (GTA SA)

2007-12-01T22:59:04Z

OrionSR: /* Block 21: IPL */

Saves (GTA SA)

2007-11-16T10:06:21Z

OrionSR: /* Block 21: IPL */

Saves (GTA SA)

2007-11-11T20:25:09Z

OrionSR: /* Block 2: Objects */

Saves (GTA SA)

2007-11-09T19:42:38Z

OrionSR: /* Block 2: Objects */

Saves (GTA SA)

2007-11-09T19:36:06Z

OrionSR: /* Block 3: Garages */

Saves (GTA SA)

2007-11-09T11:04:01Z

OrionSR: /* Block 3: Garages */

Saves (GTA SA)

2007-11-09T11:02:18Z

OrionSR: /* Block 3: Garages */

Saves (GTA SA)

2007-11-09T10:13:25Z

OrionSR: /* Block 3: Garages */

Saves (GTA SA)

2007-11-09T10:10:27Z

OrionSR: /* Block 2: Objects */

Saves (GTA SA)

2007-11-08T00:47:19Z

OrionSR: /* Block 15: Player data */

Saves (GTA SA)

2007-11-07T23:40:55Z

OrionSR: /* Block 23: Gang wars */

Saves (GTA SA)

2007-11-07T23:35:45Z

OrionSR: /* Block 23: Gang wars */

Saves (GTA SA)

2007-10-16T19:48:45Z