Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:Pokémon Generation 1 and 2 save files

From ReverseEngineering.wiki
Format
On this wiki Facts · Code · Notes · Topics

Battery saves of Pokémon Red/Blue/Yellow and Gold/Silver/Crystal (Game Boy SRAM): no sectors, one checksum over the trainer area; Gen 1 is a one-byte inverted sum, Gen 2 a 16-bit sum stored in two places.

Cartridge SRAM images (.sav, up to 32 KiB) of Platform:Game Boy Pokémon games, read from Tool:PKHeX (SAV1.cs, SAV2.cs, and the offset tables SAV1Offsets.cs, SAV2Offsets.cs). Cartridge RAM banking: Platform:Game Boy/Memory bank controllers.

Generation 1 (Red, Blue, Yellow)

Checksum: add all bytes from the OT name offset 0x2598 up to (not including) the checksum byte, then invert the 8-bit result (~sum). The checksum byte is at 0x3523 (international) or 0x3594 (Japanese). Box lists are at 0x4000 and 0x6000. Fact: Fact:Pokémon Generation 1 and 2 save files/behavior/Gen 1 save checksum.

Generation 2 (Gold, Silver, Crystal)

Checksum: 16-bit wrapping sum of every byte from 0x2009 (the start of the trainer area; the OT name is at +2) through an end offset that depends on version and language. The result is written as a little-endian u16 to two places.

Variant Sum ends at (inclusive) First copy Second copy
International Gold/Silver 0x2D68 0x2D69 0x7E6D
International Crystal 0x2B82 0x2D0D 0x1F0D
Japanese Gold/Silver 0x2C8B 0x2D0D 0x7F0D
Japanese Crystal 0x2AE2 0x2D0D 0x7F0D
Korean Gold/Silver 0x2DAA 0x2DAB 0x7E6B

See Fact:Pokémon Generation 1 and 2 save files/behavior/Gen 2 save checksum. Box lists start at 0x4000 and 0x6000 as in Generation 1 (PKHeX GetBoxOffset code adds a 2-byte step per box in Gen 2).

Code & repositories

  • https://github.com/kwsch/PKHeX @ 641c26ba100225f3605e5a44b61b3b16e15a3774 · license: GPL-3.0 (declared by the contributor; GitHub's detector did not recognize LICENSE)
    Pokémon save and entity editor; PKHeX.Core is the reference for save sectors, checksums and PK3-PK9 encryption (PokeCrypto.cs, SAV3.cs, PK3.cs, SAV1.cs, SAV2.cs).
    Tested on: source read, not run: source read, not run · checked 2026-10-18

Pitfalls

  • PKHeX has a separate routine named GetKoreanChecksum in SAV2.cs for an unusual Korean checksum; it was not analysed here, so Korean saves may need more than the sum above.
  • Gen 3 and later switched to sector-based saves: Format:Pokémon Generation 3 save file.

Unverified: which sum end belongs to which exact retail ROM (the table follows PKHeX's switch on game version and language, not a dump), and what the second copy is for.