JoiPlay Plugin Not Detected? How to Make JoiPlay Recognize Your Plugin

You installed the plugin, you can see it on your phone, and JoiPlay still tells you the plugin is missing when you try to launch your game. If you are facing the JoiPlay plugin not detected issue, it can be frustrating, but it does not necessarily mean the plugin is broken. The problem usually occurs because JoiPlay and the plugin are not paired correctly, the plugin does not match your game engine, or the app has not refreshed since installation. This guide walks you through six practical fixes in a sensible order, starting with checking engine compatibility and ending with removing old or duplicate plugin copies.

How JoiPlay Detects Plugins

JoiPlay is not one single app that runs every game type on its own. It is a main app plus separate plugin apps that pair with it. Each plugin adds support for one family of games, and it runs quietly in the background once it is installed.

You never need to open a plugin by itself. A plugin on its own does nothing, has no game library, and will not launch a game if you tap it. Its only job is to be there, installed, when JoiPlay needs it for a matching game.

When you press play, JoiPlay checks which engine the game uses and looks for the matching plugin. If the check fails, you get a missing plugin message or a game that will not launch. This explains most detection problems:

• ✅ The plugin is installed after the main app, and JoiPlay has been closed and reopened since then
• ✅ The plugin matches the exact engine your game was made with
• ✅ Both apps come from official sources and are on current builds
• ❌ The plugin was installed before the main app, so the pairing got confused
• ❌ An old or duplicate plugin copy from another source is still on the phone
• ❌ JoiPlay is still running an old session from before the plugin was installed

For the full picture, our guide to JoiPlay Plugins Explained breaks down every plugin in plain language. Work through the fixes below first, because most errors clear within the first three.

Fix 1: Confirm the Plugin Actually Matches Your Game Engine

The most common cause of a joiplay plugin not detected error is simple: the wrong plugin is installed. Your phone can hold the Ren’Py Plugin perfectly well, but that plugin will never help an RPG Maker XP game, and JoiPlay will keep asking for the one it actually needs. Start by checking what engine your game uses:

1. Open the game folder in your file manager.
2. Look at the files inside the folder, not just the folder name.
3. Check for Game.exe with .rgss, .rgss2a or .rgss3a files, which point to older RPG Maker games.
4. Check for .rpy or .rpa files, which point to a Ren’Py game.
5. Check for an index.html file, which points to an RPG Maker MV, RPG Maker MZ or HTML game.

Then match the plugin to what you found:

• RPG Maker XP, VX and VX Ace games need the RPG Maker Plugin, covered in our JoiPlay RPG Maker Plugin guide
• Ren’Py games need the Ren’Py Plugin, covered in our JoiPlay RenPy Plugin guide
• RPG Maker MV and MZ games need no plugin at all
• HTML games need the Crosswalk Plugin, which comes as an APK from the official site, not the Play Store
• Flash games need the Ruffle Plugin

If your game is an MV or MZ title and you are chasing a plugin error, the problem is probably not a missing plugin at all. Skip ahead to the restart and reinstall fixes, because those games run through the main app itself.

Fix 2: Force Close JoiPlay Fully and Reopen It

JoiPlay may need a full close and reopen to detect a plugin you just installed. Swiping the app away from the recent apps screen does not always close it fully, and a half open session can keep using old information. Do a proper force close:

1. Open Settings on your phone.
2. Tap Apps, then find and tap JoiPlay.
3. Tap Force stop and confirm if your phone asks.
4. Wait a few seconds so the app closes completely.
5. Reopen JoiPlay from your app drawer.
6. Add or open your game again and press play.

This sounds too simple, but it fixes a lot of reports. The plugin was fine, the main app just had not looked again since it arrived. If the error stays, move on to checking the install itself.

Fix 3: Check in Android Settings That the Plugin Finished Installing

A download can finish while the install quietly fails. The icon may even appear, yet Android never completed the install, so JoiPlay has nothing real to detect. Confirm the plugin is properly installed:

