Patch games on Android with HTPatcher CLI and Termux

You can patch RPG Maker games on a phone. This guide uses Termux and the same htpatcher-cli we ship in HTPatcher releases.

We do not host games. You need your own copy of the game files, plus a translation from htranslations.com.

What you need

• An Android phone with enough free storage for the game
• Termux from F-Droid (the Play Store build is outdated and often broken)
• The game folder on the phone (Game.exe, or an unpacked MV/MZ folder with data, js, and img)
• The store code from the translation page, such as RJ01234567 or d_123456

1. Install Termux and allow storage

Install Termux from F-Droid, open it, then give it access to shared storage:

pkg update -y
pkg install -y curl unzip
termux-setup-storage

termux-setup-storage prompts for permission. After that, phone storage is available as ~/storage/shared (the same place as /sdcard).

2. Download htpatcher-cli

Use the Android ARM build from HTPatcher releases, not the plain htpatcher-cli file (that one is for desktop Linux):

curl -L https://github.com/HTranslations/HTPatcher/releases/latest/download/htpatcher-cli-android-arm64 -o htpatcher-cli
chmod +x htpatcher-cli

Run it from this same folder as ./htpatcher-cli.

3. Find the store code

Open the translation on htranslations.com/translations. The store code is in the title, for example [ENG] [RJ01234567] Game Name.

You can also list every patch the CLI knows about:

./htpatcher-cli list

4. Patch

--game must be a file inside the game folder (Game.exe, or another file next to data/js/img). If the game is still zipped:

unzip ~/storage/shared/Download/game.zip -d ~/storage/shared/Download/MyGame

The CLI can download the .htpatch for you:

./htpatcher-cli patch --game ~/storage/shared/Download/MyGame/Game.exe --store-code RJ01234567

A backup is created by default. --launch is Windows-only, so skip it on Android.

Then open that folder in whatever Android player you use for RPG Maker games (JoiPlay is a common choice for MV/MZ).

5. Undo a patch

./htpatcher-cli restore --game ~/storage/shared/Download/MyGame/Game.exe

Troubleshooting

If something else fails, bring the CLI output to the community or contact us.