How to Play HTML5 Games on JoiPlay with the Crosswalk Plugin
You found a fun browser game, you want it on your phone for offline play, and you keep seeing the Crosswalk plugin mentioned next to JoiPlay. This guide on html5 games on joiplay explains what counts as an HTML5 game, what Crosswalk does, and how to install it safely and add your first game through index.html on Android.
What Counts as an HTML5 Game in JoiPlay?
An HTML5 game is built with web technology to run in a browser. Instead of a single Windows program, it is a folder of web files, images, sounds, and scripts.
You will recognize one by its files:
- ✅ A main index.html file that starts the game
- ✅ Asset folders next to it, holding images, audio, and data
- ✅ No Game.exe as the main launcher, which belongs to older RPG Maker types
- ✅ A download labeled HTML5, browser, or web version on the creator page
Many tools export this way, including RPG Maker MV and MZ and TyranoBuilder. The setup is similar, but the plugin picture can differ.
One limit matters right away. Only games with downloadable files can be added. If a game exists only inside a browser tab, you have nothing to extract. Always look for a downloadable build first.
Where People Find HTML5 Games
The most common source is itch.io, where many creators offer both a browser version and a downloadable version.
Check the page carefully:
- Look for a Download section below the browser player
- Prefer downloads labeled HTML5, web, or browser build
- Read creator notes for Android or JoiPlay mentions, where they exist
- Download only from the creator page
Our guide on How to Download Games for JoiPlay covers safe downloading in more depth. A partial download will not launch cleanly no matter which plugin you have. Other sites work the same way: if there is a ZIP with index.html, you can try it. If there is no download, you cannot.
What Is the Crosswalk Plugin and Why Does JoiPlay Use It?
Crosswalk is JoiPlay plugin for running HTML content, named after the Crosswalk web runtime it is built on.
Think of it simply. JoiPlay is the launcher and library. For HTML games, it needs a runtime that can read web content and handle its audio, visuals, and touch input. Crosswalk provides that layer, just as Ruffle handles Flash. Without it, an index.html game may fail to launch or show a blank screen even though the files are fine.
See JoiPlay Plugins Explained for where Crosswalk sits next to every other plugin.
Quick reference:
| Game content | Plugin or runtime | File you select |
|---|---|---|
| HTML5 and general HTML games | Crosswalk | index.html |
| RPG Maker MV and MZ | No plugin | index.html in www folder |
| RPG Maker XP, VX and VX Ace | RPG Maker Plugin | Game.exe |
| Ren’Py | Ren’Py Plugin | Game folder or main script |
| Flash | Ruffle | Main .swf file |
| TyranoBuilder | Built into the main app | index.html |
Not every index.html game needs Crosswalk, because MV and MZ run natively and TyranoBuilder is in the main app. Crosswalk is for general HTML5 content that does not belong to one of those engines.
What You Need Before You Start
Have these ready so the setup runs in one clean pass:
- JoiPlay installed from joiplay.net or the official JoiPlay Patreon public posts
- The Crosswalk plugin, also from an official source only
- A downloadable HTML5 game, ideally a ZIP containing index.html
- A file manager that can extract ZIP files fully
- Enough free storage for the ZIP, the extracted folder, and the plugins
The Google Play listing no longer resolves, so use the website and Patreon public posts. The latest public version referenced on this site is 1.22.000. Do not trust sites claiming newer versions. A plugin from a random APK site can be outdated and cause launch failures.
Step by Step: How to Set Up HTML5 Games on JoiPlay
Follow these steps in order. Do not skip extraction, and do not add the ZIP itself to JoiPlay.
Step 1: Install JoiPlay
- Go to joiplay.net or the official JoiPlay Patreon public posts.
- Download the main JoiPlay app file.
- Install it, allowing install from your browser or file manager if Android asks.
- Open JoiPlay once to confirm it launches to the library screen.
Install the main app before any plugin, or a plugin can go undetected. If JoiPlay is already working, skip to the next step.
Step 2: Install the Crosswalk Plugin
- From the same official source, download the Crosswalk plugin.
- Install it in the same way as the main app.
- If Android asks for Files and Media or Storage permission for the new app, allow it so it can read game files.
- Force close JoiPlay if it was open, then reopen it so it can detect the fresh plugin.
You only do this once. Update Crosswalk from the official source when you update JoiPlay, so the pair matches.
Step 3: Download and Extract an HTML5 Game
Pick a small game for your first test.
- Go to the creator page, for example on itch.io, and find the downloadable build.
- Download the ZIP to your Downloads folder.
- Open your file manager, find the ZIP, and extract it fully with no errors.
- Open the extracted folder and confirm you can see index.html.
- If index.html sits inside one inner subfolder, note that inner folder. That is the folder you will use next.
- Do not rename any files or folders. Browser games rely on exact names and paths, and Android is case sensitive.
If extraction fails, delete the partial folder and extract again.
Step 4: Add the Game to JoiPlay
- Open JoiPlay.
- Tap the + button.
- Choose Add Game.
- Browse to the extracted game folder.
- Select index.html. The full flow for this app is tap the + button, choose Add Game, then select Game.exe or index.html depending on the game type. For HTML5, index.html is correct.
- Set the game name where your build offers it, and add a custom icon if you want.
- Save the entry and confirm it appears in the library.
If the game will not add, you are likely pointing at the outer folder or the ZIP. Select the actual index.html inside the extracted folder.
Step 5: Launch and Test the Basics
- Tap the game in your library to launch it.
- Wait for the title screen. The first load is often the slowest.
- Start the game and check that images, text, and sound load where the game has them.
- Try the main interaction, such as tapping, clicking a menu, or moving a character.
- Save if the game offers an in game save, so you can test loading later.
If the title screen loads and the core interaction responds, your Crosswalk setup is working.
Performance Notes for HTML5 Games
Performance varies a lot by game. HTML5 is a broad label, not a single engine.
A tiny puzzle may run perfectly on almost any phone. A heavy game with large images, many sounds, or complex effects can stutter or load slowly, even on a decent device. That comes from how the creator built the game, not a setting you missed.
Habits that help:
- Close other apps before launching a larger game
- Keep enough free storage, since full storage slows loading
- Give the first load extra time
- Try a smaller game first if a large one struggles
Do not judge Crosswalk by the heaviest game you can find.
Controls: Mouse, Keyboard and Touch Limits
Many browser games were designed for mouse and keyboard, so touch support varies a lot.
What that means in practice:
- ✅ Tap friendly games: Menus, visual novels, point and click, and turn based games usually work well, because a tap works like a click
- ❌ Precise mouse games: Games that need hover or right clicks can feel awkward with touch alone
- ❌ Keyboard heavy games: Games that expect several keys at once may need an external keyboard where your build supports it
- ✅ Controller note: A controller helps some games and does nothing for others, since browser games were rarely built for controllers
Before a long game, spend two minutes testing controls. Can you move, confirm, cancel, and open the menu comfortably? If not at the start, that game is likely better on PC. That is a design limit, not a JoiPlay failure.
If you play Flash games too, see the JoiPlay Ruffle Plugin guide for how Ruffle handles Flash, so you can keep the two plugins straight.
What About Godot and Other Web Exports?
Godot is a common example, and the official description includes Godot (GDScript) support. Treat each web export on its own merits. If a downloadable build gives you index.html and the creator suggests JoiPlay play, test it with the steps above. If only a native PC build is offered, check our page on Godot Games on JoiPlay before assuming it follows the general HTML5 route. The same caution applies to Construct and other web tools.
Troubleshooting HTML5 Games on JoiPlay
Work through these checks in order. Most failures have a simple cause.
| Problem | Likely cause | What to try |
|---|---|---|
| Blank or black screen | Crosswalk not detected, or incomplete extraction | Reopen JoiPlay after installing Crosswalk, then re extract fully |
| Game will not add to library | You selected the ZIP or the wrong folder | Extract first, then select index.html inside the folder |
| Images or sound are missing | Files lost during extraction, or folders renamed | Delete the folder and extract again without renaming |
| Game is very slow or freezes | Heavy game, or phone low on memory | Close other apps, free storage, and test a smaller game |
| Taps do not work right | Game designed for hover or right click | Try an external mouse or keyboard, or play that title on PC |
| Only one game fails | That game files or export are the problem | Redownload that game and try a fresh extraction |
If you are still stuck, update both apps from the official source, check Permissions in Android Settings, Apps, and allow Files and Media where offered. Then test a second simple HTML5 game. If it works, your setup is correct and the first game is the issue.
Quick Checklist: HTML5 Games on JoiPlay
- ✅ JoiPlay and Crosswalk both installed from joiplay.net or the official Patreon
- ✅ Game has a real downloadable build, not just a browser player
- ✅ ZIP extracted fully, with index.html visible and nothing renamed
- ✅ Game added with the + button, Add Game, and index.html selected
- ✅ First launch tested for visuals, sound, and core controls
Conclusion
HTML5 games on JoiPlay work best when you match the right runtime to the right files. Install JoiPlay, add Crosswalk, download a game with a downloadable build, extract it fully, and add it through index.html.
Keep expectations grounded. Light, tap friendly games can feel great on a phone, while heavy mouse and keyboard designs may always suit PC better. Test controls early and start with a small game to confirm your setup.