本文详细介绍如何在 Batocera 中配置手柄控制器。无论你使用的是 Xbox、PlayStation、Switch 还是其他手柄，都能找到合适的映射方案。

手柄按钮命名规则

Batocera 采用 SNES 手柄的按钮命名方式，避免不同品牌手柄的按钮名称混淆：

• 北按钮 – 对应 SNES 的 X 按钮
• 东按钮 – 对应 SNES 的 A 按钮（取消/返回）
• 南按钮 – 对应 SNES 的 B 按钮（确认）
• 西按钮 – 对应 SNES 的 Y 按钮

常见手柄按钮映射对照

PlayStation 手柄

Xbox 手柄

手柄按钮布局参考图

手柄配置步骤

1. 首次插入手柄时，确保摇杆和按钮处于中立位置
2. Batocera 会自动读取初始状态作为中立位置
3. 如果手柄不在数据库中，会自动弹出配置界面
4. 按照屏幕提示依次按下对应按钮
5. 完成后配置会自动保存

最少需要配置的按钮

如果你的手柄按钮较少，可以跳过不需要的按钮（长按任意按钮跳过）：

• 必需：十字键/左摇杆（导航）、南按钮（确认/启动游戏）
• 重要：东按钮（取消/返回）、START（主菜单）、SELECT（热键）
• 可选：北按钮、西按钮、L1/R1、L2/R2、左右摇杆

热键（Hotkey）设置

热键是 Batocera 中非常重要的功能，通过 HOTKEY + 按钮 组合实现快捷操作：

• 建议将 SELECT 或 Xbox Guide/PS Home 按钮设为热键
• 不要将 START 设为热键，否则一按就会退出游戏
• 如果没有专用热键按钮，使用 SELECT 代替

街机手柄映射

街机布局稍有不同，四个面按钮采用菱形排列：

街机摇杆应映射为 D-pad。

手柄配置文件位置

• 当前手柄配置：/userdata/system/configs/emulationstation/es_last_input.cfg
• 所有手柄配置：/userdata/system/configs/emulationstation/es_input.cfg

为社区贡献手柄配置

如果你的手柄不在数据库中，配置后可以将配置文件通过以下方式提交：

• Batocera Discord 服务器
• GitHub 提交 PR

你的手柄配置被采纳后，其他用户使用同款手柄即可开箱即用！

单独系统的手柄重映射

如果想为某个特定模拟器单独设置按键，参考：每个模拟器的按键重映射

参考来源： Batocera 官方 Wiki – Configure a Controller