Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · Englische Quelle
Quelle öffnen →Erstelle mit deinen Spieldateien und Schlüsseln Apps für Apple Silicon Macs, iPhone und iPad. Der Spielcode läuft auf dem Apple-Chip, die Grafik wird mit Metal dargestellt.
Beide Wege beginnen auf einem Mac: Öffne die Mac-App oder installiere die unsignierte IPA per Sideloading auf iPhone oder iPad.
Erstelle die App mit --platform mac-app und öffne sie anschließend im Finder.
Erstelle eine IPA auf dem Mac und installiere sie per Sideloading. Upstream benötigt iOS / iPadOS 26+ und A17 Pro / M1 oder neuer.
Du benötigst das Basisspiel, optionale Updates und DLCs sowie prod.keys. Spiele und Schlüssel sind nicht enthalten.
Der Katalog erfasst Spieltests auf Mac oder iPhone. Die Detailseiten nennen getestete Versionen, Hinweise und bekannte Einschränkungen.
Aufgebaut auf d2r-mobile, dem Shader-Übersetzer von Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross und mehr. Siehe die Danksagungen.
Diese Spiele wurden auf einem Mac oder iPhone gespielt und getestet, jedoch nicht unbedingt auf jedem Gerät. Details findest du auf der jeweiligen Spielseite.































































































































