8BitDo Controller Mappings

Two common 8BitDo layouts: XInput-style and Nintendo/Switch-style.

Mapping 1: 8BitDo XInput / Xbox-Style

Physical Button	Gamepad Label	Common Index
A	Face Bottom	`Button 0`
B	Face Right	`Button 1`
X	Face Left	`Button 2`
Y	Face Top	`Button 3`
LB	Left Shoulder	`Button 4`
RB	Right Shoulder	`Button 5`
LT	Left Trigger	`Button 6`
RT	Right Trigger	`Button 7`
Select / View	Select	`Button 8`
Start / Menu	Start	`Button 9`
Left Stick Press	L3	`Button 10`
Right Stick Press	R3	`Button 11`
D-Pad Up	DPad Up	`Button 12`
D-Pad Down	DPad Down	`Button 13`
D-Pad Left	DPad Left	`Button 14`
D-Pad Right	DPad Right	`Button 15`

Mapping 2: 8BitDo Nintendo / Switch-Style

Physical Button	Gamepad Label	Common Index
B	Face Bottom	`Button 0`
A	Face Right	`Button 1`
Y	Face Left	`Button 2`
X	Face Top	`Button 3`
L	Left Shoulder	`Button 4`
R	Right Shoulder	`Button 5`
ZL	Left Trigger	`Button 6`
ZR	Right Trigger	`Button 7`
Minus	Select	`Button 8`
Plus	Start	`Button 9`
Left Stick Press	L3	`Button 10`
Right Stick Press	R3	`Button 11`
D-Pad Up	DPad Up	`Button 12`
D-Pad Down	DPad Down	`Button 13`
D-Pad Left	DPad Left	`Button 14`
D-Pad Right	DPad Right	`Button 15`

Axes

Stick	Axis	Meaning
Left Stick X	`Axis 0`	Left / Right
Left Stick Y	`Axis 1`	Up / Down
Right Stick X	`Axis 2`	Left / Right
Right Stick Y	`Axis 3`	Up / Down

Alternate Joystick Configs

Config	Left Stick	Right Stick
Standard	`X: Axis 0` `Y: Axis 1`	`X: Axis 2` `Y: Axis 3`
8BitDo Alternate	`X: Axis 0` `Y: Axis 1`	`X: Axis 3` `Y: Axis 4`
Browser / Driver Alternate	`X: Axis 0` `Y: Axis 1`	`X: Axis 2` `Y: Axis 5`

Some 8BitDo modes expose the right stick differently depending on firmware, connection mode, browser, and driver stack. Treat the joystick config as separate from the face-button layout.