Pokemon Battle Theater (GBA)

Pokémon Battle Theater – AI vs AI Pokémon Simulator with Custom Trainers, Tournament Modes, and Competitive Battle Sandbox

Pokemon Battle Theater Title Screen

Game Information

Hack Name: Pokémon Battle Theater
Original Game (ROM Base): Pokémon Emerald (pokeemerald-expansion)
Hack Status: v1.20.0, 5/32/2026
Language: English
Content Type: Battle Simulator, AI vs AI Sandbox, Competitive Pokémon Simulator

Table Of Contents



About This ROM Hack

Pokémon Battle Theater is one of the most unique Pokémon ROM hacks currently available because it completely abandons the traditional Pokémon RPG structure and instead focuses on being a dedicated AI vs AI battle simulator. Built using pokeemerald-expansion, the project allows players to pit trainers from across the Pokémon franchise against one another and watch how battles unfold using custom-tuned AI systems.

Rather than catching Pokémon, earning badges, exploring regions, or following a story campaign, players select trainers from a massive roster spanning Generations 1 through 9 and simulate battles in a variety of formats. The hack includes Gym Leaders, Elite Four members, Champions, anime characters, Pokémon World Tournament participants, Pokémon Legends: Arceus characters, VGC World Champions, and many other notable trainers.

One of the hack's biggest strengths is its flexibility. Players can simply spectate battles, take direct control through Pilot Mode, create custom trainers from scratch, import competitive teams from Pokémon Showdown, run tournaments, challenge the Battle Frontier using borrowed teams, or test matchups between virtually any trainers included in the roster.

The project effectively functions as an offline Pokémon battle sandbox, offering a huge amount of replay value for competitive players, theorycrafters, content creators, and fans who have ever wondered how dream matchups between famous Pokémon trainers would play out.


Story Overview

Pokémon Battle Theater does not feature a traditional story mode.

The ROM hack is designed as a battle simulation platform rather than a narrative adventure. Players create matchups, tournaments, and challenges using trainers from across Pokémon history, with the focus placed entirely on strategic battles and experimentation.

Instead of progressing through a storyline, players engage with various battle formats, create custom teams, test competitive strategies, and watch AI-controlled trainers compete against one another.


Key Features

  • AI vs AI Battle Simulator: Watch trainers from across Pokémon history battle each other using custom AI systems specifically designed for simulation gameplay.
  • Massive Trainer Roster: Features roughly 120 curated trainers from Generations 1 through 9, including Gym Leaders, Champions, anime characters, Pokémon World Tournament participants, and Pokémon Legends: Arceus characters.
  • Ash's World Champion Team: Includes Ash's anime championship roster for dream matchups against other legendary trainers.
  • Pokémon World Tournament Content: Features a large selection of Pokémon World Tournament participants, including numerous trainers from Pokémon Black 2 and White 2.
  • Pokémon Legends: Arceus Representation: Includes characters such as Volo, Adaman, Irida, Ingo, Akari, Kamado, Zisu, Beni, and Rei.
  • VGC World Championship Teams: Battle using recreated versions of the famous 2012 World Finals teams used by Wolfe Glick and Ray Rizo.
  • Professor Oak Glitch Battle: Includes the famous unused Generation 1 final boss concept with multiple starter variants.
  • Pilot Mode: Take direct control of one side of the battle and fight against the AI instead of simply spectating.
  • Custom Trainer Builder: Create up to six fully customizable trainers with persistent save support.
  • PKHeX-Style Team Editing: Edit species, movesets, abilities, held items, EVs, IVs, natures, gender, levels, shininess, trainer names, and trainer sprites.
  • Pokémon Showdown Team Import: Import complete Pokémon Showdown teams using compact team codes without requiring internet access.
  • Persistent Custom Trainers: Custom teams remain saved between play sessions.
  • Tournament Mode: Create eight-trainer elimination brackets featuring trainers from across all Pokémon generations.
  • Best-of-N Match Series: Simulate multi-match series with adaptive team selection.
  • VGC Rules Support: Includes official-style doubles battles, level restrictions, and team selection rules.
  • Doubles and Multi Battles: Supports multiple battle formats beyond standard singles battles.
  • Mega Evolution Support: Fully functional Mega Evolution mechanics with AI integration.
  • Z-Move Support: Trainers can properly utilize Z-Moves during battles.
  • Dynamax and Gigantamax Support: Modern battle mechanics have been integrated into AI decision-making.
  • Battle Frontier Challenge Mode: Borrow teams from famous trainers and use them throughout the Battle Frontier facilities.
  • Identity Swap System: Battle Frontier runs can temporarily transform the player into the selected trainer for a more authentic experience.
  • Competitive Endgame Opponents: Includes numerous competitive Pokémon from Generations 4 through 9 featuring Smogon-inspired sets, abilities, EV spreads, items, and battle strategies.
  • Modern Competitive Roster: Encounter Pokémon such as Kingambit, Dragapult, Iron Valiant, Great Tusk, Gholdengo, Flutter Mane, Roaring Moon, Tapu Koko, Mega Lucario, Mega Garchomp, Volcarona, and many others.
  • Custom Battle Backgrounds: Features original artwork created specifically for Battle Theater.
  • AI Improvements: Custom battle AI includes specialized logic for Mega Evolution, Dynamax, Gigantamax, and Z-Move usage.


