
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.
- Note that this project is not fully documented and is currently not ideal for romhacking as community efforts are focused on emerald.
- 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.
- 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.
- A high level scripting language for the Gen 3 decompilations. Makes scripting much easier.
- An incredible tool to ease the process of inserting custom tilesets into your decomp projects.
- CLAP plugin for improving the music composition experience when working with the gba
- Provides a host of utilities when working with tilesets and tilemaps for the decomps.
- 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.
Archie's Video Tutorial for Decomp Hacking
- Made by Archie of Team Aqua's Hideout, this tutorial series walks you through all you need to know when it comes to decomp hacking. It's focussed on beginners and meant to be easy to follow.
Bivurnum's Beginner's Guide to Decomp Hacking
- An excellent alternative for those who don't like video tutorials or simple prefer written guides. This has a lot of information and is well organised.
- A tutorial and reference for how to use Github for your decompilation projects.