An independent community project Meet the project
retropie.usSearch
Menu

Troubleshooting

Buttons do the wrong thing

Controls work in the menu but not as expected in a game.

Start here

  1. Check whether the problem affects every emulator or just one.
  2. Confirm the frontend mapping and configured hotkey.
  3. Check the selected emulator’s controls guide and player ordering.
  4. Back up and change only the relevant mapping; test before editing another layer.
What usually causes this?

Different frontend/core/standalone mappings, player order or an override.

Advanced explanation

RetroArch and standalone emulators can use different input paths. Global changes can hide a local configuration issue.

Still stuck?

Record what changed after each check. Include your exact board, image, emulator and error when asking for help. These are diagnostic starting points, not guaranteed fixes for every OS.

RetroArch Controller Configuration: detailed upstream reference →

Reference: RetroPie RetroArch Configuration documentation. Original companion checklist; historical upstream guidance needs OS-specific review.