Emerald Battle Revolution is a Pokémon Emerald decompilation project which uses the PokeEmerald Expansion project as a base. The goal for this project is to create a sandbox for players to enjoy the incredible post-game content in Emerald such as the Battle Frontier and other facilities using new Pokémon and simple methods for obtaining properly trained, competitive Pokémon easily without the need for modifying save files.
All of the features provided by the pokeemerald-expanded upcoming branch are included, of which there are too many to feature here. Many of these features are still in development, so you are likely to encounter bugs or other mechanical issues while playing. If you experience an issue and would like to report it, please open an issue.
For more information about the pokeemerald-expanded project, please check out their github repository.
When starting the game, you may choose to be transferred to the battle frontier with the story completed up to becoming the champion.
You will be given $300,000 to start the game, as well as a Swampert and Talonflame for using important HMs such as Fly, Surf, Waterfall, etc.
All TMs / HMs / Key Items can be purchased in the Battle Frontier Underground.
The Battle Frontier Underground is a new underground shopping area in the Battle Frontier, which allows the players to buy pretty much anything you could need for making a competitive team. This includes, but is not limited to:
Elevator to Battle Dome
Legendary Pokémon Shop (Purchase unobtainable legendaries for $12,000)
Legendary Forme-Changing Item Shop (Both Key Items and Held Items)
Pokémon Day Care, containing the following:
PokeDrugs Shop (Feathers/Drugs, Ability Changers, PP Up/Max, Bottle Cap)
Nature Mint Shop
Training Item Shop (Rare/XP Candy, Macho/Power Items, etc.)
Tera Shard Shop
Pokémon Center, containing the following:
IV Berry Shop (IV Increasing / Decreasing Berries)
EV Berry Shop (EV Mochi / EV Decreasing Berries)
Games Corner, containing the following:
Mega Stone Shop
Z-Crystal Shop
Battle Tower Elevator
Common Battle Item Shop (Choice Items, Life Orb, Assault Vest, etc.)
Uncommon / Signature Battle Item Shop (Big Root, Light Ball, etc.)
Type-Specific Battle Item Shop (Silk Scarf, Mystic Water, etc.)
Battle Gem Shop (Normal Gem, Fire Gem, etc.)
Battle Pyramid Elevator
Battle Status Berry Shop (e.g. Lum Berry, Sitrus Berry, etc.)
Battle Resist Berry Shop (e.g. Coba Berry, Yache Berry, etc.)
TM/HM Shop (TM01-25, HM0-4)
TM/HM Shop (TM26-50, HM5-8)
Battle Factory Elevator
Move Tutor (Relearnable Moves, including ones not learnt yet)
Move Tutor (Teachable Moves, e.g. Egg/Tutor Moves, other gen TR/TMs, etc.)
Standard Pokemart
All Pokeballs (Including Apricorn Balls)
Battle Palace Elevator
Ingame Key Items Shop (Acro Bike, Exp.Share, Coin Case, etc.)
New Key Items Shop (Dynamax Band, Tera Orb, Mega Ring, etc.)
The Battle Frontier underground is also filled with machines which you can use to convert between Battle Points and $, at an exchange rate of $9800 to 1 BP.
Please see below for the list of features which are supported in each Battle Frontier facility.
| Facility Name | Level Scaling | New Species | Doubles Mode | 4 Pokémon (Doubles) | Total |
|---|---|---|---|---|---|
| Battle Arena | Yes | Yes | No | N/A | 3/3 |
| Battle Dome | Yes | No | Yes | No | 2/4 |
| Battle Factory | Yes | Yes | Yes | No | 3/4 |
| Battle Palace | Yes | Yes | Yes | No | 3/4 |
| Battle Pike | Yes | Yes | N/A | N/A | 2/2 |
| Battle Pyramid | Yes | Yes | No | N/A | 2/3 |
| Battle Tower | Yes | Yes | Yes | Yes | 4/4 |
Please see below for the list of features which are supported in each Battle Tent.
| Facility Name | Level Scaling | New Species | Doubles Mode | 4 Pokémon (Doubles) | Total |
|---|---|---|---|---|---|
| Fallarbor Tent | Yes | Yes | No | N/A | 2/3 |
| Slateport Tent | Yes | Yes | No | N/A | 2/3 |
| Verdanturf Tent | Yes | Yes | No | N/A | 2/3 |
For a list of future changes which are intended for this project, please check the issues page.
Please note, that this list is subject to change and planned features may be added or removed at any time.
If you experience any issues with the application, or would like to suggest improvements you can open an issue or please feel free to contact me on twitter at @SirScrubbington.
The entire PokeEmerald-Expansion development team, for developing and maintaining the incredible source image this project uses
Avara, for creating the Changing Birch's Intro Pokémon tutorial
SonikkuA-DatH, for creating the Make space for EWRAM Data for Summary Screen tutorial
Jaizu, for creating the Not showing dex entries until getting the Pokédex tutorial
Anon822, for creating the Wrong Save Type Error Screen tutorial
FlameTix, for creating the Implement Missing Text Function RESET_FONT tutorial
Ghoulslash, for creating the following tutorials:
LOuroboros, for creating the following tutorials:
Jirachii, for creating the Hidden Power type in summary screen tutorial.
EllaBrella, for creating the Increase Text Speed Beyond Fast tutorial
Hiram Anderson, for creating the Extra Save Space tutorial
FieryMewtwo, for creating the following tutorials:
voloved, for creating the following tutorials:
Mkol103, for creating the mid-battle test skip tutorial
DizzyEgg, for creating the Coloured Stats by Nature tutorial
PokemonCrazy, for creating the Show EVs / IVs in Summary tutorial
huderlem, for creating Poryscript
This is the main release branch for the software, where the latest stable version
of the code will be deployed. This will be kept up to date with the latest stable
dev release.
This is the main development branch for the software, which is where code which is actively being worked on is stored. This branch has the debug menu enabled, as well as other debugging features. This branch is generally not advised to be used for a genuine playthrough, and may not always be in a compiling state when committed.
This branch is used to merge updates from my (battle frontier generator branch), which is used for developing the Battle Frontier Modernised Set-Generation feature. This is developed on a seperate project, to allow for other romhackers to implement this feature on their own projects.
Please see below for the Dragapult Emerald project changelog. For changes related to the PokeEmerald Expanded project, please see the PokeEmerald Changelog.
Merged upstream changes
Added missing attack power scaling values, fixed issue with checking incorrect variable when performing power scaling calculations, fixed issue with incorrectly accessed difficulty switch, merged upstream changes
Implemented variable move power, hidden ability selection chance and added an optional 'hard mode' to the battle frontier controllers, which allows you to skip the easy (low base stat, ivs, etc.) opponents in the battle frontier and jump straight to the hardest.
Simplified sample teams & sample sets shop menus, added move deleter to Battle Frontier Underground, fixed some minor issues with battle frontier underground map sprites
Updated to the new PokeEmerald-Expansion Pokedex Plus, which provides useful information such as base stats, moves, formes and more. Re-enabled the displaying of tera types in the summary menu, and added the ability to change the tera type of a Pokémon by using a single tera shard on them.
Merged upstream changes, fixed issue with text rendering, implemented game versioning system which will be used for preventing battling and trading with unofficial versions in the future, fixed bugs related to the battle frontier underground link / cable club rooms
Expanded shops to allow for the purchasing of individual sets from a team, as well as expanded the individual Pokémon shops to show Pokémon in the categories for both their primary and secondary type
Merged upstream changes, including support for terastalisation which can now be banned or unbanned using the Battle Frontier controllers, and used inside and out of Battle Facilities.
Created new branch for developing the 'Battle Spot' feature, added new sample teams from old VGC formats (2016, 2018 pre/post bank and 2019 sun, moon and ultra series).
Implemented auto-generator for Pokémon and Legendary shop multi-select menus, updated Pokémon Shop / Legendary Shop text
Updated move lists, ability selection bonuses, fixed several minor bugs, added new sample teams
Restructured nature code, fixed mega/gmax/zmove allow flags, implemented basic testing for set generation. Implemented rng seeding for consistent sample set ability/gender selection. Fixed set generation bugs, updated banned moves, improved item selection.
Full build pipeline has been written to compile sample teams and sets which can be purchased by players at compile-time by adding .team and .set files
to the tools/bfg_helpers/sample directory. Likewise, multi-choice menus can now be automatically generated by adding a json file containing options to
the tools/bfg_helpers/select directory. Other text in the Sample Team and Sample Set shops has been cleaned up and improved. Many sample doubles teams have
been added, and more will be added in the future.
Added new, unfinished location 'Battle Spot' to the Battle Frontier Underground, with a pathway leading in from the center of the top row of shops. Several vendors have been broken down into their own files to improve code reusability. Updated battle frontier controller to allow for the banning and unbanning of megas, zmoves, gigantamax. Improved startup scripts
Merged upstream changes which have implemented modern battle frontier set generation for Battle Factory, as well as all Battle Tent Facilities. Battle Factory is fully working, including items, swapping, and open lvl. mode has every second Pokémon (and one Pokémon on each opponent team) as a restricted legendary. Please see the Battle Frontier Feature Table for more details.
Optional BST range fixing has been implemented (compile-side), and open lvl. mode will now always have the highest BST limit by default rather than starting low and increasing. The latest changes from the upstream branch of the Pokeemerald Expansion Project have now also been merged.
The list of Pokémon which can be selected for each trainer class has been expanded, and Tera Blast has been added to the banned moves list as it has not been fully implemented yet.
Extensive testing has been performed on each Battle Frontier facility, to ensure that features are working as expected. Issues with level scaling have now been resolved in all facilities, and new set generation has been confirmed as working in most facilities. For a full list of all features which are currently supported in each Battle Facility, including Battle Tents please see the Battle Frontier Feature Table.
Merged upstream changes which have implemented a more efficient species selection system, including ensuring that two restricted (i.e. legendary) Pokémon are picked on all teams in the 'Open' rules battle mode when playing doubles (with four Pokémon), and one is selected playing in formats where three Pokémon are selected.
Mythicals are now legal to be used in all level 50 and open rules formats, and have been added to the normal selection pool for both (Excluding Arceus and Deoxys, which are considered restricted).
Special cases have now been added for selecting moves such as Icy Wind, Trick Room, Tailwind and some others which will make them more likely to be chosen appropriately (even when 'attacks only' mode is chosen).
Other issues with fusion formes (e.g. Kyurem, Calyrex) not appearing has been resolved, and incomplete species such as Pecharunt and Terapagos have been removed from the available species list.
Updated config to revert changes which prevented Battle Frontier set randomisation from working as expected
Major update: Battle Frontier Modernised Set-Generator has been implemented, with over a months worth of development on a seperate repository (battle frontier generator branch) so it may be used by other projects. An NPC has been added to the Battle Frontier Underground which allows for the customisation of Battle Frontier Facilities, with the following options:
For the 'Default' and 'Random' settings, EVs are invested in bulk (HP required, then Def/Spdef randomly) and a neutral nature is used. Otherwise, evs/ivs/nature are selected based upon the base-stats of the Pokémon, where nature and evs will be invested in whichever stats are highest first. Signature Z-Moves and Mega Evolutions may be used in the later matches (~41+),
There is still a significant amount of work expected to be done on this part of the project, however it is currently in a completely playable state. Please note, this has only been tested in Battle Tower Singles and Doubles so far, however further testing and development will be conducted to ensure all features work in the other facilities as well. Team generation takes about ~1 second to complete (can be quicker with default/random methods, as they are simpler). In future, this will be worked on to reduce wait time and attempt to reduce performance impacts. Please keep in mind, however that while these features are still in active development you may encounter crashes or other issues whilst using these features. If you do, please feel free to open an issue with the project describing the crash so it can be investigated.
Merged upstream changes, removed unused poryscripts, reviewed and fixed code differences, reverted upstream plural string changes due to text issues, gigantamax-flagged Pokémon can no longer evolve, and Pokémon without Gigantamax formes can no longer have the flag set.
Added an NPC to the Battle Frontier Underground Pokémon Center which is able to change the Gigantamax Factor of a Pokémon for $500. Music-changing NPCs have also been added to the Battle Tent facilities.
Merged upstream changes, added a toggle to the dynamax band which allows you to enable or disable dynamax battles, you will be unable to use megas/zmoves/tera during dynamax battles and dynamax will be unavailable outside of them. Ingame text has been updated to reflect this behavior. A new configuration header file has been added to control dynamax battle behavior (i.e. controlling if mega/z/tera can be used, setting if opponents can dynamax, etc.)
Added an NPC to all battle facilities (Frontier Facilities and Trainer Tower) which allows you to change the battle music within the facility. NPCs still need to be added for the battle tents located throughout the game.
Removed Cherish Ball / Gold Bottle Cap from stores, added NPC for exchanging Battle Points for those items (50 each) to Battle Frontier Underground Pokémon Centre, reorganised shop items
Added fully working Pokémon Centre to (with respawn point) to Battle Frontier Underground, added Gimmighoul Coin / Leaders Crest item effects
Resolved merge conflicts, new teachable moves, text improvements, updated rom name, changed Ursaluna-BM to use standard Ursaluna sprite temporarily
Created Game Corner Currency Converter, added to the top left of both the Mauville Game Corner and the Battle Frontier Underground Game Corner
Removed fade to black from Pokémon salespeople, added multichoice text for all breeder options, implemented Pokémon breeder for all species, minor refractor to add some missing species
Updated move tutor prices, fixed berry/bottle cap descriptions, made photon geyser single target, fixed bleakwind/wildbolt/sandsear storm accuracy,
Implemented system for exchanging Gold Bottle Caps for shiny Pokémon in both the legendary Pokémon counter and the Pokémon breeder, added optional allow battle z-moves in battle frontier switch, reduce held item animation time
Hidden Power type is now displayed accurately in the summary menu, move teacher menu, and in battle. Code has been developed based on the guides provided by LOuroboros and Jirachii.
Added fully working Game Corner to Battle Frontier Underground, where the greeter outside gives you a coin case if you do not already own one. Balls can now be used on a Pokémon from the bag menu to swap the ball the Pokémon is in. The original ball is returned to the player's inventory. Battle frontier species checks have now been disabled for the open rules mode, allowing all Pokémon (incl. Mythicals) to be allowed. The level cap has also been reduced to level 50.
Merged code from pokeemerald-expanded upcoming branch into dev, updated evolution methods for all unobtainable evolutions (i.e. Hisuian formes, etc.) using a linking cable, new Paldean Pokémon with unimplemented evolution methods have been given item evolutions. Updated item prices, underground item shop layouts, and Pokémon breeding helper messages.
Last used bike is now remembered, and will not be reset back to Acro bike each time you
get off it. Several item prices have been reduced. Signs have been added to all of the
entrances to the Battle Frontier Underground, and the Battle Dome Underground Entrance
has been moved to make it more accessible. Added a new file ENCOUNTERS.md which lists
all of the locations where Pokémon can be encountered, generated by Spawn Table Analyzer.
Fixed move tutor, improved relearn tutor. Improved flow for move tutor conversation loop (both). Fixed Genie signature moves to be spread, however they still do not have perfect accuracy in rain. Further improved underground layout, added shop clerks for both new (Expansion) and original key items, implemented support for gender-specific flags in sandbox mode startup script. Other minor improvements
Remodeled underground interior, implemented dev sandbox mode code (Within starting truck). Working move relearner has been created for tutor/egg moves, and has been added to both the Battle Frontier Underground and the original Move Tutor house. Instead of requiring a Heart Scale, both tutors now cost for $2000 per move.
Added Porymoves combined teachable_learnsets to teachable_learnsets.h, which will allow Pokémon to be taught
moves they learnt in any game after Black and White 2, except for Pokémon Let's Go Pikachu and Eevee.
Minor improvements have been made to the Battle Frontier Underground map layout, and development for a move tutor for allowing Pokémon to be taught egg/tutor/other moves has been started.
Merged upcoming features into main branch, resolved associated merge conflicts. Updated wild encounters json file with randomly generated wild encounters, using Wild Encounter Randomiser. These spawn tables are likely to be modified in the future, as the Wild Encounter Randomiser is developed and improved.
Implemented Bottle Cap function for maxing all ivs, durin/belue berry for 0 Attack / Speed respectively. Added TM/HM sellers to underground as well as added basic item / pokeball seller.
Created work-in-progress currency converter (BP -> $, $ -> BP), as well as more battle item shops. Reworked battle frontier underground layout to make it smaller and easier to navigate.
Implemented basic Pokémon breeder code, for selling basic Pokémon within the Battle Frontier Underground Day Care. Training Item/Berry Sellers, signs, and many placeholders and other basic features have been added.
Legendary Pokémon shop has now been implemented for all legendaries, using the new left/right bumper navigation system to simplify navigation. Instructions for how to navigate the menu are displayed in the chat window. Several new underground shops have been added, for purposes such as ev/iv training, battle items, tm/hms and more.
Legendary seller has been implemented up to generation six, and an additional feature has been added to multichoice2 which allows for the 'left' and 'right' bumpers to be accepted as inputs, similar to the 'b' button. This has been used for tabbing between Pokémon seller menus, rather than needing to have an additional item at the bottom of the menu.
Battle Frontier Underground Day Care service has been added, with an entrance next to the Legendary Pokémon sales counter. Legendary Pokémon seller has been implemented up to the first three generations.
Started work on Battle Frontier Underground Legendary Pokémon sales counter, which will be able to sell any Legendary Pokémon to players for a flat price ($12000).
Started working on Battle Frontier Underground area, which will include shops for every type of item as well as various facilities such as a Day Care and Game Corner.
Basic floor plan has been created, and map warps with the Battle Frontier overworld (both East and West) have been created.
Implemented flags to optionally allow duplicate items and species, merged changes from PokeEmerald-Expanded upcoming branch, resolved issues related to level scaling system - level scaling now works without issues for both open level (level 100) and level 50 rules.
Implemented level scaling system for Battle Frontier facilities, which allows for Pokémon above level 50 to participate in level 50 battles and optionally, Pokémon below level 50 can be raised to level 50 or level 100 in Open Battles. As a result, the minimum level for Open Battles has been raised to 100 to ensure Pokémon all have the same level.
Implemented voloved's PC Access in PokeNav tutorial, as well as allow Move Relearner to Teach Moves that Pre Evolutions Know. Implemented Diego Marten's Move Relearner as an option in the Pokémon Party Screen tutorial. Implemented Lunos's Party swap with select tutorial, as well as Nicknaming as an option in the Pokémon Party Screen
Implemented Lunos's 2-in-1-bike
tutorial, and modified the bike shop scripts to adjust it for the new behavior. Swapped the order of battle
mechanic items to be the following:
Battle mechanic items (e.g. Mega Power Ring) will now be recieved during the story, after defeating the 2nd, 4th, 6th and 8th gyms respectively. The order is as follows:
Special sellers in each Pokemart have been completely reworked, and the item table for each has been overhauled to provide a variety of unique items for the player to use while progressing through the game. Mega Stones, Z-Crystals, Dynamax Candies and Tera Shards will be made available in each special shop where other items of the same type are also available (e.g. Sootopolis will have Dragonium Z and Tera Dragon Shards). Trainer Hill, Lilycove Department Store, Evergrande City and the Battle Frontier all have unique secondary special shops which do not follow the general pattern of the other special shops.
Removed unnecessary files, modified item prices, fixed issues with mochi seller, added special shop vendors with static, randomised contents to each Pokemart. Implemented and tested multichoice2, which allows for an easy method for implementing multiple choice menus.
Completed rough spawn tables up to route 120, with recurring patterns for water/fishing encounter tables and mostly new spawn tables for wild encounters (Original wild encounters remain available, but with lower spawn rate).
Merged upcoming branch of PokeEmerald-Expanded into the project, which adds support for several new features including all of the Generation 9 Pokémon (so far), Dynamax, most of the new items, and more. Resolved several merge conflicts which were caused as a result of this change.
Updated spawn tables for route 101, 102 and 103 with new wild encounters, as well as water and fishing encounters where applicable. All (Non-Department Store) PokeMarts have now been updated to use the same item list, which is dependent on the number of badges the player has. Modified Pokemarts to have stock dependent on the number of badges the player has earned.
Implemented EV/IV increasing/decreasing items - Some Pokeblock-only berries have been repurposed to increase or decrease IVs by one, and Zinc/Carbos/etc. have been modified to provide 28 EVs at a time in their respective stat, requiring only 9 to reach the maximum value (252). Feathers have also been modified to provide 4 of their respective stats, which can be useful for building more fine-grained EV spreads. EV-reducing berries have also been modified to reduce stats by 28. Item descriptions have been updated to reflect the new behavior. New TM behavior has been tested and verified. A bug was fixed where mom would be placed outside (for the running shoes encounter), even though this encounter has been removed from the game.
Updated TM behavior based on this tutorial, now infinitely reusable and cannot be sold / bought more than once. Text references to TMs have now been updated to reflect new behavior. Replacing a move with a new move will no longer refresh the PP for the move slot
Implemented Poryscript to build pipeline, converted all pre-existing map script.inc files to .pory format, removed running shoes event when returning to Littleroot town and enabled running shoes flags by default when exiting the truck, Added National Dex upgrade to initial Birch Pokedex event, as well as the battle key items (Mega Ring, Z Power Ring, Dynamax Band), Added follow-up event where these items can be recieved instead of they are missed initially (for migrated save files). Modified EXP.Share to use Gen 6+ behavior (Key item, affects all party members, can be toggled on or off.)
Implemented additional save space (tutorial by Hiram Anderson), keyboard auto switch (tutorial by FieryMewtwo), early FRLG trading (tutorial by FieryMewtwo), sleep mode (tutorial by voloved), mid-battle text skip (tutorial by Mkol103), coloured stats by nature (tutorial by DizzyEgg), show EVs / IVs in summary (tutorial by PokemonCrazy)
Implemented repeated medicine use without re-entering the bag menu (tutorial by ghoulslash), faster text speed (tutorial by ellabrella)
Implemented not showing dex entries until getting the Pokedex (tutorial by Jaizu), an error screen for if a flash chip is not present on the cart (tutorial by Anon822), implemented missing text function RESET_FONT (tutorial by Flametix), fixed surf dismount ground effect bug (tutorial by ghoulslash), fixed camera wave bug (tutorial by LOuroboros), implemented better reflections (tutorial by ghoulslash)
Implemented EWRAM Data summary screen optimisation (tutorial by SonikkuA-DatH)
Updated readme with planned features / credits / other information, release build script
Implemented main/dev/debug branching system, modified Birch's intro Pokémon to Hisuian Zorua (Added SPECIES_INTRO #define for modifying both intro sprite/sound at once).
Cloned PokeEmerald Expansion project base image, unmodified source project is stored in branch 'base'
If you'd like to support this project and other future projects, please feel free to use the paypal domation link below.