Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · Источник на английском
Открыть источник →Apple Silicon Mac · iPhone · iPad
Ваши игры Switch — нативно на Apple
Создавайте приложения для Mac с Apple Silicon, iPhone и iPad из своих файлов игр и ключей. Код игры выполняется на чипе Apple, а графика выводится через Metal.
128играбельных игр
25улучшено до 60 fps
MITИсходный код на GitHub
Выберите устройство
Оба варианта собираются на Mac: откройте приложение для Mac или установите неподписанный IPA на iPhone или iPad через sideloading.
Apple Silicon Mac
Соберите с параметром --platform mac-app и откройте полученное приложение в Finder.
iPhone & iPad
Создайте IPA на Mac и установите его через sideloading. Основной проект требует iOS / iPadOS 26+ и A17 Pro / M1 или новее.
Ваши игры и ключи
Подготовьте основную игру, при необходимости обновления и DLC, а также prod.keys. Файлы игр и ключи не предоставляются.
Сначала проверьте свою игру
Каталог основан на игровых тестах на Mac или iPhone. На странице игры указаны проверенная версия, заметки и известные ограничения.
Построено на d2r-mobile, трансляторе шейдеров Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross и других проектах. См. благодарности.
Найдите свою игру
Эти игры прошли игровые тесты на Mac или iPhone, но не обязательно на каждом устройстве. Подробности — на страницах игр.
Donkey Kong Bananza
Splatoon Raiders
Fire Emblem Fortune's Weave60 fps
Pokémon Pokopia
Mario Kart 8 Deluxe
Mario vs. Donkey Kong
Paper Mario: The Thousand-Year Door60 fps
Super Mario 3D World + Bowser's Fury3D раскладка
Super Mario Bros. Wonder2D раскладка
Super Mario Galaxy3D раскладка
Super Mario Galaxy 23D раскладка
Super Mario Odyssey3D раскладка
Показать весь каталог (128)
The Legend of Zelda: Breath of the Wild3D раскладка60 fps
The Legend of Zelda: Link's Awakening2D раскладка
The Legend of Zelda: Tears of the Kingdom3D раскладка60 fps
13 Sentinels: Aegis Rim2D раскладка
Absolum2D раскладка
Ace Attorney Investigations Collection2D раскладка
Advance Wars 1+2: Re-Boot Camp
AI: THE SOMNIUM FILES
AI: THE SOMNIUM FILES - nirvanA Initiative
Animal Crossing: New Horizons
ANIMAL WELL
ASTRAL CHAIN60 fps
Balatro
BALL x PIT
Bayonetta
Bayonetta 2
Bayonetta 3
Big Brain Academy: Brain vs. Brain2D раскладка
Brain Memory Training Academy2D раскладка
Captain Toad: Treasure Tracker3D раскладка
Catherine: Full Body
Celeste2D раскладка
Cuphead2D раскладка
DARK SOULS: REMASTERED60 fps
Digimon Story Cyber Sleuth: Complete Edition
Donkey Kong Country: Tropical Freeze
DRAGON QUEST VII Reimagined60 fps
DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition3D раскладка60 fps
FINAL FANTASY RESONANCE60 fps
FINAL FANTASY TACTICS - The Ivalice Chronicles3D раскладка
Fire Emblem Engage2D раскладка60 fps
Fire Emblem: Three Houses3D раскладка60 fps
Ghost Trick: Phantom Detective
The Great Ace Attorney Chronicles2D раскладка
Hades3D раскладка
Hades II3D раскладка
Hollow Knight: Silksong
Hyrule Warriors: Age of Calamity3D раскладка60 fps
Kirby and the Forgotten Land
Luigi's Mansion 360 fps
Metroid Dread2D раскладка
Monster Hunter Rise3D раскладка60 fps
Monster Train 22D раскладка60 fps
OCTOPATH TRAVELER
Octopath Traveler 02D раскладка60 fps
Octopath Traveler II60 fps
Patrick's Parabox2D раскладка
Persona 5 Royal
Pikmin 4
Pokémon Brilliant Diamond60 fps
Pokémon Legends: Z-A2D раскладка
Pokémon Scarlet
Pokémon Violet
Pokémon Sword
Pokémon Shield
Portal
Raging Loop
Rhythm Heaven Groove2D раскладка
ROMANCE OF THE THREE KINGDOMS 8 REMAKE
Sea of Stars
SHIN MEGAMI TENSEI V: Vengeance60 fps
Stardew Valley
STEINS;GATE RE:BOOT2D раскладка
Super Smash Bros. Ultimate
Taiko Risshiden V DX
Unicorn Overlord2D раскладка
Yoshi's Crafted World
NieR:Automata The End of YoRHa Edition60 fps
The Legend of Zelda: Echoes of Wisdom
Donkey Kong Country Returns HD
Mario + Rabbids Sparks of Hope
Xenoblade Chronicles 2
Xenoblade Chronicles 3
FINAL FANTASY CRYSTAL CHRONICLES Remastered Edition
Return of the Obra Dinn
Blasphemous 2
Silver Pines
Blasphemous
FINAL FANTASY X/X-2 HD Remaster
Mario + Rabbids Kingdom Battle
Persona 4 Golden
Xenoblade Chronicles: Definitive Edition
Pokémon Legends: Arceus
Super Mario Party Jamboree
Cult of the Lamb
Paper Mario: The Origami King
Batman: Arkham Knight
Bastion
Baba Is You
SteamWorld Heist II
SteamWorld Heist: Ultimate Edition
Subnautica: Below Zero
SteamWorld Dig 2
Streets of Rage 4
Mario Party Superstars
Subnautica
SteamWorld Dig
Team Sonic Racing
Well Dweller
Need for Speed: Hot Pursuit Remastered60 fps
EA SPORTS FC 2760 fps
Portal 2
Super Monkey Ball Banana Rumble
Atelier Ryza: Ever Darkness & the Secret Hideout DX
DRAGON QUEST III HD-2D Remake60 fps
Hyrule Warriors: Definitive Edition
Metroid Prime Remastered
DRAGON QUEST I & II HD-2D Remake
Dead Cells
Hollow Knight
TRIANGLE STRATEGY60 fps
Castlevania: Belmont's Curse
SUPER ROBOT WARS Y
Super Mario RPG
The Legend of Zelda: Skyward Sword HD
Princess Peach: Showtime!60 fps
От файлов игры к приложению
Первая сборка занимает около 30–60 минут; следующие используют уже выполненную работу. Результат — приложение для Mac или неподписанный IPA.
Для сборки нужны macOS 26.6+, Xcode 27.1, Homebrew и ARM64 Python 3.12+. Для iPhone также установите платформу iOS в Xcode. Свободное место: примерно двойной размер игры плюс 10 ГБ.
Предпочитаете окно терминалу? NX2Apple, проект сообщества, собирает эти шаги в приложение для macOS.
Получите nxnative и инструменты
Один раз, на Mac.
xcodebuild -downloadComponent MetalToolchain
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 "capstone>=5,<6" fonttools nsz zbic "backports.zstd; python_version < '3.14'"Положите NSP одной игры в папку
Поместите основную игру, обновления и DLC в одну папку. Поддерживаются NSP, XCI, NSZ и XCZ.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspЗапустите скрипт
Результат появится в папке игры. Для Mac добавьте --platform mac-app.
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys
# Mac app instead of an iPhone IPA:
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys --platform mac-appОткрыть или установить
На Mac откройте приложение в Finder. На iPhone / iPad установите IPA через AltStore, Sideloadly или LiveContainer. Для крупных игр включите Increased Memory Limit, если инструмент это позволяет.
Играйте
Нажмите 2D / 3D сверху, чтобы переключить сенсорную раскладку. Подключённый геймпад скрывает сенсорное управление. В 3D проведите пальцем по правой трети экрана, чтобы управлять камерой. Встряхните телефон, чтобы встряхнуть контроллер.
Если IPA слишком большой, пересоберите с --romfs separate и выполните указанную команду копирования. Совместимость со старыми iOS обеспечивается отдельной веткой сообщества. Играйте.
Руководства и видео
Отобраны из результатов Google 30 октября 2026 года. Позиции меняются. Следуйте актуальной документации; названия видео не гарантируют поддержку всех игр.
nxnative — Development guide
seedds / nxnative · Источник на английском
Открыть источник →How to Build Any Switch Game As Native Mac App (nxnative)
Andrew Tsai’s Tips · 11:59 · Источник на английском
Открыть источник →NXnative - Native Switch Games on iPhone 17 Pro Max
blackheart909 · 8:41 · Источник на английском
Открыть источник →FAQ и советы
Язык
По умолчанию английский. Выберите другой при упаковке через -l (например, -l ja) или добавьте DM_LANG=zh-Hans в Documents/env.txt.
Сохранения и логи
В приложении «Файлы» под названием приложения: save/ и log.txt. Если что-то пошло не так, пришлите log.txt.
Подтормаживания
Короткие подтормаживания при первом появлении сцены — это нормально: графика компилируется один раз и запоминается.
Переустановка
Некоторые средства сайдлоада создают новую папку данных. Скопируйте save/ и pso_user.tsv из старой.
Настройки
Строки в Documents/env.txt: DM_OPMODE=0 для портативного режима, DM_FPS_TARGET=30 для экономии батареи, DM_SHOW_FPS=1 для счётчика FPS.
Не поддерживается
Нет amiibo и онлайн-функций. Для других игр создаётся отчёт об анализе и IPA «как получится», который может не запуститься.
Инструменты сообщества и совместимость
Здесь есть графические сборщики, игровые библиотеки и поддержка старых версий iOS. Проекты поддерживаются независимо; их страницы содержат требования и ссылки на исходный код.
NX2Apple Сторонний
Лаунчер и игровая библиотека для macOS, которые собирают и ведут игры для Mac, iPhone и iPad. С версии 1.0 iPhone и iPad используют общую оболочку с библиотекой, Cover Flow, управлением контроллером и клавиатурой и настройками для каждой игры; движок входит в релиз и ежедневно следует за upstream.
О проекте →NX Play Сторонний
Одна библиотека для распаковки, запуска, упаковки и управления играми, теперь с NX Play для iPhone и iPad. Мобильный лаунчер показывает игры Mac, запрашивает установку по локальной сети, запускает установленные игры с контроллером и напоминает о продлении подписи.
О проекте →LumaNX Сторонний
LumaNX, ранее LumaDock, объединяет nxnative, графическую библиотеку, очередь сборок и преобразование пакетов. Версия 0.3.0 добавляет на Mac экспериментальный импорт расшифрованных папок Switch 2 и повторное использование неизменённых этапов подготовки.
О проекте →iOS 16.1/17 compatibility fork Сторонний
Экспериментальная ветка совместимости для старых iOS: классический Metal, ограничения шейдеров по устройству и адаптеры для каждой сборки. Поддерживаемая ветка теперь называется ios16-ios17-compat.
О проекте →nx2android Сторонний
nx2android переносит прямой запуск nxnative на Android. ARM64-код игры работает на устройстве, вызовы NVN переводятся в Vulkan, а сборщик создаёт APK и данные игры.
О проекте →MacNativeGames Сторонний
MacNativeGames — независимый проект нативной работы, прежде всего для Breath of the Wild и Tears of the Kingdom. Он работает на Mac, iPhone, iPad и имеет раннюю поддержку Vision Pro.
О проекте →xbunax nxnative Сторонний
xbunax/nxnative — форк с локальной WebUI-студией. Он добавляет браузерный импорт, управление задачами, преобразование XCI и документированные IPA-сборки для Windows и macOS.
О проекте →CA-NINAPPLE Сторонний
CA-NINAPPLE — ориентированный на Windows форк NXNativeWindows. GUI и PowerShell создают iOS IPA из игры и ключей без Mac.
О проекте →NX OS Сторонний
NX OS — консольный лаунчер macOS на базе nxnative. Он находит собранные игры, запускает их на весь экран, считает время и может ставить новые сборки для Mac или iPhone.
О проекте →nxnative-gui Сторонний
nxnative-gui — лёгкий интерфейс macOS, а не второй runtime. Он клонирует или обновляет nxnative, проверяет инструменты и собирает привычные терминальные параметры в одной форме.
О проекте →ns2ios-shell Сторонний
ns2ios-shell отделяет универсальную iOS-оболочку от локальной упаковки игры. CI собирает оболочку, а упаковщик соединяет её с игрой в Windows, Linux или macOS без Xcode.
О проекте →