View source for Pokemon Save Structure (X/Y)

Pokémon in the games Pokémon [[POKEMON X|X]] and [[POKEMON Y|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 pk6 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 [[Pokemon NDS Structure|Generation 4]] and [[Pokemon Black/White NDS Structure|Generation 5]] structures. First, the LCRNG to decrypt the structure's blocks is now seeded with the Encryption Key at the beginning of the pk6 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 pk6 instead of the PID.

== Unencrypted Bytes (0x0-0x7)  ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x00-0x03
| Encryption Key
|- style="background: #ddd;" align="center"
| 0x04-0x05
| Sanity Placeholder
|- style="background: #eee;" align="center"
| 0x06-0x07
| Checksum
|}

== Encrypted Bytes ==
=== Block A (0x8-0x3F) ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x08-0x09 
| [[Nationaldex|National Pokédex ID]]
|- style="background: #ddd;" align="center"
| 0x0A-0x0B 
| [[item index|Held Item]]
|- style="background: #eee;" align="center"
| 0x0C-0x0D
| [[Original Trainer|OT ID]]
|- style="background: #ddd;" align="center"
| 0x0E-0x0F 
| [[Original Trainer|OT Secret ID]]
|- style="background: #eee;" align="center"
| 0x10-0x13
| [[Experience Points|Experience Points]]
|- style="background: #ddd;" align="center"
| 0x14
| [[Ability]]
|- style="background: #eee;" align="center"
| 0x15
| Ability Number
|- style="background: #ddd;" align="center"
| 0x16-0x17
| [Hits Remaining] on [Training Bag]
|- style="background: #eee;" align="center"
| 0x18-0x1B
| [[Personality value]] (Also known as the [[PID]])
|- style="background: #ddd;" align="center"
| 0x1C
| Nature
|- style="background: #eee;" align="center"
| 0x1D
| Bit 0 - Fateful Encounter Flag<br>Bit 1 - Female<br>Bit 2 - Genderless<br>Bit 3-7 - [[#Alternate Forms|Alternate Forms]]
|- style="background: #ddd;" align="center"
| 0x1E
| [[Effort Values#Hit Points|HP Effort Value]]
|- style="background: #eee;" align="center"
| 0x1F
| [[Effort Values#Attack Points|Attack Effort Value]]
|- style="background: #ddd;" align="center"
| 0x20
| [[Effort Values#Defense Points|Defense Effort Value]]
|- style="background: #eee;" align="center"
| 0x21
| [[Effort Values#Speed Points|Speed Effort Value]]
|- style="background: #ddd;" align="center"
| 0x22
| [[Effort Values#Special Attack Points|SP Attack Effort Value]]
|- style="background: #eee;" align="center"
| 0x23
| [[Effort Values#Special Defense Points|SP Defense Effort Value]]
|- style="background: #ddd;" align="center"
| 0x24
| Contest Stat: Cool
|- style="background: #eee;" align="center"
| 0x25
| Contest Stat: Beauty
|- style="background: #ddd;" align="center"
| 0x26
| Contest Stat: Cute
|- style="background: #eee;" align="center"
| 0x27
| Contest Stat: Smart
|- style="background: #ddd;" align="center"
| 0x28
| Contest Stat: Tough
|- style="background: #eee;" align="center"
| 0x29
| Contest Stat: Sheen
|- style="background: #ddd;" align="center"
| 0x2A
| Markings
|- style="background: #eee;" align="center"
| 0x2B
| [[Pokerus|Pokérus]]
|- style="background: #ddd;" align="center"
| 0x2C-0x2F
| (Secret) Super Training<br>Gold Medal Flags
|- style="background: #eee;" align="center"
| 0x30-0x35
| Ribbons
|- style="background: #ddd;" align="center"
| 0x36-0x37
| ''Unused''
|- style="background: #eee;" align="center"
| 0x38
| Contest Memory Ribbon [Count]
|- style="background: #ddd;" align="center"
| 0x39
| Battle Memory Ribbon [Count]
|- style="background: #eee;" align="center"
| 0x3A
| Distribution Super Training Flags
|- style="background: #ddd;" align="center"
| 0x3B-0x3F
| ''Unused''
|}

=== Block B (0x40-0x77) ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x40-0x57
| Nickname
|- style="background: #ddd;" align="center"
| 0x58-0x59
| ''Null Terminator''
|- style="background: #eee;" align="center"
| 0x5A-0x5B
| [[Pokemon Moves|Move 1 ID]]
|- style="background: #ddd;" align="center"
| 0x5C-0x5D
| [[Pokemon Moves|Move 2 ID]]
|- style="background: #eee;" align="center"
| 0x5E-0x5F
| [[Pokemon Moves|Move 3 ID]]
|- style="background: #ddd;" align="center"
| 0x60-0x61
| [[Pokemon Moves|Move 4 ID]]
|- style="background: #eee;" align="center"
| 0x62
| [[Pokemon Moves#Power Points|Move 1 Current PP]]
|- style="background: #ddd;" align="center"
| 0x63
| [[Pokemon Moves#Power Points|Move 2 Current PP]]
|- style="background: #eee;" align="center"
| 0x64
| [[Pokemon Moves#Power Points|Move 3 Current PP]]
|- style="background: #ddd;" align="center"
| 0x65
| [[Pokemon Moves#Power Points|Move 4 Current PP]]
|- style="background: #eee;" align="center"
| 0x66-0x69
| [[Pokemon Moves#Power Points|Move PP Ups]]
|- style="background: #ddd;" align="center"
| 0x6A-0x6B
| [[Pokemon Moves|Relearn Move 1 ID]]
|- style="background: #eee;" align="center"
| 0x6C-0x6D
| [[Pokemon Moves|Relearn Move 2 ID]]
|- style="background: #ddd;" align="center"
| 0x6E-0x6F
| [[Pokemon Moves|Relearn Move 3 ID]]
|- style="background: #eee;" align="center"
| 0x70-0x71
| [[Pokemon Moves|Relearn Move 4 ID]]
|- style="background: #ddd;" align="center"
| 0x72
| "Secret" Super Training Flag<br>0 - Missions Unavailable<br>1 - Missions Available
|- style="background: #eee;" align="center"
| 0x73
| ''Unused''
|- style="background: #ddd;" align="center"
| 0x74-0x77
| Bits 0-29 - [[Individual Values]]<br>
[[Individual Values#Hit Points|HP]] ( [0-31] << 0 )<br>
[[Individual Values#Attack Points|Attack]] ( [0-31] << 5 )<br>
[[Individual Values#Defense Points|Defense]] ( [0-31] << 10 )<br>
[[Individual Values#Speed Points|Speed]] ( [0-31] << 15 )<br>
[[Individual Values#Special Attack Points|SP Attack]] ( [0-31] << 20 )<br>
[[Individual Values#Special Defense Points|SP Defense]] ( [0-31] << 25 )<br>
Bit 30 - IsEgg Flag<br>Bit 31 - IsNicknamed Flag
|}

=== Block C (0x78-0xAF) ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x78-0x8F
| Latest NotOT Handler<br>Updates Every Trade
|- style="background: #ddd;" align="center"
| 0x90-0x91
| ''Null Terminator''
|- style="background: #eee;" align="center"
| 0x92
| NotOT Gender<br>0 - Male<br>1 - Female
|- style="background: #ddd;" align="center"
| 0x93
| Current Handler<br>0 - OT<br>1 - NotOT
|- style="background: #eee;" align="center"
| 0x94-0x95
| Geolocation 1 - (Region,Country)
|- style="background: #ddd;" align="center"
| 0x96-0x97
| Geolocation 2 - (Region,Country)
|- style="background: #eee;" align="center"
| 0x98-0x99
| Geolocation 3 - (Region,Country)
|- style="background: #ddd;" align="center"
| 0x9A-0x9B
| Geolocation 4 - (Region,Country)
|- style="background: #eee;" align="center"
| 0x9C-0x9D
| Geolocation 5 - (Region,Country)
|- style="background: #ddd;" align="center"
| 0x9E-0x9F
| ''Unused''
|- style="background: #eee;" align="center"
| 0xA0-0xA1
| ''Unused''
|- style="background: #ddd;" align="center"
| 0xA2
| NotOT Friendship
|- style="background: #eee;" align="center"
| 0xA3
| NotOT Affection
|- style="background: #ddd;" align="center"
| 0xA4
| NotOT Memory Intensity
|- style="background: #eee;" align="center"
| 0xA5
| NotOT Memory Line
|- style="background: #ddd;" align="center"
| 0xA6
| NotOT Memory Feeling
|- style="background: #eee;" align="center"
| 0xA7
| ''Unused''
|- style="background: #ddd;" align="center"
| 0xA8-0xA9
| NotOT Memory TextVar
|- style="background: #eee;" align="center"
| 0xAA-0xAB
| ''Unused''
|- style="background: #ddd;" align="center"
| 0xAC-0xAD
| ''Unused''
|- style="background: #eee;" align="center"
| 0xAE
| Fullness
|- style="background: #ddd;" align="center"
| 0xAF
| Enjoyment
|}

=== Block D (0xB0-0xE7) ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0xB0-0xC7
| [[#Nickname and OT Name|OT Name]]
|- style="background: #ddd;" align="center"
| 0xC8-0xC9
| ''Null Terminator''
|- style="background: #eee;" align="center"
| 0xCA
| OT Friendship
|- style="background: #ddd;" align="center"
| 0xCB
| OT Affection
|- style="background: #eee;" align="center"
| 0xCC
| OT Memory Intensity
|- style="background: #ddd;" align="center"
| 0xCD
| OT Memory Line
|- style="background: #eee;" align="center"
| 0xCE-0xCF
| OT Memory TextVar
|- style="background: #ddd;" align="center"
| 0xD0
| OT Memory Feeling
|- style="background: #eee;" align="center"
| 0xD1-0xD3
| Date Egg Received
|- style="background: #ddd;" align="center"
| 0xD4-0xD6
| Date Met
|- style="background: #eee;" align="center"
| 0xD7
| Unknown / Unused
|- style="background: #ddd;" align="center"
| 0xD8-0xD9
| Egg [[Pokemon NDS Locations|Location]]
|- style="background: #eee;" align="center"
| 0xDA-0xDB
| Met At [[Pokemon NDS Locations|Location]]
|- style="background: #ddd;" align="center"
| 0xDC
| Pokéball
|- style="background: #eee;" align="center"
| 0xDD
| Bit 0-6 - Encounter Level<br>Bit 7 - Female OT Gender
|- style="background: #ddd;" align="center"
| 0xDE
| Encounter Type (Gen 4)
|- style="background: #eee;" align="center"
| 0xDF
| OT Game ID
|- style="background: #ddd;" align="center"
| 0xE0
| Country ID
|- style="background: #eee;" align="center"
| 0xE1
| Region ID
|- style="background: #ddd;" align="center"
| 0xE2
| 3DS Region ID
|- style="background: #eee;" align="center"
| 0xE3
| OT Language ID
|- style="background: #ddd;" align="center"
| 0xE4-0xE7
| ''Unused''
|}

== Battle Stats ==

The battle stats are encrypted in the exact same manner as the main pk6 data.  The seed is still the Encryption Key.

=== Encrypted Bytes ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0xE8
| Bits 0-2 - Asleep (0-7 rounds)<br>Bit 3 - Poisoned<br>Bit 4 - Burned<br>Bit 5 - Frozen<br>Bit 6 - Paralyzed<br>Bit 7 - Toxic
|- style="background: #ddd;" align="center"
| 0xE9
| ''Unknown'' - Flags
|- style="background: #eee;" align="center"
| 0xEA-0xEB
| Unknown / Unused
|- style="background: #ddd;" align="center"
| 0xEC
| Level
|- style="background: #eee;" align="center"
| 0xED
| Unknown / Unused
|- style="background: #ddd;" align="center"
| 0xEE-0xEF
| Unknown / Unused
|- style="background: #eee;" align="center"
| 0xF0-0xF1
| Current HP
|- style="background: #ddd;" align="center"
| 0xF2-0xF3
| Max HP
|- style="background: #eee;" align="center"
| 0xF4-0xF5
| Attack
|- style="background: #ddd;" align="center"
| 0xF6-0xF7
| Defense
|- style="background: #eee;" align="center"
| 0xF8-0xF9
| Speed
|- style="background: #ddd;" align="center"
| 0xFA-0xFB
| Special Attack
|- style="background: #eee;" align="center"
| 0xFC-0xFD
| Special Defense
|- style="background: #ddd;" align="center"
| 0xFE-0xFF
| Unknown / Unused
|- style="background: #eee;" align="center"
| 0x100-0x103
| Unknown / Unused
|}

== Original Language ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Value
! Language
|- style="background: #eee;" align="center"
| 0x1
| 日本語 (Japan)
|- style="background: #ddd;" align="center"
| 0x2
| English (US/UK/AU)
|- style="background: #eee;" align="center"
| 0x3
| Français (France/Québec)
|- style="background: #ddd;" align="center"
| 0x4
| Italiano (Italy)
|- style="background: #eee;" align="center"
| 0x5
| Deutsch (Germany)
|- style="background: #ddd;" align="center"
| 0x7
| Español (Spain/Latin Americas)
|- style="background: #eee;" align="center"
| 0x8
| 한국어 (South Korea)
|}

== Markings ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Marking
|- style="background: #eee;" align="center"
| 0x01
| Circle
|- style="background: #ddd;" align="center"
| 0x02
| Triangle
|- style="background: #eee;" align="center"
| 0x04
| Square
|- style="background: #ddd;" align="center"
| 0x08
| Heart
|- style="background: #eee;" align="center"
| 0x10
| Star
|- style="background: #ddd;" align="center"
| 0x20
| Diamond
|}

== Encounter Types ==

Encounter Types are not used in X/Y. Transferred Pokemon keep their Encounter Type hex.

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Value
! Country
|- style="background: #eee;" align="center"
| 0x0
| Pal Park, Egg, Hatched, Special Event
|- style="background: #ddd;" align="center"
| 0x2
| Tall Grass
|- style="background: #eee;" align="center"
| 0x4
| Dialga/Palkia In-Game Event
|- style="background: #ddd;" align="center"
| 0x5
| Cave, Hall of Origin
|- style="background: #eee;" align="center"
| 0x7
| Surfing, Fishing
|- style="background: #ddd;" align="center"
| 0x9
| Building
|- style="background: #eee;" align="center"
| 0xA
| Great Marsh (Safari Zone)
|- style="background: #ddd;" align="center"
| 0xC
| Starter, Fossil, Gift (Eevee)
|}

==Medals & Ribbons==

=== Super Training Medals ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Flag Value
! 0x2C
! 0x2D
! 0x2E
! 0x2F
|- style="background: #eee;" align="center"
| 0x01
| Unused
| Sp. Atk Level 2
| Atk Level 3
| Follow Those Fleeing Goals!
|- style="background: #ddd;" align="center"
| 0x02
| Unused
| HP Level 2
| Sp. Def Level 3
| Watch Out! That's One Tricky Second Half!
|- style="background: #eee;" align="center"
| 0x04
| Sp. Atk Level 1
| Atk Level 2
| Speed Level 3
| An Opening of Lighting-Quick Attacks!
|- style="background: #ddd;" align="center"
| 0x08
| HP Level 1
| Sp. Def Level 2
| Def Level 3
| Those Long Shots Are No Long Shot!
|- style="background: #eee;" align="center"
| 0x10
| Atk Level 1
| Speed Level 2
| The Troubles Keep on Coming?!
| Scatterbug Lugs Back!
|- style="background: #ddd;" align="center"
| 0x20
| Sp. Def Level 1
| Def Level 2
| The Leaf Stone Cup Begins!
| A Barrage of Bitbots!
|- style="background: #eee;" align="center"
| 0x40
| Speed Level 1
| Sp. Atk Level 3
| The Fire Stone Cup Begins!
| Drag Down Hydreigon!
|- style="background: #ddd;" align="center"
| 0x80
| Def Level 1
| HP Level 3
| The Water Stone Cup Begins!
| The Battle for the Best: Version X/Y!
|}

=== Ribbon Set 1 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Flag Value
! 0x30
! 0x31
|- style="background: #eee;" align="center"
| 0x01
| Kalos Champ Ribbon
| Alert Ribbon
|- style="background: #ddd;" align="center"
| 0x02
| Champion Ribbon
| Shock Ribbon
|- style="background: #eee;" align="center"
| 0x04
| Sinnoh Champ Ribbon
| Downcast Ribbon
|- style="background: #ddd;" align="center"
| 0x08
| Best Friends Ribbon
| Careless Ribbon
|- style="background: #eee;" align="center"
| 0x10
| Training Ribbon
| Relax Ribbon
|- style="background: #ddd;" align="center"
| 0x20
| Skillful Battler Ribbon
| Snooze Ribbon
|- style="background: #eee;" align="center"
| 0x40
| Expert Battler Ribbon
| Smile Ribbon
|- style="background: #ddd;" align="center"
| 0x80
| Effort Ribbon
| Gorgeous Ribbon
|}

=== Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Flag Value
! 0x32
! 0x33
|- style="background: #eee;" align="center"
| 0x01
| Royal Ribbon
| Earth Ribbon
|- style="background: #ddd;" align="center"
| 0x02
| Gorgeous Royal Ribbon
| World Ribbon
|- style="background: #eee;" align="center"
| 0x04
| Artist Ribbon
| Classic Ribbon
|- style="background: #ddd;" align="center"
| 0x08
| Footprint Ribbon
| Premier Ribbon
|- style="background: #eee;" align="center"
| 0x10
| Record Ribbon
| Event Ribbon
|- style="background: #ddd;" align="center"
| 0x20
| Legend Ribbon
| Birthday Ribbon
|- style="background: #eee;" align="center"
| 0x40
| Country Ribbon
| Special Ribbon
|- style="background: #ddd;" align="center"
| 0x80
| National Ribbon
| Souvenir Ribbon
|}
=== Ribbon Set 3 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Flag Value
! 0x34
|- style="background: #eee;" align="center"
| 0x01
| Wishing Ribbon
|- style="background: #ddd;" align="center"
| 0x02
| Battle Champion Ribbon
|- style="background: #eee;" align="center"
| 0x04
| Regional Champion Ribbon
|- style="background: #ddd;" align="center"
| 0x08
| National Champion Ribbon
|- style="background: #eee;" align="center"
| 0x10
| World Champion Ribbon
|- style="background: #ddd;" align="center"
| 0x20
| None
|- style="background: #eee;" align="center"
| 0x40
| None
|- style="background: #ddd;" align="center"
| 0x80
| Hoenn Champion Ribbon
|}

=== Ribbon Set 4 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Flag Value
! 0x35
|- style="background: #eee;" align="center"
| 0x01
| Contest Star Ribbon
|- style="background: #ddd;" align="center"
| 0x02
| Coolness Master Ribbon
|- style="background: #eee;" align="center"
| 0x04
| Beauty Master Ribbon
|- style="background: #ddd;" align="center"
| 0x08
| Cuteness Master Ribbon
|- style="background: #eee;" align="center"
| 0x10
| Cleverness Master Ribbon
|- style="background: #ddd;" align="center"
| 0x20
| Toughness Master Ribbon
|}


[[Category:Structures]]
[[Category:Game Mechanics]]
[[Category:SAV Research]]