Skip to content

MiSTercade controller mappings

Use the interactive installer when possible. It detects MiSTercade V2 versus V1-family hardware, removes conflicting profiles, and backs up replaced files.

Choose a behavior

Choice Behavior
Standard Normal coin and Start behavior. Recommended default.
Freeplay Start also inserts a coin for cabinet-friendly freeplay.
OSD/menu Down + Start opens the MiSTer menu. Recommended default.
No-menu Disables the Down + Start menu shortcut.

Install only one profile for the connected hardware version.

MiSTercade V2

Behavior OSD/menu No-menu
Standard Download Download
Freeplay Download Download

MiSTercade V1 2025

V1 2025 is the recommended identity and mapping set for original V1 hardware.

Behavior OSD/menu No-menu
Standard Download Download
Freeplay Download Download

Legacy MiSTercade V1

Use these only when an existing installation cannot migrate to V1 2025.

Behavior OSD/menu No-menu
Standard Download Download
Freeplay Download Download

Manual installation

  1. Download one profile.
  2. Copy it to the root of the MiSTer SD card beside downloader.ini.
  3. Remove any other MiSTercade mapping profile for a different version or behavior.
  4. Run update_all.
  5. Confirm the controller mapping files were installed under /media/fat/config/inputs.

Return to the MiSTercade guide