Pokémon data structure (Generation III)

2023-08-19T20:15:46Z

ProfX: /* Data location */

Pokémon in the {{game|Ruby and Sapphire|s}}, {{2v2|FireRed|LeafGreen}}, and {{v|Emerald}}s are all stored the same way in a 100-byte structure. All numbers are stored in little-endian order.

==Notes==

{| style="border: 1px solid #88a; background: #f8f8ff; padding: 0.5em; border-collapse: collapse; float: right; margin: 0 0 0.5em 0.5em;" cellpadding="2"
|-
! colspan="3" style="text-align: center; background: #{{hoenn color}};" | '''Pokémon'''
|-
! || type || offset
|-
| [[Personality value]] || dword || 0
|-
| [[Original Trainer|OT]] [[Trainer ID number|ID]] || dword || 4
|-
| [[Nickname]] || 10 bytes || 8
|-
| Language || byte || 18
|-
| Egg Name || byte || 19
|-
| OT name || 7 bytes || 20
|-
| [[Marking]]s || byte || 27
|-
| Checksum || word || 28
|-
| ???? || word || 30
|-
| {{OBP|Pokémon data substructures|Generation III|Data}} || 48 bytes || 32
|-
| [[Status condition]] || dword || 80
|-
| [[Level]] || byte || 84
|-
| [[Pokérus]] remaining || byte || 85
|-
| Current [[stats|HP]] || word || 86
|-
| Total [[stats|HP]] || word || 88
|-
| [[stats|Attack]] || word || 90
|-
| [[stats|Defense]] || word || 92
|-
| [[stats|Speed]] || word || 94
|-
| [[stats|Sp. Attack]] || word || 96
|-
| [[stats|Sp. Defense]] || word || 98
|}

===Personality value===
The [[personality value]] controls many things, including [[gender]], {{p|Unown}}'s letter, {{p|Spinda}}'s dots, any Pokémon's [[Nature]], and more.

===OT ID===
The [[Original Trainer]]'s [[Trainer ID number|ID number]]. This number is part of the XOR encryption key for the {{OBP|Pokémon data substructures|Generation III|data}} section, and is also used in [[Shiny Pokémon|Shiny]] determination and the [[Pokémon Lottery Corner|lottery]]. The least significant bytes of this number are the Trainer ID visible on the status screen. The most significant bits (top 16) are the Secret ID of the trainer that caught it.

===Nickname===
The Pokémon's [[nickname]], limited to 10 characters. The characters represented by each byte are determined by the {{OBP|Character encoding|Generation III|proprietary character set}}.

===Language===
The [[language of origin]] is language of the game the Pokémon originates from.

In Western languages, a Pokémon's language of origin determines which font to use to display its name and Original Trainer. This allows the names and Original Trainers of Pokémon from Japanese games to display correctly, including displaying Latin letters as {{wp|fullwidth}} characters.

In Japanese, the language of origin is entirely ignored—names are always rendered using the Japanese character set. This causes all names to be truncated to five characters (even though they can be up to 10 characters in Western languages). In some cases, this causes characters to render as {{wp|mojibake}}; for example, if the {{DL|In-game trade|Pokémon FireRed and LeafGreen|in-game trade}} {{p|Seel}} from Spanish {{game|FireRed and LeafGreen|s}} (whose nickname is normally SEELÍN) is traded to a Japanese game, its nickname will be displayed as ＳＥＥＬコ.

The values that the languages correspond to are:

{| class="wikitable"
! Index || Language
|-
| 1 || Japanese
|-
| 2 || English
|-
| 3 || French
|-
| 4 || Italian
|-
| 5 || German
|-
| 6 || ''unused''
|-
| 7 || Spanish
|}

In the Generation III games, [[Pokémon Egg|Eggs]] always have their language set to Japanese. This does not cause any issues as, upon hatching, the language of the Egg is set to the language of the game it hatched in.

===Egg Name===
This byte houses 3 flags:

