Pokémon data substructures (Generation III)
This is the list of Pokémon data substructures in the Generation III Game Boy Advance games, Pokémon Ruby, Sapphire, FireRed, LeafGreen, and Emerald.
Format
A Pokémon's data is slightly more complex than the rest of the structure. It is stored as four substructures, each 12 bytes in length:
| Growth | ||
|---|---|---|
| size | offset | |
| Species | word | 0 |
| Item held | word | 2 |
| Experience | dword | 4 |
| PP bonuses | byte | 8 |
| Friendship | byte | 9 |
| ??? | word | 10 |
| Attacks | ||
|---|---|---|
| size | offset | |
| Attack 1 | word | 0 |
| Attack 2 | word | 2 |
| Attack 3 | word | 4 |
| Attack 4 | word | 6 |
| PP 1 | byte | 8 |
| PP 2 | byte | 9 |
| PP 3 | byte | 10 |
| PP 4 | byte | 11 |
| Effort | ||
|---|---|---|
| size | offset | |
| HP EV | byte | 0 |
| Attack EV | byte | 1 |
| Defense EV | byte | 2 |
| Speed EV | byte | 3 |
| Sp. Attack EV | byte | 4 |
| Sp. Defense EV | byte | 5 |
| Coolness | byte | 6 |
| Beauty | byte | 7 |
| Cuteness | byte | 8 |
| Smartness | byte | 9 |
| Toughness | byte | 10 |
| Feel | byte | 11 |
| Misc. | ||
|---|---|---|
| size | offset | |
| Pokérus status | byte | 0 |
| Location caught | byte | 1 |
| OriginsInfo | word | 2 |
| IVs | dword | 4 |
| Ribbons | dword | 8 |
Order
The order of the structures is determined by the personality value of the Pokémon. The order is determined by the value modulo 24:
| 00. GAEM | 06. AGEM | 12. EGAM | 18. MGAE |
| 01. GAME | 07. AGME | 13. EGMA | 19. MGEA |
| 02. GEAM | 08. AEGM | 14. EAGM | 20. MAGE |
| 03. GEMA | 09. AEMG | 15. EAMG | 21. MAEG |
| 04. GMAE | 10. AMGE | 16. EMGA | 22. MEGA |
| 05. GMEA | 11. AMEG | 17. EMAG | 23. MEAG |
Where G, A, E, and M stand for the substructures: growth, attacks, effort, and Misc. respectively.
Encryption
The entire data structure is encrypted by XORing the entire Trainer ID with the personality value, after that the player will get a 4 bytes value, then XORing the resulting value with the data (one long value at a time, p/s: one long value here refer to 4 bytes). The same process is used to decrypt the encrypted data, for detail check on use of xor. The correct checksum is found by summing the original values, not the encrypted values.
Notes
PP bonuses
The PP bonuses byte stores the number of PP Ups used for each attack. Two bits per attack, starting with the first attack from the least significant bits upward to the last attack.
Pokérus status
Pokérus status is stored in a single byte. The lower 4 bits represents the number of units of time left until the virus wears away. If any bit in the upper 4 bits is set, the Pokémon is immune to Pokérus, indicated a small black dot appears on the Pokémon's status screen. Both values are completely random when caught, leading to the fact that not all Pokémon contract the virus for the same amount of time and some are able to catch it again.
Origins
FBBBBGGGGLLLLLLL
Some tools divide this into two bytes:
GLLLLLLL (Level) FBBBBGGG (Ball/Game)
Level caught
Level caught is a 7-bit value stored in the lowest seven bits of the Origins-Word. It is limited to the range of 1-127. This range does not include zero because setting this value to zero causes the game to produce the "Level 5 (egg)" message instead of the regular "Level # (met)" message.
When examining the Level-byte on its own, the highest bit has to be cleared.
Game of origin
When regarding the Origins-word as two seperate bytes (Level and Poké Ball/Trainer, this value is confusing as it spans into both (taking bit 0-2 of the the Poké Ball/Trainer Gender plus the MSB of Pokemon) so it is recommended to tread the Origins-word as an LSB two-byte value. Then, Bits 7-10 report the game which the Pokémon came from:
- 0 = Demo Jirachi Disk
- 1 = Pokémon Sapphire
- 2 = Pokémon Ruby
- 3 = Pokémon Emerald
- 4 = Pokémon FireRed
- 5 = Pokémon LeafGreen
- 15 = Pokémon Colosseum
Poké Ball
When examining offset 3 as a single byte, this information is stored in Bits 3-6. When treating Origins as two-byte word, Bits 11-14 store the Poké Ball type that the Pokémon was caught in.
Trainer Gender
The most significant bit stores whether the original trainer is female. This can be used to color the name in the status screen.
IVs
IVs are stored pretty logically. Starting from the least significant bit, each stat from HP to Special Defense takes up 5 bits, leaving the uppermost 2 bits zeroed.
See also
| |||||||||||||||||||||||||||||||||
|
This data structure article is part of Project Games, a Bulbapedia project that aims to write comprehensive articles on the Pokémon games. |
