Graphic User Interface of the editor
More Previews
Level Editor section
3D Model Viewer
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.
If you don't know how to use this program, please see the User Manual.
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 + wav (Using the actimagine submodule, WIP)
- Import/Export bmp
- 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
- 3D Model Viewer (WIP)
- 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*
- 3D Model Exporter/Importer*
*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.
If you are on Windows 11, you can download the latest binary release.
Otherwise, or if you want the most up-to-date version, you will want to run the program from source code:
- Download&Install Python (using 3.14.7)
- Now that you have Python, you can use pip (Package Installer for Python) to install the following modules:
- Download&Install NDSPy (using 4.2.0)
- Download&Install PyQt6 (using 6.11.0)
- Download&Install PyOpenGL (required for 3D rendering, using 3.1.10)
- 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
- The submodule > Code > Download ZIP
- Extract the actimagine folder in lib
- That's it! Now you can run MME_NDS.py with python (or you can run RunEditor.bat on Windows).
- 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