* '''Is Bad Egg (Bit 0):''' When this flag is set, the Pokémon will be treated as a [[Bad Egg]]. If a Pokémon's [[#Checksum|checksum]] is invalid, this flag is set, marking it as a Bad Egg and making it unusable.
* '''Has Species (Bit 1):''' This flag is set whenever the Pokémon species index is non-zero, which should be the case for any Pokémon. It is used as a sanity check for empty spaces, and any Pokémon without this flag set cannot be bred and will disappear when group selected.
* '''Use Egg Name (Bit 2):''' When this flag is set, the Pokémon will ignore their [[#Nickname|nickname]] and display the game's regional variant of "EGG". Only eggs should have this flag set. Note that this flag is independent from the [[Pokémon data substructures (Generation III)#IVs, Egg, and Ability|egg flag]] in the subdata structure.
* '''Bits 3-7''': These bits are unused, and are just padding for the three flags. They should be set to 0.

===OT name===
The name of the Pokémon's Original Trainer. The characters represented by each byte are determined by the {{OBP|Character encoding|Generation III|proprietary character set}}.

===Markings===
The markings seen in the [[Pokémon Storage System|storage Box]]. These markings serve only to aid in organizing large collections of Pokémon.
{| style="border: 1px solid #88a; background: #f8f8ff; padding: 0.5em; border-collapse: collapse; margin: 0 0 0.5em 0.5em" cellpadding=2
! Bit || Mark
|-
| 0 || ●
|-
| 1 || ■
|-
| 2 || ▲
|-
| 3 || ♥
|}

===Checksum===
The checksum for the 48-byte {{OBP|Pokémon data substructures|Generation III|data}} section of this structure. It is computed by adding all of the unencrypted values of that section one word at a time. If the computed sum and the stored checksum do not match, the Pokémon is interpreted as a [[Bad Egg]].

===????===
Unknown, possibly simply padding (not used and usually set to either 0 or -1, depending on the data type).

===Data===
Certain {{OBP|Pokémon data substructures|Generation III|data}} pertaining to the Pokémon that is stored in a special and encrypted format.

===Status condition===
The Pokémon's [[status condition]] is stored as follows:

{| style="border: 1px solid #88a; background: #f8f8ff; padding: 0.5em; border-collapse: collapse; margin: 0 0 0.5em 0.5em" cellpadding=2
! Bit || colspan=2 | Status
|-
| 0-2 || class="roundy" style="background:#{{status color}}; border:1px solid #f8f8ff; text-align:center" width="32px" | {{color2|FFFFFF|Sleep (status condition)|SLP}} || Sleep
|-
| 3 || class="roundy" style="background:#{{poison color}}; border:1px solid #f8f8ff; text-align:center" | {{color2|FFFFFF|Poison (status condition)|PSN}} || Poison
|-
| 4 || class="roundy" style="background:#{{fire color}}; border:1px solid #f8f8ff; text-align:center" | {{color2|FFF|Burn (status condition)|BRN}} || Burn
|-
| 5 || class="roundy" style="background:#{{ice color}}; border:1px solid #f8f8ff; text-align:center" | {{color2|FFFFFF|Freeze (status condition)|FRZ}} || Freeze
|-
| 6 || class="roundy" style="background:#{{electric color}}; border:1px solid #f8f8ff; text-align:center" | {{color2|FFFFFF|Paralysis (status condition)|PAR}} || Paralysis
|-
| 7 || class="roundy" style="background:#{{poison color}}; border:1px solid #f8f8ff; border-bottom:1px solid; text-align:center" | {{color2|FFFFFF|Poison (status condition)|PSN}} || Bad Poison
|}
The three sleep bits are used to indicate turns of sleep. So 1112 = 7 turns of sleep, 1012 = 5 turns, et cetera.

===Pokérus===
{{incomplete|section|What happens when this value ticks down to 0? What determines when it ticks down?}}
{{main|Pokérus}}
Not the same as the value found in [[Pokémon data substructures (Generation III)#Pokérus status|the miscellaneous data substructure]], which is a [[Pokérus#Technical information|standard Pokérus byte]]. Instead, this value starts at 0xFF (and is in fact set to 0xFF initially even for Pokémon who haven't contracted Pokérus) and slowly ticks down. Cured Pokémon have this value set to 0.

==Data location==
{{incomplete|section|Are the addresses below only for US games? Also, is the mentioned "general region" of box data correct?}}
A Trainer's [[party]] starts at the following addresses in the GBA's RAM.
{| style="border: 1px solid #88a; background: #f8f8ff; padding: 0.5em; border-collapse: collapse; margin: 0 0 0.5em 0.5em" cellpadding=2
! Game || Address
|-
| '''{{color2|{{ruby color}}|Pokémon Ruby and Sapphire Versions|Ruby}}''' || rowspan=2 | 0x03004360
|-
| '''{{color2|{{sapphire color}}|Pokémon Ruby and Sapphire Versions|Sapphire}}'''
|-
| '''{{color2|{{emerald color}}|Pokémon Emerald Version|Emerald}}''' || 0x02024190 0x020244EC{{tt|US,FR|for US and FR games}}
|-
| '''{{color2|{{firered color}}|Pokémon FireRed and LeafGreen Versions|FireRed}}''' || 0x02024284
|-
| '''{{color2|{{leafgreen color}}|Pokémon FireRed and LeafGreen Versions|LeafGreen}}''' || 0x020241E4 0x02024284{{tt|US|for US games}}
|}
An opponent's party, or a wild Pokémon, starts at the following addresses.
{| style="border: 1px solid #88a; background: #f8f8ff; padding: 0.5em; border-collapse: collapse; margin: 0 0 0.5em 0.5em" cellpadding=2
! Game || Address
|-
| '''{{color2|{{ruby color}}|Pokémon Ruby and Sapphire Versions|Ruby}}''' || rowspan=2 | 0x030045C0
|-
| '''{{color2|{{sapphire color}}|Pokémon Ruby and Sapphire Versions|Sapphire}}'''
|-
| '''{{color2|{{emerald color}}|Pokémon Emerald Version|Emerald}}''' || 0x02024744
|-
| '''{{color2|{{firered color}}|Pokémon FireRed and LeafGreen Versions|FireRed}}''' || 0x0202402C
|-

|}

The 600 bytes following these addresses describe a whole team of 6 Pokémon.

The full 100-byte structure for a Pokémon is only used to describe Pokémon being held in the player's party. When Pokémon are stored in the PC, their data is recorded using only the first 80 bytes of this structure, stopping after the {{OBP|Pokémon data substructures|Generation III|data}} field. The last 20 bytes (excepting status condition, current HP, and Pokerus remaining byte) can all be recalculated from data in the data substructure when a Pokémon is withdrawn (level being derived from experience). This also explains why Pokémon suffering a status condition are "cured" when put in the PC.

This means there are also 33,600 bytes (80 bytes * 30 per Box * 14 Boxes) elsewhere in the GBA's RAM describing Pokémon in the PC. When the GBA's saved state (including memory contents) is unzipped into a 740,000+ byte file and viewed, the 14 Boxes of 420 Pokémon are stored in the general region of $038000 and $040000. In the US version of Pokémon Emerald, box data is between 0x02FE9888 and 0x02FF1BC8, non-inclusive. Depending on the emulator or game it can be in a different address for example on mgba pokemon emerald(BPEE) the ram address was 0x02FE9880. The first 6 80-byte structures make up, from left to right, the first row of Pokémon in box 1. The next Pokémon gets placed on the next row. After 5 rows (30 80-byte structures), the next Pokémon is placed in box 2, and so on.

==See also==
* [[Pokémon data substructures (Generation III)]]

==Links==
* [http://www.ppnstudio.com/maker/PokemonMakerHelp.txt PokemonMakerV4x Help and 80 bytes Make a Pokémon]

{{data structure}} 
{{Project Games notice|data structure}}

Bulbapedia - User contributions [en]

Pokémon data structure (Generation III)