Українська

Як налаштувати контролер в Ryujinx на Mac

Завантажити InputConfig з Mac App StoreЦей застосунок повністю безкоштовний. Обліковий запис створювати не потрібно. Немає підписок, складних завантажень, і нічого не заблоковано. Оптимізовано для Apple Silicon.

Відкрийте Options, Settings в Ryujinx, клацніть Input, оберіть Player 1 і виберіть свій контролер у меню Input Device. Задайте Controller Type як Pro Controller, перевірте, що кожне поле кнопки показує потрібну кнопку, і клацніть Save. Контролер PS5, PS4, Xbox, Switch Pro чи 8BitDo, який Mac уже показує в Ігрових контролерах, зазвичай з'являється в цьому меню без додаткових встановлень, і більшість неробочих контролерів виправляється в цьому одному вікні.

InputConfig, безкоштовний застосунок для Mac, що прив'язує контролери до клавіш і миші, створюю я. Ryujinx читає контролери сам, тож мапер для пада йому не потрібен. InputConfig згадую лише там, де він справді допомагає: гарячі клавіші, які Ryujinx тримає на клавіатурі, і пад, який Ryujinx не може показати.

Версія InputConfig 1.7, яку очікуємо в жовтні 2026 року, буде повністю доступна українською мовою.

Кроки

  1. Підключіть контролер до Mac і перевірте, що він світиться в Системні параметри, Ігрові контролери.
  2. В Ryujinx відкрийте Options, Settings і клацніть Input.
  3. Оберіть Player 1, потім виберіть контролер у меню Input Device.
  4. Задайте Controller Type як Pro Controller, перевірте кожне поле кнопки й клацніть Save.
  5. Якщо гра показує Controller Applet, зіставте гравців і типи контролерів, які він перелічує, потім запустіть гру знову.

Перевірте, який Ryujinx ви запускаєте

Оригінальний проєкт Ryujinx зупинився в жовтні 2024 року. Назва живе в громадському форку, і саме цю збірку слід використовувати у 2026 році. 22 жовтня 2026 року прочитано його сайт, ryujinx.app, який називає його емулятором Nintendo Switch 1, каже, що він з відкритим кодом за ліцензією MIT на власному сервері Forgejo, і каже, що його перевірено приблизно на 4300 іграх. Його сторінка завантаження каже, що належним чином підтримуються лише Mac з Apple Silicon. Сервер Forgejo і блог того дня не завантажилися, тож номера версії назвати не можна.

  • Стара збірка з 2024 року. Виправлення вводу з того часу є лише у форку, тож оновіться, перш ніж шукати проблему з контролером.
  • Mac з Intel. Сторінка завантаження не обіцяє, що він працює добре, і про це варто знати, перш ніж звинувачувати пад.
  • Сайти-двійники для завантаження. Багато сторінок використовують цю назву. Беріть із власного сайту проєкту.

Почніть із поточної збірки форку, з його власного сайту, перш ніж змінювати хоч одне налаштування вводу. Ця сторінка охоплює лише контролери, а не файли чи ключі ігор.

Налаштуйте Player 1 у налаштуваннях Input в Ryujinx

  • Ви: Підключіть пад, відкрийте 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 позначає експериментальним і лише для першопартійних контролерів Nintendo.

Input Device це налаштування, що виправляє більшість неробочих контролерів, бо воно часто досі стоїть на Keyboard або Disabled.

Прочитайте Controller Applet, коли гра його показує

Деякі ігри просять контролери під час запуску, і Ryujinx відповідає вікном із заголовком Controller Applet. Воно перелічує Players і Supported Controllers та каже, що поточна конфігурація недійсна і що слід відкрити налаштування й переналаштувати вхід, з кнопкою Open Settings Window. Це означає, що гра хоче налаштування, якого ваші налаштування не дають.

  • Зіставте тип контролера. Якщо у списку немає Pro Controller, оберіть один із наведених типів, наприклад JoyCon Pair, у Controller Type для Player 1.
  • Зіставте кількість гравців. Грі, що хоче двох гравців, потрібен і Player 2 з пристроєм.
  • Зіставте док і портативний режим. Якщо апплет каже, що задано режим док-станції і керування Handheld слід вимкнути, залиште Handheld на Disabled і використовуйте Player 1.

У System, Hacks є Ignore Controller Applet, що не дає вікну з'являтися, коли пад відключається посеред гри. Власна підказка Ryujinx радить залишити вимкненим, якщо не впевнені, і так варто зробити. Апплет каже точно, чого хоче гра, тож прочитайте його два списки, перш ніж змінювати щось інше.

Якщо контролер усе одно нічого не робить

Піднімайтеся цими сходами, починаючи з найменшого кроку:

  1. Перевірте Mac. Системні параметри, Ігрові контролери мають показувати пад і підсвічувати кожну кнопку. Якщо ні, проблема в з'єднанні, і з цього починається контролер не розпізнається на Mac.
  2. Оновіть список пристроїв. Натисніть Refresh input devices або закрийте й відкрийте Ryujinx знову з уже підключеним падом.
  3. Оберіть пад, а не клавіатуру. Input Device для Player 1 має називати ваш контролер.
  4. Збережіть, потім запустіть гру знову. Гра, що показала Controller Applet, просить контролери знову під час запуску.
  5. Перевірте втрату фокуса. On Emulator Focus Loss у налаштуваннях Interface може блокувати ввід, коли попереду інше вікно. Клацніть вікно гри.
  6. Закрийте Steam. Steam Input може перетворити пад на власні клавіші, тож натискання надходять двічі або не туди.
  7. Переставлені чи неробочі кнопки. Клацніть поле в Input і натисніть потрібну кнопку. Поле бере те, що надсилає пад, що б не було надруковано на ньому.

