JoiPlay Virtual Gamepad: Customize Layout, Size and Opacity
The default touch layout in JoiPlay is a compromise, built to suit everyone and perfect for no one. Buttons sit where your thumbs do not, the pad covers the artwork you want to see, or a menu heavy game needs keys the default set buries. Good joiplay virtual gamepad customization fixes all of that in a few minutes. The official JoiPlay site even lists customizing the virtual gamepad overlay as a core step of setting up each game. This guide shows where the settings live, how to move, resize and fade the buttons, and how to keep a different setup for each game type. If you are brand new to the app, What Is JoiPlay? explains the basics first.
Global Settings vs Per-Game Settings
JoiPlay splits control options across two places, and knowing which is which saves a lot of confusion:
- App level settings: open JoiPlay Settings from the main screen. This is where Gamepad Settings live, including the option to hide the virtual gamepad entirely. Changes here affect the app as a whole.
- Per-game settings: each game can keep its own overlay arrangement, adjusted from inside the running game. The official site describes this as adjusting settings for your title, so the layout that suits a visual novel does not have to suit an RPG Maker game.
Exact menu labels vary a little between builds, so if a name below does not match your screen word for word, look for the closest equivalent. The features themselves have been part of JoiPlay for a long time.
Step by Step: Open the Gamepad Editor
You edit the overlay from inside a running game, because that is where you can see it against the game itself.
- Launch any game from your library.
- Look for the overlay controls at the top of the screen. Tapping the controller icon shows or hides the on-screen buttons.
- Tap the gear or Settings icon in the overlay bar to open the in-game settings.
- Find the gamepad or controls section. This is where you choose which keys appear on the overlay.
- Switch to the edit or customize mode if your build shows one, so buttons can be dragged instead of pressed.
💡 Tip: edit your layout in a safe spot in the game, like the title screen or a quiet town, so stray taps while you work do not cost you progress.
Move and Resize the Buttons
Once you are in edit mode, most builds let you drag buttons to new positions with a long press and a drag. Work through it methodically:
- Drag the D-pad to the exact spot your left thumb rests naturally.
- Drag the action cluster (Confirm, Cancel, Menu) under your right thumb.
- Move rarely used keys, like Shift for dashing, slightly further away so you do not hit them by accident.
- Enlarge the buttons you press constantly and shrink the occasional ones, using the size option in the editor where your build offers it.
- Exit edit mode and play for two minutes before judging. Your thumbs will tell you what your eyes cannot.
Keep the confirm and cancel buttons clearly apart. In the standard RPG Maker layout, confirm is Z or Enter and cancel or menu is X or Escape, and mixing them up mid battle is the most common layout complaint.
Adjust Button Opacity
Opacity controls how see-through the buttons are, and it is the single biggest comfort setting in JoiPlay. Solid buttons hide dialogue and artwork. Faded buttons let the game show through but can be hard to find in bright scenes.
- Open the in-game settings from the gear icon while a game is running.
- Find the opacity or transparency slider for the gamepad buttons.
- Start around the middle and adjust in small steps, testing against both a dark cave scene and a bright outdoor scene.
- Settle on the lowest opacity where you can still find every button instantly, without looking.
Note that this is about the overlay only. If the game graphics themselves render wrongly see-through or faded, that is a different problem entirely, and our JoiPlay Opacity Error Fix guide covers it.
Add or Remove Buttons for Your Game Type
More buttons is not better. Extra keys clutter the screen and invite mis-taps. Match the overlay to the game:
| Game type | Buttons worth showing | Can usually hide |
|---|---|---|
| RPG Maker XP, VX, VX Ace | D-pad, Confirm, Cancel/Menu, Shift (dash) | Extra letter keys the game never uses |
| Pokemon Essentials fan games | D-pad, Confirm, Cancel, Menu, plus any extra action key the game lists in its own controls screen | Duplicate confirm keys |
| RPG Maker MV and MZ | A compact set, since these games also accept taps directly on the screen | Most letter keys |
| Ren’Py and TyranoBuilder visual novels | A minimal set, or none at all, since taps advance the text | The full keyboard style layout |
Check the game’s own options or help screen once. Some fan games map special features, like a registered item or a speed toggle, to a specific key, and that key earns its place on your overlay.
Portrait vs Landscape Layouts
Most JoiPlay games are built for landscape, and your main layout should be tuned there first. If you also play in portrait, for example with visual novels, check the overlay again in that orientation. Buttons that sit perfectly in landscape can crowd the text box in portrait, and the comfortable thumb zones move.
A practical approach is to keep portrait minimal: a small confirm button low in the screen, cancel within reach, and everything else hidden. You can always open the settings and show more keys for a menu heavy section, then hide them again.
Building a Layout That Fits Your Hands
Good layouts follow your thumbs, not the screen edges. A few principles make any layout feel right much faster:
- Work in the bottom corners: your thumbs rest at the lower left and lower right, so the D-pad and the main action buttons belong there, not halfway up the screen
- Keep the center clear: the middle of the screen is where characters, dialogue and menus appear, so it should hold no buttons at all in most games
- Space the action cluster: confirm and cancel need a clear gap between them, because a mis-tap during a battle or a save prompt is the costliest mistake touch controls offer
- Test with both thumbs moving: walk diagonally, open and close the menu, and dash in a straight line; if any move feels like a stretch, the layout is not done
- Shrink before you move: when a button keeps getting hit by accident, making it smaller often works better than moving it, because your thumb already knows where it is
For one handed play, which suits visual novels and slower menu driven games, slide the whole essential set toward your dominant side and fade the rest out of the way. You can rebuild the full two handed layout for action heavy games under their own per-game settings.
Hide the Gamepad Completely
For games you play mostly by tapping, or when you switch to a physical controller, the overlay can go away entirely:
- Open JoiPlay Settings from the main screen.
- Tap Gamepad Settings.
- Enable Hide Virtual Gamepad.
With the overlay hidden, remember how you exit a game before you start playing, since the on-screen exit controls may hide with it. The star or tab control at the top of the screen is the usual route back to the launcher in current builds. For pairing and mapping a physical pad instead, see our full JoiPlay Controller Setup Guide.
Save Your Layout and Reset to Default
Per-game changes are kept for that game once you leave the editor, so build your layouts one game at a time and test each in real play. If a layout experiment goes wrong, do not fight it button by button. Look for a reset or default option in the same gamepad settings area and start again from the standard arrangement. Resetting the overlay only affects the controls. Your saves live inside the game folder and are never touched by gamepad settings.
When to Rebuild a Layout From Scratch
Sometimes tuning is the wrong tool. Start over from the default arrangement when you switch to a phone with a different screen size, because every position was measured against the old display. Do the same when a layout has been edited so many times that buttons overlap in ways you no longer remember choosing, or when you hand the phone to another player whose hands are simply different from yours. A rebuild takes two or three minutes once you know the principles in this guide, and a clean layout you understand beats a patched one you fight. Your per-game settings for other titles are untouched by resetting one game’s pad.
Troubleshooting Gamepad Problems
| Problem | Likely cause | Fix |
|---|---|---|
| Buttons do not appear at all | Overlay hidden, or the controller icon toggled off | Tap the controller icon, then check Hide Virtual Gamepad is off |
| Buttons respond a beat late | Phone under load, or the game itself is running slowly | Work through our JoiPlay Lag Fix steps |
| One game ignores the overlay | That game reads taps directly, common with MV and MZ titles | Play it with taps, or connect a physical controller |
| Layout changes will not stick | Editor closed without confirming, in some builds | Reopen the editor, make one change, exit cleanly and reopen the game |
| Buttons cover the text box | Layout tuned for a different orientation | Reposition for the orientation you actually play in |
Conclusion
A few minutes of joiplay virtual gamepad customization pays off in every session after it. Put the D-pad and action buttons where your thumbs already are, fade them until the game shows through, and strip each game’s overlay down to the keys it really uses.
Remember the two homes for these options: JoiPlay Settings and Gamepad Settings for app wide choices like hiding the pad, and the in-game gear menu for per-game layout, keys and opacity. Tune one game, play it properly, then repeat for the next.