繁體中文
怎麼在 Mac 上的 Ryujinx 設定手把
這款 App 完全免費。不需要建立帳號。沒有訂閱，沒有麻煩的下載，也沒有任何鎖住的功能。針對 Apple 晶片最佳化。
在 Ryujinx 裡打開 Options、Settings，按一下 Input，選擇 Player 1，並在 Input Device 選單選擇你的手把。把 Controller Type 設為 Pro Controller，檢查每個按鈕欄位顯示的都是你要的按鈕，然後按一下 Save。Mac 已經在「遊戲控制器」下列出的 PS5、PS4、Xbox、Switch Pro 或 8BitDo 手把，通常不用安裝任何其他東西就會出現在那個選單中，而且大多數沒反應的手把，在那一個視窗裡就能修好。
我做了 InputConfig，這是把手把對應到按鍵和滑鼠的免費 Mac App。Ryujinx 自己就會讀取手把，所以手把本身不需要對應工具。我只在 InputConfig 真正有幫助的地方才提到它：Ryujinx 放在鍵盤上的快速鍵，以及 Ryujinx 列不出來的手把。
InputConfig 1.7 版預計於 2026 年 10 月推出，屆時 App 將完整支援繁體中文。
步驟
- 把手把連接到 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 伺服器上開放原始碼，並說已在大約 4,300 個遊戲上測試過。它的下載頁面只說正式支援 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 開啟之後才連接的手把。
- 設定檔。用 Add 為一份配置命名並儲存，之後再用 Load 載入，這樣換第二支手把或重新安裝，只要一下子就好。Default 設定檔不能被覆寫。
- Docked Mode。開啟時，Ryujinx 的行為像是接上底座的 Switch。關閉時，則像掌上型模式，遊戲就會期待 Handheld 玩家。
- Global Input。在遊戲自己的設定裡，它讓那個遊戲使用全域配置，而不是自己的配置。
- Reset keybinds to default。把所選裝置的每個欄位恢復原狀。
- 動作和震動。動作有 Use CemuHook Compatible Motion 和陀螺儀靈敏度。震動有強弱倍率，以及 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 設定成一個裝置。
- 對照底座模式和掌上型模式。如果 applet 說已設定底座模式，並且應停用掌上型控制，就讓 Handheld 保持 Disabled，並使用 Player 1。
System、Hacks 裡有 Ignore Controller Applet，能讓手把在遊戲中途斷線時不出現這個視窗。Ryujinx 自己的提示說，不確定的話就保持關閉，我也會這樣做。Applet 會確切告訴你遊戲想要什麼，所以在更改其他任何東西之前，先讀它的兩份清單。
如果手把還是沒有反應
照這個階梯走，從最小的一步開始：
- 檢查 Mac。「系統設定」的「遊戲控制器」應該要列出手把，並讓每個按鈕亮起。如果沒有，問題出在配對，Mac 上無法辨識手把就從那裡開始。
- 重新整理裝置清單。按 Refresh input devices，或是在手把已連接的情況下，結束並重新打開 Ryujinx。
- 選手把，不是鍵盤。Player 1 的 Input Device 必須寫出你的手把。
- 儲存，然後重新啟動遊戲。顯示過 Controller Applet 的遊戲，會在啟動時再次要求手把。
- 檢查失去焦點的設定。Interface 設定裡的 On Emulator Focus Loss 可能會在有其他視窗位於最前方時擋掉輸入。請點一下遊戲視窗。
- 結束 Steam。Steam Input 可能把手把變成它自己的按鍵，使按下的動作送達兩次，或是送到錯的地方。
- 按鈕互換或沒反應。在 Input 中按一下欄位，並按下你要的按鈕。不論按鈕上印的是什麼，欄位都會接受手把送出的內容。
在遊戲控制器和 Input 視窗裡都能用，在遊戲中卻不能用的手把，幾乎都是 Controller Applet 或玩家設定的問題。Mac 上模擬器手把無法使用對其他模擬器涵蓋同樣的檢查。
了解它在 Mac 上讀得到哪些手把
Ryujinx 的原始碼透過 SDL3 讀取手把，所以 Mac 看得到的手把它也看得到。下面每一支手把，我並沒有親自在 Ryujinx 裡測試過。重要的是每一支如何連到 Mac：
- PS5 和 PS4 手把。在「系統設定」中用藍牙配對。請見連接 PS5 手把。
- Xbox Wireless 手把。用藍牙配對。有線的 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 送出的按鍵，所以在建立更多之前，請先檢查一個按鍵。
把 Ryujinx 列在「這些 App 在最前方時啟用」之下，預設集就只會在 Ryujinx 位於最前方時開啟。只對應 Ryujinx 沒用到的按鈕，否則每次按下會同時做兩件事。
用 Ryujinx 列不出來的手把來驅動鍵盤設定檔
有幾支手把從不會出現在 Input Device 選單中，通常是 macOS 不視為遊戲手把的一般 USB 手把。如果 InputConfig 的 Live Visualizer 會讓手把的按鈕亮起，InputConfig 就可以把它變成 Ryujinx 在 Player 1 選用 Keyboard 時已經使用的鍵盤按鍵：
| 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。
- 讀懂 applet。對照 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 是左搖桿，方向鍵是十字鍵，Z、X、C 和 V 是 A、B、X 和 Y，E、U、Q 和 O 是 L、R、ZL 和 ZR。右搖桿是 I、J、K 和 L。
Ryujinx 在 2026 年還有人在開發嗎？
最初的專案在 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 上.