pokerecomp
ALPHA v0.1.0

TWO GENERATIONS. ONE ENGINE. REBUILT, NOT EMULATED.

pokerecomp is a native reimplementation of the Game Boy Pokémon games, written from scratch in Godot 4. Red, Blue, Yellow, Gold, Silver and Crystal are playable. Both generations are in alpha and being polished. Your own cartridge is verified by SHA-1, decoded once, then released.

Alpha builds for eight platforms. Bring your own cartridge dump: no game data ships.

  • Windows
  • macOS
  • Linux
  • Android
  • iOS
  • Nintendo Switch

GET THE ALPHA.

One file per platform. Play Red, Blue, Yellow, Gold, Silver or Crystal with your own cartridge dump. No game data ships with the build.

Nothing is signed with a paid certificate, so each platform asks once.

  • Windows shows a blue box: More info, then Run anyway.
  • macOS refuses a double-click: right-click the app, Open, then Open again.
  • Linux needs chmod +x on the file first.
  • Android asks you to allow installing from this source.
  • Nintendo Switch is a homebrew .nro: copy it into /switch/ on your SD card and launch it from the homebrew menu.
  • iOS is deliberately unsigned, so AltStore or SideStore signs it on your own machine with your own Apple ID. A free Apple ID works and needs re-signing weekly.

Every file is listed in sha256sums.txt on the release.

SIX CARTRIDGES. READY TO PLAY.

Every cartridge is decoded straight from your own dump. Matching is by SHA-1, never by filename. An unrecognised cartridge is refused outright.

GENERATION 1

Red, Blue and Yellow are playable, from your bedroom to the Hall of Fame.

Pokémon Red cartridge

Red

Where Kanto begins.

Pokémon Blue cartridge

Blue

The other half of Kanto.

Pokémon Yellow cartridge

Yellow

Pikachu at your heels.

GENERATION 2

Playable end to end, from Elm's Lab to Red on Mt. Silver.

Pokémon Gold cartridge

Gold

A golden journey through Johto.

Pokémon Silver cartridge

Silver

The darker half.

Pokémon Crystal cartridge

Crystal

The definitive edition.

GENERATION 3 · PLANNED

Planned support for the Game Boy Advance games. Development has not started; these cartridges are not playable.

Pokémon Ruby Game Boy Advance cartridge — planned support

Ruby

Hoenn in red.

PLANNED
Pokémon Sapphire Game Boy Advance cartridge — planned support

Sapphire

Hoenn in blue.

PLANNED
Pokémon Emerald Game Boy Advance cartridge — planned support

Emerald

Back to Hoenn.

PLANNED
Pokémon FireRed Game Boy Advance cartridge — planned support

FireRed

Kanto, reimagined.

PLANNED
Pokémon LeafGreen Game Boy Advance cartridge — planned support

LeafGreen

A fresh shade of Kanto.

PLANNED

WHAT IS THIS?

Four things worth knowing before you download anything.

Not an emulator

The engine is written from scratch for Generations 1 and 2 in Godot. No emulation, no static recompilation, no disassembly.

Bring your own ROM

No game data ships in the repository. Drop in your own Red, Blue, Yellow, Gold, Silver or Crystal dump, matched by SHA-1.

Decoded, then released

A verified cartridge is decoded once into a local cache and released. Your ROM is never modified.

MIT, open source

The entire engine is public on GitHub under the MIT licence. Fork it, read it, build with it.

MADE TO BE MODDED.

Change the way it looks, plays and surprises you. Mods are part of the engine, not an afterthought.

FROM 2D TO HD-2D

pokerecomp is built around a mod host. The repository includes a voxel preview renderer, and mods can replace the world or battle renderer while keeping the same game data and logic underneath.

That means the classic 2D game can grow into a different presentation without changing the cartridge data or core systems.

EXPLORE THE MOD LIBRARY
THE JOURNEY CONTINUES

WHAT COMES NEXT.

The focus is on fixes, accuracy and polish for Generations 1 and 2. Generation 3 support is planned.

  1. DONE Red · Blue · Yellow

    Generation 1

    Red, Blue and Yellow are playable from your own cartridge dumps, with their worlds, battles and audio running in the shared engine.

  2. DONE Gold · Silver · Crystal

    Generation 2

    Gold, Silver and Crystal are playable from your own cartridge dumps, from Johto through Kanto.

  3. NOW Fixes · parity · feel

    Polish Generations 1 & 2

    Both generations are getting the same care: fixing bugs, smoothing rough edges and bringing the experience closer to the originals.

  4. UP NEXT Ruby · Sapphire · Emerald · FireRed · LeafGreen

    Generation 3

    Support for Ruby, Sapphire, Emerald, FireRed and LeafGreen is planned. Development has not started; polishing Generations 1 and 2 takes priority.

FOUND SOMETHING BROKEN?

It is an alpha, so it will break. Tell us on Discord or open an issue, and star the repo to follow development.