Skip to content

On-screen buttons ​

What players see is on Touch controls. This page is the controls part of the game's settings:

json
"controls": {
  "enabled": true,
  "showOn": "touch",
  "gamepad": true,
  "dpad": true,
  "opacity": 0.2,
  "scale": 1,
  "extras": ["fullscreen", "editLayout"],
  "buttons": [
    { "key": "one", "label": "Items", "hint": "Inventory" },
    { "key": "five", "label": "Quickbar", "hint": "Show or hide the quickbar" },
    { "key": "four", "label": "Candle", "pin": true },
    { "label": "Menus", "keys": [{ "key": "two", "label": "Equip" }, "three"] }
  ]
}

These are the keys of GameDev: The Beginning, the game in this guide's screenshots: its plugin reads the number keys 1 to 5.

KeyValuesDefault
enabledThe whole on-screen gamepadfirst-deploy answer
showOntouch (touch screens), always, nevertouch
gamepadA / B / X / Y (ok, cancel, shift, menu)true
shoulderL / R (pageup / pagedown), needs gamepad. Off because most games never use themfalse
dpadThe D-padtrue
opacity0 to 10.2
scaleButton size multiplier1
extrasfullscreen (a toolbar button on touch screens, ⚙ → Full screen otherwise) and editLayout (⚙ → Edit button layout)both

Extra keys (buttons) ​

The first deploy finds the keys the game's plugins read and asks for a label for each.

Plain buttons go in the ⌨ Game keys panel, with their hint

Pinned buttons stay on screen: Candle, top left

FieldMeaning
keyAn RPG Maker key name (ok, escape…), a name a plugin registers (r, t…), or a keyCode
labelText on the button
hintWhat it does, shown in the ⌨ panel. Filled from the plugin's description
pintrue: on screen as a keycap instead of in the ⌨ panel
keysMakes a group (▾) that opens a row of sub-buttons: key names or { "key", "label" }

With "gamepad": false, every button stays on screen. Buttons for keys the gamepad already presses are hidden. When an update adds keys, the deploy offers buttons for them.

Players can still move and hide buttons; that stays in their browser and does not change these settings.

PolyForm Noncommercial License 1.0.0, plus any use by game creators for their own games. For games you own, played by you.
Screenshots: GameDev: The Beginning by yancharkin, CC BY-SA 4.0 (credits). Not affiliated with Cloudflare or RPG Maker.