Pokémon Romhack Base, based off pret's pokeemerald decompilation. See the wiki for more info.
Go to file
grintoul 7248ff7193
Some checks are pending
CI / build-emerald (push) Waiting to run
CI / build-firered (push) Waiting to run
CI / build-leafgreen (push) Waiting to run
CI / release (push) Waiting to run
CI / test (push) Waiting to run
CI / build (push) Blocked by required conditions
CI / docs_validate (push) Waiting to run
CI / allcontributors (push) Waiting to run
Docs / deploy (push) Waiting to run
Silence Makefile map_version message (#9590)
2026-03-21 06:58:03 +00:00
.github Parallelize CI jobs and cache build tools (#9528) 2026-03-16 08:50:49 +01:00
asm 27/02/26 Master to upcoming merge (#9384) 2026-02-28 15:58:05 +01:00
constants Adds `Item` enum (#8897) 2026-01-17 02:26:09 -08:00
data Fix SafeguardProtected script (#9559) 2026-03-18 11:39:19 +01:00
dev_scripts Ease vanilla maps deletions (#9199) 2026-02-24 10:26:33 -08:00
docs docs(tutorials): clean up mon_generation tutorial for readability (#9531) 2026-03-20 11:30:08 +01:00
graphics Add better Strange Ball sprite (#9556) 2026-03-20 17:21:00 +01:00
include Fix AI debug timers (#9585) 2026-03-20 21:49:29 +01:00
libagbsyscall Fix $(AR) define, remove \u warns on macOS. 2021-01-04 11:35:59 -05:00
migration_scripts createmon uses enum Pokeball instead of Item (#9281) 2026-02-25 21:10:57 +01:00
sound Fix space indentation in .s and .inc files (#9371) 2026-02-27 12:45:00 -08:00
src Fix AI debug timers (#9585) 2026-03-20 21:49:29 +01:00
test Retaliate post ko bug fix (#9561) 2026-03-19 00:17:40 +01:00
tools fix(learnset_helpers): Harden regex-patterns for preproc directives (#9582) 2026-03-20 18:24:34 +01:00
.all-contributorsrc add DragonScaledEmma as a contributor for bug (#9458) 2026-03-07 14:48:07 -05:00
.gitattributes squash! *.party: text with lfs 2025-11-21 19:30:30 +00:00
.gitignore Fix partner difficulty and rework tests (#9419) 2026-03-13 07:49:23 -07:00
asmdiff.ps1 Remove debug printing 2019-04-07 19:18:42 -05:00
asmdiff.sh Pret merge (20th of June) (#4845) 2024-06-21 12:21:29 +02:00
audio_rules.mk Remove trailing whitespace - Master (#9011) 2026-01-25 10:12:41 +01:00
build_tools.sh Update deprecated build_tools script 2019-08-27 09:15:44 -04:00
CHANGELOG.md Version 1.10.2 (#6144) 2025-01-30 18:38:28 -03:00
charmap.txt Fix region text when looking at map in frlg (#9347) 2026-02-25 15:19:09 +01:00
check_history.sh feat: check if inside of git repository before building (#4363) 2024-04-07 10:43:04 -04:00
config.mk Add making release build 2025-07-07 10:24:45 -10:00
CONTRIBUTING.md Remove trailing whitespace - Master (#9011) 2026-01-25 10:12:41 +01:00
CREDITS.md add DragonScaledEmma as a contributor for bug (#9458) 2026-03-07 14:48:07 -05:00
FEATURES.md Spruce up FEATURES.md (#7159) 2025-06-20 05:44:55 -07:00
graphics_file_rules.mk Add FRLG (#7423) 2026-01-28 17:41:12 +01:00
INSTALL.md Fix Status1 icon not being registered for recorded partner in tests (#8520) 2025-12-26 23:36:42 +00:00
json_data_rules.mk Merge branch 'master' into master-to-upcoming 2025-05-28 14:26:15 +02:00
ld_script_modern.ld Merge remote-tracking branch 'pret/master' into pret-merge 2026-02-26 15:33:26 +01:00
ld_script_test.ld Fix EWRAM_INIT in tests and add a default state to test runner main loop 2025-09-06 18:20:45 +02:00
make_tools.mk Merge remote-tracking branch 'pret/master' into pret-merge 2025-12-01 16:46:34 +01:00
Makefile preproc: generate .size in script_data sections (#9233) 2026-03-19 11:42:51 +01:00
map_data_rules.mk Silence Makefile map_version message (#9590) 2026-03-21 06:58:03 +00:00
README.md Expansion 1.15.0 2026-02-28 22:13:30 +01:00
rom.sha1 Make rom.sha1 lowercase to fix erroneous comparison results on *nix 2017-09-06 09:20:49 -04:00
spritesheet_rules.mk Adds Cherrim Overworld sprite (#9442) 2026-03-08 09:51:24 +01:00
trainer_rules.mk Fix partner difficulty and rework tests (#9419) 2026-03-13 07:49:23 -07:00

About pokeemerald-expansion

Gif that shows debugging functionality that is unique to pokeemerald-expansion such as rerolling Trainer ID, Cheat Start, PC from Debug Menu, Debug PC Fill, Pokémon Sprite Visualizer, Debug Warp to Map, and Battle Debug Menu Gif that shows overworld functionality that is unique to pokeemerald-expansion such as indoor running, BW2 style map popups, overworld followers, DNA Splicers, Gen 1 style fishing, OW Item descriptions, Quick Run from Battle, Use Last Ball, Wild Double Battles, and Catch from EXP Gif that shows off a number of modern Pokémon battle mechanics happening in the pokeemerald-expansion engine: 2 vs 1 battles, modern Pokémon, items, moves, abilities, fully customizable opponents and partners, Trainer Slides, and generational gimmicks

pokeemerald-expansion is a GBA ROM hack base that equips developers with a comprehensive toolkit for creating Pokémon ROM hacks. pokeemerald-expansion is built on top of pret's pokeemerald decompilation project. It is not a playable Pokémon game on its own.

Features

pokeemerald-expansion offers hundreds of features from various core series Pokémon games, along with popular quality-of-life enhancements designed to streamline development and improve the player experience. A full list of those features can be found in FEATURES.md.

Credits

If you use pokeemerald-expansion, please credit RHH (Rom Hacking Hideout). Optionally, include the version number for clarity.

Based off RHH's pokeemerald-expansion 1.15.0 https://github.com/rh-hideout/pokeemerald-expansion/

Please consider crediting all contributors involved in the project!

Choosing pokeemerald or pokeemerald-expansion

  • pokeemerald-expansion supports multiplayer functionality with other games built on pokeemerald-expansion. It is not compatible with official Pokémon games.
  • If compatibility with official games is important, use pokeemerald. Otherwise, we recommend using pokeemerald-expansion.
  • pokeemerald-expansion incorporates regular updates from pokeemerald, including bug fixes and documentation improvements.

Getting Started

Important: Do not use GitHub's "Download Zip" option as it will not include commit history. This is necessary if you want to update or merge other feature branches.

If you're new to git and GitHub, Team Aqua's Asset Repo has a guide to forking and cloning the repository. Then you can follow one of the following guides:

📥 Installing pokeemerald-expansion

🏗️ Building pokeemerald-expansion

🚚 Migrating from pokeemerald

🚀 Updating pokeemerald-expansion

Documentation

For detailed documentation, visit the pokeemerald-expansion documentation page.

Contributions

If you are looking to report a bug, open a pull request, or request a feature, our CONTRIBUTING.md has guides for each.

Community

Our community uses the ROM Hacking Hideout (RHH) Discord server to communicate and organize. Most of our discussions take place there, and we welcome anybody to join us!