Пад, що працює в Ігрових контролерах і у вікні Input, але не в грі, майже завжди є проблемою Controller Applet або налаштування гравців. Ті самі перевірки для інших емуляторів охоплює контролер емулятора не працює на Mac.

Дізнайтеся, які контролери він читає на Mac

Код Ryujinx читає контролери через SDL3, тож він бачить пади, які бачить Mac. Кожен пад нижче не перевірено в Ryujinx. Важливо, як кожен доходить до Mac:

  • Контролери PS5 і PS4. З'єднуються по Bluetooth у Системні параметри. Дивіться підключення контролера PS5.
  • Xbox Wireless Controller. З'єднуються по Bluetooth. Дротовий пад Xbox 360 macOS не підтримує взагалі.
  • Switch Pro Controller. З'єднується по Bluetooth, і саме його очікують ігри Switch, тож Pro Controller в Ryujinx підходить найкраще.
  • Joy-Con. macOS з'єднує кожен окремо. Ryujinx має типи JoyCon Pair, JoyCon Left і JoyCon Right, але як він об'єднує два Joy-Con, з'єднані з Mac, в одну пару, не перевірено.
  • Пади 8BitDo. Лише в режимі, який 8BitDo вказує для пристроїв Apple, D на більшості моделей. Кожну модель має контролери 8BitDo на Mac.

Якщо Mac показує пад в Ігрових контролерах, його варто обрати в меню Input Device в Ryujinx.

Поставте гарячі клавіші 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 не перевірено, тож перевірте одну клавішу, перш ніж будувати більше.
Редактор InputConfig з рядками, що надсилають клавіші-стрілки, Control, Option, Space та Escape з кнопок контролера.
Figure 1. Кожен рядок надсилає одну клавішу з однієї кнопки. Для Ryujinx знадобляться рядки на кшталт цих з F4, F5 і F8 на кнопках, які емулятор лишає непризначеними.

Перелічіть Ryujinx у розділі Activate when these apps are in front, і пресет вмикається лише тоді, коли Ryujinx на передньому плані. Призначайте лише кнопки, якими Ryujinx не користується, інакше кожне натискання робитиме дві дії.

Розділ Automation and Gaming Utilities пресета в InputConfig, де програму вказано в Activate when these apps are in front.
Figure 2. Список програм у пресеті. Додайте сюди Ryujinx, і кнопки гарячих клавіш працюватимуть лише тоді, коли він на передньому плані.

Керуйте профілем клавіатури з пада, якого Ryujinx не може показати

Деякі пади ніколи не показуються в меню Input Device, часто прості пади USB, які macOS не вважає ігровими контролерами. Якщо Live Visualizer в InputConfig підсвічує кнопки пада, InputConfig може перетворити його на клавіші клавіатури, які Ryujinx уже використовує для Player 1 з вибраною Keyboard:

Елемент SwitchТипова клавіша RyujinxПокладіть на
Лівий стікW, A, S, D, і F для натисканняЛівий стік пада
ХрестовинаКлавіші-стрілкиХрестовину
A, B, X, YZ, X, C, VПраву, нижню, верхню й ліву лицьові кнопки, розташування Switch
L, R, ZL, ZRE, U, Q, OБампери й тригери
Правий стікI, J, K, L, і H для натисканняПравий стік

Minus і Plus теж мають типові клавіші: подивіться, які клавіші показує для них вікно Input в Ryujinx, і прив'яжіть їх. Потім перевірте швидким способом: з Keyboard як Input Device клацніть поле і натисніть кнопку пада. Якщо поле заповнюється клавішею, 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 підсвічує пад в Ігрових контролерах, виправлення майже завжди всередині вікна Input в Ryujinx.

Питання

Чому мій контролер не працює в Ryujinx на Mac?

Найчастіше Input Device для Player 1 досі стоїть на Keyboard або Disabled, або пад підключили після відкриття Ryujinx. Натисніть Refresh input devices, оберіть пад, задайте Controller Type як Pro Controller і клацніть Save.

Що таке Controller Applet в Ryujinx?

Вікно, яке деякі ігри відкривають, щоб попросити контролери. Воно перелічує гравців і типи контролерів, які підтримує гра. Зіставте їх у Settings, Input, потім запустіть гру знову.

Чи працює контролер PS5 з Ryujinx на Mac?

Ryujinx читає контролери через SDL3, який читає DualSense, з'єднаний у Системні параметри, Bluetooth. Оберіть його в меню Input Device для Player 1 і перевірте поля кнопок.

Які типові клавіші керування в 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, який 22 жовтня 2026 року описував себе як проєкт з відкритим кодом за ліцензією MIT, що належним чином підтримується лише на Mac з Apple Silicon.

Більше українською

Докладні посібники, англійською

Хто пише. Ryleigh Newman розробляє InputConfig і щодня керує своїм Mac за допомогою геймпада, бо руки погано слухаються. Цю сторінку перекладено з англійської. Інтерфейс застосунку й решта сайту англійською.

Ця сторінка іншими мовами: 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, 繁體中文, 简体中文

Завантажити InputConfig з Mac App StoreБезкоштовно. macOS 14 або новіша. Без облікового запису, ніщо не залишає ваш Mac. Відкритий код на GitHub.