Der erste Build dauert etwa 30–60 Minuten. Spätere Builds verwenden abgeschlossene Schritte erneut. Das Ergebnis ist eine Mac-App oder eine unsignierte IPA.
Zum Bauen: macOS 26.6+, Xcode 27.1, Homebrew und ARM64 Python 3.12+. Für iPhone wird auch die iOS-Plattform von Xcode benötigt. Halte etwa die doppelte Spielgröße plus 10 GB frei.
Lieber ein Fenster als ein Terminal? NX2Apple, ein Community-Projekt, packt diese Schritte in eine macOS-App.
Einmalig, auf dem 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'"Lege Basisspiel, Updates und DLCs in einen Ordner. NSP, XCI, NSZ und XCZ werden unterstützt.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspDas Ergebnis liegt im Spielordner. Für Mac ergänze --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Öffne die App auf dem Mac im Finder. Installiere die IPA auf iPhone / iPad mit AltStore, Sideloadly oder LiveContainer. Aktiviere bei großen Spielen Increased Memory Limit, falls verfügbar.
Tippe oben auf 2D / 3D, um das Touch-Layout zu wechseln. Ein verbundener Controller blendet die Touch-Steuerung aus. In 3D wischst du auf dem rechten Drittel des Bildschirms für die Kamera. Schüttle das Handy, um den Controller zu schütteln.
Ist die IPA zu groß, baue erneut mit --romfs separate und führe den angezeigten Kopierbefehl aus. Ältere iOS-Versionen werden separat von einem Community-Zweig unterstützt. Spielen.
Aus Google-Ergebnissen vom 30. Oktober 2026 ausgewählt. Die Reihenfolge variiert. Aktuelle Projektdokumentation hat Vorrang; Videotitel garantieren keine Unterstützung aller Spiele.
AppleGamingWiki · Englische Quelle
Quelle öffnen →seedds / nxnative · Englische Quelle
Quelle öffnen →Andrew Tsai’s Tips · 11:59 · Englische Quelle
Quelle öffnen →blackheart909 · 8:41 · Englische Quelle
Quelle öffnen →Standardmäßig Englisch. Beim Packen mit -l eine andere wählen (zum Beispiel -l ja) oder DM_LANG=zh-Hans in Documents/env.txt eintragen.
In der Dateien-App unter dem Namen der App: save/ und log.txt. Schick log.txt, wenn etwas schiefgeht.
Kurze Ruckler beim ersten Auftauchen einer Szene sind normal: Die Grafik wird einmal kompiliert und gemerkt.
Manche Sideload-Werkzeuge vergeben einen neuen Datenordner. Kopiere save/ und pso_user.tsv aus dem alten.
Zeilen in Documents/env.txt: DM_OPMODE=0 für den Handheld-Modus, DM_FPS_TARGET=30 zum Akkusparen, DM_SHOW_FPS=1 für eine FPS-Anzeige.
Keine amiibo, keine Online-Funktionen. Andere Spiele bekommen einen Analysebericht und eine bestmögliche IPA, die vielleicht nicht startet.
Entdecke grafische Builder, Spielebibliotheken und Unterstützung für ältere iOS-Versionen. Die unabhängig gepflegten Projekte verlinken auf ihren Detailseiten Voraussetzungen und Quellcode.
Ein macOS-Launcher und eine Spielebibliothek zum Bauen und Verwalten von Mac-, iPhone- und iPad-Spielen. Seit v1.0 nutzen iPhone und iPad eine gemeinsame Hülle mit Bibliothek, Cover Flow, Controller- und Tastaturnavigation sowie Einstellungen pro Spiel; die Engine wird mit Releases ausgeliefert und folgt Upstream täglich.
Projekt ansehen →Eine Bibliothek zum Entpacken, Spielen, Packen und Verwalten von Spielen, jetzt mit NX Play für iPhone und iPad. Der mobile Launcher listet Mac-Spiele, fragt Installationen im lokalen Netzwerk an, startet installierte Spiele mit Controller und erinnert an Signaturerneuerungen.
Projekt ansehen →LumaNX, früher LumaDock, verbindet nxnative mit grafischer Bibliothek, Build-Warteschlange und Konvertierung. Version 0.3.0 ergänzt den experimentellen Mac-Import entschlüsselter Switch-2-Ordner und verwendet unveränderte Vorbereitungsphasen erneut.
Projekt ansehen →Experimenteller Kompatibilitätszweig für ältere iOS-Versionen mit klassischem Metal, gerätespezifischen Shader-Einschränkungen und Anpassungen pro Build. Der gepflegte Zweig heißt jetzt ios16-ios17-compat.
Projekt ansehen →nx2android überträgt den Direktausführungsansatz von nxnative auf Android. Der ARM64-Code des Spiels läuft auf dem Gerät, NVN-Aufrufe werden nach Vulkan übersetzt und der Builder erzeugt eine APK samt Spieldaten.
Projekt ansehen →MacNativeGames ist ein eigenständiges natives Projekt mit Schwerpunkt auf Breath of the Wild und Tears of the Kingdom. Es läuft auf Mac, iPhone und iPad und bietet frühe Vision-Pro-Unterstützung.
Projekt ansehen →xbunax/nxnative ist ein Fork mit lokalem WebUI-Buildstudio. Er ergänzt Browser-Import und Aufgabenverwaltung, XCI-Konvertierung und dokumentierte IPA-Builds unter Windows und macOS.
Projekt ansehen →CA-NINAPPLE ist ein Windows-orientierter Fork von NXNativeWindows. GUI und PowerShell erzeugen ohne Mac eine iOS-IPA aus Spiel und Schlüsseln.
Projekt ansehen →NX OS ist ein konsolenartiger macOS-Launcher auf Basis von nxnative. Er findet gebaute Spiele, startet sie im Vollbild, zählt Spielzeit und kann neue Mac- oder iPhone-Builds einreihen.
Projekt ansehen →nxnative-gui ist eine schlanke macOS-Oberfläche und keine zweite Laufzeit. Sie klont oder aktualisiert nxnative, prüft Werkzeuge und bündelt die sonst im Terminal gewählten Buildoptionen in einem Formular.
Projekt ansehen →ns2ios-shell trennt eine wiederverwendbare spielunabhängige iOS-Shell vom lokalen Packen. Die CI baut die Shell; ein Packer kombiniert sie unter Windows, Linux oder macOS ohne Xcode mit den Spieldaten.
Projekt ansehen →