RPG-Maker-MacOS-Launcher

A launcher to natively play RPG maker MV, MZ, XP, VX, VX Ace, 2000, and 2003 games on MacOS!
Development for this launcher has been completed! Only bugfixes will be released if needed.

Plan/TODO (no particular order)

1. ✅ Add nwjs version selected
   
2. ✅ Toggle for game_en.exe extractor (if for some reason you want to play in japanese?!)
   
3. ✅ Toggle for cheat menu
   
4. ✅ Better logging incase something goes wrong
   
5. ✅ Remember last opened game
   
6. ❌ Look in directory(s) for a bunch of games
   
7. ✅ Export game as standalone app
   
8. ❌ Better looking UI
   
9. ✅ Better looking Icon
   
10. ✅ Save editor
    
11. ✅ mkxp-z (support for RPG Maker XP / VX / VX Ace)
    
12. ✅ Export non MV or MZ game as standalone app
    
13. ✅ Add Midi support
    
14. ✅ Add advanced options for mkxp-z
    
15. ✅ Apply advanced options and midi when exporting mkxp-z games
    
16. ✅ Use Kawariki patches for some windows API calls
    
17. ❌ Extract rgss#a files for VX Ace, VX, and XP games
    
18. ✅ Detect mkxp-z updates
    
19. ✅ Better RPG maker version detector
    
20. ✅ Fix possible file permissions issue
    
21. ✅ Remove cheat engine when untoggled
    
22. ✅ EasyRPG (support for RPG Maker 2000 / 2003)
    
23. ❌ Uninstall button for everything
    
24. ❌ Advanced options for EasyRPG
    
25. ✅ Export EasyRPG games as standalone

How it works

1. Downloads nwjs, mkxp-z, and EasyRPG
2. Checks package.json, Game.ini, or RTP_RT
3. Unpacks game_en.exe if it exists
4. Points nwjs, mkxp-z, or EasyRPG to directory
5. Launches game

How to build

Native version (Specifically x64 or arm64 depending on your system):

1. Clone the repo
   git clone https://github.com/m5kro/RPG-Maker-MacOS-Launcher
2. Setup the venv
   python3 -m venv RPGM-Launcher
source RPGM-Launcher/bin/activate
3. Install packages
   pip install PySide6-Essentials evbunpack requests chardet PyInstaller
4. Build the app
   pyinstaller --name "RPG-Maker-Launcher" --add-data Cheat_Menu.js:. --add-data Cheat_Menu.css:. --add-data EasyRPG-Standalone:. --icon ./icon.icns --onedir --windowed main.py
5. Find the app in the dist folder
6. Decativate venv
   deactivate
7. Clear the venv
   sudo rm -rf venv

Universal2 version (works on both x64 or arm64):

1. Download and install Universal2 version of python: https://www.python.org/downloads/macos/
2. Clone the repo
   git clone https://github.com/m5kro/RPG-Maker-MacOS-Launcher
3. Setup the venv
   python3 -m venv RPGM-Launcher
source RPGM-Launcher/bin/activate
4. Install packages
   pip install PySide6-Essentials evbunpack requests PyInstaller
5. Replace charset-normalizer with chardet
   pip uninstall charset-normalizer
pip install chardet
6. Build the app
   pyinstaller --name "RPG-Maker-Launcher" --add-data Cheat_Menu.js:. --add-data Cheat_Menu.css:. --add-data EasyRPG-Standalone:. --icon ./icon.icns --target-arch universal2 --onedir --windowed main.py
7. Find the app in the dist folder
8. Decativate venv
   deactivate
9. Clear the venv
   sudo rm -rf venv

Credits and Special Thanks

Donators:
lecrolonk

Credit to mkxp-z maintainers for mkxp-z
https://github.com/mkxp-z/mkxp-z

Credit to emerladCoder for cheat menu
https://github.com/emerladCoder/RPG-Maker-MV-Cheat-Menu-Plugin

Credit to SaveEditorOnline for the save editor
https://saveeditor.online

Credit to SynthFont developers for the Soundfont
https://musical-artifacts.com/artifacts/841

Credit to Orochimarufan for the Kawariki Patches
https://github.com/Orochimarufan/Kawariki

Credit to EasyRPG team for EasyRPG Player
https://easyrpg.org/player/downloads/#release-macos

Donations

Ethereum Wallet:
0x60F040444876EB5996DfA04CB8d8fc8D2aB96CF7