Android MAME controller configuration / 2026-08-02

MAME UI controls vs machine controls on Android

Map menu navigation, exit, coin, start, and player inputs at the correct layer without letting one button perform two dangerous actions.

9 minute controller guideOfficial MAME 0.289 input model as exposed by an Android port and its controller provider

MAME UI controls vs machine controls on Android

MAME's user-interface controls operate menus and session actions, while machine controls feed the emulated cabinet. On an Android controller, inspect and assign those groups separately: prove UI Menu, UI Back, and UI Cancel first, then coin, start, directions, and buttons for the current system. Avoid a single unmodified button that both plays and exits.

Do this in order

  1. 01

    Connect one controller and record the Android device, transport, port build, and upstream MAME revision.

  2. 02

    Open General Inputs → User Interface and identify assignments for menu, back, cancel, clear, pause, and exit behavior.

  3. 03

    Choose a deliberate chord or protected assignment for destructive session actions so gameplay buttons cannot trigger them alone.

  4. 04

    Launch one authorized machine and open Input Assignments (this system) to map coin, start, directions, and player buttons.

  5. 05

    Test menu open/close, cancel, coin, start, hold, release, and simultaneous directions without changing another layer.

  6. 06

    Exit normally, reconnect the controller, and cold-start once to verify enumeration and saved configuration.

Decision and diagnostic table

Control groupOwnsCommon collision
User InterfaceMenus, pause, cancel, exitGameplay button closes the session
General player inputsDefaults shared by machinesGlobal change breaks another layout
This systemCurrent machine assignmentsCoin/start confused with UI actions
Android wrapperBack gesture, overlay, launcherWrapper consumes input before MAME

The menu and cabinet are different consumers

MAME exposes user-interface assignments separately from emulated inputs. The same physical control can reach both, so the assignment screen—not the label printed on the gamepad—is the evidence.

Protect cancel and exit

Official MAME documentation distinguishes UI Back, which closes a menu, from UI Cancel, which can return to selection or exit. A controller-only setup should make both reachable without placing accidental exit on a fire button.

Scope the repair

Change a current-system assignment when one cabinet differs; change a general default only when the mapping should apply broadly. Then retest after reconnect because device numbering can change.

First-party sources

Related guides