1. Open Settings and tap Apps.
2. Tap See all apps if your phone hides the full list.
3. Search for the plugin name, such as RPG Maker Plugin for JoiPlay or Ren’Py Plugin for JoiPlay.
4. Tap the plugin entry to open its App info page.
5. Check that the page opens normally and shows options like Uninstall and Disable, or similar labels on your phone.
6. If the plugin is missing from the list, it was never installed, so install it again.

A plugin bundled with a random game download is a common source of trouble later. Official sources matter, and Fix 5 covers that.

Fix 4: Uninstall and Reinstall the Plugin After the Main App

Install order matters more than most people expect. Installing plugins before the main app can cause pairing confusion, and a reinstall in the right order often fixes detection in one go. Reinstall in the correct order:

1. Open Settings, then Apps, and uninstall the plugin only.
2. Leave the main JoiPlay app installed, so your game library stays in place.
3. Force close JoiPlay using the steps in Fix 2.
4. Download the plugin again from an official source.
5. Install the plugin like a normal Android app.
6. Open JoiPlay again and try your game.

A few points help:

• ✅ Reinstall only the plugin before you consider reinstalling everything
• ✅ Download a fresh copy instead of reusing an old APK sitting in your Downloads folder
• ❌ Do not uninstall JoiPlay itself unless nothing else works, since that resets your setup
• ❌ Do not install two copies of the same plugin from different places

If your whole setup has wider problems beyond one plugin, our JoiPlay Not Working guide covers the general checks to run next.

Fix 5: Update JoiPlay and the Plugin to Matching Current Builds

Plugins and the main app are updated separately, and a big gap between them can break detection. An old plugin may not pair with a newer JoiPlay build, and an old main app may not recognise a newer plugin. Update both sides safely:

1. Note that the Google Play listing for JoiPlay no longer resolves, so use official downloads instead.
2. Get the main app and plugins from homepage.
3. Install the updated main app first.
4. Install the updated plugin after it.
5. Force close and reopen JoiPlay, then test your game.

The latest public version referenced on this site is 1.22.000. Treat any site promising a special newer build with caution. Modified APKs from random sites are a regular cause of pairing errors and plugins that never get detected.

Fix 6: Remove Duplicate or Old Plugin Copies From Other Sources

If you have tried plugins from a few places, your phone may hold more than one copy of the same plugin. JoiPlay can end up checking an old or broken copy while the good copy sits unused, which makes the error look random. Clean up your plugin copies:

1. Open Settings, then Apps, then See all apps.
2. Search for each plugin name one at a time.
3. Look for duplicates, very old entries, or copies you do not recognise.
4. Uninstall every copy of that plugin.
5. Restart your phone once, so Android clears out leftover app records.
6. Install one fresh copy of the plugin from an official source, after the main app.
7. Open JoiPlay and test the game again.

Keep this rule: one plugin, one official copy, kept up to date. Different plugins can sit side by side, because they do different jobs. Duplicates of the same plugin are the problem.

Quick Refresher: Which Plugin Does Your Game Need?

Use this table when a game will not launch and you are not sure which file to select or which plugin should be present.

Selecting the wrong file can look like a plugin problem. For older RPG Maker games, pick Game.exe, even though you are on Android. Picking a data file instead will fail like a detection error.

Before You Try Again, Run This Checklist

• ✅ The plugin matches your game engine, not just the game genre
• ✅ JoiPlay was force closed and reopened after the plugin install
• ✅ The plugin appears in Settings, Apps, with a normal App info page
• ✅ The main app was installed before the plugin
• ✅ Only one copy of each plugin is on the phone

Conclusion

A joiplay plugin not detected error is almost never a dead end. In most cases the plugin is wrong for the engine, the app has not restarted since the install, or an old copy is confusing the pairing. Work through the fixes in order and test your game after each one, so you know which step solved it. Once the right plugin is detected, you should not need to think about it again. It will sit in the background and do its job every time you launch a matching game, which is exactly how the system is meant to work.

Frequently Asked Questions