Русский
Как настроить контроллер в Ryujinx на Mac
Это приложение полностью бесплатное. Создавать учётную запись не нужно. Нет подписок, нет сложных загрузок, и ничего не заблокировано. Оптимизировано для 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 года, будет полностью доступна на русском языке.
Шаги
- Подключите контроллер к Mac и проверьте, что он загорается в Системных настройках, Контроллеры.
- В Ryujinx откройте Options, Settings и нажмите Input.
- Выберите Player 1, затем укажите свой контроллер в меню Input Device.
- Поставьте Controller Type в Pro Controller, проверьте каждое поле кнопки и нажмите Save.
- Если игра показывает Controller Applet, сопоставьте игроков и типы контроллеров, которые он перечисляет, затем запустите игру снова.
Проверьте, какой Ryujinx вы запускаете
Оригинальный проект Ryujinx остановился в октябре 2024 года. Название живет в форке сообщества, и именно эту сборку стоит использовать в 2026 году. Его сайт ryujinx.app, прочитанный 22 октября 2026 года, называет его эмулятором Nintendo Switch 1, сообщает, что он с открытым кодом под лицензией MIT на собственном сервере Forgejo, и что он проверен примерно на 4300 играх. Его страница загрузки сообщает, что нормально поддерживаются только Mac с Apple Silicon. Сервер Forgejo и блог в тот день не загрузились, поэтому номер версии назвать нельзя.
- Старая сборка 2024 года. Исправления ввода с тех пор есть только в форке, поэтому обновитесь, прежде чем искать проблему с контроллером.
- Mac с Intel. Страница загрузки не обещает, что он хорошо работает, и об этом стоит знать, прежде чем винить пад.
- Сайты-подделки. Множество страниц используют это название. Берите его на сайте самого проекта.
Начните с текущей сборки форка, с его собственного сайта, прежде чем менять хоть одну настройку ввода. Эта страница охватывает только контроллеры, а не файлы игр или ключи.
Настройте Player 1 в настройках ввода 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 в Disabled и используйте Player 1.
В System, Hacks есть Ignore Controller Applet, который не дает окну появляться, когда пад отключается посреди игры. Собственный совет Ryujinx в том, чтобы при сомнениях оставить его выключенным, и так и стоит поступить. Апплет точно сообщает, чего хочет игра, поэтому прочитайте его два списка, прежде чем менять что-либо еще.
Если контроллер все равно ничего не делает
Поднимайтесь по этой лестнице, начиная с самого малого шага:
- Проверьте Mac. В Системных настройках, Контроллеры пад должен быть в списке, и должна загораться каждая кнопка. Если нет, проблема в подключении, и с него начинается страница контроллер не распознается на Mac.
- Обновите список устройств. Нажмите Refresh input devices или закройте и снова откройте Ryujinx с уже подключенным падом.
- Выберите пад, а не клавиатуру. Input Device для Player 1 должен называть ваш контроллер.
- Сохраните, затем запустите игру снова. Игра, которая показала Controller Applet, при запуске снова запрашивает контроллеры.
- Проверьте потерю фокуса. On Emulator Focus Loss в настройках Interface может блокировать ввод, когда на переднем плане другое окно. Щелкните окно игры.
- Закройте Steam. Steam Input может превращать пад в собственные клавиши, поэтому нажатия приходят дважды или не туда.
- Перепутанные или мертвые кнопки. Щелкните поле в Input и нажмите нужную кнопку. Поле берет то, что отправляет пад, что бы на нем ни было напечатано.
Пад, который работает в Контроллерах и в окне Input, но не в игре, почти всегда означает настройку Controller Applet или игрока. Те же проверки для других эмуляторов описывает страница контроллер эмулятора не работает на Mac.
Узнайте, какие контроллеры он читает на Mac
Исходный код Ryujinx читает контроллеры через SDL3, поэтому он видит те пады, которые видит Mac. Не каждый пад из списка ниже лично проверялся в Ryujinx. Важно, как каждый из них доходит до Mac:
- Контроллеры PS5 и PS4. Подключаются по Bluetooth в Системных настройках. См. подключение контроллера PS5.
- Беспроводные контроллеры Xbox. Подключаются по Bluetooth. Проводной пад Xbox 360 macOS не поддерживает вообще.
- Switch Pro Controller. Подключается по Bluetooth и это контроллер, которого ожидают игры Switch, так что Pro Controller в Ryujinx подходит ему лучше всего.
- Joy-Con. macOS подключает каждый по отдельности. В Ryujinx есть типы JoyCon Pair, JoyCon Left и JoyCon Right, но как он объединяет два подключенных через Mac Joy-Con в пару, не проверялось.
- Пады 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, лично не проверялся, поэтому проверьте одну клавишу, прежде чем строить больше.
Перечислите Ryujinx в Activate when these apps are in front, и пресет будет включаться, только пока Ryujinx на переднем плане. Назначайте только кнопки, которые Ryujinx не использует, иначе одно нажатие сделает две вещи сразу.
Управляйте профилем клавиатуры с пада, который Ryujinx не может показать
Некоторые пады никогда не появляются в меню Input Device, часто это обычные пады USB, которые macOS не считает игровыми контроллерами. Если Live Visualizer в InputConfig подсвечивает кнопки пада, 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 тоже есть значения по умолчанию: посмотрите, какие клавиши показывает для них окно 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 с помощью геймпада, потому что руки плохо слушаются. Эта страница переведена с английского. Если на 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, 繁體中文, 简体中文
Бесплатно. macOS 14 или новее. Без учётной записи, ничего не покидает ваш Mac. Исходный код на GitHub.