ProjectPokemon Wiki - User contributions [en]

Notable Breakpoints

2009-09-08T22:07:44Z

Jiggy-Ninja:

This page contains RAM addresses to various interesting and useful processes of Pokemon DPP.

Breakpoints can be set at these addresses.

==Inspiration==
This page is inspired by tsanth's thread with the same name on GameFAQs: [http://boards.gamefaqs.com/gfaqs/genmessage.php?board=925602&topic=40532445]

==Pokemon DPP (U)==
{|border="1" style="border: 1px solid #999; border-collapse: collapse;"
|-style="background: #ccc;" align="center"
!DP RAM Address
!Pl RAM Address
!Description
!Discovered by
|-style="background: #eee;" align="center"
|2000FB0
|
|Begin Seed Calculation Routine
|[[mingot]]
|-style="background: #eee;" align="center"
|201B9E0
|
|Set [[PRNG]] seed
|[[mingot]]
|-style="background: #eee;" align="center"
|0201B9EC
|0201D2E8
|PRNG
|[[loadingNOW]], [[tsanth]]
|-style="background: #eee;" align="center"
|0201BA10
|0201D30C
|Alternate RNG used in some cases: Examples, PID generation for mystery gift pokemon, recalculating a PID after a failed shiny check, number which determines swarm pokemon and great marsh pokemon
|[[SCV]]
|-style="background: #eee;" align="center"
|201BA1C
|
|Set [[IRNG]] Seed
|[[mingot]]
|-style="background: #eee;" align="center"
|02038B70
|0203E778
|Script Handler
|[[loadingNOW]]
|-style="background: #eee;" align="center"
|
|203E7D2
|Loads address for a command then branches to that address
|[[SCV]]
|-style="background: #eee;" align="center"
|02042FB4
|
|ARNG call for PID of Wondercard pokemon
|[[SCV]]
|-style="background: #eee;" align="center"
|02042FBA
|
|Loads PID from wondercard to r0
|[[SCV]]
|-style="background: #eee;" align="center"
|02042FC8
|
|First Shiny Check call during the generation of some wondercard pokemon
|[[SCV]]
|-style="background: #eee;" align="center"
|02042FD0
|
|Beginning of loop that makes sure you do not get a shiny wondercard pokemon (in some cases)
|[[SCV]]
|-style="background: #eee;" align="center"
|0204305E
|
|PRNG call for first set of Wondercard pokemon IVs
|[[tsanth]]
|-style="background: #eee;" align="center"
|0204309C
|
|PRNG call for second set of Wondercard pokemon IVs
|[[tsanth]]
|-style="background: #eee;" align="center"
|205DED4
|
|Create chain set (not sure about address in tsanth's thread it said 205DED
|[[tsanth]], [[loadingNOW]]
|-style="background: #eee;" align="center"
|0205DF42
|
|End of Create chain set routine
|[[tsanth]], [[loadingNOW]]
|-style="background: #eee;" align="center"
|0205E40C
|
|Pokeradar Routine
|[[loadingNOW]], [[tsanth]]
|-style="background: #eee;" align="center"
|2068AAC
|
|Shiny Check, used to decide what sprite to show for a pokemon and to make sure dynamic PID mystery gift pokemon are not shiny as well as preventing manaphy from hatching shiny in some cases.
|[[SCV]]
|-style="background: #eee;" align="center"
|
|2078780
|Begin Calculation of [[Pokemon ID]] for alternate forms.
|SCV
|-style="background: #eee;" align="center"
|020EBC80
|020E1F6C
|Division routine; R0= R0 / R1, R1=R0%R1
|[[tsanth]], [[SCV]]
|-style="background: #eee;" align="center"
|
|020EAC58
|Pointer to Begin Routine for Script Command 0000
|[[SCV]]
|-style="background: #eee;" align="center"
|
|020EB974
|Pointer to Begin Routine for Script Command 0347
|-style="background: #eee;" align="center"
|021F4DA8
|
|Beginning of [[Honey Tree]] Routine
|[[SCV]]
|-style="background: #eee;" align="center"
|021F4EE4
|
|Determines a value from 0-3 to use to determine which list will be used and how the shake value is calculated. If 0, slathering fails and not pokemon will show up.
|[[SCV]]
|-style="background: #eee;" align="center"
|021F4F44
|
|Determines a number from 0-5 that represents which pokemon will be encountered in a honey tree.
|[[SCV]]
|-style="background: #eee;" align="center"
|021F4F98
|
|Determines which list will be used by (value determined by 021F4EE4) - 1 (its not done this way, but is equivalent)
|[[SCV]]
|-style="background: #eee;" align="center"
|021F4FAC
|
|Determines a number from 0-3 that represents how much a [[Honey Tree]] will shake
|[[SCV]]
|-style="background: #eee;" align="center"
|021F5138
|021EFF4C
|Returns 1 if the current tree being slathered is a [[Munchlax Tree]] and 0 otherwise.
|[[SCV]]
|-style="background: #eee;" align="center"
|0223C1EE
|
|Pokeball catching routine
|[[tsanth]]
|-style="background: #eee;" align="center"
|0223BA10
|
|Movement Handler Start
|[[tsanth]]
|-style="background: #eee;" align="center"
|0223BA46
|
|"Am I on grass?" check
|[[tsanth]]
|-style="background: #eee;" align="center"
|0223BB2E
|
|Pair-battle (NPC partner) check
|[[tsanth]]
|-style="background: #eee;" align="center"
|0223BAD4
|
|Wild Encounter Check
|[[tsanth]]
|-style="background: #eee;" align="center"
|0223BD1C
|
|Movement Handler END
|[[tsanth]]
|-style="background: #eee;" align="center"
|
|22479E6
|Call to get ID routine (result in r0)
|[[SCV]]
|-style="background: #eee;" align="center"
|
|224E920
|Start of Frozen Handler
|[[SCV]]
|-style="background: #eee;" align="center"
|223C5B8
|
|Start of Encounter Table Lookup Handler
|[[mingot]]
|-style="background: #eee;" align="center"
|223C66A
|
|Start of Water (Sweet Scent/Surfing) Encounter Table Lookup Handler
|[[mingot]]
|-style="background: #eee;" align="center"
|223C6A0
|
|Start of Water (Fishing) Encounter Table Lookup Handler. There are 3 branches for each of the rods in this routine with different results for old and good/super.
|[[mingot]]
|}

Pokemon Save Structure

2009-07-09T05:00:12Z

Jiggy-Ninja: /* Block B */

Pokémon in the games Pokémon [[Pokémon Diamond|Diamond]], [[Pokemon Pearl|Pearl]], and [[Pokémon Platinum Version|Platinum]] are stored in a 136 byte or 236 byte structures. All unencrypted values are stored in [[little-endian|little-endian]] format. The game encrypts the data when it is stored in the [[Pokémon NDS Save File Structure|save file]]. Party Pokémon have additional values to hold current battle stats and conditions. The information below describes the Pokémon data format.

== Checksum ==

The checksum serves two purposes:
# It validates the data after decryption, and
# It serves as the encryption key for the data.

The checksum is calculated in three steps:
# Split the unencrypted data from offsets 0x08 to 0x87 into two-byte words,
# Take the sum of the words, and
# Truncate the sum to 16 bits.

== Block Shuffling ==

The 128 bytes of Pokémon data are split into four 32-byte blocks for shuffling. The blocks are shuffled according to a shift value derived from the [[personality value]]. Given the personality value ''pv'', the expression yielding the shift value is:
: ''((pv >> 0xD) & 0x1F) % 24''
The right shifting (pv >> 0xD) is equivalent to a division of 8192.

To shuffle the blocks, take the four blocks of unencrypted data, ''A'', ''B'', ''C'', and ''D''. The blocks shall be rearranged in the encrypted data according to this table:

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Shift Value (decimal)
! Block Order
|- style="background: #eee;" align="center"
| 00
| ABCD
|- style="background: #ddd;" align="center"
| 01
| ABDC
|- style="background: #eee;" align="center"
| 02
| ACBD
|- style="background: #ddd;" align="center"
| 03
| ACDB
|- style="background: #eee;" align="center"
| 04
| ADBC
|- style="background: #ddd;" align="center"
| 05
| ADCB
|- style="background: #eee;" align="center"
| 06
| BACD
|- style="background: #ddd;" align="center"
| 07
| BADC
|- style="background: #eee;" align="center"
| 08
| BCAD
|- style="background: #ddd;" align="center"
| 09
| BCDA
|- style="background: #eee;" align="center"
| 10
| BDAC
|- style="background: #ddd;" align="center"
| 11
| BDCA
|- style="background: #eee;" align="center"
| 12
| CABD
|- style="background: #ddd;" align="center"
| 13
| CADB
|- style="background: #eee;" align="center"
| 14
| CBAD
|- style="background: #ddd;" align="center"
| 15
| CBDA
|- style="background: #eee;" align="center"
| 16
| CDAB
|- style="background: #ddd;" align="center"
| 17
| CDBA
|- style="background: #eee;" align="center"
| 18
| DABC
|- style="background: #ddd;" align="center"
| 19
| DACB
|- style="background: #eee;" align="center"
| 20
| DBAC
|- style="background: #ddd;" align="center"
| 21
| DBCA
|- style="background: #eee;" align="center"
| 22
| DCAB
|- style="background: #ddd;" align="center"
| 23
| DCBA
|}

== Encryption ==

The encryption uses the [http://projectpokemon.org/wiki/PRNG_in_Pok%C3%A9mon pseudorandom number generator (PRNG)], a linear congruential generator. Elements of the PRNG can be described with the recursive function:
: ''X[n+1] = (0x41C64E6D * X[n] + 0x6073)''

To decrypt the data, given a function ''rand()'' which returns the upper 16 bits of consecutive results of the above given function:
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum).
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''
# Unshuffle the blocks using the block shuffling algorithm above.

To encrypt the data:
# Shuffle the blocks using the block shuffling algorithm above.
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum),
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''

== Unencrypted bytes ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x00-0x03
| [[Personality value]]
|- style="background: #ddd;" align="center"
| 0x04-0x05
| ''Unused''
|- style="background: #eee;" align="center"
| 0x06-0x07
| Checksum
|}

