pkmn wiki

Supported ROMs

Which cartridge dumps the client accepts, and how it uses them.

pkmn does not ship the original games' art or sound. The client reads your own dumps of the cartridges, decodes what it needs and stores the result on your computer. Your dumps are read where they are: nothing is copied, uploaded or changed.

Accepted cartridges

A file is accepted only when its SHA-1 matches a known retail dump below. The header is read to explain a refusal (wrong region, wrong game, a trimmed file), never to accept a file. Patched files, ROM hacks, trimmed dumps and overdumps are refused. The file name and extension do not matter.

GameRegionSystemGame codeSHA-1
Pokémon EmeraldUSA/EuropeGame Boy AdvanceBPEE
f3ae088181bf583e55daf962a92bb46f4f1d07b7
Pokémon FireRedUSA/EuropeGame Boy AdvanceBPRE
41cb23d8dccc8ebd7c649cd8fbb58eeace6e2fdc
dd5945db9b930750cb39d00c84da8571feebf417
Pokémon LeafGreenUSA/EuropeGame Boy AdvanceBPGE
574fa542ffebb14be69902d1d36f1ec0a4afd71e
7862c67bdecbe21d1d69ce082ce34327e1c6ed5e
Pokémon HeartGoldUSANintendo DSIPKE
4fcded0e2713dc03929845de631d0932ea2b5a37
Pokémon SoulSilverUSA/AustraliaNintendo DSIPGE
f8dc38ea20c17541a43b58c5e6d18c1732c7e582
Pokémon BlackUSA/EuropeNintendo DSIRBO
26ad0b9967aa279c4a266ee69f52b9b2332399a5
Pokémon WhiteUSA/EuropeNintendo DSIRAO
bc696a0dfb448c7b3a8a206f0f8214411a039208

Ruby and Sapphire, and Black 2 and White 2, are recognised so the client can name them when it refuses them, but they are not used.

Which ones you need

You need one accepted dump from each of these four groups before LOGIN and Register unlock:

  • Pokémon Emerald
  • Pokémon FireRed or LeafGreen
  • Pokémon HeartGold or SoulSilver
  • Pokémon Black or White

Until then the title screen shows "Missing required ROMs — check Game Data."

Adding them

The Extract from your cartridge window opens by itself on the title screen until every group is present. You can also open it from Game Data on the title screen or from Settings → Game Data in game.

  • Select File on a cartridge's row picks a dump anywhere on your disk.
  • Open Roms Folder opens the client's own roms folder. Drop your dumps there and the window finds them.
  • Extract decodes the art and sound. If it is interrupted, the button reads Resume.

When a release needs new art from a cartridge, the title screen says "Artwork out of date — re-extract in Game Data." You can still sign in.

The client's data folder (where the extracted files live) is:

SystemFolder
Windows%APPDATA%\Godot\app_userdata\PKMN Engine\
macOS~/Library/Application Support/Godot/app_userdata/PKMN Engine/
Linux~/.local/share/godot/app_userdata/PKMN Engine/

Last updated on

As of v0.75.0 · engine 22ba612f

On this page