Skip to content

m5kro/RPG-Maker-MacOS-Launcher

Repository files navigation

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.

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

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

About

A launcher to natively play RPG maker MV, MZ, XP, VX, VX Ace, 2000, and 2003 games on MacOS

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published