Skip to main content

Pokémon Red/Blue Disassembly

A complete, byte-perfect disassembly of Pokémon Red and Blue in Game Boy Z80 assembly. Build authentic ROMs, explore game internals, and create mods.

Key Features

Byte-Perfect ROMs

Builds ROMs that exactly match the original Pokémon Red and Blue checksums, verified with SHA-1 hashes

Complete Game Systems

Fully documented battle engine, overworld mechanics, Pokémon data, items, trainers, maps, and audio

Game Boy Architecture

Learn how classic Game Boy games work with detailed documentation of hardware, memory, and banking

Custom Build Tools

Graphics compression, ROM patching, and specialized tools for working with Game Boy assembly

Quick Start

1

Install Dependencies

Install RGBDS 1.0.1, Make, GCC, and Git on your platform
2

Clone and Build

Clone the repository and run make to build pokered.gbc and pokeblue.gbc
3

Verify ROMs

Run make compare to verify your builds match the original game checksums

Ready to build?

Follow the complete installation guide for your platform

Explore the Disassembly

Architecture

Learn about Game Boy hardware and ROM structure

Game Systems

Dive into battle mechanics and game features

Code Reference

Browse constants, macros, and data structures

Community

Discord Community

Join the pret Discord server (#pokered channel) to ask questions and share discoveries

GitHub Repository

Explore the source code, report issues, and contribute improvements

Build docs developers (and LLMs) love