Graphic User Interface of the editor
Level Editor section of the editor
Edited dialogue file (talk_m01_en1.bin) in-game
Edited dialogue file (talk_m01_en1.bin) in Mega Man ZX Advent
This is a tool I created in an attempt to make editing Mega Man ZX much easier.
If you need to know where specific assets, values, or code sections are in the game, please see the (unfinished) wiki page, as it contains documentation I accumulated on the game.
Currently, I am focusing on the USA version of Mega Man ZX. This means that the editor's (full) compatibility with other versions of the game is not guarenteed at the moment (although, it's worth noting that the dialogue and level data files MMZXA has use the same structure as in MMZX, and as such, editing those files works for both games).
The editor can edit, export and import english dialogue files and save them to the ROM. Other files can be viewed but I have not yet implemented the code to edit and/or export most of them in a converted format.
- Dialogue text converter (for dialogue "talk_" and message "m_" files)
- Functional User Interface
- Import/Export bin
- Import/Export txt
- VX Export/Import to/from png list + (unusable) wav (Using the actimagine submodule, WIP)
- Import/Export bmp (WIP)
- Togglable patches system
- Playtest button
- Graphics Editor (WIP)
- Font Editor
- SDAT Viewer (WIP)
- ARM Viewer (WIP)
- OAM Editor (WIP)
- Level Editor (WIP)
- Loading room layout in Level Editor
- Modifyable entities in Level Editor
- Find more patches for the game to add to the editor's "patches" tab*
- Find patches and tweaks that are helpful for playtesting purposes*
- Sound/Music Editor*
- Tweaks/Physics Editor*
- Game Logic Editor*
*This feature may not be implemented/is not currently prioritized since I haven't looked into it and/or it looks/is hard to do.
Currently, there are no releases, so:
- Download&Install Python (using 3.14.3)
- Now that you have Python, you can use pip (Package Installer for Python) to install the two following modules:
- Download&Install NDSPy (using 4.2.0)
- Download&Install PyQt6 (using 6.10.2)
- Download&Install audioop-lts (required for audio processing, using 0.2.2)
- Download&Install sounddevice (required for audio playback, using 0.5.5)
- Download&Install matplotlib (required for audio waveform plotting, using 3.10.8)
- Download&Install NumPy (submodule dependency)
- Download&Install Pillow (submodule dependency)
- Download&Install SciPy (submodule dependency)
- This project > Code > Download ZIP
- Extract the contents of the .zip file wherever you want
- That's it! Now you can run RunEditor.bat (or run MME_NDS.py directly, from command line)
- Nitro filesystem handling: https://ndspy.readthedocs.io/en/latest/
- GUI (PyQt6): https://www.riverbankcomputing.com/software/pyqt/
- Icons (with shadow): https://p.yusukekamiyamane.com/
- appicon.ico: Mega Man ZX devs, taken from here and truncated by me using GIMP
- This project uses a submodule
Some parts of code I copied (and modified) from answers to other people who asked for help (for example, on stack overflow) on topics I myself needed help on.
- My brother, who assisted me in the development of most editor features
- KnackiKitsune, who helped me with ARM9 overlays containing level data
