Pokemon Save Structure (X/Y)
Pokémon in the games Pokémon X and Y are stored in a new 232 byte structure (for the box data only). Party Pokémon hold 28 bytes of additional data for overworld and battle values. We recommend using the pkx extension for decrypted 232-byte box data and 260-byte party data structures.
Checksum / Block Shuffling / Encryption
There have been some changes compared to the Generation 4 and Generation 5 structures. First, the LCRNG to decrypt the structure's blocks is now seeded with the encryption key at the beginning of the pkx file. Second, the blocks are now 56 bytes instead of the previous 32. However, the way the blocks are shuffled based on the PID did not change. That said, the shuffling algorithm now uses the encryption key at the beginning of the pkx instead of the PID.
Unencrypted bytes (0x0-0x7)
| Offset | Contents |
|---|---|
| 0x00-0x03 | Pkx encryption key |
| 0x04-0x05 | Sanity Placeholder |
| 0x06-0x07 | Checksum |
Encrypted bytes
Block A (0x8-0x3F)
| Offset | Contents |
|---|---|
| 0x08-0x09 | National Pokédex ID |
| 0x0A-0x0B | Held Item |
| 0x0C-0x0D | OT ID |
| 0x0E-0x0F | OT Secret ID |
| 0x10-0x13 | Experience points |
| 0x14 | Ability |
| 0x15 | Ability number |
| 0x16-0x17 | Unknown |
| 0x18-0x1B | Personality value (Also known as the PID) |
| 0x1C | Nature |
| 0x1D | Bit 0 - Fateful Encounter Flag Bit 1 - Female Bit 2 - Genderless Bit 3-7 - Alternate Forms |
| 0x1E | HP Effort Value |
| 0x1F | Attack Effort Value |
| 0x20 | Defense Effort Value |
| 0x21 | Speed Effort Value |
| 0x22 | SP Attack Effort Value |
| 0x23 | SP Defense Effort Value |
| 0x24 | Contest Stat: Cool |
| 0x25 | Contest Stat: Beauty |
| 0x26 | Contest Stat: Cute |
| 0x27 | Contest Stat: Smart |
| 0x28 | Contest Stat: Tough |
| 0x29 | Contest Stat: Sheen |
| 0x2A | Markings |
| 0x2B | Pokérus |
| 0x2C-0x2F | (Secret) Super Training Gold Medal Flags |
| 0x30-0x34 | Ribbons |
| 0x35-0x37 | Unknown / Unused |
| 0x38 | Contest Memory Ribbon [Count] |
| 0x39 | Battle Memory Ribbon [Count] |
| 0x3A-0x3F | Unknown / Unused |
Block B (0x40-0x77)
| Offset | Contents |
|---|---|
| 0x40-0x57 | Nickname |
| 0x58-0x59 | Unused |
| 0x5A-0x5B | Move 1 ID |
| 0x5C-0x5D | Move 2 ID |
| 0x5E-0x5F | Move 3 ID |
| 0x60-0x61 | Move 4 ID |
| 0x62 | Move 1 Current PP |
| 0x63 | Move 2 Current PP |
| 0x64 | Move 3 Current PP |
| 0x65 | Move 4 Current PP |
| 0x66-0x69 | Move PP Ups |
| 0x6A-0x6B | Move 1 ID at hatching |
| 0x6C-0x6D | Move 2 ID at hatching |
| 0x6E-0x6F | Move 3 ID at hatching |
| 0x70-0x71 | Move 4 ID at hatching |
| 0x72 | "Secret" Super Training Flag 00 - Missions Unavailable |
| 0x73 | Unknown |
| 0x74-0x77 | Bits 0-29 - Individual Values HP ( [0-31] << 0 ) |
Block C (0x78-0xAF)
This block is dedicated to the history/memory of the Pokémon.
| Offset | Contents |
|---|---|
| 0x78-0x8F | OT Traded To Updates Every Trade |
| 0x90-0x91 | Unused |
| 0x92-0x93 | 00/01 flags |
| 0x94-0x95 | Geolocation 1 - (Region,Country) |
| 0x96-0x97 | Geolocation 2 - (Region,Country) |
| 0x98-0x99 | Geolocation 3 - (Region,Country) |
| 0x9A-0x9B | Geolocation 4 - (Region,Country) |
| 0x9C-0x9D | Geolocation 5 - (Region,Country) |
| 0x9E-0x9F | Unused |
| 0xA0-0xA1 | Unused |
| 0xA2 | Friendship before being received by current OT |
| 0xA3 | Unknown |
| 0xA4 | Latest Memory TextBank |
| 0xA5 | Latest Memory TextLine |
| 0xA6 | Latest Memory Feeling |
| 0xA7 | Unused |
| 0xA8-0xA9 | Latest Memory TextVar |
| 0xAA-0xAB | Unused |
| 0xAC-0xAD | Unused |
| 0xAE | Fullness |
| 0xAF | Enjoyment |
Block D (0xB0-0xE7)
| Offset | Contents |
|---|---|
| 0xB0-0xC7 | OT Name |
| 0xC8-0xC9 | Unused |
| 0xCA | Friendship |
| 0xCB | Affection |
| 0xCC-0xCD | OT Memory TextBank&TextLine |
| 0xCE-0xCF | OT Memory TextVar |
| 0xD0 | OT Memory Feeling |
| 0xD1-0xD3 | Date Egg Received |
| 0xD4-0xD6 | Date Met |
| 0xD8-0xD9 | Egg Location |
| 0xDA-0xDB | Met At Location |
| 0xDC | Pokéball |
| 0xDD | Bit 0-6 - Encounter Level Bit 7 - Female OT Gender |
| 0xDE | Encounter Type (Gen 4) |
| 0xDF | OT Game version (24=X, 25=Y) |
| 0xE0 | Country ID |
| 0xE1 | Region ID |
| 0xE2 | 3DS region ID |
| 0xE3 | OT language |
| 0xE4-0xE7 | Unknown / Unused |
Battle Stats
The battle stats are encrypted in the exact same manner as the main pkx data. The seed is still the Encryption Key.
Encrypted Bytes
| Offset | Contents |
|---|---|
| 0xE8 | Bits 0-2 - Asleep (0-7 rounds) Bit 3 - Poisoned Bit 4 - Burned Bit 5 - Frozen Bit 6 - Paralyzed Bit 7 - Toxic |
| 0xE9 | Unknown - Flags |
| 0xEA-0xEB | Unknown / Unused |
| 0xEC | Level |
| 0xED | Unknown / Unused |
| 0xEE-0xEF | Unknown / Unused |
| 0xF0-0xF1 | Current HP |
| 0xF2-0xF3 | Max HP |
| 0xF4-0xF5 | Attack |
| 0xF6-0xF7 | Defense |
| 0xF8-0xF9 | Speed |
| 0xFA-0xFB | Special Attack |
| 0xFC-0xFD | Special Defense |
| 0xFE-0xFF | Unknown / Unused |
| 0x100-0x103 | Unknown / Unused |
Original Language
| Value | Language |
|---|---|
| 0x1 | 日本語 (Japan) |
| 0x2 | English (US/UK/AU) |
| 0x3 | Français (France/Québec) |
| 0x4 | Italiano (Italy) |
| 0x5 | Deutsch (Germany) |
| 0x7 | Español (Spain/Latin Americas) |
| 0x8 | 한국어 (South Korea) |
Markings
| Bit | Marking |
|---|---|
| 0x01 | Circle |
| 0x02 | Triangle |
| 0x04 | Square |
| 0x08 | Heart |
| 0x10 | Star |
| 0x20 | Diamond |
Ribbons
Ribbon Set 1
| Flag Value | 0x30 | 0x31 |
|---|---|---|
| 0x01 | Kalos Champ Ribbon | Alert Ribbon |
| 0x02 | Champion Ribbon | Shock Ribbon |
| 0x04 | Sinnoh Champ Ribbon | Downcast Ribbon |
| 0x08 | ??? | Careless Ribbon |
| 0x10 | ??? | Relax Ribbon |
| 0x20 | Skillful Battler Ribbon | Snooze Ribbon |
| 0x40 | Expert Battler Ribbon | Smile Ribbon |
| 0x80 | Effort Ribbon | Gorgeous Ribbon |
Ribbon Set 2
| Flag Value | 0x32 | 0x33 |
|---|---|---|
| 0x01 | Royal Ribbon | Earth Ribbon |
| 0x02 | Gorgeous Royal Ribbon | World Ribbon |
| 0x04 | Artist Ribbon | Classic Ribbon |
| 0x08 | Footprint Ribbon | Premier Ribbon |
| 0x10 | Record Ribbon | Event Ribbon |
| 0x20 | Legend Ribbon | Birthday Ribbon |
| 0x40 | Country Ribbon | Special Ribbon |
| 0x80 | National Ribbon | Souvenir Ribbon |
Ribbon Set 3
| Flag Value | 0x34 |
|---|---|
| 0x01 | Wishing Ribbon |
| 0x02 | Battle Champion Ribbon |
| 0x04 | Regional Champion Ribbon |
| 0x08 | National Champion Ribbon |
| 0x10 | World Champion Ribbon |