== Encrypted bytes ==
=== Block A ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x08-0x09
| [[Pokedex|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
| Friendship (Steps to Hatch if an egg)
|- style="background: #eee;" align="center"
| 0x15
| [[Ability]]
|- style="background: #ddd;" align="center"
| 0x16
| [[#Markings|Markings]]
|- style="background: #eee;" align="center"
| 0x17
| [[#Original Language|Original Language]]

|- style="background: #ddd;" align="center"
| 0x18
| [[Effort Values#Hit Points|HP Effort Value]]
|- style="background: #eee;" align="center"
| 0x19
| [[Effort Values#Attack Points|Attack Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1A
| [[Effort Values#Defense Points|Defense Effort Value]]
|- style="background: #eee;" align="center"
| 0x1B
| [[Effort Values#Speed Points|Speed Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1C
| [[Effort Values#Special Attack Points|SP Attack Effort Value]]
|- style="background: #eee;" align="center"
| 0x1D
| [[Effort Values#Special Defense Points|SP Defense Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1E
| [[Contest Stats#Cool|Cool Contest Value]]
|- style="background: #eee;" align="center"
| 0x1F
| [[Contest Stats#Beauty|Beauty Contest Value]]

|- style="background: #ddd;" align="center"
| 0x20
| [[Contest Stats#Cute|Cute Contest Value]]
|- style="background: #eee;" align="center"
| 0x21
| [[Contest Stats#Smart|Smart Contest Value]]

|- style="background: #ddd;" align="center"
| 0x22
| [[Contest Stats#Tough|Tough Contest Value]]
|- style="background: #eee;" align="center"
| 0x23
| [[Contest Stats#Sheen|Sheen Contest Value]]

|- style="background: #ddd;" align="center"
| 0x24-0x25
| [[#Sinnoh Ribbon Set 1|Sinnoh Ribbon Set 1]]
|- style="background: #eee;" align="center"
| 0x26-0x27
| [[#Sinnoh Ribbon Set 2|Sinnoh Ribbon Set 2]]
|}

=== Block B ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x28-0x29
| [[Pokemon Moves|Move 1 ID]]
|- style="background: #ddd;" align="center"
| 0x2A-0x2B
| [[Pokemon Moves|Move 2 ID]]
|- style="background: #eee;" align="center"
| 0x2C-0x2D
| [[Pokemon Moves|Move 3 ID]]
|- style="background: #ddd;" align="center"
| 0x2E-0x2F
| [[Pokemon Moves|Move 4 ID]]
|- style="background: #eee;" align="center"
| 0x30
| [[Pokemon Moves#Power Points|Move 1 Current PP]]
|- style="background: #ddd;" align="center"
| 0x31
| [[Pokemon Moves#Power Points|Move 2 Current PP]]
|- style="background: #eee;" align="center"
| 0x32
| [[Pokemon Moves#Power Points|Move 3 Current PP]]
|- style="background: #ddd;" align="center"
| 0x33
| [[Pokemon Moves#Power Points|Move 4 Current PP]]
|- style="background: #eee;" align="center"
| 0x34-0x37
| [[Pokemon Moves#Power Points|Move PP Ups]]
|- style="background: #ddd;" align="center"
| 0x38-0x3B
| Bits 0-29 - [[Individual Values]] 
[[Individual Values#Hit Points|HP]] ( [0-31] << 0 ) 
[[Individual Values#Attack Points|Attack]] ( [0-31] << 5 ) 
[[Individual Values#Defense Points|Defense]] ( [0-31] << 10 ) 
[[Individual Values#Speed Points|Speed]] ( [0-31] << 15 ) 
[[Individual Values#Special Attack Points|SP Attack]] ( [0-31] << 20 ) 
[[Individual Values#Special Defense Points|SP Defense]] ( [0-31] << 25 ) 
Bit 30 - IsEgg Flag Bit 31 - IsNicknamed Flag
|- style="background: #eee;" align="center"
| 0x3C-0x3D
| [[#Hoenn Ribbon Set 1|Hoenn Ribbon Set 1]]
|- style="background: #ddd;" align="center"
| 0x3E-0x3F
| [[#Hoenn Ribbon Set 2|Hoenn Ribbon Set 2]]
|- style="background: #eee;" align="center"
| 0x40-0x41
| Bit 0 - Fateful Encounter Flag Bit 1 - Female Bit 2 - Genderless Bit 3-15 - [[#Alternate Forms|Alternate Forms]]
|- style="background: #ddd;" align="center"
| 0x42-0x43
| ''Unused''
|- style="background: #eee;" align="center"
| 0x44-0x45
| Egg [[Pokemon NDS Locations#Egg Locations|Location]] (Platinum)
|- style="background: #ddd;" align="center"
| 0x46-0x47
| Met at [[Pokemon NDS Locations|Location]] (Platinum)
|}

=== Block C ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x48-0x5D
| Nickname
|- style="background: #ddd;" align="center"
| 0x5E
| ''Unused''
|- style="background: #eee;" align="center"
| 0x5F
| [[Pokemon Hometown|Hometown]]
|- style="background: #ddd;" align="center"
| 0x60-0x61
| [[#Sinnoh Ribbon Set 3|Sinnoh Ribbon Set 3]]
|- style="background: #eee;" align="center"
| 0x62-0x63
| [[#Sinnoh Ribbon Set 4|Sinnoh Ribbon Set 4]]
|- style="background: #ddd;" align="center"
| 0x64-0x67
| ''Unused''
|}

=== Block D ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x68-0x77
| [[Original Trainer|OT Name]]
|- style="background: #ddd;" align="center"
| 0x78-0x7A
| Date Egg Received
|- style="background: #eee;" align="center"
| 0x7B-0x7D
| Date Met
|- style="background: #ddd;" align="center"
| 0x7E-0x7F
| Egg [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #eee;" align="center"
| 0x80-0x81
| Met At [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #ddd;" align="center"
| 0x82
| [[Pokerus|Pokérus]]
|- style="background: #eee;" align="center"
| 0x83
| [http://projectpokemon.org/wiki/Item_index#Balls Poké Ball]
|- style="background: #ddd;" align="center"
| 0x84
| Bit 0-6 - Met At Level Bit 7 - Female OT Gender
|- style="background: #eee;" align="center"
| 0x85
| [[#Encounter Types|Encounter Type]]
|- style="background: #ddd;" align="center"
| 0x86-0x87
| ''Unused''
|}

== Battle Stats ==

The battle stats are encrypted in the same manner, however the seed is not the checksum, it is 0.

=== Encrypted Bytes ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x88
| Bits 0-2 - Asleep (0-7 rounds) Bit 3 - Poisoned Bit 4 - Burned Bit 5 - Frozen Bit 6 - Paralyzed Bit 7 - Toxic
|- style="background: #ddd;" align="center"
| 0x89
| ''Unknown'' - Flags - Max Value 0xF0
|- style="background: #eee;" align="center"
| 0x8A-0x8B
| ''Unknown''
|- style="background: #ddd;" align="center"
| 0x8C
| Level
|- style="background: #eee;" align="center"
| 0x8D
| Capsule Index (Seals)
|- style="background: #ddd;" align="center"
| 0x8E-0x8F
| Current HP
|- style="background: #eee;" align="center"
| 0x90-0x91
| Max HP
|- style="background: #ddd;" align="center"
| 0x92-0x93
| Attack
|- style="background: #eee;" align="center"
| 0x94-0x95
| Defense
|- style="background: #ddd;" align="center"
| 0x96-0x97
| Speed
|- style="background: #eee;" align="center"
| 0x98-0x99
| Special Attack
|- style="background: #ddd;" align="center"
| 0x9A-0x9B
| Special Defense
|- style="background: #eee;" align="center"
| 0x9C-0xD3
| ''Unknown'' - Contains Trash Data
|- style="background: #ddd;" align="center"
| 0xD4-0xEB
| Seal Coordinates
|}

== 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
|}

== Alternate Forms ==
Alternate forms are stored at offset 0x40 of the Pokemon structure. Each form follows the pattern of ''index << 3'' where index starts at zero for the main form.

=== Unown's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| A
| 0x38
| H
| 0x70
| O
| 0xA8
| V
|- style="background: #ddd;" align="center"
| 0x08
| B
| 0x40
| I
| 0x78
| P
| 0xB0
| W
|- style="background: #eee;" align="center"
| 0x10
| C
| 0x48
| J
| 0x80
| Q
| 0xB8
| X
|- style="background: #ddd;" align="center"
| 0x18
| D
| 0x50
| K
| 0x88
| R
| 0xC0
| Y
|- style="background: #eee;" align="center"
| 0x20
| E
| 0x58
| L
| 0x90
| S
| 0xC8
| Z
|- style="background: #ddd;" align="center"
| 0x28
| F
| 0x60
| M
| 0x98
| T
| 0xD0
| !
|- style="background: #eee;" align="center"
| 0x30
| G
| 0x68
| N
| 0xA0
| U
| 0xD8
| ?
|}

=== Deoxy's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Attack
|- style="background: #eee;" align="center"
| 0x10
| Defense
|- style="background: #ddd;" align="center"
| 0x18
| Speed
|}

=== Burmy's & Wormadam's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Plant
|- style="background: #ddd;" align="center"
| 0x08
| Sandy
|- style="background: #eee;" align="center"
| 0x10
| Trash
|}

=== Shellos' & Gastrodon's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| West
|- style="background: #ddd;" align="center"
| 0x08
| East
|}

=== Rotom's Forms ===
Rotom's alternate forms will only be displayed in Pokemon Platinum. Rotom may be traded between Diamond, Pearl, and Platinum without losing the alternate form.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Heat
|- style="background: #eee;" align="center"
| 0x10
| Wash
|- style="background: #ddd;" align="center"
| 0x18
| Frost
|- style="background: #eee;" align="center"
| 0x20
| Fan
|- style="background: #ddd;" align="center"
| 0x28
| Cut
|}

=== Giratina's Forms ===
Giratina's Origin form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Altered
|- style="background: #ddd;" align="center"
| 0x08
| Origin
|}

=== Shaymin's Forms ===
Shaymin's Sky form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Land
|- style="background: #ddd;" align="center"
| 0x08
| Sky
|}

=== Arceus' Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
| 0x30
| Insect
| 0x60
| Zap
|- style="background: #ddd;" align="center"
| 0x08
| Fist
| 0x38
| Spooky
| 0x68
| Mind
|- style="background: #eee;" align="center"
| 0x10
| Sky
| 0x40
| Iron
| 0x70
| Icicle
|- style="background: #ddd;" align="center"
| 0x18
| Toxic
| 0x48
| Flame
| 0x78
| Draco
|- style="background: #eee;" align="center"
| 0x20
| Earth
| 0x50
| Splash
| 0x80
| Dread
|- style="background: #ddd;" align="center"
| 0x28
| Stone
| 0x58
| Meadow
|}

== Encounter Types ==
{| 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)
|}

== Ribbons ==
Diamond, Pearl, and Platinum store the ribbon information as [[Bitfields|bitfields]] in 1-byte words. Given below are the bytewise representation of the ribbon bitfields.

=== Sinnoh Ribbon Set 1 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x01
| Sinnoh Champ Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x02
| Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x04
| Great Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x08
| Double Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x10
| Multi Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x20
| Pair Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x40
| World Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x80
| Alert Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x01
| Shock Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x02
| Downcast Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x04
| Careless Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x08
| Relax Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x10
| Snooze Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x20
| Smile Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x40
| Gorgeous Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x80
| Royal Ribbon
|}

=== Sinnoh Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x01
| Gorgeous Royal Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x02
| Footprint Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x04
| Record Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x08
| History Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x10
| Legend Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x20
| Red Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x40
| Green Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x80
| Blue Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x01
| Festival Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x02
| Carnival Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x04
| Classic Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x08
| Premier Ribbon
|}

=== Sinnoh Ribbon Set 3 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x60 & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x02
| Cool Ribbon Great
|- style="background: #eee;" align="center"
| 0x60 & 0x04
| Cool Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x60 & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x60 & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x20
| Beauty Ribbon Great
|- style="background: #eee;" align="center"
| 0x60 & 0x40
| Beauty Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x60 & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x02
| Cute Ribbon Great
|- style="background: #eee;" align="center"
| 0x61 & 0x04
| Cute Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x61 & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x20
| Smart Ribbon Great
|- style="background: #eee;" align="center"
| 0x61 & 0x40
| Smart Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x61 & 0x80
| Smart Ribbon Master
|}

=== Sinnoh Ribbon Set 4 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x62 & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x62 & 0x02
| Tough Ribbon Great
|- style="background: #eee;" align="center"
| 0x62 & 0x04
| Tough Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x62 & 0x08
| Tough Ribbon Master
|}

=== Hoenn Ribbon Set 1 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3C & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x02
| Cool Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x04
| Cool Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x3C & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x20
| Beauty Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x40
| Beauty Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x02
| Cute Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x04
| Cute Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x20
| Smart Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x40
| Smart Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x80
| Smart Ribbon Master
|}

=== Hoenn Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x02
| Tough Ribbon Super
|- style="background: #eee;" align="center"
| 0x3F & 0x04
| Tough Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3F & 0x08
| Tough Ribbon Master
|- style="background: #eee;" align="center"
| 0x3F & 0x10
| Champion Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x20
| Winning Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x40
| Victory Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x80
| Artist Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x01
| Effort Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x02
| Marine Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x04
| Land Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x08
| Sky Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x10
| Country Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x20
| National Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x40
| Earth Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x80
| World Ribbon
|}

== Save File Location ==
The party Pokémon are stored in the [[Pokémon NDS Save File Structure|save file]] beginning at offset 0x00098 for the first small block, and 0x40098 for the second small block.

In the first small save block, the first Daycare Pokémon is located at 0x0141C, and the second is located at 0x01508. In the second small block, the first Daycare Pokémon is located at 0x4141C, and the second is located at 0x41508.

In the first small save block, the Pal Park Pokémon are stored beginning at 0x0BA28. In the second small save block, the Pal Park Pokémon are stored beginning at 0x4BA28.

Each party, Daycare, and Pal Park Pokémon is 236 bytes in size.

The PC storage Pokémon are stored in the save file from Box 1 to Box 18. The offset starts at 0x0C104 for the first big block and 0x4C104 for the second big block. Each PC stored Pokémon is 136 bytes in size.

[[Category:Structures]]
[[Category:Game Mechanics]]

Pokemon Save Structure

2009-07-09T04:56:57Z

Jiggy-Ninja: /* Block B */

Pokémon in the games Pokémon [[Pokémon Diamond|Diamond]], [[Pokemon Pearl|Pearl]], and [[Pokémon Platinum Version|Platinum]] are stored in a 136 byte or 236 byte structures. All unencrypted values are stored in [[little-endian|little-endian]] format. The game encrypts the data when it is stored in the [[Pokémon NDS Save File Structure|save file]]. Party Pokémon have additional values to hold current battle stats and conditions. The information below describes the Pokémon data format.

== Checksum ==

The checksum serves two purposes:
# It validates the data after decryption, and
# It serves as the encryption key for the data.

The checksum is calculated in three steps:
# Split the unencrypted data from offsets 0x08 to 0x87 into two-byte words,
# Take the sum of the words, and
# Truncate the sum to 16 bits.

== Block Shuffling ==

The 128 bytes of Pokémon data are split into four 32-byte blocks for shuffling. The blocks are shuffled according to a shift value derived from the [[personality value]]. Given the personality value ''pv'', the expression yielding the shift value is:
: ''((pv >> 0xD) & 0x1F) % 24''
The right shifting (pv >> 0xD) is equivalent to a division of 8192.

To shuffle the blocks, take the four blocks of unencrypted data, ''A'', ''B'', ''C'', and ''D''. The blocks shall be rearranged in the encrypted data according to this table:

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Shift Value (decimal)
! Block Order
|- style="background: #eee;" align="center"
| 00
| ABCD
|- style="background: #ddd;" align="center"
| 01
| ABDC
|- style="background: #eee;" align="center"
| 02
| ACBD
|- style="background: #ddd;" align="center"
| 03
| ACDB
|- style="background: #eee;" align="center"
| 04
| ADBC
|- style="background: #ddd;" align="center"
| 05
| ADCB
|- style="background: #eee;" align="center"
| 06
| BACD
|- style="background: #ddd;" align="center"
| 07
| BADC
|- style="background: #eee;" align="center"
| 08
| BCAD
|- style="background: #ddd;" align="center"
| 09
| BCDA
|- style="background: #eee;" align="center"
| 10
| BDAC
|- style="background: #ddd;" align="center"
| 11
| BDCA
|- style="background: #eee;" align="center"
| 12
| CABD
|- style="background: #ddd;" align="center"
| 13
| CADB
|- style="background: #eee;" align="center"
| 14
| CBAD
|- style="background: #ddd;" align="center"
| 15
| CBDA
|- style="background: #eee;" align="center"
| 16
| CDAB
|- style="background: #ddd;" align="center"
| 17
| CDBA
|- style="background: #eee;" align="center"
| 18
| DABC
|- style="background: #ddd;" align="center"
| 19
| DACB
|- style="background: #eee;" align="center"
| 20
| DBAC
|- style="background: #ddd;" align="center"
| 21
| DBCA
|- style="background: #eee;" align="center"
| 22
| DCAB
|- style="background: #ddd;" align="center"
| 23
| DCBA
|}

== Encryption ==

The encryption uses the [http://projectpokemon.org/wiki/PRNG_in_Pok%C3%A9mon pseudorandom number generator (PRNG)], a linear congruential generator. Elements of the PRNG can be described with the recursive function:
: ''X[n+1] = (0x41C64E6D * X[n] + 0x6073)''

To decrypt the data, given a function ''rand()'' which returns the upper 16 bits of consecutive results of the above given function:
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum).
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''
# Unshuffle the blocks using the block shuffling algorithm above.

To encrypt the data:
# Shuffle the blocks using the block shuffling algorithm above.
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum),
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''

== Unencrypted bytes ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x00-0x03
| [[Personality value]]
|- style="background: #ddd;" align="center"
| 0x04-0x05
| ''Unused''
|- style="background: #eee;" align="center"
| 0x06-0x07
| Checksum
|}

== Encrypted bytes ==
=== Block A ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x08-0x09
| [[Pokedex|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
| Friendship (Steps to Hatch if an egg)
|- style="background: #eee;" align="center"
| 0x15
| [[Ability]]
|- style="background: #ddd;" align="center"
| 0x16
| [[#Markings|Markings]]
|- style="background: #eee;" align="center"
| 0x17
| [[#Original Language|Original Language]]

|- style="background: #ddd;" align="center"
| 0x18
| [[Effort Values#Hit Points|HP Effort Value]]
|- style="background: #eee;" align="center"
| 0x19
| [[Effort Values#Attack Points|Attack Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1A
| [[Effort Values#Defense Points|Defense Effort Value]]
|- style="background: #eee;" align="center"
| 0x1B
| [[Effort Values#Speed Points|Speed Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1C
| [[Effort Values#Special Attack Points|SP Attack Effort Value]]
|- style="background: #eee;" align="center"
| 0x1D
| [[Effort Values#Special Defense Points|SP Defense Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1E
| [[Contest Stats#Cool|Cool Contest Value]]
|- style="background: #eee;" align="center"
| 0x1F
| [[Contest Stats#Beauty|Beauty Contest Value]]

|- style="background: #ddd;" align="center"
| 0x20
| [[Contest Stats#Cute|Cute Contest Value]]
|- style="background: #eee;" align="center"
| 0x21
| [[Contest Stats#Smart|Smart Contest Value]]

|- style="background: #ddd;" align="center"
| 0x22
| [[Contest Stats#Tough|Tough Contest Value]]
|- style="background: #eee;" align="center"
| 0x23
| [[Contest Stats#Sheen|Sheen Contest Value]]

|- style="background: #ddd;" align="center"
| 0x24-0x25
| [[#Sinnoh Ribbon Set 1|Sinnoh Ribbon Set 1]]
|- style="background: #eee;" align="center"
| 0x26-0x27
| [[#Sinnoh Ribbon Set 2|Sinnoh Ribbon Set 2]]
|}

=== Block B ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x28-0x29
| [[Pokemon Moves|Move 1 ID]]
|- style="background: #ddd;" align="center"
| 0x2A-0x2B
| [[Pokemon Moves|Move 2 ID]]
|- style="background: #eee;" align="center"
| 0x2C-0x2D
| [[Pokemon Moves|Move 3 ID]]
|- style="background: #ddd;" align="center"
| 0x2E-0x2F
| [[Pokemon Moves|Move 4 ID]]
|- style="background: #eee;" align="center"
| 0x30
| [[Pokemon Moves#Power Points|Move 1 Current PP]]
|- style="background: #ddd;" align="center"
| 0x31
| [[Pokemon Moves#Power Points|Move 2 Current PP]]
|- style="background: #eee;" align="center"
| 0x32
| [[Pokemon Moves#Power Points|Move 3 Current PP]]
|- style="background: #ddd;" align="center"
| 0x33
| [[Pokemon Moves#Power Points|Move 4 Current PP]]
|- style="background: #eee;" align="center"
| 0x34-0x37
| [[Pokemon Moves#Power Points|Move PP Ups]]
|- style="background: #ddd;" align="center"
| 0x38-0x3B
| Bits 0-29 - [[Individual Values]] 
[[Individual Values#Hit Points|HP]] ( [0-31] >> 0 ) 
[[Individual Values#Attack Points|Attack]] ( [0-31] >> 5 ) 
[[Individual Values#Defense Points|Defense]] ( [0-31] >> 10 ) 
[[Individual Values#Speed Points|Speed]] ( [0-31] >> 15 ) 
[[Individual Values#Special Attack Points|SP Attack]] ( [0-31] >> 20 ) 
[[Individual Values#Special Defense Points|SP Defense]] ( [0-31] >> 25 ) 
Bit 30 - IsEgg Flag Bit 31 - IsNicknamed Flag
|- style="background: #eee;" align="center"
| 0x3C-0x3D
| [[#Hoenn Ribbon Set 1|Hoenn Ribbon Set 1]]
|- style="background: #ddd;" align="center"
| 0x3E-0x3F
| [[#Hoenn Ribbon Set 2|Hoenn Ribbon Set 2]]
|- style="background: #eee;" align="center"
| 0x40-0x41
| Bit 0 - Fateful Encounter Flag Bit 1 - Female Bit 2 - Genderless Bit 3-15 - [[#Alternate Forms|Alternate Forms]]
|- style="background: #ddd;" align="center"
| 0x42-0x43
| ''Unused''
|- style="background: #eee;" align="center"
| 0x44-0x45
| Egg [[Pokemon NDS Locations#Egg Locations|Location]] (Platinum)
|- style="background: #ddd;" align="center"
| 0x46-0x47
| Met at [[Pokemon NDS Locations|Location]] (Platinum)
|}

=== Block C ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x48-0x5D
| Nickname
|- style="background: #ddd;" align="center"
| 0x5E
| ''Unused''
|- style="background: #eee;" align="center"
| 0x5F
| [[Pokemon Hometown|Hometown]]
|- style="background: #ddd;" align="center"
| 0x60-0x61
| [[#Sinnoh Ribbon Set 3|Sinnoh Ribbon Set 3]]
|- style="background: #eee;" align="center"
| 0x62-0x63
| [[#Sinnoh Ribbon Set 4|Sinnoh Ribbon Set 4]]
|- style="background: #ddd;" align="center"
| 0x64-0x67
| ''Unused''
|}

=== Block D ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x68-0x77
| [[Original Trainer|OT Name]]
|- style="background: #ddd;" align="center"
| 0x78-0x7A
| Date Egg Received
|- style="background: #eee;" align="center"
| 0x7B-0x7D
| Date Met
|- style="background: #ddd;" align="center"
| 0x7E-0x7F
| Egg [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #eee;" align="center"
| 0x80-0x81
| Met At [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #ddd;" align="center"
| 0x82
| [[Pokerus|Pokérus]]
|- style="background: #eee;" align="center"
| 0x83
| [http://projectpokemon.org/wiki/Item_index#Balls Poké Ball]
|- style="background: #ddd;" align="center"
| 0x84
| Bit 0-6 - Met At Level Bit 7 - Female OT Gender
|- style="background: #eee;" align="center"
| 0x85
| [[#Encounter Types|Encounter Type]]
|- style="background: #ddd;" align="center"
| 0x86-0x87
| ''Unused''
|}

== Battle Stats ==

The battle stats are encrypted in the same manner, however the seed is not the checksum, it is 0.

=== Encrypted Bytes ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x88
| Bits 0-2 - Asleep (0-7 rounds) Bit 3 - Poisoned Bit 4 - Burned Bit 5 - Frozen Bit 6 - Paralyzed Bit 7 - Toxic
|- style="background: #ddd;" align="center"
| 0x89
| ''Unknown'' - Flags - Max Value 0xF0
|- style="background: #eee;" align="center"
| 0x8A-0x8B
| ''Unknown''
|- style="background: #ddd;" align="center"
| 0x8C
| Level
|- style="background: #eee;" align="center"
| 0x8D
| Capsule Index (Seals)
|- style="background: #ddd;" align="center"
| 0x8E-0x8F
| Current HP
|- style="background: #eee;" align="center"
| 0x90-0x91
| Max HP
|- style="background: #ddd;" align="center"
| 0x92-0x93
| Attack
|- style="background: #eee;" align="center"
| 0x94-0x95
| Defense
|- style="background: #ddd;" align="center"
| 0x96-0x97
| Speed
|- style="background: #eee;" align="center"
| 0x98-0x99
| Special Attack
|- style="background: #ddd;" align="center"
| 0x9A-0x9B
| Special Defense
|- style="background: #eee;" align="center"
| 0x9C-0xD3
| ''Unknown'' - Contains Trash Data
|- style="background: #ddd;" align="center"
| 0xD4-0xEB
| Seal Coordinates
|}

== 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
|}

== Alternate Forms ==
Alternate forms are stored at offset 0x40 of the Pokemon structure. Each form follows the pattern of ''index << 3'' where index starts at zero for the main form.

=== Unown's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| A
| 0x38
| H
| 0x70
| O
| 0xA8
| V
|- style="background: #ddd;" align="center"
| 0x08
| B
| 0x40
| I
| 0x78
| P
| 0xB0
| W
|- style="background: #eee;" align="center"
| 0x10
| C
| 0x48
| J
| 0x80
| Q
| 0xB8
| X
|- style="background: #ddd;" align="center"
| 0x18
| D
| 0x50
| K
| 0x88
| R
| 0xC0
| Y
|- style="background: #eee;" align="center"
| 0x20
| E
| 0x58
| L
| 0x90
| S
| 0xC8
| Z
|- style="background: #ddd;" align="center"
| 0x28
| F
| 0x60
| M
| 0x98
| T
| 0xD0
| !
|- style="background: #eee;" align="center"
| 0x30
| G
| 0x68
| N
| 0xA0
| U
| 0xD8
| ?
|}

=== Deoxy's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Attack
|- style="background: #eee;" align="center"
| 0x10
| Defense
|- style="background: #ddd;" align="center"
| 0x18
| Speed
|}

=== Burmy's & Wormadam's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Plant
|- style="background: #ddd;" align="center"
| 0x08
| Sandy
|- style="background: #eee;" align="center"
| 0x10
| Trash
|}

=== Shellos' & Gastrodon's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| West
|- style="background: #ddd;" align="center"
| 0x08
| East
|}

=== Rotom's Forms ===
Rotom's alternate forms will only be displayed in Pokemon Platinum. Rotom may be traded between Diamond, Pearl, and Platinum without losing the alternate form.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Heat
|- style="background: #eee;" align="center"
| 0x10
| Wash
|- style="background: #ddd;" align="center"
| 0x18
| Frost
|- style="background: #eee;" align="center"
| 0x20
| Fan
|- style="background: #ddd;" align="center"
| 0x28
| Cut
|}

=== Giratina's Forms ===
Giratina's Origin form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Altered
|- style="background: #ddd;" align="center"
| 0x08
| Origin
|}

=== Shaymin's Forms ===
Shaymin's Sky form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Land
|- style="background: #ddd;" align="center"
| 0x08
| Sky
|}

=== Arceus' Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
| 0x30
| Insect
| 0x60
| Zap
|- style="background: #ddd;" align="center"
| 0x08
| Fist
| 0x38
| Spooky
| 0x68
| Mind
|- style="background: #eee;" align="center"
| 0x10
| Sky
| 0x40
| Iron
| 0x70
| Icicle
|- style="background: #ddd;" align="center"
| 0x18
| Toxic
| 0x48
| Flame
| 0x78
| Draco
|- style="background: #eee;" align="center"
| 0x20
| Earth
| 0x50
| Splash
| 0x80
| Dread
|- style="background: #ddd;" align="center"
| 0x28
| Stone
| 0x58
| Meadow
|}

== Encounter Types ==
{| 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)
|}

== Ribbons ==
Diamond, Pearl, and Platinum store the ribbon information as [[Bitfields|bitfields]] in 1-byte words. Given below are the bytewise representation of the ribbon bitfields.

=== Sinnoh Ribbon Set 1 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x01
| Sinnoh Champ Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x02
| Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x04
| Great Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x08
| Double Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x10
| Multi Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x20
| Pair Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x40
| World Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x80
| Alert Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x01
| Shock Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x02
| Downcast Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x04
| Careless Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x08
| Relax Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x10
| Snooze Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x20
| Smile Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x40
| Gorgeous Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x80
| Royal Ribbon
|}

=== Sinnoh Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x01
| Gorgeous Royal Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x02
| Footprint Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x04
| Record Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x08
| History Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x10
| Legend Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x20
| Red Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x40
| Green Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x80
| Blue Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x01
| Festival Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x02
| Carnival Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x04
| Classic Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x08
| Premier Ribbon
|}

=== Sinnoh Ribbon Set 3 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x60 & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x02
| Cool Ribbon Great
|- style="background: #eee;" align="center"
| 0x60 & 0x04
| Cool Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x60 & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x60 & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x20
| Beauty Ribbon Great
|- style="background: #eee;" align="center"
| 0x60 & 0x40
| Beauty Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x60 & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x02
| Cute Ribbon Great
|- style="background: #eee;" align="center"
| 0x61 & 0x04
| Cute Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x61 & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x20
| Smart Ribbon Great
|- style="background: #eee;" align="center"
| 0x61 & 0x40
| Smart Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x61 & 0x80
| Smart Ribbon Master
|}

=== Sinnoh Ribbon Set 4 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x62 & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x62 & 0x02
| Tough Ribbon Great
|- style="background: #eee;" align="center"
| 0x62 & 0x04
| Tough Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x62 & 0x08
| Tough Ribbon Master
|}

=== Hoenn Ribbon Set 1 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3C & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x02
| Cool Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x04
| Cool Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x3C & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x20
| Beauty Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x40
| Beauty Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x02
| Cute Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x04
| Cute Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x20
| Smart Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x40
| Smart Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x80
| Smart Ribbon Master
|}

=== Hoenn Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x02
| Tough Ribbon Super
|- style="background: #eee;" align="center"
| 0x3F & 0x04
| Tough Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3F & 0x08
| Tough Ribbon Master
|- style="background: #eee;" align="center"
| 0x3F & 0x10
| Champion Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x20
| Winning Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x40
| Victory Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x80
| Artist Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x01
| Effort Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x02
| Marine Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x04
| Land Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x08
| Sky Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x10
| Country Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x20
| National Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x40
| Earth Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x80
| World Ribbon
|}

== Save File Location ==
The party Pokémon are stored in the [[Pokémon NDS Save File Structure|save file]] beginning at offset 0x00098 for the first small block, and 0x40098 for the second small block.

In the first small save block, the first Daycare Pokémon is located at 0x0141C, and the second is located at 0x01508. In the second small block, the first Daycare Pokémon is located at 0x4141C, and the second is located at 0x41508.

In the first small save block, the Pal Park Pokémon are stored beginning at 0x0BA28. In the second small save block, the Pal Park Pokémon are stored beginning at 0x4BA28.

Each party, Daycare, and Pal Park Pokémon is 236 bytes in size.

The PC storage Pokémon are stored in the save file from Box 1 to Box 18. The offset starts at 0x0C104 for the first big block and 0x4C104 for the second big block. Each PC stored Pokémon is 136 bytes in size.

[[Category:Structures]]
[[Category:Game Mechanics]]

Pokemon Save Structure

2009-07-09T04:55:43Z

Jiggy-Ninja: /* Block B */

Pokémon in the games Pokémon [[Pokémon Diamond|Diamond]], [[Pokemon Pearl|Pearl]], and [[Pokémon Platinum Version|Platinum]] are stored in a 136 byte or 236 byte structures. All unencrypted values are stored in [[little-endian|little-endian]] format. The game encrypts the data when it is stored in the [[Pokémon NDS Save File Structure|save file]]. Party Pokémon have additional values to hold current battle stats and conditions. The information below describes the Pokémon data format.

== Checksum ==

The checksum serves two purposes:
# It validates the data after decryption, and
# It serves as the encryption key for the data.

The checksum is calculated in three steps:
# Split the unencrypted data from offsets 0x08 to 0x87 into two-byte words,
# Take the sum of the words, and
# Truncate the sum to 16 bits.

== Block Shuffling ==

The 128 bytes of Pokémon data are split into four 32-byte blocks for shuffling. The blocks are shuffled according to a shift value derived from the [[personality value]]. Given the personality value ''pv'', the expression yielding the shift value is:
: ''((pv >> 0xD) & 0x1F) % 24''
The right shifting (pv >> 0xD) is equivalent to a division of 8192.

To shuffle the blocks, take the four blocks of unencrypted data, ''A'', ''B'', ''C'', and ''D''. The blocks shall be rearranged in the encrypted data according to this table:

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Shift Value (decimal)
! Block Order
|- style="background: #eee;" align="center"
| 00
| ABCD
|- style="background: #ddd;" align="center"
| 01
| ABDC
|- style="background: #eee;" align="center"
| 02
| ACBD
|- style="background: #ddd;" align="center"
| 03
| ACDB
|- style="background: #eee;" align="center"
| 04
| ADBC
|- style="background: #ddd;" align="center"
| 05
| ADCB
|- style="background: #eee;" align="center"
| 06
| BACD
|- style="background: #ddd;" align="center"
| 07
| BADC
|- style="background: #eee;" align="center"
| 08
| BCAD
|- style="background: #ddd;" align="center"
| 09
| BCDA
|- style="background: #eee;" align="center"
| 10
| BDAC
|- style="background: #ddd;" align="center"
| 11
| BDCA
|- style="background: #eee;" align="center"
| 12
| CABD
|- style="background: #ddd;" align="center"
| 13
| CADB
|- style="background: #eee;" align="center"
| 14
| CBAD
|- style="background: #ddd;" align="center"
| 15
| CBDA
|- style="background: #eee;" align="center"
| 16
| CDAB
|- style="background: #ddd;" align="center"
| 17
| CDBA
|- style="background: #eee;" align="center"
| 18
| DABC
|- style="background: #ddd;" align="center"
| 19
| DACB
|- style="background: #eee;" align="center"
| 20
| DBAC
|- style="background: #ddd;" align="center"
| 21
| DBCA
|- style="background: #eee;" align="center"
| 22
| DCAB
|- style="background: #ddd;" align="center"
| 23
| DCBA
|}

== Encryption ==

The encryption uses the [http://projectpokemon.org/wiki/PRNG_in_Pok%C3%A9mon pseudorandom number generator (PRNG)], a linear congruential generator. Elements of the PRNG can be described with the recursive function:
: ''X[n+1] = (0x41C64E6D * X[n] + 0x6073)''

To decrypt the data, given a function ''rand()'' which returns the upper 16 bits of consecutive results of the above given function:
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum).
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''
# Unshuffle the blocks using the block shuffling algorithm above.

To encrypt the data:
# Shuffle the blocks using the block shuffling algorithm above.
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum),
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''

== Unencrypted bytes ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x00-0x03
| [[Personality value]]
|- style="background: #ddd;" align="center"
| 0x04-0x05
| ''Unused''
|- style="background: #eee;" align="center"
| 0x06-0x07
| Checksum
|}

== Encrypted bytes ==
=== Block A ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x08-0x09
| [[Pokedex|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
| Friendship (Steps to Hatch if an egg)
|- style="background: #eee;" align="center"
| 0x15
| [[Ability]]
|- style="background: #ddd;" align="center"
| 0x16
| [[#Markings|Markings]]
|- style="background: #eee;" align="center"
| 0x17
| [[#Original Language|Original Language]]

|- style="background: #ddd;" align="center"
| 0x18
| [[Effort Values#Hit Points|HP Effort Value]]
|- style="background: #eee;" align="center"
| 0x19
| [[Effort Values#Attack Points|Attack Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1A
| [[Effort Values#Defense Points|Defense Effort Value]]
|- style="background: #eee;" align="center"
| 0x1B
| [[Effort Values#Speed Points|Speed Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1C
| [[Effort Values#Special Attack Points|SP Attack Effort Value]]
|- style="background: #eee;" align="center"
| 0x1D
| [[Effort Values#Special Defense Points|SP Defense Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1E
| [[Contest Stats#Cool|Cool Contest Value]]
|- style="background: #eee;" align="center"
| 0x1F
| [[Contest Stats#Beauty|Beauty Contest Value]]

|- style="background: #ddd;" align="center"
| 0x20
| [[Contest Stats#Cute|Cute Contest Value]]
|- style="background: #eee;" align="center"
| 0x21
| [[Contest Stats#Smart|Smart Contest Value]]

|- style="background: #ddd;" align="center"
| 0x22
| [[Contest Stats#Tough|Tough Contest Value]]
|- style="background: #eee;" align="center"
| 0x23
| [[Contest Stats#Sheen|Sheen Contest Value]]

|- style="background: #ddd;" align="center"
| 0x24-0x25
| [[#Sinnoh Ribbon Set 1|Sinnoh Ribbon Set 1]]
|- style="background: #eee;" align="center"
| 0x26-0x27
| [[#Sinnoh Ribbon Set 2|Sinnoh Ribbon Set 2]]
|}

=== Block B ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x28-0x29
| [[Pokemon Moves|Move 1 ID]]
|- style="background: #ddd;" align="center"
| 0x2A-0x2B
| [[Pokemon Moves|Move 2 ID]]
|- style="background: #eee;" align="center"
| 0x2C-0x2D
| [[Pokemon Moves|Move 3 ID]]
|- style="background: #ddd;" align="center"
| 0x2E-0x2F
| [[Pokemon Moves|Move 4 ID]]
|- style="background: #eee;" align="center"
| 0x30
| [[Pokemon Moves#Power Points|Move 1 Current PP]]
|- style="background: #ddd;" align="center"
| 0x31
| [[Pokemon Moves#Power Points|Move 2 Current PP]]
|- style="background: #eee;" align="center"
| 0x32
| [[Pokemon Moves#Power Points|Move 3 Current PP]]
|- style="background: #ddd;" align="center"
| 0x33
| [[Pokemon Moves#Power Points|Move 4 Current PP]]
|- style="background: #eee;" align="center"
| 0x34-0x37
| [[Pokemon Moves#Power Points|Move PP Ups]]
|- style="background: #ddd;" align="center"
| 0x38-0x3B
| Bits 0-29 - [[Individual Values]] 
[[Individual Values#Hit Points|HP]] ( [0-31] << 25 ) 
[[Individual Values#Attack Points|Attack]] ( [0-31] << 20 ) 
[[Individual Values#Defense Points|Defense]] ( [0-31] << 15 ) 
[[Individual Values#Speed Points|Speed]] ( [0-31] << 10 ) 
[[Individual Values#Special Attack Points|SP Attack]] ( [0-31] << 5 ) 
[[Individual Values#Special Defense Points|SP Defense]] ( [0-31] << 0 ) 
Bit 30 - IsEgg Flag Bit 31 - IsNicknamed Flag
|- style="background: #eee;" align="center"
| 0x3C-0x3D
| [[#Hoenn Ribbon Set 1|Hoenn Ribbon Set 1]]
|- style="background: #ddd;" align="center"
| 0x3E-0x3F
| [[#Hoenn Ribbon Set 2|Hoenn Ribbon Set 2]]
|- style="background: #eee;" align="center"
| 0x40-0x41
| Bit 0 - Fateful Encounter Flag Bit 1 - Female Bit 2 - Genderless Bit 3-15 - [[#Alternate Forms|Alternate Forms]]
|- style="background: #ddd;" align="center"
| 0x42-0x43
| ''Unused''
|- style="background: #eee;" align="center"
| 0x44-0x45
| Egg [[Pokemon NDS Locations#Egg Locations|Location]] (Platinum)
|- style="background: #ddd;" align="center"
| 0x46-0x47
| Met at [[Pokemon NDS Locations|Location]] (Platinum)
|}

=== Block C ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x48-0x5D
| Nickname
|- style="background: #ddd;" align="center"
| 0x5E
| ''Unused''
|- style="background: #eee;" align="center"
| 0x5F
| [[Pokemon Hometown|Hometown]]
|- style="background: #ddd;" align="center"
| 0x60-0x61
| [[#Sinnoh Ribbon Set 3|Sinnoh Ribbon Set 3]]
|- style="background: #eee;" align="center"
| 0x62-0x63
| [[#Sinnoh Ribbon Set 4|Sinnoh Ribbon Set 4]]
|- style="background: #ddd;" align="center"
| 0x64-0x67
| ''Unused''
|}

=== Block D ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x68-0x77
| [[Original Trainer|OT Name]]
|- style="background: #ddd;" align="center"
| 0x78-0x7A
| Date Egg Received
|- style="background: #eee;" align="center"
| 0x7B-0x7D
| Date Met
|- style="background: #ddd;" align="center"
| 0x7E-0x7F
| Egg [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #eee;" align="center"
| 0x80-0x81
| Met At [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #ddd;" align="center"
| 0x82
| [[Pokerus|Pokérus]]
|- style="background: #eee;" align="center"
| 0x83
| [http://projectpokemon.org/wiki/Item_index#Balls Poké Ball]
|- style="background: #ddd;" align="center"
| 0x84
| Bit 0-6 - Met At Level Bit 7 - Female OT Gender
|- style="background: #eee;" align="center"
| 0x85
| [[#Encounter Types|Encounter Type]]
|- style="background: #ddd;" align="center"
| 0x86-0x87
| ''Unused''
|}

== Battle Stats ==

The battle stats are encrypted in the same manner, however the seed is not the checksum, it is 0.

=== Encrypted Bytes ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x88
| Bits 0-2 - Asleep (0-7 rounds) Bit 3 - Poisoned Bit 4 - Burned Bit 5 - Frozen Bit 6 - Paralyzed Bit 7 - Toxic
|- style="background: #ddd;" align="center"
| 0x89
| ''Unknown'' - Flags - Max Value 0xF0
|- style="background: #eee;" align="center"
| 0x8A-0x8B
| ''Unknown''
|- style="background: #ddd;" align="center"
| 0x8C
| Level
|- style="background: #eee;" align="center"
| 0x8D
| Capsule Index (Seals)
|- style="background: #ddd;" align="center"
| 0x8E-0x8F
| Current HP
|- style="background: #eee;" align="center"
| 0x90-0x91
| Max HP
|- style="background: #ddd;" align="center"
| 0x92-0x93
| Attack
|- style="background: #eee;" align="center"
| 0x94-0x95
| Defense
|- style="background: #ddd;" align="center"
| 0x96-0x97
| Speed
|- style="background: #eee;" align="center"
| 0x98-0x99
| Special Attack
|- style="background: #ddd;" align="center"
| 0x9A-0x9B
| Special Defense
|- style="background: #eee;" align="center"
| 0x9C-0xD3
| ''Unknown'' - Contains Trash Data
|- style="background: #ddd;" align="center"
| 0xD4-0xEB
| Seal Coordinates
|}

== 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
|}

== Alternate Forms ==
Alternate forms are stored at offset 0x40 of the Pokemon structure. Each form follows the pattern of ''index << 3'' where index starts at zero for the main form.

=== Unown's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| A
| 0x38
| H
| 0x70
| O
| 0xA8
| V
|- style="background: #ddd;" align="center"
| 0x08
| B
| 0x40
| I
| 0x78
| P
| 0xB0
| W
|- style="background: #eee;" align="center"
| 0x10
| C
| 0x48
| J
| 0x80
| Q
| 0xB8
| X
|- style="background: #ddd;" align="center"
| 0x18
| D
| 0x50
| K
| 0x88
| R
| 0xC0
| Y
|- style="background: #eee;" align="center"
| 0x20
| E
| 0x58
| L
| 0x90
| S
| 0xC8
| Z
|- style="background: #ddd;" align="center"
| 0x28
| F
| 0x60
| M
| 0x98
| T
| 0xD0
| !
|- style="background: #eee;" align="center"
| 0x30
| G
| 0x68
| N
| 0xA0
| U
| 0xD8
| ?
|}

=== Deoxy's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Attack
|- style="background: #eee;" align="center"
| 0x10
| Defense
|- style="background: #ddd;" align="center"
| 0x18
| Speed
|}

=== Burmy's & Wormadam's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Plant
|- style="background: #ddd;" align="center"
| 0x08
| Sandy
|- style="background: #eee;" align="center"
| 0x10
| Trash
|}

=== Shellos' & Gastrodon's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| West
|- style="background: #ddd;" align="center"
| 0x08
| East
|}

=== Rotom's Forms ===
Rotom's alternate forms will only be displayed in Pokemon Platinum. Rotom may be traded between Diamond, Pearl, and Platinum without losing the alternate form.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Heat
|- style="background: #eee;" align="center"
| 0x10
| Wash
|- style="background: #ddd;" align="center"
| 0x18
| Frost
|- style="background: #eee;" align="center"
| 0x20
| Fan
|- style="background: #ddd;" align="center"
| 0x28
| Cut
|}

=== Giratina's Forms ===
Giratina's Origin form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Altered
|- style="background: #ddd;" align="center"
| 0x08
| Origin
|}

=== Shaymin's Forms ===
Shaymin's Sky form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Land
|- style="background: #ddd;" align="center"
| 0x08
| Sky
|}

=== Arceus' Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
| 0x30
| Insect
| 0x60
| Zap
|- style="background: #ddd;" align="center"
| 0x08
| Fist
| 0x38
| Spooky
| 0x68
| Mind
|- style="background: #eee;" align="center"
| 0x10
| Sky
| 0x40
| Iron
| 0x70
| Icicle
|- style="background: #ddd;" align="center"
| 0x18
| Toxic
| 0x48
| Flame
| 0x78
| Draco
|- style="background: #eee;" align="center"
| 0x20
| Earth
| 0x50
| Splash
| 0x80
| Dread
|- style="background: #ddd;" align="center"
| 0x28
| Stone
| 0x58
| Meadow
|}

== Encounter Types ==
{| 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)
|}

== Ribbons ==
Diamond, Pearl, and Platinum store the ribbon information as [[Bitfields|bitfields]] in 1-byte words. Given below are the bytewise representation of the ribbon bitfields.

=== Sinnoh Ribbon Set 1 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x01
| Sinnoh Champ Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x02
| Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x04
| Great Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x08
| Double Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x10
| Multi Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x20
| Pair Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x40
| World Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x80
| Alert Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x01
| Shock Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x02
| Downcast Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x04
| Careless Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x08
| Relax Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x10
| Snooze Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x20
| Smile Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x40
| Gorgeous Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x80
| Royal Ribbon
|}

=== Sinnoh Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x01
| Gorgeous Royal Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x02
| Footprint Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x04
| Record Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x08
| History Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x10
| Legend Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x20
| Red Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x40
| Green Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x80
| Blue Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x01
| Festival Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x02
| Carnival Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x04
| Classic Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x08
| Premier Ribbon
|}

=== Sinnoh Ribbon Set 3 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x60 & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x02
| Cool Ribbon Great
|- style="background: #eee;" align="center"
| 0x60 & 0x04
| Cool Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x60 & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x60 & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x20
| Beauty Ribbon Great
|- style="background: #eee;" align="center"
| 0x60 & 0x40
| Beauty Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x60 & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x02
| Cute Ribbon Great
|- style="background: #eee;" align="center"
| 0x61 & 0x04
| Cute Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x61 & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x20
| Smart Ribbon Great
|- style="background: #eee;" align="center"
| 0x61 & 0x40
| Smart Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x61 & 0x80
| Smart Ribbon Master
|}

=== Sinnoh Ribbon Set 4 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x62 & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x62 & 0x02
| Tough Ribbon Great
|- style="background: #eee;" align="center"
| 0x62 & 0x04
| Tough Ribbon Ultra
|- style="background: #ddd;" align="center"
| 0x62 & 0x08
| Tough Ribbon Master
|}

=== Hoenn Ribbon Set 1 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3C & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x02
| Cool Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x04
| Cool Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x3C & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x20
| Beauty Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x40
| Beauty Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x02
| Cute Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x04
| Cute Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x20
| Smart Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x40
| Smart Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x80
| Smart Ribbon Master
|}

=== Hoenn Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x02
| Tough Ribbon Super
|- style="background: #eee;" align="center"
| 0x3F & 0x04
| Tough Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3F & 0x08
| Tough Ribbon Master
|- style="background: #eee;" align="center"
| 0x3F & 0x10
| Champion Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x20
| Winning Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x40
| Victory Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x80
| Artist Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x01
| Effort Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x02
| Marine Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x04
| Land Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x08
| Sky Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x10
| Country Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x20
| National Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x40
| Earth Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x80
| World Ribbon
|}

== Save File Location ==
The party Pokémon are stored in the [[Pokémon NDS Save File Structure|save file]] beginning at offset 0x00098 for the first small block, and 0x40098 for the second small block.

In the first small save block, the first Daycare Pokémon is located at 0x0141C, and the second is located at 0x01508. In the second small block, the first Daycare Pokémon is located at 0x4141C, and the second is located at 0x41508.

In the first small save block, the Pal Park Pokémon are stored beginning at 0x0BA28. In the second small save block, the Pal Park Pokémon are stored beginning at 0x4BA28.

Each party, Daycare, and Pal Park Pokémon is 236 bytes in size.

The PC storage Pokémon are stored in the save file from Box 1 to Box 18. The offset starts at 0x0C104 for the first big block and 0x4C104 for the second big block. Each PC stored Pokémon is 136 bytes in size.

[[Category:Structures]]
[[Category:Game Mechanics]]

Pokémon DP Save File Structure

2009-05-19T16:25:33Z

Jiggy-Ninja: /* Small block offsets */

== General Save File Structure ==

A Pokémon Diamond and Pearl save file is divided into two pairs of blocks. Each pair consists of one general block, one storage box block, and one hall of fame block. The storage box block contains current information regarding [[Bebe|Bebe's]] storage system, including stored Pokémon, box names, box wallpapers, and the current open box. The general block contains current information on every other aspect of the game's progress, such as the trainer's name, ID number, acquired badges, party Pokémon, items, and much more. The hall of fame block contains information about the Pokémon used to defeat the Elite 4. The other pair is a backup from the previous save.

The first general block in the file begins at 0x00000. The first storage block begins at 0x0C100. The first hall of fame block starts at 0x20000. The second general, storage, and hall of fame blocks are at the same address + 0x40000. The current blocks are not always stored in linear order in the save file (i.e. if the second general block is the more current, the first or second storage box block can possibly be the current as well).

== Block Footers ==

The last 20 bytes of each general and storage box block is a footer. The last 24 bytes of each hall of fame block is a footer. The footer is used to determine:

* The size of the block
* Whether the block is current or a backup.
* Which big & small blocks link together.

===General/Storage Box Footer===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Purpose
|- style="background: #eee;" align="center"
| 0x00 - 0x03
| Save ID number
|- style="background: #eee;" align="center"
| 0x04 - 0x07
| Save index number
|- style="background: #eee;" align="center"
| 0x08 - 0x0B
| Size of block
|- style="background: #eee;" align="center"
| 0x0C - 0x0F
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x10 - 0x11
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x12 - 0x13
| [[Pokémon NDS Save File Checksum|Checksum]]
|}

===Hall of Fame Footer===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Purpose
|- style="background: #eee;" align="center"
| 0x00 - 0x03
| Save ID number
|- style="background: #ddd;" align="center"
| 0x04 - 0x07
| Save index number
|- style="background: #eee;" align="center"
| 0x08 - 0x0B
| ''Run-time usage''
|- style="background: #ddd;" align="center"
| 0x0C - 0x0F
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x10 - 0x13
| Size of block
|- style="background: #ddd;" align="center"
| 0x14 - 0x15
| ''Run-time usage''
|- style="background: #eee;" align="center"
| 0x16 - 0x17
| [[Pokémon NDS Save File Checksum|Checksum]]
|}

== Loading/Saving A Save File ==

When the game loads the save file, it first compares the save index number of each small block. If the small block with the highest save index number has a correct checksum, then the game checks to see which big block has a matching ID number. If both big blocks have the same ID number as the small block, then the big block with the highest save index number is chosen. If the big block chosen by the save file has a correct checksum, then the game loads successfully. If the checksum is incorrect in either the small or big block, the game reverts to the other block pair. If either of their checksums are incorrect, then no data is loaded, and a new game must be started.

When the game saves data, the save index number is incremented + 1 from the current save index number, and the backup small block is overwritten with the new data.

If nothing in the big block has changed, then the save ID number in both blocks is retained. However, if changes have been made to the big block, then the backup big block is overwritten with the new data, and a new save ID number is generated, which is then written to the new small block. This is the reason why the game varies on how long it takes to save.

Thus, either small block can be linked with either big block, and the current pair is identified using the footer information.

==Small block offsets==

===Adventure Started - 0x34===
*Unsigned 32bit integer.
*Number of seconds since 1/1/2000 00:00:00

===Pokémon League Champ Date - 0x3C===
*Unsigned 32bit integer.
*Number of seconds since 1/1/2000 00:00:00

===Trainer Name - 0x64===
*8 unsigned 16bit integers.
*Each {{wplink|word_(computing)|word}} represents a character in the game's [[Pokémon NDS Character Table|character table]].

===Trainer ID - 0x74===
*Random unsigned 16bit integer
*The visible identification number of a trainer
*Determines ownership of Pokémon.

===Secret ID - 0x76===
*Random unsigned 16bit integer
* The hidden identification number of a trainer
*Determines ownership of Pokémon.
*Determines variation in the game.

===Money - 0x78===
*Unsigned 32bit integer.
*Limited to 0xF423F (999,999)

===Trainer Gender - 0x7C===
*0 if male, 1 if female.
*Determines ownership of Pokémon.

===Multiplayer Avatar - 0x7F===
*Unsigned 8bit integer.
*Determines the sprite seen by other players in a multiplayer environment such as the Union Room.
: 0x00 = None
: 0x03 = School Kid
: 0x05 = Bug Catcher
: 0x06 = Lass
: 0x07 = Battle Girl
: 0x0B = Ace Trainer Male
: 0x0D = Beauty
: 0x0E = Ace Trainer Female
: 0x0F = Roughneck
: 0x1F = Pop Idol
: 0x23 = Social
: 0x25 = Cowgirl
: 0x2A = Ruin Maniac
: 0x32 = Black Belt
: 0x3E = Rich Boy
: 0x3F = Lady
: 0x46 = Psychic

===Number of Current Party Pokémon - 0x94===
*Unsigned 8bit integer.

===Party Pokémon - 0x98===
The Pokémon in the trainer's party.
*6 blocks of 236byte structures
{{main|Pokemon NDS Structure}}

===Starter Pokémon - 0xDFC===
The [[Pokédex]] number of the starter chosen.
*Unsigned 16bit integer.

===Fly Locations - 0x1112===
*9byte bit field

===Berry Trees - 0x1E84===
*128 blocks of 14byte structures
*List of [[Berry Tree#Locations|Berry Tree locations]]
{{main|Berry Tree(Technical)|Berry Trees}}

===Rival's Name - 0x25A8===
*8 unsigned 16bit integers.
*Each {{wplink|word_(computing)|word}} represents a character in the game's [[Pokémon NDS Character Table|character table]].

===Capsules in PC - 0x6050===
*12 blocks of 24 bytes structures.

===Safari Zone Pokémon - 0x72D0===
*Unsigned 32bit integer result from the [[ARNG]].
*Four daily safari zone Pokémon
*''Indexn'' = ( ''ARNG'' >> ( ''n'' * 0x5 ) ) & 0x1F
*List of [[Safari Zone Pokémon#Pokémon list|Safari Zone Pokémon]]
*''Notes'': Both Safari Zone Pokémon and [[#Swarm Pokémon - 0x72D0|Swarm Pokémon]] have the same [[ARNG]] value.

===Swarm Pokémon - 0x72D4===
*Unsigned 32bit integer result from the [[ARNG]].
*One daily swarm Pokémon
*''Index'' = ''ARNG'' % 0x1C
*List of [[Swarm Pokémon#Pokémon list|Swarm Pokémon]]
*''Notes'': Both [[#Safari Zone Pokémon - 0x72D0|Safari Zone Pokémon]] and Swarm Pokémon have the same [[ARNG]] value.

===Daily Trophy Pokémon Today - 0x72DC===
*Unsigned 8bit integer
*First daily trophy garden Pokémon
*List of [[Daily Trophy Pokémon#Pokémon list|Daily Trophy Pokémon]]

===Daily Trophy Pokémon Yesterday - 0x72DE===
*Unsigned 8bit integer
*Second daily trophy garden Pokémon
*List of [[Daily Trophy Pokémon#Pokémon list|Daily Trophy Pokémon]]
*''Notes'': Yesterday's Pokémon can be caught after beating the [[Elite 4]] and receiving the [[National Pokédex upgrade]].

===Honey Trees - 0x72E4===
*21 blocks of 8byte structures
*List of [[Honey Tree#Locations|Honey Tree locations]]
{{main|Honey Tree(Technical)|Honey Trees}}

===Unknown Pokémon - 0x73E8===
One Pokémon
*1 block of 236byte structures
{{main|Pokemon NDS Structure}}

[[Category:Structures]]
[[Category:Game Mechanics]]

Pokemon Save Structure

2009-05-19T16:21:20Z

Jiggy-Ninja: /* Encrypted Bytes */

Pokémon in the games Pokémon [[Pokemon Diamond|Diamond]], [[Pokemon Pearl|Pearl]], and [[Pokemon Platinum|Platinum]] are stored in a 136 byte or 236 byte structures. All unencrypted values are stored in [[little-endian|little-endian]] format. The game encrypts the data when it is stored in the [[Pokemon NDS Save Structure|save file]]. Party Pokémon have additional values to hold current battle stats and conditions. The information below describes the Pokémon data format.

== Checksum ==

The checksum serves two purposes:
# It validates the data after decryption, and
# It serves as the encryption key for the data.

The checksum is calculated in three steps:
# Split the unencrypted data from offsets 0x08 to 0x87 into two-byte words,
# Take the sum of the words, and
# Truncate the sum to 16 bits.

== Block Shuffling ==

The 128 bytes of Pokémon data are split into four 32-byte blocks for shuffling. The blocks are shuffled according to a shift value derived from the [[personality value]]. Given the personality value ''pv'', the expression yielding the shift value is:
: ''((pv >> 0xD) & 0x1F) % 24''
The right shifting (pv >> 0xD) is equivalent to a division of 8192.

To shuffle the blocks, take the four blocks of unencrypted data, ''A'', ''B'', ''C'', and ''D''. The blocks shall be rearranged in the encrypted data according to this table:

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Shift Value (decimal)
! Block Order
|- style="background: #eee;" align="center"
| 00
| ABCD
|- style="background: #ddd;" align="center"
| 01
| ABDC
|- style="background: #eee;" align="center"
| 02
| ACBD
|- style="background: #ddd;" align="center"
| 03
| ACDB
|- style="background: #eee;" align="center"
| 04
| ADBC
|- style="background: #ddd;" align="center"
| 05
| ADCB
|- style="background: #eee;" align="center"
| 06
| BACD
|- style="background: #ddd;" align="center"
| 07
| BADC
|- style="background: #eee;" align="center"
| 08
| BCAD
|- style="background: #ddd;" align="center"
| 09
| BCDA
|- style="background: #eee;" align="center"
| 10
| BDAC
|- style="background: #ddd;" align="center"
| 11
| BDCA
|- style="background: #eee;" align="center"
| 12
| CABD
|- style="background: #ddd;" align="center"
| 13
| CADB
|- style="background: #eee;" align="center"
| 14
| CBAD
|- style="background: #ddd;" align="center"
| 15
| CBDA
|- style="background: #eee;" align="center"
| 16
| CDAB
|- style="background: #ddd;" align="center"
| 17
| CDBA
|- style="background: #eee;" align="center"
| 18
| DABC
|- style="background: #ddd;" align="center"
| 19
| DACB
|- style="background: #eee;" align="center"
| 20
| DBAC
|- style="background: #ddd;" align="center"
| 21
| DBCA
|- style="background: #eee;" align="center"
| 22
| DCAB
|- style="background: #ddd;" align="center"
| 23
| DCBA
|}

== Encryption ==

The encryption uses the pseudorandom number generator (PRNG), a linear congruential generator. Elements of the PRNG can be described with the recursive function:
: ''X[n+1] = (0x41C64E6D * X[n] + 0x6073)''

To decrypt the data, given a function ''rand()'' which returns the upper 16 bits of consecutive results of the above given function:
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum).
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''
# Unshuffle the blocks using the block shuffling algorithm above.

To encrypt the data:
# Shuffle the blocks using the block shuffling algorithm above.
# Seed the PRNG with the checksum (let ''X[n]'' be the checksum),
# Sequentially, for each 2-byte word ''Y'' from 0x08 to 0x87, apply the transformation: ''unencryptedByte = Y xor rand()''

== Unencrypted bytes ==
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x00-0x03
| [[Personality value]]
|- style="background: #ddd;" align="center"
| 0x04-0x05
| ''Unused''
|- style="background: #eee;" align="center"
| 0x06-0x07
| Checksum
|}

== Encrypted bytes ==
=== Block A ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x08-0x09
| [[PokeDex|National PokéDex ID]]
|- style="background: #ddd;" align="center"
| 0x0A-0x0B
| [[Pokemon Items|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
| Friendship (Steps to Hatch if an egg)
|- style="background: #eee;" align="center"
| 0x15
| [[Ability]]
|- style="background: #ddd;" align="center"
| 0x16
| [[#Markings|Markings]]
|- style="background: #eee;" align="center"
| 0x17
| [[#Original Language|Original Language]]

|- style="background: #ddd;" align="center"
| 0x18
| [[Effort Values#Hit Points|HP Effort Value]]
|- style="background: #eee;" align="center"
| 0x19
| [[Effort Values#Attack Points|Attack Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1A
| [[Effort Values#Defense Points|Defense Effort Value]]
|- style="background: #eee;" align="center"
| 0x1B
| [[Effort Values#Speed Points|Speed Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1C
| [[Effort Values#Special Attack Points|SP Attack Effort Value]]
|- style="background: #eee;" align="center"
| 0x1D
| [[Effort Values#Special Defense Points|SP Defense Effort Value]]

|- style="background: #ddd;" align="center"
| 0x1E
| [[Contest Stats#Cool|Cool Contest Value]]
|- style="background: #eee;" align="center"
| 0x1F
| [[Contest Stats#Beauty|Beauty Contest Value]]

|- style="background: #ddd;" align="center"
| 0x20
| [[Contest Stats#Cute|Cute Contest Value]]
|- style="background: #eee;" align="center"
| 0x21
| [[Contest Stats#Smart|Smart Contest Value]]

|- style="background: #ddd;" align="center"
| 0x22
| [[Contest Stats#Tough|Tough Contest Value]]
|- style="background: #eee;" align="center"
| 0x23
| [[Contest Stats#Sheen|Sheen Contest Value]]

|- style="background: #ddd;" align="center"
| 0x24-0x25
| [[#Sinnoh Ribbon Set 1|Sinnoh Ribbon Set 1]]
|- style="background: #eee;" align="center"
| 0x26-0x27
| [[#Sinnoh Ribbon Set 2|Sinnoh Ribbon Set 2]]
|}

=== Block B ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x28-0x29
| [[Pokemon Moves|Move 1 ID]]
|- style="background: #ddd;" align="center"
| 0x2A-0x2B
| [[Pokemon Moves|Move 2 ID]]
|- style="background: #eee;" align="center"
| 0x2C-0x2D
| [[Pokemon Moves|Move 3 ID]]
|- style="background: #ddd;" align="center"
| 0x2E-0x2F
| [[Pokemon Moves|Move 4 ID]]
|- style="background: #eee;" align="center"
| 0x30
| [[Pokemon Moves#Power Points|Move 1 Current PP]]
|- style="background: #ddd;" align="center"
| 0x31
| [[Pokemon Moves#Power Points|Move 2 Current PP]]
|- style="background: #eee;" align="center"
| 0x32
| [[Pokemon Moves#Power Points|Move 3 Current PP]]
|- style="background: #ddd;" align="center"
| 0x33
| [[Pokemon Moves#Power Points|Move 4 Current PP]]
|- style="background: #eee;" align="center"
| 0x34-0x37
| [[Pokemon Moves#Power Points|Move PP Ups]]
|- style="background: #ddd;" align="center"
| 0x38-0x3B
| Bit 0 - IsEgg Flag Bit 1 - IsNicknamed Flag
Bits 2-31 - [[Individual Values]] 
[[Individual Values#Hit Points|HP]] ( [0-31] << 25 ) 
[[Individual Values#Attack Points|Attack]] ( [0-31] << 20 ) 
[[Individual Values#Defense Points|Defense]] ( [0-31] << 15 ) 
[[Individual Values#Speed Points|Speed]] ( [0-31] << 10 ) 
[[Individual Values#Special Attack Points|SP Attack]] ( [0-31] << 5 ) 
[[Individual Values#Special Defense Points|SP Defense]] ( [0-31] << 0 ) 
|- style="background: #eee;" align="center"
| 0x3C-0x3D
| [[#Hoenn Ribbon Set 1|Hoenn Ribbon Set 1]]
|- style="background: #ddd;" align="center"
| 0x3E-0x3F
| [[#Hoenn Ribbon Set 2|Hoenn Ribbon Set 2]]
|- style="background: #eee;" align="center"
| 0x40-0x41
| Bit 0 - Fateful Encounter Flag Bit 1 - Female Bit 2 - Genderless Bit 3-15 - [[#Alternate Forms|Alternate Forms]]
|- style="background: #ddd;" align="center"
| 0x42-0x43
| ''Unused''
|- style="background: #eee;" align="center"
| 0x44-0x45
| Egg [[Pokemon NDS Locations#Egg Locations|Location]] (Platinum)
|- style="background: #ddd;" align="center"
| 0x46-0x47
| Met at [[Pokemon NDS Locations|Location]] (Platinum)
|}

=== Block C ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x48-0x5D
| Nickname
|- style="background: #ddd;" align="center"
| 0x5E
| ''Unused''
|- style="background: #eee;" align="center"
| 0x5F
| [[Pokemon Hometown|Hometown]]
|- style="background: #ddd;" align="center"
| 0x60-0x61
| [[#Sinnoh Ribbon Set 3|Sinnoh Ribbon Set 3]]
|- style="background: #eee;" align="center"
| 0x62-0x63
| [[#Sinnoh Ribbon Set 4|Sinnoh Ribbon Set 4]]
|- style="background: #ddd;" align="center"
| 0x64-0x67
| ''Unused''
|}

=== Block D ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x68-0x77
| [[Original Trainer|OT Name]]
|- style="background: #ddd;" align="center"
| 0x78-0x7A
| Date Egg Received
|- style="background: #eee;" align="center"
| 0x7B-0x7D
| Date Met
|- style="background: #ddd;" align="center"
| 0x7E-0x7F
| Egg [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #eee;" align="center"
| 0x80-0x81
| Met At [[Pokemon NDS Locations|Location]] (Diamond/Pearl)
|- style="background: #ddd;" align="center"
| 0x82
| [[Pokerus|Pokérus]]
|- style="background: #eee;" align="center"
| 0x83
| [[Pokeball|PokéBall]]
|- style="background: #ddd;" align="center"
| 0x84
| Bit 0-6 - Met At Level Bit 7 - Female OT Gender
|- style="background: #eee;" align="center"
| 0x85
| [[#Encounter Types|Encounter Type]]
|- style="background: #ddd;" align="center"
| 0x86-0x87
| ''Unused''
|}

== Battle Stats ==

The battle stats are encrypted in the same manner, however the seed is not the checksum, it is 0.

=== Encrypted Bytes ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
|- style="background: #ccc;" align="center"
! Offset
! Contents
|- style="background: #eee;" align="center"
| 0x88
| Bits 0-2 - Asleep (0-7 rounds) Bit 3 - Poisoned Bit 4 - Burned Bit 5 - Frozen Bit 6 - Paralyzed Bit 7 - Toxic
|- style="background: #ddd;" align="center"
| 0x89
| ''Unknown'' - Flags - Max Value 0xF0
|- style="background: #eee;" align="center"
| 0x8A-0x8B
| ''Unknown''
|- style="background: #ddd;" align="center"
| 0x8C
| Level
|- style="background: #eee;" align="center"
| 0x8D
| Capsule Index (Seals)
|- style="background: #ddd;" align="center"
| 0x8E-0x8F
| Current HP
|- style="background: #eee;" align="center"
| 0x90-0x91
| Max HP
|- style="background: #ddd;" align="center"
| 0x92-0x93
| Attack
|- style="background: #eee;" align="center"
| 0x94-0x95
| Defense
|- style="background: #ddd;" align="center"
| 0x96-0x97
| Speed
|- style="background: #eee;" align="center"
| 0x98-0x99
| Special Attack
|- style="background: #ddd;" align="center"
| 0x9A-0x9B
| Special Defense
|- style="background: #eee;" align="center"
| 0x9C-0xD3
| ''Unknown'' - Contains Trash Data
|- style="background: #ddd;" align="center"
| 0xD4-0xEB
| Seal Coordinates
|}

== 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
|}

== Alternate Forms ==
Alternate forms are stored at offset 0x40 of the Pokemon structure. Each form follows the pattern of ''index << 3'' where index starts at zero for the main form.

=== Unown's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| A
| 0x38
| H
| 0x70
| O
| 0xA8
| V
|- style="background: #ddd;" align="center"
| 0x08
| B
| 0x40
| I
| 0x78
| P
| 0xB0
| W
|- style="background: #eee;" align="center"
| 0x10
| C
| 0x48
| J
| 0x80
| Q
| 0xB8
| X
|- style="background: #ddd;" align="center"
| 0x18
| D
| 0x50
| K
| 0x88
| R
| 0xC0
| Y
|- style="background: #eee;" align="center"
| 0x20
| E
| 0x58
| L
| 0x90
| S
| 0xC8
| Z
|- style="background: #ddd;" align="center"
| 0x28
| F
| 0x60
| M
| 0x98
| T
| 0xD0
| !
|- style="background: #eee;" align="center"
| 0x30
| G
| 0x68
| N
| 0xA0
| U
| 0xD8
| ?
|}

=== Deoxy's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Attack
|- style="background: #eee;" align="center"
| 0x10
| Defense
|- style="background: #ddd;" align="center"
| 0x18
| Speed
|}

=== Burmy's & Wormadam's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Plant
|- style="background: #ddd;" align="center"
| 0x08
| Sandy
|- style="background: #eee;" align="center"
| 0x10
| Trash
|}

=== Shellos' & Gastrodon's Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| West
|- style="background: #ddd;" align="center"
| 0x08
| East
|}

=== Rotom's Forms ===
Rotom's alternate forms will only be displayed in Pokemon Platinum. Rotom may be traded between Diamond, Pearl, and Platinum without losing the alternate form.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
|- style="background: #ddd;" align="center"
| 0x08
| Heat
|- style="background: #eee;" align="center"
| 0x10
| Cut
|- style="background: #ddd;" align="center"
| 0x18
| Wash
|- style="background: #eee;" align="center"
| 0x20
| Frost
|- style="background: #ddd;" align="center"
| 0x28
| Spin
|}

=== Giratina's Forms ===
Giratina's alternate form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Alternate
|- style="background: #ddd;" align="center"
| 0x08
| Origine
|}

=== Shaymin's Forms ===
Shaymin's alternate form will only be displayed in Pokemon Platinum.
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Land
|- style="background: #ddd;" align="center"
| 0x08
| Sky
|}

=== Arceus' Forms ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Form
! Bit
! Form
! Bit
! Form
|- style="background: #eee;" align="center"
| 0x00
| Normal
| 0x38
| Insect
| 0x68
| Zap
|- style="background: #ddd;" align="center"
| 0x08
| Fist
| 0x40
| Spooky
| 0x70
| Mind
|- style="background: #eee;" align="center"
| 0x10
| Sky
| 0x48
| Iron
| 0x78
| Icicle
|- style="background: #ddd;" align="center"
| 0x18
| Toxic
| 0x50
| Flame
| 0x80
| Draco
|- style="background: #eee;" align="center"
| 0x20
| Earth
| 0x58
| Splash
| 0x88
| Dread
|- style="background: #ddd;" align="center"
| 0x28
| Stone
| 0x60
| Meadow
|}

== Encounter Types ==
{| 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)
|}

== Ribbons ==
Diamond, Pearl, and Platinum store the ribbon information as [[Bitfields|bitfields]] in 1-byte words. Given below are the bytewise representation of the ribbon bitfields.

=== Sinnoh Ribbon Set 1 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x01
| Sinnoh Champ Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x02
| Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x04
| Great Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x08
| Double Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x10
| Multi Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x20
| Pair Ability Ribbon
|- style="background: #eee;" align="center"
| 0x24 & 0x40
| World Ability Ribbon
|- style="background: #ddd;" align="center"
| 0x24 & 0x80
| Alert Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x01
| Shock Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x02
| Downcast Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x04
| Careless Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x08
| Relax Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x10
| Snooze Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x20
| Smile Ribbon
|- style="background: #eee;" align="center"
| 0x25 & 0x40
| Gorgeous Ribbon
|- style="background: #ddd;" align="center"
| 0x25 & 0x80
| Royal Ribbon
|}

=== Sinnoh Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x01
| Gorgeous Royal Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x02
| Footprint Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x04
| Record Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x08
| History Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x10
| Legend Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x20
| Red Ribbon
|- style="background: #eee;" align="center"
| 0x26 & 0x40
| Green Ribbon
|- style="background: #ddd;" align="center"
| 0x26 & 0x80
| Blue Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x01
| Festival Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x02
| Carnival Ribbon
|- style="background: #eee;" align="center"
| 0x27 & 0x04
| Classic Ribbon
|- style="background: #ddd;" align="center"
| 0x27 & 0x08
| Premier Ribbon
|}

=== Sinnoh Ribbon Set 3 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x60 & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x02
| Cool Ribbon Super
|- style="background: #eee;" align="center"
| 0x60 & 0x04
| Cool Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x60 & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x60 & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x60 & 0x20
| Beauty Ribbon Super
|- style="background: #eee;" align="center"
| 0x60 & 0x40
| Beauty Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x60 & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x02
| Cute Ribbon Super
|- style="background: #eee;" align="center"
| 0x61 & 0x04
| Cute Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x61 & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x61 & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x61 & 0x20
| Smart Ribbon Super
|- style="background: #eee;" align="center"
| 0x61 & 0x40
| Smart Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x61 & 0x80
| Smart Ribbon Master
|}

=== Sinnoh Ribbon Set 4 ===
{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x62 & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x62 & 0x02
| Tough Ribbon Super
|- style="background: #eee;" align="center"
| 0x62 & 0x04
| Tough Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x62 & 0x08
| Tough Ribbon Master
|}

=== Hoenn Ribbon Set 1 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3C & 0x01
| Cool Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x02
| Cool Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x04
| Cool Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x08
| Cool Ribbon Master
|- style="background: #eee;" align="center"
| 0x3C & 0x10
| Beauty Ribbon
|- style="background: #ddd;" align="center"
| 0x3C & 0x20
| Beauty Ribbon Super
|- style="background: #eee;" align="center"
| 0x3C & 0x40
| Beauty Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3C & 0x80
| Beauty Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x01
| Cute Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x02
| Cute Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x04
| Cute Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x08
| Cute Ribbon Master
|- style="background: #eee;" align="center"
| 0x3D & 0x10
| Smart Ribbon
|- style="background: #ddd;" align="center"
| 0x3D & 0x20
| Smart Ribbon Super
|- style="background: #eee;" align="center"
| 0x3D & 0x40
| Smart Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3D & 0x80
| Smart Ribbon Master
|}

=== Hoenn Ribbon Set 2 ===

{| border="1" style="border: 1px solid #999; border-collapse: collapse;"
! Bit
! Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x01
| Tough Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x02
| Tough Ribbon Super
|- style="background: #eee;" align="center"
| 0x3F & 0x04
| Tough Ribbon Hyper
|- style="background: #ddd;" align="center"
| 0x3F & 0x08
| Tough Ribbon Master
|- style="background: #eee;" align="center"
| 0x3F & 0x10
| Champion Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x20
| Winning Ribbon
|- style="background: #eee;" align="center"
| 0x3F & 0x40
| Victory Ribbon
|- style="background: #ddd;" align="center"
| 0x3F & 0x80
| Artist Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x01
| Effort Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x02
| Marine Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x04
| Land Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x08
| Sky Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x10
| Country Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x20
| National Ribbon
|- style="background: #eee;" align="center"
| 0x3E & 0x40
| Earth Ribbon
|- style="background: #ddd;" align="center"
| 0x3E & 0x80
| World Ribbon
|}

== Save File Location ==
The party Pokémon are stored in the [[Pokémon NDS Save File Structure|save file]] beginning at offset 0x00098 for the first small block, and 0x40098 for the second small block.

In the first small save block, the first Daycare Pokémon is located at 0x0141C, and the second is located at 0x01508. In the second small block, the first Daycare Pokémon is located at 0x4141C, and the second is located at 0x41508.

In the first small save block, the Pal Park Pokémon are stored beginning at 0x0BA28. In the second small save block, the Pal Park Pokémon are stored beginning at 0x4BA28.

Each party, Daycare, and Pal Park Pokémon is 236 bytes in size.

The PC storage Pokémon are stored in the save file from Box 1 to Box 18. The offset starts at 0x0C104 for the first big block and 0x4C104 for the second big block. Each PC stored Pokémon is 136 bytes in size.

[[Category:Structures]]
[[Category:Game Mechanics]]