Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · Źródło po angielsku
Otwórz źródło →Apple Silicon Mac · iPhone · iPad
Twoje gry Switch, natywnie na Apple
Twórz aplikacje na Maca z Apple Silicon, iPhone’a i iPada z własnych plików gier i kluczy. Kod gry działa na układzie Apple, a grafikę renderuje Metal.
128grywalnych gier
25ulepszonych do 60 fps
MITKod źródłowy na GitHubie
Wybierz urządzenie do gry
Obie ścieżki zaczynają się na Macu: otwórz aplikację Mac lub zainstaluj niepodpisany plik IPA na iPhonie albo iPadzie przez sideloading.
Apple Silicon Mac
Zbuduj aplikację z --platform mac-app, a następnie otwórz ją w Finderze.
iPhone & iPad
Utwórz IPA na Macu i zainstaluj przez sideloading. Projekt źródłowy wymaga iOS / iPadOS 26+ i A17 Pro / M1 lub nowszego.
Własne gry i klucze
Przygotuj grę podstawową, opcjonalne aktualizacje i DLC oraz prod.keys. Gry i klucze nie są dołączone.
Najpierw sprawdź swoją grę
Katalog zawiera wyniki testów rozgrywki na Macu lub iPhonie. Strony gier podają sprawdzone wersje, uwagi i znane ograniczenia.
Zbudowane na d2r-mobile, tłumaczu shaderów z Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross i innych. Zobacz podziękowania.
Znajdź swoją grę
Te gry przeszły testy rozgrywki na Macu lub iPhonie, ale niekoniecznie na każdym urządzeniu. Szczegóły znajdziesz na stronach gier.
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 układ
Super Mario Bros. Wonder2D układ
Super Mario Galaxy3D układ
Super Mario Galaxy 23D układ
Super Mario Odyssey3D układ
Pokaż cały katalog (128)
The Legend of Zelda: Breath of the Wild3D układ60 fps
The Legend of Zelda: Link's Awakening2D układ
The Legend of Zelda: Tears of the Kingdom3D układ60 fps
13 Sentinels: Aegis Rim2D układ
Absolum2D układ
Ace Attorney Investigations Collection2D układ
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 układ
Brain Memory Training Academy2D układ
Captain Toad: Treasure Tracker3D układ
Catherine: Full Body
Celeste2D układ
Cuphead2D układ
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 układ60 fps
FINAL FANTASY RESONANCE60 fps
FINAL FANTASY TACTICS - The Ivalice Chronicles3D układ
Fire Emblem Engage2D układ60 fps
Fire Emblem: Three Houses3D układ60 fps
Ghost Trick: Phantom Detective
The Great Ace Attorney Chronicles2D układ
Hades3D układ
Hades II3D układ
Hollow Knight: Silksong
Hyrule Warriors: Age of Calamity3D układ60 fps
Kirby and the Forgotten Land
Luigi's Mansion 360 fps
Metroid Dread2D układ
Monster Hunter Rise3D układ60 fps
Monster Train 22D układ60 fps
OCTOPATH TRAVELER
Octopath Traveler 02D układ60 fps
Octopath Traveler II60 fps
Patrick's Parabox2D układ
Persona 5 Royal
Pikmin 4
Pokémon Brilliant Diamond60 fps
Pokémon Legends: Z-A2D układ
Pokémon Scarlet
Pokémon Violet
Pokémon Sword
Pokémon Shield
Portal
Raging Loop
Rhythm Heaven Groove2D układ
ROMANCE OF THE THREE KINGDOMS 8 REMAKE
Sea of Stars
SHIN MEGAMI TENSEI V: Vengeance60 fps
Stardew Valley
STEINS;GATE RE:BOOT2D układ
Super Smash Bros. Ultimate
Taiko Risshiden V DX
Unicorn Overlord2D układ
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
Od plików gry do aplikacji
Pierwsze budowanie trwa około 30–60 minut; kolejne wykorzystują ukończoną pracę. Wynikiem jest aplikacja Mac lub niepodpisany plik IPA.
Budowanie wymaga macOS 26.6+, Xcode 27.1, Homebrew i ARM64 Python 3.12+. Dla iPhone’a zainstaluj też platformę iOS w Xcode. Zarezerwuj dwukrotność rozmiaru gry plus 10 GB miejsca.
Wolisz okno od terminala? NX2Apple, projekt społeczności, zamyka te kroki w aplikacji na macOS.
Pobierz nxnative i narzędzia
Jednorazowo, na Macu.
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'"Umieść pliki NSP jednej gry w folderze
Umieść grę podstawową, aktualizacje i DLC w jednym folderze. Obsługiwane formaty: NSP, XCI, NSZ i XCZ.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspUruchom skrypt
Wynik pojawi się w folderze gry. Dla Maca dodaj --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-appOtwórz lub zainstaluj
Na Macu otwórz aplikację w Finderze. Na iPhonie / iPadzie zainstaluj IPA przez AltStore, Sideloadly lub LiveContainer. Dla dużych gier włącz Increased Memory Limit, jeśli narzędzie to umożliwia.
Graj
Dotknij 2D / 3D u góry, aby przełączyć układ dotykowy. Podłączony kontroler ukrywa sterowanie dotykowe. W 3D przesuwaj palcem po prawej trzeciej części ekranu, aby obracać kamerę. Potrząśnij telefonem, aby potrząsnąć kontrolerem.
Jeśli IPA jest za duży, zbuduj ponownie z --romfs separate i wykonaj wyświetlone polecenie kopiowania. Zgodność ze starszym iOS zapewnia osobna gałąź społeczności. Graj.
Poradniki i filmy
Wybrane z wyników Google z 30 października 2026 r. Pozycje się zmieniają. Korzystaj z aktualnej dokumentacji; tytuły filmów nie gwarantują obsługi wszystkich gier.
nxnative — Development guide
seedds / nxnative · Źródło po angielsku
Otwórz źródło →How to Build Any Switch Game As Native Mac App (nxnative)
Andrew Tsai’s Tips · 11:59 · Źródło po angielsku
Otwórz źródło →NXnative - Native Switch Games on iPhone 17 Pro Max
blackheart909 · 8:41 · Źródło po angielsku
Otwórz źródło →FAQ i wskazówki
Język
Domyślnie angielski. Przy pakowaniu wybierz inny przez -l (na przykład -l ja) albo dodaj DM_LANG=zh-Hans do Documents/env.txt.
Zapisy i logi
W aplikacji Pliki pod nazwą aplikacji: save/ i log.txt. Gdy coś pójdzie nie tak, wyślij log.txt.
Przycinki
Krótkie przycinki przy pierwszym pojawieniu się sceny są normalne: grafika kompiluje się raz i jest zapamiętywana.
Ponowna instalacja
Niektóre narzędzia do sideloadingu tworzą nowy folder danych. Skopiuj save/ i pso_user.tsv ze starego.
Ustawienia
Linie w Documents/env.txt: DM_OPMODE=0 dla trybu przenośnego, DM_FPS_TARGET=30 dla oszczędzania baterii, DM_SHOW_FPS=1 dla licznika FPS.
Nieobsługiwane
Brak amiibo i funkcji online. Inne gry dostają raport z analizy i IPA robiony według możliwości, który może się nie uruchomić.
Narzędzia społeczności i zgodność
Poznaj graficzne narzędzia budowania, biblioteki gier i obsługę starszych wersji iOS. Projekty są utrzymywane niezależnie; ich strony zawierają wymagania i linki do kodu.
NX2Apple Zewnętrzny
Launcher i biblioteka macOS do budowania i zarządzania grami na Mac, iPhone i iPad. Od v1.0 iPhone i iPad używają wspólnej powłoki z biblioteką, Cover Flow, obsługą pada i klawiatury oraz ustawieniami dla gry; silnik jest dołączony do wydań i codziennie podąża za upstreamem.
Zobacz projekt →NX Play Zewnętrzny
Jedna biblioteka do wypakowywania, grania, pakowania i zarządzania grami, teraz z NX Play na iPhone i iPad. Mobilny launcher pokazuje gry z Maca, prosi o instalację przez sieć lokalną, uruchamia je z padem i przypomina o odnowieniu podpisu.
Zobacz projekt →LumaNX Zewnętrzny
LumaNX, dawniej LumaDock, łączy nxnative z biblioteką graficzną, kolejką buildów i konwersją. Wersja 0.3.0 dodaje na Macu eksperymentalny import odszyfrowanych folderów Switch 2 i ponowne użycie niezmienionych etapów przygotowania.
Zobacz projekt →iOS 16.1/17 compatibility fork Zewnętrzny
Eksperymentalna gałąź zgodności dla starszego iOS z klasycznym Metalem, ograniczeniami shaderów zależnymi od urządzenia i adapterami dla buildów. Utrzymywana gałąź nazywa się teraz ios16-ios17-compat.
Zobacz projekt →nx2android Zewnętrzny
nx2android przenosi bezpośrednie uruchamianie nxnative na Androida. Kod ARM64 gry działa na urządzeniu, wywołania NVN są tłumaczone na Vulkan, a builder tworzy APK i dane gry.
Zobacz projekt →MacNativeGames Zewnętrzny
MacNativeGames to niezależny projekt natywnego działania skupiony na Breath of the Wild i Tears of the Kingdom. Działa na Macu, iPhonie, iPadzie i ma wstępne wsparcie Vision Pro.
Zobacz projekt →xbunax nxnative Zewnętrzny
xbunax/nxnative to fork z lokalnym studiem WebUI. Dodaje import i zadania w przeglądarce, konwersję XCI oraz opisane budowanie IPA w Windows i macOS.
Zobacz projekt →CA-NINAPPLE Zewnętrzny
CA-NINAPPLE to fork dla Windows wywodzący się z NXNativeWindows. GUI i PowerShell tworzą IPA z gry i kluczy bez Maca.
Zobacz projekt →NX OS Zewnętrzny
NX OS to konsolowy launcher macOS zbudowany na nxnative. Znajduje zbudowane gry, uruchamia je pełnoekranowo, mierzy czas i może rozpocząć nowe buildy Mac lub iPhone.
Zobacz projekt →nxnative-gui Zewnętrzny
nxnative-gui to lekkie GUI macOS, a nie drugi runtime. Klonuje lub aktualizuje nxnative, sprawdza narzędzia i grupuje w jednym formularzu opcje zwykle wpisywane w terminalu.
Zobacz projekt →ns2ios-shell Zewnętrzny
ns2ios-shell oddziela uniwersalną powłokę iOS od lokalnego pakowania gry. CI buduje powłokę, a packer łączy dane w Windows, Linux lub macOS bez Xcode.
Zobacz projekt →