Ryujinx Setup и Troubleshooting Руководства

Установка ключей продукта и прошивки

Сделайте дамп prod.keys и title.keys с Nintendo Switch, которой вы владеете, с помощью homebrew-инструментов.

Откройте Ryujinx, перейдите в File → Open Ryujinx Folder и скопируйте ключи в папку system.

Либо используйте Tools или Actions → Install Keys, если ваша сборка это поддерживает.

Установите прошивку через Tools → Install Firmware и выберите ZIP, папку или XCI.

Перезапустите эмулятор по запросу. Устаревшие ключи вызывают ошибку разбора прошивки RYU-0003.

Добавить папки с играми

Откройте Options → Settings → Game Directories.

Нажмите Add и выберите папку с файлами .nsp, .xci или .nca.

Нажмите Apply и OK. Библиотека пересканируется автоматически.

Если игры не появляются, проверьте ключи и доступность путей.

Выбор правильного графического бэкенда

Откройте Options → Settings → Graphics. Обновите драйверы GPU перед тестированием любого бэкенда.

Vulkan

Пробуйте первым на современных GPU NVIDIA и AMD. Лучшая производительность и совместимость в Windows и Linux.

Рекомендуется

OpenGL

Запасной вариант при сбое инициализации Vulkan или отсутствии vulkan-1.dll.

Запасной

Metal

Бэкенд по умолчанию в сборках macOS и Apple Silicon. Оптимизирован для Metal.

macOS

Повысить FPS и уменьшить рывки

Включите асинхронную компиляцию шейдеров в настройках графики.

Дайте PPTC собраться при первом запуске; не удаляйте кэш во время сессии.

Снизьте масштаб разрешения при ограничении GPU; закройте фоновые приложения при ограничении CPU.

Используйте Vulkan в Linux-сборках Steam Deck для лучших результатов.

Базовая память

Оставьте минимум 8 ГБ свободной ОЗУ; для стабильности рекомендуется 16 ГБ.

Настройка контроллеров

Откройте Options → Settings → Input и выберите Player 1.

Выберите устройство: Xbox, DualSense, Pro Controller или клавиатуру.

Сопоставьте кнопки, сохраните и проверьте в игре. Сброс — через clear в интерфейсе.

Установка модов и DLC

Щёлкните правой кнопкой по игре или используйте менеджер для установки обновлений NSP и DLC. Помещайте моды RomFS или Exefs в папку модов из настроек. Включайте читы в меню игры, если поддерживается.

Объяснение предупреждений антивируса

Эвристика помечает неизвестные эмуляторы. Проверяйте SHA-256, скачивайте только с доверенных страниц и избегайте репаков. После проверки хеша восстановите файл из карантина и при необходимости добавьте исключение папки.

Краткий справочник по типичным проблемам

Эмулятор не открывается в Windows

Установите последний .NET Desktop Runtime по запросу. Запускайте из обычной пользовательской папки, не из Program Files.

Отсутствуют ключи или ошибки хеша

Обновите prod.keys и title.keys из дампа консоли. Переустановите обновления игры при сбое проверки NCA.

Игра застряла на 30 FPS

Некоторые игры ограничивают FPS по задумке. Используйте VSync и лимит кадров; снимайте ограничение только если игра поддерживает.

Сбои после обновления

Очистите кэш шейдеров и PPTC для игры и пересоберите. Убедитесь, что прошивка соответствует требованиям.

Лучшие практики

Сохраняйте сейвы перед крупными обновлениями эмулятора.

Держите драйверы GPU и сборки Ryujinx актуальными.

Используйте Canary только если готовы к временным регрессиям.

Читайте заметки по играм в списках совместимости перед длинными сессиями.

Ryujinx Руководства и устранение неполадок