haven1433 / HexManiacAdvance

A tool for editing tables, text, scripts, images, and other data in Pokemon GBA games
MIT License
243 stars 55 forks source link
hex-editor pokemon-gba-games

Hex Maniac Advance

HexManiacAdvance is an all-purpose editor designed for editing Pokemon GBA games. It specifically targets the English games Ruby (AXVE), Sapphire (AXPE), FireRed (BPRE), LeafGreen (BPGE), and Emerald (BPEE). It has a reduced set of features when opening other files.

Other than standard hex editor features like view/edit, copy/paste, and diff, it also provides improved navigation, display, and editing for working with data within the files. It also has custom editors for complex data like code, images, maps, and the pokedex.

Screenshot

What Can HexManiacAdvance do for me?

Data Editing

Map Editing

Text Editing

Image Editing

Code Editing

Utilities

Community

Here's a quote about the tool from Asith, Pokemon GBA Rom Hacker. Maker of Spectrobes GBA, judge from MAGM4, winner of MAGM5.

HexManiacAdvance is now a must-have binary hacking tool. It does what all the old tools did but better and safer, essentially being an all-in-one toolkit. You can make an entire hack using only HMA, and when that's combined with its QoL features and safety nets to not break your rom, there's no reason to use tools of the past. I'm especially impressed with how its new map and script editors have ousted AdvanceMap and XSE - tools that were the only option for a decade - by immediately being 10 times better to use. It has changed the binary hacking standard to the point where classic binary hacking and HMA hacking are completely distinct and I can't imagine working without it.

Getting Started

As a User

Go visit the releases page to grab the latest public build.

Visit the Wiki to see a user guide, tutorials, and other resources.

Visit the Discord to connect with other users.

Running HexManiacAdvance requires Windows and .Net 6.0: x64 x86

As a Developer

Clone or download the project, then open the solution with Visual Studio 2022.

Once you have the solution open in Visual Studio, you can find the XUnit automated tests in the test explorer window. Note that some tests expect you to have roms in a folder called "sampleFiles" within ..\HexManiac\artifacts\HexManiac.Tests\bin\Debug\net6.0.

For information on the achitecture of the application, see the Developer Guide.

License

This project is licensed under the MIT License - see the LICENSE file for details.