Known Bugs & Issues

  • The provided information does not include an active bug list.
  • Recent versions have included fixes for issues such as Pilot Mode item usage behavior and earlier save persistence problems affecting custom trainers. As the project continues receiving updates, additional fixes and balance adjustments may occur.


Screenshots

Pokemon Battle Theater SS01Pokemon Battle Theater SS02Pokemon Battle Theater SS03Pokemon Battle Theater SS04

Download Links

v1.20.0: Mediafire


Documentation

(Official Links)
Project links Source + documentation: Github 
All releases: Github 
Latest patch download: Github 
Showdown team-code encoder (offline tool): Github 

Developer Information

Developer / Team: logdog2325
Credits: 

  • Engine & Foundation: pokeemerald-expansion project
  • Battle Theater Background Art: LiYun
  • Trainer Research & Roster Sources: Bulbapedia and Smogon archives
  • Team Code System Inspiration: u/Healthy_Bug7977 and u/LordePachi
  • Battle Frontier Challenge Mode Concept: u/Itchy-Hedgehog-3371
  • Placeholder Title Screen Artwork: u/Itchy-Hedgehog-3371


Source & References

Official Thread / Website: https://github.com/logdog2325/pokemon-battle-theater
Community Link: https://www.hackdex.app/hack/pokemon-battle-theater


Frequently Asked Questions

Q: What is Pokémon Battle Theater?
A: Pokémon Battle Theater is an AI vs AI battle simulator that allows players to create battles between trainers from across the Pokémon franchise rather than playing a traditional Pokémon RPG.

Q: Who is this hack for?
A: This hack is ideal for competitive Pokémon players, theorycrafters, content creators, battle simulator fans, and players who enjoy testing matchups between famous trainers and teams.

Q: Does Pokémon Battle Theater have a story mode?
A: No. The project is focused entirely on battle simulation, team building, tournaments, and competitive experimentation.

Q: Can I play battles myself instead of watching AI battles?
A: Yes. Pilot Mode allows players to directly control one side of the battle while the opposing trainer remains AI-controlled.

Q: How many trainers are included?
A: The game includes approximately 120 curated trainers spanning Generations 1 through 9, along with several custom trainer slots.

Q: Can I create my own trainers and teams?
A: Yes. The Custom Trainer Editor allows players to build trainers from scratch and fully customize every Pokémon on the team.

Q: Are modern battle mechanics included?
A: Yes. Mega Evolution, Z-Moves, Dynamax, Gigantamax, doubles battles, tournament modes, and various competitive formats are all supported.

Q: What is Battle Frontier Challenge Mode?
A: This mode lets players borrow teams from preset trainers and use them throughout the Battle Frontier facilities.

Q: Is Pokémon Battle Theater designed for casual players or competitive players?
A: While anyone can enjoy watching battles, the hack is especially appealing to competitive players due to its advanced team-building tools, simulation options, competitive rosters, and strategic battle systems.