Guide: Running Switch games natively on Mac with nxnative
AppleGamingWiki · Engelse bron
Bron openen →Apple Silicon Mac · iPhone · iPad
Je Switch-games, native op Apple
Maak apps voor Apple Silicon Macs, iPhone en iPad met je eigen games en sleutels. De spelcode draait op de Apple-chip en Metal verzorgt de graphics.
128speelbare games
25opgewaardeerd naar 60 fps
MITBroncode op GitHub
Kies waar je speelt
Beide routes beginnen op een Mac: open de Mac-app of installeer de ongetekende IPA via sideloading op je iPhone of iPad.
Apple Silicon Mac
Bouw met --platform mac-app en open de gemaakte app vanuit Finder.
iPhone & iPad
Maak een IPA op je Mac en installeer die via sideloading. Upstream vereist iOS / iPadOS 26+ en A17 Pro / M1 of nieuwer.
Je eigen games en sleutels
Zorg voor het basisspel, eventuele updates en DLC, en prod.keys. Games en sleutels worden niet meegeleverd.
Controleer eerst je game
De catalogus bevat speeltests op Mac of iPhone. Elke pagina vermeldt de geteste versie, opmerkingen en bekende beperkingen.
Gebouwd op d2r-mobile, de shadervertaler van Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross en meer. Zie de dankwoorden.
Vind je game
Deze games zijn getest door ze te spelen op een Mac of iPhone, maar niet noodzakelijk op elk apparaat. Bekijk de afzonderlijke pagina’s voor details.
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 indeling
Super Mario Bros. Wonder2D indeling
Super Mario Galaxy3D indeling
Super Mario Galaxy 23D indeling
Super Mario Odyssey3D indeling
Volledige catalogus tonen (128)
The Legend of Zelda: Breath of the Wild3D indeling60 fps
The Legend of Zelda: Link's Awakening2D indeling
The Legend of Zelda: Tears of the Kingdom3D indeling60 fps
13 Sentinels: Aegis Rim2D indeling
Absolum2D indeling
Ace Attorney Investigations Collection2D indeling
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 indeling
Brain Memory Training Academy2D indeling
Captain Toad: Treasure Tracker3D indeling
Catherine: Full Body
Celeste2D indeling
Cuphead2D indeling
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 indeling60 fps
FINAL FANTASY RESONANCE60 fps
FINAL FANTASY TACTICS - The Ivalice Chronicles3D indeling
Fire Emblem Engage2D indeling60 fps
Fire Emblem: Three Houses3D indeling60 fps
Ghost Trick: Phantom Detective
The Great Ace Attorney Chronicles2D indeling
Hades3D indeling
Hades II3D indeling
Hollow Knight: Silksong
Hyrule Warriors: Age of Calamity3D indeling60 fps
Kirby and the Forgotten Land
Luigi's Mansion 360 fps
Metroid Dread2D indeling
Monster Hunter Rise3D indeling60 fps
Monster Train 22D indeling60 fps
OCTOPATH TRAVELER
Octopath Traveler 02D indeling60 fps
Octopath Traveler II60 fps
Patrick's Parabox2D indeling
Persona 5 Royal
Pikmin 4
Pokémon Brilliant Diamond60 fps
Pokémon Legends: Z-A2D indeling
Pokémon Scarlet
Pokémon Violet
Pokémon Sword
Pokémon Shield
Portal
Raging Loop
Rhythm Heaven Groove2D indeling
ROMANCE OF THE THREE KINGDOMS 8 REMAKE
Sea of Stars
SHIN MEGAMI TENSEI V: Vengeance60 fps
Stardew Valley
STEINS;GATE RE:BOOT2D indeling
Super Smash Bros. Ultimate
Taiko Risshiden V DX
Unicorn Overlord2D indeling
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
Van spelbestanden naar speelbare app
De eerste build duurt ongeveer 30–60 minuten; volgende builds hergebruiken voltooid werk. Je krijgt een Mac-app of een ongetekende IPA.
Bouwen vereist macOS 26.6+, Xcode 27.1, Homebrew en ARM64 Python 3.12+. Installeer voor iPhone ook het iOS-platform van Xcode. Reserveer tweemaal de spelgrootte plus 10 GB.
Liever een venster dan een terminal? NX2Apple, een communityproject, verpakt deze stappen in een macOS-app.
Haal nxnative en de tools op
Eenmalig, op de 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'"Zet de NSP's van één game in een map
Zet het basisspel, updates en DLC in één map. NSP, XCI, NSZ en XCZ worden ondersteund.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspVoer het script uit
Het resultaat staat in de spelmap. Voeg voor Mac --platform mac-app toe.
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-appOpenen of installeren
Open de app op Mac vanuit Finder. Installeer de IPA op iPhone / iPad met AltStore, Sideloadly of LiveContainer. Schakel voor grote games Increased Memory Limit in als dat beschikbaar is.
Spelen
Tik bovenaan op 2D / 3D om de aanraakindeling te wisselen. Een aangesloten controller verbergt de aanraakbediening. In 3D veeg je over het rechtergedeelte (een derde) van het scherm voor de camera. Schud de telefoon om de controller te schudden.
Is de IPA te groot, bouw dan opnieuw met --romfs separate en voer de getoonde kopieeropdracht uit. Ondersteuning voor oudere iOS-versies komt van een aparte communitybranch. Spelen.
Handleidingen en video’s
Geselecteerd uit Google-resultaten van 30 oktober 2026. De volgorde varieert. Volg de actuele projectdocumentatie; videotitels garanderen geen ondersteuning voor elk spel.
nxnative — Development guide
seedds / nxnative · Engelse bron
Bron openen →How to Build Any Switch Game As Native Mac App (nxnative)
Andrew Tsai’s Tips · 11:59 · Engelse bron
Bron openen →NXnative - Native Switch Games on iPhone 17 Pro Max
blackheart909 · 8:41 · Engelse bron
Bron openen →FAQ en tips
Taal
Standaard Engels. Kies bij het packen een andere met -l (bijvoorbeeld -l ja), of voeg DM_LANG=zh-Hans toe aan Documents/env.txt.
Saves en logs
In de Bestanden-app onder de naam van de app: save/ en log.txt. Stuur log.txt mee als er iets misgaat.
Haperingen
Korte haperingen de eerste keer dat een scène verschijnt zijn normaal: graphics worden één keer gecompileerd en onthouden.
Opnieuw installeren
Sommige sideload-tools geven een nieuwe gegevensmap. Kopieer save/ en pso_user.tsv uit de oude.
Instellingen
Regels in Documents/env.txt: DM_OPMODE=0 voor handheld, DM_FPS_TARGET=30 om batterij te besparen, DM_SHOW_FPS=1 voor een fps-teller.
Niet ondersteund
Geen amiibo, geen onlinefuncties. Andere games krijgen een analyserapport en een IPA op basis van beste inspanning die mogelijk niet start.
Communitytools en compatibiliteit
Ontdek grafische bouwtools, gamebibliotheken en ondersteuning voor oudere iOS-versies. Deze projecten worden onafhankelijk onderhouden; hun pagina’s verwijzen naar vereisten en broncode.
NX2Apple Van derden
Een macOS-launcher en spelbibliotheek om Mac-, iPhone- en iPad-games te bouwen en beheren. Sinds v1.0 delen iPhone en iPad één shell met bibliotheek, Cover Flow, controller- en toetsenbordnavigatie en instellingen per spel; de engine zit in releases en volgt upstream dagelijks.
Project bekijken →NX Play Van derden
Eén bibliotheek voor uitpakken, spelen, verpakken en beheren, nu met NX Play voor iPhone en iPad. De mobiele launcher toont Mac-games, vraagt installatie via het lokale netwerk, start geïnstalleerde games met controller en herinnert aan signatuurvernieuwing.
Project bekijken →LumaNX Van derden
LumaNX, voorheen LumaDock, combineert nxnative met een grafische bibliotheek, buildwachtrij en conversie. Versie 0.3.0 voegt op de Mac experimentele import van ontsleutelde Switch 2-mappen toe en hergebruikt ongewijzigde voorbereidingsfasen.
Project bekijken →iOS 16.1/17 compatibility fork Van derden
Experimentele compatibiliteitsbranch voor oudere iOS-versies met klassiek Metal, apparaatspecifieke shaderbeperkingen en adapters per build. De onderhouden branch heet nu ios16-ios17-compat.
Project bekijken →nx2android Van derden
nx2android brengt de directe uitvoering van nxnative naar Android. De ARM64-code van het spel draait op het toestel, NVN-aanroepen worden naar Vulkan vertaald en de builder maakt een APK plus speldata.
Project bekijken →MacNativeGames Van derden
MacNativeGames is een onafhankelijk native project rond Breath of the Wild en Tears of the Kingdom. Het werkt op Mac, iPhone en iPad en heeft vroege Vision Pro-ondersteuning.
Project bekijken →xbunax nxnative Van derden
xbunax/nxnative is een fork met een lokale WebUI-buildstudio. Hij voegt browserimport en taakbeheer, XCI-conversie en gedocumenteerde IPA-builds voor Windows en macOS toe.
Project bekijken →CA-NINAPPLE Van derden
CA-NINAPPLE is een Windows-gerichte fork van NXNativeWindows. GUI en PowerShell maken zonder Mac een iOS IPA van spel en sleutels.
Project bekijken →NX OS Van derden
NX OS is een macOS-launcher in consolestijl boven op nxnative. Hij vindt gebouwde games, start ze schermvullend, houdt speeltijd bij en kan nieuwe Mac- of iPhone-builds starten.
Project bekijken →nxnative-gui Van derden
nxnative-gui is een lichte macOS-frontend, geen tweede runtime. Het kloont of vernieuwt nxnative, controleert de toolchain en bundelt de terminalkeuzes in één buildformulier.
Project bekijken →ns2ios-shell Van derden
ns2ios-shell scheidt een herbruikbare game-onafhankelijke iOS-shell van lokaal per-game packen. CI bouwt de shell; een packer combineert spel en shell op Windows, Linux of macOS zonder Xcode.
Project bekijken →