简体中文
怎样在 Mac 上的 Ryujinx 里设置手柄
这款应用完全免费。无需创建账户。没有订阅，没有麻烦的下载，也没有任何锁定的功能。针对 Apple 芯片优化。
在 Ryujinx 里打开 Options, Settings，点按 Input，选择 Player 1，并在 Input Device 菜单里选择你的手柄。把 Controller Type 设为 Pro Controller，检查每个按钮字段显示的是你想要的按钮，然后点按 Save。Mac 已经在“游戏控制器”下列出的 PS5、PS4、Xbox、Switch Pro 或 8BitDo 手柄，通常不用安装别的东西就会出现在那个菜单里，大多数失灵的手柄在这一个窗口里就能修好。
我做了 InputConfig，一个把手柄映射到按键和鼠标的免费 Mac 应用。Ryujinx 自己就能读取手柄，所以手柄本身不需要映射工具。我只在它确实有帮助的地方才提到 InputConfig：Ryujinx 放在键盘上的热键，以及 Ryujinx 无法列出的手柄。
InputConfig 1.7 版预计于 2026 年 10 月发布，届时应用将完整支持简体中文。
步骤
- 把手柄连接到 Mac，并检查它在“系统设置”的“游戏控制器”里会亮起。
- 在 Ryujinx 里，打开 Options, Settings，点按 Input。
- 选择 Player 1，然后在 Input Device 菜单里选择你的手柄。
- 把 Controller Type 设为 Pro Controller，检查每个按钮字段，然后点按 Save。
- 如果游戏显示 Controller Applet，请对照它列出的玩家和手柄类型，然后重新启动游戏。
确认你运行的是哪个 Ryujinx
最初的 Ryujinx 项目在 2024 年 10 月停止了。这个名字继续存在于一个社区分支里，2026 年要用的就是那个版本。2026 年 10 月 22 日我读了它的网站 ryujinx.app，它称自己是 Nintendo Switch 1 模拟器，说它以 MIT 许可证在自己的 Forgejo 服务器上开源，并且已在大约 4300 个游戏上测试过。它的下载页面只说 Apple 芯片的 Mac 得到了妥善支持。那天它的 Forgejo 服务器和博客我都打不开，所以我无法给出版本号。
- 2024 年的旧版本。此后的输入修复只在这个分支里，所以在排查手柄问题之前先更新。
- Intel Mac。下载页面没有承诺它能运行良好，在责怪手柄之前，值得知道这一点。
- 外观相似的下载网站。很多页面沿用了这个名字。请从项目自己的网站获取。
在更改任何一项输入设置之前，先从分支自己的网站获取当前版本。本页只涉及手柄，不涉及游戏文件或密钥。
在 Ryujinx 的 Input 设置里设置 Player 1
- 你：连接手柄，打开 Options, Settings, Input，在顶部选择 Player 1，并在 Input Device 里选择手柄。把 Controller Type 设为 Pro Controller。
- Ryujinx：为这个手柄填满按钮、摇杆和扳机字段。
- 检查：点按一个字段，比如 A，并按下你想设给它的按钮。字段会显示它听到了什么。点按 Save。
同一个窗口里还有人们容易漏掉的设置：
- Refresh input devices。这个按钮会列出你在 Ryujinx 打开之后才连接的手柄。
- Profile。用 Add 给布局命名并保存，以后再用 Load 载入，这样第二个手柄或重新安装都只需片刻。Default 配置文件不能被覆盖。
- Docked Mode。开启时，Ryujinx 的行为像插在底座上的 Switch。关闭时，行为像掌机，游戏这时会期待 Handheld 玩家。
- Global Input。在某个游戏自己的设置里，它让这个游戏使用全局布局，而不是自己的。
- Reset keybinds to default。把所选设备的每个字段恢复原样。
- Motion 和 Rumble。Motion 里有 Use CemuHook Compatible Motion 和陀螺仪灵敏度。Rumble 里有强和弱的倍数，以及 Enable HD Rumble，Ryujinx 把它标为实验性，且只适用于任天堂第一方手柄。
Input Device 是修复大多数失灵手柄的设置，因为它常常还停在 Keyboard 或 Disabled。
游戏显示 Controller Applet 时怎么读
有些游戏在启动时会要求手柄，Ryujinx 用一个标题为 Controller Applet 的窗口来回应。它列出 Players 和 Supported Controllers，并说你当前的配置无效，应该打开设置并重新配置你的输入，还带一个 Open Settings Window 按钮。这表示游戏想要一种你的设置没有提供的配置。
- 匹配手柄类型。如果列表里不包含 Pro Controller，就在 Player 1 的 Controller Type 里选它列出的某个类型，比如 JoyCon Pair。
- 匹配玩家数量。需要两个玩家的游戏，也需要给 Player 2 设一个设备。
- 匹配底座模式和掌机模式。如果这个窗口说已设置底座模式，应禁用掌机控制，请让 Handheld 保持在 Disabled，使用 Player 1。
System, Hacks 里有 Ignore Controller Applet，它能防止手柄在游戏中途断开时出现这个窗口。Ryujinx 自己的提示说，不确定就保持关闭，我也会这样做。这个窗口会准确告诉你游戏想要什么，所以在改动任何别的东西之前，先读一读它的两个列表。
如果手柄仍然没有反应
从最小的一步开始，沿着这个阶梯往上走：
- 检查 Mac。“系统设置”的“游戏控制器”应该列出这个手柄，并让每个按钮亮起。如果没有，问题出在配对上，Mac 无法识别手柄就从这里讲起。
- 刷新设备列表。按 Refresh input devices，或者在手柄已经连接的状态下退出并重新打开 Ryujinx。
- 选手柄，而不是键盘。Player 1 的 Input Device 必须是你的手柄的名称。
- 保存，然后重新启动游戏。显示过 Controller Applet 的游戏，启动时会再次请求手柄。
- 检查失去焦点。界面设置里的 On Emulator Focus Loss 可能在另一个窗口位于前台时阻止输入。点按游戏窗口。
- 退出 Steam。Steam Input 可能把手柄变成它自己的按键，所以按键会到达两次或到错误的地方。
- 按钮对调或失灵。在 Input 里点按字段并按下你想要的按钮。字段会取手柄发送的内容，不管按钮上印的是什么。
在“游戏控制器”和 Input 窗口里都能用，在游戏里却不能用的手柄，几乎总是 Controller Applet 或玩家设置的问题。Mac 上模拟器手柄无法使用对其他模拟器介绍了同样的检查。
了解它在 Mac 上能读取哪些手柄
Ryujinx 的源代码通过 SDL3 读取手柄，所以它能看到 Mac 看到的手柄。下面每一种手柄，我自己没有全部在 Ryujinx 里测试过。重要的是每一种是怎样到达 Mac 的：
- PS5 和 PS4 手柄。它们在“系统设置”里通过蓝牙配对。见连接 PS5 手柄。
- Xbox 无线手柄。它们通过蓝牙配对。有线的 Xbox 360 手柄完全不受 macOS 支持。
- Switch Pro 手柄。它通过蓝牙配对，是 Switch 游戏所期待的手柄，所以 Ryujinx 里的 Pro Controller 与它最匹配。
- Joy-Con。macOS 会分别配对每一个。Ryujinx 有 JoyCon Pair、JoyCon Left 和 JoyCon Right 类型，但我没有检查它怎样把两个由 Mac 配对的 Joy-Con 合成一对。
- 8BitDo 手柄。只能在 8BitDo 为 Apple 设备列出的模式下使用，多数型号是 D。Mac 上的 8BitDo 手柄里有每个型号。
如果 Mac 在“游戏控制器”下列出了某个手柄，它就值得在 Ryujinx 的 Input Device 菜单里选择。
把 Ryujinx 的热键放到备用按钮上
Ryujinx 把它的热键放在键盘上，位于 Settings, Hotkeys 下。默认设置是：F1 切换 VSync，F2 静音，F4 显示或隐藏界面，F5 暂停，F8 截图。Turbo Mode、音量和分辨率缩放一开始没有绑定，所以先在那里给它们一个按键。InputConfig 可以从 Ryujinx 没有绑定的按钮按下那些按键，比如 Create 或 Share 按钮、DualSense 触控板的按下，或者 DualSense Edge 的拨片。
- 你：为 Ryujinx 做一个预设，添加一行，点按 Scan，然后按备用按钮。把输出设为 Keyboard Key，选择 F5。
- InputConfig：你每按一次那个按钮就发送一次 F5，与 Ryujinx 正在读取的手柄并行。
- 检查：在游戏里按这个按钮。游戏会暂停。我自己没有测试过 Ryujinx 接收 InputConfig 发送的按键，所以建立更多之前，先检查一个按键。
在 Activate when these apps are in front 下列出 Ryujinx，预设就只在 Ryujinx 位于前台时打开。只映射 Ryujinx 不用的按钮，否则每次按下都会同时做两件事。
用 Ryujinx 无法列出的手柄驱动键盘配置
少数手柄永远不会出现在 Input Device 菜单里，往往是 macOS 不当作游戏手柄的普通 USB 手柄。如果 InputConfig 的 Live Visualizer 能让这个手柄的按钮亮起，InputConfig 就能把它变成 Ryujinx 在选择 Keyboard 时已经为 Player 1 使用的键盘按键：
| Switch 控件 | Ryujinx 的默认按键 | 放在哪里 |
|---|---|---|
| 左摇杆 | W、A、S、D，F 用来按下它 | 手柄的左摇杆 |
| 方向键 | 方向键 | 手柄的方向键 |
| A、B、X、Y | Z、X、C、V | 右、下、上、左面部按钮，也就是 Switch 的位置 |
| L、R、ZL、ZR | E、U、Q、O | 肩键和扳机 |
| 右摇杆 | I、J、K、L，H 用来按下它 | 右摇杆 |
Minus 和 Plus 也有默认设置：检查 Ryujinx 的 Input 窗口显示它们是哪些按键，并绑定这些。然后用快捷的办法测试：把 Input Device 设为 Keyboard，点按一个字段并按下手柄按钮。如果字段填入了那个按键，说明 Ryujinx 收到了 InputConfig 的按键。用按键发送的摇杆要么推到底，要么完全不动，所以这是针对 Ryujinx 看不到的手柄的后备办法，绝不能取代它能看到的手柄。
它做不到的事
- 没有虚拟手柄。InputConfig 发送按键和鼠标事件。它无法让一个手柄在 Ryujinx 看来像另一个游戏手柄。
- 按键无法传递模拟量。键盘路线会丢掉摇杆和扳机的半幅倾斜。
- 无法通过它传递陀螺仪或震动。体感和震动只能通过 Ryujinx 自己的手柄支持来实现。
我会让 Ryujinx 读取手柄，把 InputConfig 留给它周围的按键。
简短版本
- 设置。前往 Options, Settings, Input，选择 Player 1，在 Input Device 里选择手柄，选择 Pro Controller，然后点按 Save。
- 读懂窗口。对照 Controller Applet 列出的玩家和手柄类型。
- 添加热键。用 InputConfig 预设把 F4、F5 和 F8 放到 Ryujinx 空出来的按钮上。
如果 Mac 在“游戏控制器”里点亮了手柄，修复办法几乎总是在 Ryujinx 的 Input 窗口里。
常见问题
为什么我的手柄在 Mac 上的 Ryujinx 里不能用？
最常见的是 Player 1 的 Input Device 仍停在 Keyboard 或 Disabled，或者手柄是在 Ryujinx 打开之后才连接的。按 Refresh input devices，选择手柄，把 Controller Type 设为 Pro Controller，然后点按 Save。
Ryujinx 里的 Controller Applet 是什么？
一些游戏打开的、用来请求手柄的窗口。它列出游戏支持的玩家和手柄类型。在 Settings, Input 里匹配这些，然后重新启动游戏。
PS5 手柄能在 Mac 上配合 Ryujinx 使用吗？
Ryujinx 通过 SDL3 读取手柄，它能读取在“系统设置”的“蓝牙”里配对的 DualSense。在 Player 1 的 Input Device 菜单里选择它，并检查按钮字段。
Ryujinx 默认的键盘控制是什么？
左摇杆是 W、A、S 和 D，方向键是方向键，A、B、X 和 Y 是 Z、X、C 和 V，L、R、ZL 和 ZR 是 E、U、Q 和 O。右摇杆是 I、J、K 和 L。
2026 年 Ryujinx 还在开发吗？
最初的项目在 2024 年停止了。一个社区分支在 ryujinx.app 继续，2026 年 10 月 22 日它自称以 MIT 许可证开源，并且只在 Apple 芯片的 Mac 上得到妥善支持。
更多中文页面
详细指南（英文）
作者说明。Ryleigh Newman 开发了 InputConfig，因为双手活动不便，每天都用手柄操作自己的 Mac。本页译自英文。Mac 的语言设为简体中文时，App 的主要按钮和菜单显示为中文，本页使用这些名称，并在括号中附上英文名称。App 的其他部分和网站的其他页面都是英文。
本页的其他语言版本： English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文
免费。macOS 14 或更高版本。无需账户，数据不会离开你的 Mac。 源代码在 GitHub 上.