Pokémon DP Save File Structure
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'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).
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.
Offset | Purpose |
---|---|
0x00 - 0x03 | Save ID number |
0x04 - 0x07 | Save index number |
0x08 - 0x0B | Size of block |
0x0C - 0x0F | Run-time usage |
0x10 - 0x11 | Run-time usage |
0x12 - 0x13 | Checksum |
Offset | Purpose |
---|---|
0x00 - 0x03 | Save ID number |
0x04 - 0x07 | Save index number |
0x08 - 0x0B | Run-time usage |
0x0C - 0x0F | Run-time usage |
0x10 - 0x13 | Size of block |
0x14 - 0x15 | Run-time usage |
0x16 - 0x17 | 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 word represents a character in the game's 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.
Country of Origin - 0x7D
- Unsigned 8bit integer.
- Determines whether or not Pokémon get an outsider EXP bonus.
- 0x1 = 日本語 (Japan)
- 0x2 = English (US/UK/AU)
- 0x3 = Français (France/Québec)
- 0x4 = Italiano (Italy)
- 0x5 = Deutsch (Germany)
- 0x7 = Español (Spain/Latin Americas)
- 0x8 = 한국어 (South Korea)
Badges - 0x7E
- Unsigned 8bit bitfield
- Determines what PokéMart items are for sale, what level outsider Pokémon will obey until, and flags certain in-game events.
- 0x01 = Coal Badge
- 0x02 = Forest Badge
- 0x04 = Cobble Badge
- 0x08 = Fen Badge
- 0x10 = Relic Badge
- 0x20 = Mine Badge
- 0x40 = Icicle Badge
- 0x80 = Beacon Badge
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
Total Playtime - 0x86
- Hours = unsigned 16bit integer.
- Minutes = unsigned 8bit integer.
- Seconds = unsigned 8bit integer.
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 article: Pokemon NDS Structure
General Items - 0x624
The items in the Trainer's general Items bag pocket.
- 165 blocks of 4 byte structures (two bytes for item index, two bytes for quantity)
Key Items - 0x8B8
The items in the Trainer's Key Items bag pocket.
- 50 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
TMs & HMs - 0x980
The items in the Trainer's TMs & HMs bag pocket.
- 100 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
- TMs & HMs are auto-sorted by item index in ascending order.
Mail - 0xB10
The items in the Trainer's Mail bag pocket.
- 12 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
Medicine - 0xB40
The items in the Trainer's Medicine bag pocket.
- 40 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
Berries - 0xBE0
The items in the Trainer's Berries bag pocket.
- 64 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
- Berries are auto-sorted by item index in ascending order.
Balls - 0xCE0
The items in the Trainer's Balls bag pocket.
- 15 blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
Battle Items - 0xD1C
The items in the Trainer's Battle Items bag pocket.
- 56 (?) blocks of 4 byte structures (two bytes for item index, two bytes for quantity).
Starter Pokémon - 0xDFC
The Pokédex number of the starter chosen.
- Unsigned 16bit integer.
Fly Locations - 0x1112
- 9byte bit field
Pokétch Enabled (?) - 0x114C
- 0x00 if disabled, can be 0x03 or 0x07 if enabled
Number of Pokétch Apps Enabled - 0x114D
- Max number = 25 (0x19)
Currently Selected Pokétch App - 0x114E
Pokétch app currently viewed in DS bottom screen.
- Pokétch apps are ordered like so:
- 0x00 = Digital Watch
- 0x01 = Calculator
- 0x02 = Memo Pad
- 0x03 = Pedometer
- 0x04 = Pokémon List
- 0x05 = Friendship Checker
- 0x06 = Dowsing Machine
- 0x07 = Berry Searcher
- 0x08 = Day-Care Checker
- 0x09 = Pokémon History
- 0x0A = Counter
- 0x0B = Analog Watch
- 0x0C = Marking Map
- 0x0D = Link Searcher
- 0x0E = Coin Toss
- 0x0F = Move Tester
- 0x10 = Calendar
- 0x11 = Dot Artist
- 0x12 = Roulette
- 0x13 = Trainer Counter
- 0x14 = Kitchen Timer
- 0x15 = Color Changer
- 0x16 = Matchup Checker
- 0x17 = Stopwatch
- 0x18 = Alarm Clock
Pokétch Apps Enabled - 0x114F
- 25 one byte flags, each corresponding to one Pokétch app (in the same order as above)
- 1 = enabled, 0 = disabled
Map ID Number - 0x1238
- Unsigned 16bit integer.
Sinnoh Pokédex Unlocked - 0x1414
- 1 if unlocked, 0 if not unlocked.
National Pokédex Unlocked - 0x1415
- 1 if unlocked, 0 if not unlocked.
Berry Trees - 0x1E84
- 128 blocks of 14byte structures
- List of Berry Tree locations
- Main article: Berry Trees
Rival's Name - 0x25A8
- 8 unsigned 16bit integers.
- Each word represents a character in the game's character table.
Map X Coordinate - 0x25FA
- Unsigned 16bit integer.
Map Y Coordinate - 0x25FE
- Unsigned 16bit integer.
Map Z Coordinate - 0x2602
- Unsigned 16bit integer.
Players Met Underground - 0x3A2C
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Spheres Obtained - 0x3A38
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Fossils Obtained - 0x3A3C
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Gifts Given - 0x3A40
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Traps Hit - 0x3A44
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Traps Triggered - 0x3A48
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Flags Captured - 0x3A60
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Poffins - 0x5050
- 98 (?) blocks of 8byte structures
- 0x00: Poffin Type (Overall flavor?)
- 0x01: Spicy/Cool Level
- 0x02: Dry/Beauty Level
- 0x03: Sweet/Cute Level
- 0x04: Bitter/Smart Level
- 0x05: Sour/Tough Level
- 0x06: Smooth Level
- 0x07: value is 0
Trainer Card Signature - 0x5904
The signature on the back of the Trainer Card.
- 192 blocks of 8 byte structures
- The signature can be changed by speaking to the NPC behind the leftmost counter on the top floor of any Pokémon Center. It is created using the stylus.
- Main article: Trainer Card Signature
Score - 0x5F08
A measure of the player's progress or performance in the game.
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Pokémon Caught - 0x5F2C
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Pokémon Met While Fishing - 0x5F30
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Pokémon Eggs - 0x5F34
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Pokémon Defeated - 0x5FAC
- Unsigned 32bit integer
- Max value = 999999 (0xF423F)
Single Battle Wins - 0x5FCA
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Consecutive Single Battle Wins - 0x5FCC
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Double Battle Wins - 0x5FCE
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Consecutive Double Battle Wins - 0x5FD0
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Multi Battle Wins - 0x5FD2
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Consecutive Multi Battle Wins - 0x5FD4
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Link Multi Battle Wins - 0x5FD6
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Consecutive Link Multi Battle Wins - 0x5FD8
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Wi-Fi Battle Wins - 0x5FDA
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Consecutive Wi-Fi Battle Wins - 0x5FDC
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Contests Won - 0x5FE2
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Ribbons - 0x5FE6
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
Battle Points - 0x65F8
- Unsigned 16bit integer
- Max value = 9999 (0x270F)
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
- Notes: Both Safari Zone Pokémon and 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
- Notes: Both 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
Daily Trophy Pokémon Yesterday - 0x72DE
- Unsigned 8bit integer
- Second daily trophy garden Pokémon
- List of 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
- Main article: Honey Trees
GTS Pokémon - 0x73E8
One Pokémon
- 1 block of 236byte structures
- The data for the Pokémon currently uploaded to the GTS (if any).
- Main article: Pokemon NDS Structure