JoiPlay Setup Guide: RPG Maker and Ren'Py Games on Android

Last updated: September 2026

JoiPlay is not an emulator. That is the first thing to understand about it, and it is why it runs on handhelds that struggle with anything heavier than PS1. RPG Maker and Ren’Py games are scripts on top of an engine, and JoiPlay ships Android builds of those engines. It reads the game’s files and runs them directly. No emulated CPU, no translation layer, and an Anbernic RG405M plays a 2020 RPG Maker MV game as smoothly as a PC does.

The catch is that the setup is unusual. The app is a shell, the engines come as separate plugins, and the version on the Play Store is dead. Get those three things right and the rest is drag and drop.

What JoiPlay Runs

RPG Maker 2000 and 2003 are not supported. For those, EasyRPG Player is the Android app to use, and it runs on the cheap Linux handhelds too.

Where to Get It

JoiPlay left the Google Play Store years ago and the listing that remains is an abandoned build that crashes on modern Android. The maintained version comes from two places:

• The official JoiPlay site, which links the current release and the plugins.
• The developer’s Patreon, where new builds appear first. The public builds are free.

Download three files: the JoiPlay APK, the RPG Maker Plugin APK, and the Ren’Py Plugin APK. Install them in that order. Each one asks Android for permission to install from an unknown source the first time; allow it.

Ignore any site with a domain that looks like the real one with an extra letter. There are several, and they wrap the APK in adware.

First Launch and Permissions

1. Open JoiPlay. It asks for All files access. Grant it. This is the permission that lets it read game folders anywhere on the SD card, and denying it is the single most common cause of the “game crashes on launch” complaint.
2. It checks for the plugins. If either shows as missing, install the plugin APK and reopen the app.
3. Tap the Settings icon (top right) once to look at the defaults. Nothing needs changing yet.

Adding a Game

RPG Maker and Ren’Py games come as folders, usually inside a zip. Extract the zip on the device with a file manager, or extract it on a PC and copy the folder over USB.

1. Put the extracted game folder somewhere sensible. I use Games/JoiPlay/ on the SD card with one subfolder per game.
2. In JoiPlay, tap the plus button.
3. Executable File: browse into the game folder and pick the launcher. For RPG Maker XP, VX and VX Ace that is Game.exe. For MV and MZ it is Game.exe as well, or index.html inside the www folder if there is no exe. For Ren’Py it is the .exe in the root or the .py file with the same name as the game.
4. Name and Version fill themselves from the file. Change the name if you want.
5. Tap Add, then tap the game tile to launch.

JoiPlay detects the engine from the file you pick and loads the matching plugin. If it picks the wrong one, long-press the game tile, choose Edit, and set the engine manually.

RTP Files for Older RPG Maker Games

RPG Maker XP, VX and VX Ace games often ship without their default assets and expect the engine’s Run Time Package to be installed on the PC. On Android there is no RTP install, so a game that depends on it shows missing-file errors at launch.

The fix is on the PC side: download the matching RTP from the RPG Maker site, install it, then copy its Graphics and Audio folders into the game’s folder before you move the game to the handheld. Merge, do not overwrite; the game’s own files take priority over the RTP’s.

MV and MZ games bundle everything, so this only bites on the older engines.

Controls

JoiPlay maps a handheld’s physical controller automatically: d-pad and left stick move, A confirms, B cancels, and the shoulder buttons scroll menus. A touchscreen overlay appears on phones without a controller.

For anything beyond that, open Settings > Controller and map the keys. RPG Maker games mostly use the arrow keys, Enter, Escape and Shift, so binding Shift to a shoulder button gives you the dash that most games hide there.

Settings Worth Changing

The cheats menu is a JoiPlay feature, not a hack of the game. It reads the RPG Maker variables directly, which is why it works on any game built on the engine.

Common Problems

Game crashes immediately. All files access was denied, or the game folder is inside another zip. Check the permission in Android Settings > Apps > JoiPlay, then check that the folder contains the game files directly.

Black screen after the title. Usually an incompatible RPG Maker plugin inside the game itself (the game’s JavaScript plugins, not JoiPlay’s). Long-press the game, open Edit, and try switching the RPG Maker MV plugin version between the options listed. If it still fails, the game uses a desktop-only feature and will not run.

Missing file errors on an XP, VX or VX Ace game. RTP. See the section above.

Ren’Py game runs but text is blank. The game’s font is Windows-only. In Edit, enable the default font override.

Slow on a cheap device. MV and MZ games render through a web engine and the heaviest ones want a real GPU. On an RG405M-class chip, turn the game’s own graphics options down (most have them under Options in the title screen) and disable screen effects.

Plugin shows as missing after an update. JoiPlay and its plugins update separately, and a new JoiPlay sometimes needs the newer plugin. Install both from the same release date.

What About the Linux Handhelds?

JoiPlay is Android only. On a Miyoo Mini or an RG35XX running muOS or OnionOS, the equivalent is PortMaster, which ships native ports of specific games rather than engine runtimes. EasyRPG covers RPG Maker 2000 and 2003 on those devices, and there is no general Ren’Py runtime for them. If your library leans RPG Maker MV, an Android handheld is the right tool.

FAQ

Is JoiPlay free?

Yes. The app and both plugins are free. The Patreon funds development and gives early access to builds; the public releases are the same software.

Is JoiPlay safe?

The builds from the official site and the Patreon are. The Play Store version is dead, and the copycat sites bundle adware. Download only from the official links.

Does JoiPlay run RPG Maker 2003 games?

No. Use EasyRPG Player for RPG Maker 2000 and 2003.

Can I use my PC saves?

Yes. RPG Maker saves are files in the game folder (save or www/save). Copy them across with the game and they load.

Why does the game need the RTP?

Older RPG Maker engines let developers leave out the default assets to keep downloads small, assuming players had the Run Time Package installed. Android has no RTP, so you supply those assets yourself.

JoiPlay official site | EasyRPG Player | RPG Maker RTP downloads

Last verified: September 2026