Skip to content

Mac: add optional Xbox letter-based controller mapping - #102

Closed
SilverFT wants to merge 1 commit into
seedds:mainfrom
SilverFT:codex/xbox-letter-mapping
Closed

SilverFT wants to merge 1 commit into
seedds:mainfrom
SilverFT:codex/xbox-letter-mapping

Conversation

@SilverFT

Copy link
Copy Markdown

The Mac frontend currently maps face buttons by Nintendo position, so the A button on an Xbox controller sends B to the game. Add an opt-in DM_PAD_LAYOUT=letters setting for players who prefer the printed Xbox labels: A sends A, B sends B, X sends X, and Y sends Y.

The setting is read once when controllers start. The existing positional mapping remains the default. This is a Mac-only option that applies to all connected controllers, assumes Xbox-style labels, and does not detect controller types. The developer documentation describes these limits.

Validation:

  • git diff --check passes.
  • The Mac frontend passes Clang syntax checking with ARC and the Super Mario Bros. Wonder profile include paths. Clang reports the existing unused activity variable warning.
  • The Xbox letter mapping was manually tested on macOS with a physical Xbox controller in Super Mario Bros. Wonder. The subsequent change to read the setting once at startup was checked with Clang.

@v0lumehi

Copy link
Copy Markdown
Contributor

Heads-up: #388 proposes treating controls as data that every UI writes (#388 (comment)): the key and button maps (#386's DM_KEYMAP / DM_PAD_MAP) in one per-game store, so a controls page in any launcher and an in-app panel never disagree. An Xbox letter-based layout could then be a preset of that map rather than a separate switch. Input welcome in #388.

@SilverFT

Copy link
Copy Markdown
Author

Thanks for the heads-up! A shared per-game mapping store makes sense to me. I’d be happy for the Xbox letter-based layout in this PR to become a preset on top of DM_PAD_MAP, while keeping it easy for users to select.

I’ve tested the letter-based mapping with a physical Xbox controller on macOS in Super Mario Bros. Wonder. I’ll follow #388 and can adapt this PR once the mapping interface is settled.

@SilverFT SilverFT closed this Nov 2, 2026
@SilverFT
SilverFT deleted the codex/xbox-letter-mapping branch November 2, 2026 01:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants