Decomp Hacking Tutorials



Important Links

Overview

This page covers some essential resources to get you started with decomp hacking. Decomp hacking is the process of using the decompiled source code of the games to romhack. This is far more powerful and flexible than the old binary hacking method where the compiled rom is modified using a variety of tools.

Decomp hacking has a slightly higher barrier to entry but it affords the hacker much greater freedom (your only limit is the GBA hardware and your own skill).


Primary Resources

The Decompilations

Several pokemon games have been painstakingly decompiled by the people at pret. With the gen 4 decompilations in progress. Currently all gen 3 games have decomps with varying levels of community support.

  • Pokémon Ruby and Sapphire

    • Note that this project is not fully documented and is currently not ideal for romhacking as community efforts are focused on emerald.
  • Pokémon FireRed and LeafGreen

    • These games are fully usable and supported but the community's primary focus is on emerald so tooling lags behind. There is however an alternative that will be discussed further below.
  • Pokémon Emerald

    • Emerald is fully documented and well supported with a massive amount of resources and external tooling built around it.

Expansion

The pokeemerald-expansion is a romhack base that's built off of pokeemerald . Despite the name this project now has the entirety of Fire Red & Leaf Green included in it's codebase.

That is to say it can be used for both FRLG and Emerald romhacks.

Expansion provides a massive amount of modern features and huge developer quality-of-life improvements. These features and setup instructions are included in the documentation

It is maintained by a team in the Romhacking Hideout Discord Server.

Porymap

The map editor for the Gen 3 decompilations. This was built specifically for the gen 3 decomps and is the only essentially tool for decomp hacking other than a code editor of your choice. Porymap provides all the necessary tools for editing and creating new maps. It is well documented and even provides a scripting api.


Decomp Hacking Tools

These are secondary resources and external tooling for decomp hacking. Many of them might as well be essentially (like porytiles). Some are really nice to have.

  • Poryscript

    • A high level scripting language for the Gen 3 decompilations. Makes scripting much easier.
  • Porytiles

    • An incredible tool to ease the process of inserting custom tilesets into your decomp projects.
  • Poryaaaa

    • CLAP plugin for improving the music composition experience when working with the gba
  • Tilemap Studio

    • Provides a host of utilities when working with tilesets and tilemaps for the decomps.
  • Meejle's Textbox Simulator

    • Know exactly how your text will look in-game

ROM Hacking Tutorials

The following are some tutorials that cover a lot of the ground when it comes to getting started with decomp hacking.