To nie emulator. Kod samej gry działa bezpośrednio na układzie Apple, a grafika Switcha jest odtworzona na Metal. Przynieś własne pliki NSP i prod.keys; jeden skrypt zamieni je w IPA, który zainstalujesz przez sideloading.
Natywny port zamiast emulacji: kod gry jest przepisywany tylko tam, gdzie wymaga tego jądro Apple.
Moduły NSO każdej gry są przepisywane i działają bezpośrednio na CPU. Warstwa hosta zastępuje Horizon, system operacyjny Switcha: wątki, pamięć, system plików, dźwięk i usługi.
Wywołania NVN i Vulkan są zaimplementowane na Metal. Shadery Maxwell są podczas budowania tłumaczone na SPIR-V, a potem na Metal Shading Language.
Nic z żadnej gry nie jest tu dołączone. Skrypt pakujący czyta twoje pliki NSP twoimi kluczami na twoim Macu i zapisuje niepodpisany IPA do sideloadingu.
Każda gra ma mały profil ze stałymi i tabelami shaderów w dm/games/<title id>. Kod czyta profil i nigdy nie zakłada na sztywno konkretnej gry.
Zbudowane na d2r-mobile, tłumaczu shaderów z Ryujinx, Atmosphère, yuzu, LibHac, SPIRV-Cross i innych. Zobacz podziękowania.
Spakuj IPA na Macu, zainstaluj przez sideloading i graj. Pierwsza kompilacja trwa 30–60 minut, kolejne około 10.
Wymagania. Mac z Xcode i Homebrew; wolne miejsce na dysku około dwa razy większe niż pliki NSP plus 10 GB; iPhone 15 Pro lub nowszy (A17 Pro+) albo iPad z M1 lub nowszym, z iOS / iPadOS 26+ (wymagają tego tekstury kompresowane BC).
Wolisz okno od terminala? NX2Apple, projekt społeczności, zamyka te kroki w aplikacji na macOS.
Jednorazowo, na Macu.
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd spirv-cross
brew install --cask dotnet-sdk
python3 -m pip install lz4 capstone fonttools "backports.zstd; python_version < '3.14'"Gra podstawowa (NSP lub zrzut XCI), jej aktualizacja i ewentualne DLC.
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nspIPA pojawi się w tym samym folderze.
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keysZainstaluj IPA przez AltStore, Sideloadly, LiveContainer lub podobne narzędzie. Aplikacja przyjmie nazwę, ikonę i wersję gry.
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.
Przetestowane na Macu lub iPhonie. Wybierz grę, aby zobaczyć szczegóły; notatki o grach podają przetestowane platformy i postępy.
























































































Domyślnie angielski. Przy pakowaniu wybierz inny przez -l (na przykład -l ja) albo dodaj DM_LANG=zh-Hans do Documents/env.txt.
W aplikacji Pliki pod nazwą aplikacji: save/ i log.txt. Gdy coś pójdzie nie tak, wyślij log.txt.
Krótkie przycinki przy pierwszym pojawieniu się sceny są normalne: grafika kompiluje się raz i jest zapamiętywana.
Niektóre narzędzia do sideloadingu tworzą nowy folder danych. Skopiuj save/ i pso_user.tsv ze starego.
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.
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ć.
Projekty, które inni budują na nxnative. nxnative ich nie utrzymuje; sprawdź README i zgłoszenia każdego z nich.
A fork of nxnative that follows upstream daily and adds NS Port Builder, a macOS app that runs the whole pipeline from a window.
A native launcher for Apple Silicon Macs (macOS 26+, SwiftUI) that you point at your own nxnative checkout, games and keys.
A Mac app (and the nxplay script behind it) that builds, plays, installs and manages your Switch games through nxnative, on the Mac and on iPhone / iPad.
A native macOS interface (Apple silicon, macOS 13+) that turns nxnative's command-line pipeline into a console-style game library and a guided porting wizard.