pokemon-randomizer

This project is no longer maintained and most of the code has been migrated to the TM35-Metronome project, which aims to be a set of simple tools for hacking Pokémon roms.

A Pokémon Rom randomizer tool written in Zig

For now, this project exists for me to test out the Zig programming language and its features.

Supported games

Each Pokémon game exists in multiple different languages. The reason this is important is that different languages have different data layouts. The Japanese version of Pokémon Emerald might not work with the randomizer even though a US version does.

Build

The randomizer relies on libraries which are included as git submodules. You, therefore, need to clone with --recursive, in order to get these libraries on clone.

The repo contains both the Pokémon randomizer, but also a few tools used to make development of the randomizer a little simpler.

Here are the different build commands:

• zig build randomizer builds the randomizer (default).
• zig build tools builds the tools.
• zig build test runs all tests.
• zig build all builds everything and runs all tests.

Resources

Useful links with information on the structure of roms, or where data exists in different Pokémon games.

Roms

• Gameboy Advance / Nintendo DS / DSi - Technical Info
• Pan Doc (Gb info)
• Nds formats

Gen 1

Gen 2

Gen 3

• Pokémon Emerald Offsets

Gen 4

• HGSS File System
• HG/SS Mapping File Specifications
• HG/SS Pokemon File Specifications
• HG/SS Encounter File Specification

Gen 5

• BW2 File System
• BW Trainer data
• BW Move data

All Gens

• Bulbapedia on Pokemon Data Structures
• Pokemon Game Disassemblies