RPG-Maker-MacOS-Launcher

Note

Development for this launcher has been completed! Only bugfixes will be released if needed.
Check out Xenolauncher for a more versatile launcher!

A launcher to natively play RPG maker MV, MZ, XP, VX, VX Ace, 2000, and 2003 games on MacOS!
Custom MKXP-Z fork: https://github.com/m5kro/mkxp-z/tree/RPGM-Launcher

Tip

Instructions video by xem/pgm: https://www.youtube.com/watch?v=NIRiKIjhXHk

Donations

Ethereum Wallet:
0x60F040444876EB5996DfA04CB8d8fc8D2aB96CF7

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

If the prebuilt releases don't work, or you'd like to add a feature, here are instructions on how to build the app:

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

1. Clone the repo
   git clone https://github.com/m5kro/RPG-Maker-MacOS-Launcher
cd 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:. --add-data bg.js:. --add-data disable-child.js:. --add-data disable-net.js:. --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
cd 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:. --add-data bg.js:. --add-data disable-child.js:. --add-data disable-net.js:. --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
athanadoc05

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