seeddsandnocmt
a08bbdd3ba
From the PR (The Legend of Zelda: Echoes of Wisdom, 1.1.0, on the Mac): - A view whose level count runs past the texture's levels gets the levels it has, as deko3d's descriptor writer clips the maximum level (the game views levels 1 + 7 of a seven-level texture, which Metal's validation refuses); a base level past them is an empty slot (red line 109). - tex_by_id composes the descriptor's swizzle with the format's mapping (nvn_fmt_to_mtl: alpha 1 for RGBX-type formats, red and blue swapped for the RGB565 family), which was computed and never applied: the hearts' RGB565 mask drew as red rectangles. On top of the PR: - The red / blue swap is for bits in the guest's order, so it applies only to a texture uploaded from guest memory (an NvPkg in the serial table) or read from it in place (a texture on a pool buffer). What Metal renders or clears into a 16-bit texture is in Metal's order: with the PR, a target cleared to red sampled blue. - Metal gives a swizzled view only the read usage (a base of usage 0x7, its swizzled view 0x1), and the image binder sent such a slot to the dummy image: with the PR every RGBX8 / RGB565 image lost its writes (red line 32). An image takes no channel mapping, as a Vulkan storage image view must have the identity swizzle, so img_fit gives the slot the same view without one (kept in the slot's image view, as for a class change). - The on-chip read merge needs the sampled view's swizzle to be plain: a tile read takes no channel mapping, so an RGBX attachment merged into the next pass read its stored alpha. - Graphics tests: 13 of the 27 had stopped building. Every test that includes nvn_mtl.m now links hle_nvn.c, the large host stack and weak host stubs (t_host_stubs.c) through one Makefile variable, the tests that stubbed prog_key for want of hle_nvn.c drop the stub, t_present_crop / t_mip_extent rename hle_nvn.c's static g_ft (nvn_mtl.m has one too), and the budget test gets DM_GAME. t_view_swizzle (203 checks) reads the mappings back from the GPU through tex_by_id: the PR's cases, now with uploaded textures for the swap, plus RGB565 / BGR565 targets Metal cleared to red (red, no view) and an RGBX8 image (sampled alpha 1, writes through img_fit's view stored as written); without the upload rule it fails 9. t_view_levels 34 checks. Every graphics test builds; the ones still failing fail the same with main's nvn_mtl.m: t_refl 2 (reflection samples in a local cache), t_reorder_chain 30, t_mip_extent 2, t_rt_range 4 to 8 per mode, t_pfv 1, t_rt_range_ro (a missing JSON file). Co-authored-by: nocmt <26828323+nocmt@users.noreply.github.com>
nxnative
Play your own Nintendo Switch games natively on iPhone and iPad. Bring your game (its NSP files) and your prod.keys; one script turns them into an IPA that you sideload.
It is not an emulator: the game's own code runs directly on the Apple chip, with Switch graphics rebuilt on Metal. Nothing from any game is in this repository, and the project is not affiliated with Nintendo or any game publisher.
Acknowledgements
This project is built on other people's work:
- d2r-mobile (MIT) developed this native-execution approach, for Diablo II: Resurrected. nxnative (first called smbw-mobile) started as a copy of its generic parts: the NSO rewriter, the host that stands in for Horizon, the NVN-on-Metal layer and the iOS app shell. Fixes go both ways.
- Ryujinx (MIT): its shader translator (
Ryujinx.Graphics.Shader,Ryujinx.CommonandSpv.Generator1.3.2, indm/third_party/ryujinxwith a few fixes listed in its README) turns the games' Maxwell shaders into SPIR-V. Its emulation of the kernel and system services is also a reference when the host's behaviour is in doubt. - Atmosphère: its kernel, mesosphère, is the reference for Horizon's synchronization semantics (address arbiter, condition variables).
- yuzu: Maxwell instruction encodings for the shader reference tool, and a cross-check for kernel behaviour.
- LibHac: reads NSPs and layers updates over the base game in
dm/tools/nx_extract. hactool did the first extractions. - SPIRV-Cross: SPIR-V to Metal Shading Language. glslang compiles the GLSL of OpenGL games to SPIR-V for it.
- deko3d (zlib): its texture layout size algorithm is ported in
dm/gfx/nvn/nvn_tex.c. - libvpx (VP9 movies), stb_vorbis (movie sound), the Vulkan headers and NVIDIA FLIP ship in
dm/third_partywith their licenses (list). - Capstone, lz4, fontTools and XcodeGen are used by the build.
Games
All of these are tested on an iPhone and playable:
Needs iOS / iPadOS 26 or later on an iPhone 15 Pro or newer (A17 Pro chip or later) or an iPad with an M1 chip or later: the games' textures are BC-compressed, and older iPhones can't read that format. Other games aren't supported yet. For them the script writes a survey and still tries its best to pack an IPA, guessing the game's settings; such an IPA may not start.
 Super Mario Bros. Wonder IPA ~4 GB |
 Fire Emblem Engage IPA ~15 GB · 60 fps (30 on Switch) with update 2.0.0 |
 Metroid Dread IPA ~5 GB |
 13 Sentinels: Aegis Rim IPA ~5 GB |
 Super Mario 3D World + Bowser's Fury IPA ~3 GB |
 The Legend of Zelda: Breath of the Wild IPA ~16 GB · 60 fps (30 on Switch) with update 1.9.0 |
 The Legend of Zelda: Link's Awakening IPA ~6 GB |
 Super Mario Odyssey IPA ~6 GB |
 Hades IPA ~4 GB |
 Hyrule Warriors: Age of Calamity IPA ~15 GB · 60 fps (30 on Switch) with update 1.3.0 |
 Fire Emblem: Three Houses IPA ~13 GB · 60 fps (30 on Switch) with update 1.2.0 |
 Super Mario Galaxy IPA ~3 GB |
 The Legend of Zelda: Tears of the Kingdom IPA ~17 GB · 60 fps (30 on Switch) with update 1.4.3 |
 Monster Hunter Rise IPA ~22 GB · 60 fps (30 on Switch) with update 16.0.2 |
 Ace Attorney Investigations Collection IPA ~7 GB |
 Hades II IPA ~4 GB |
 Unicorn Overlord IPA ~4 GB |
 Rhythm Heaven Groove IPA ~3 GB |
 Octopath Traveler 0 IPA ~4 GB · 60 fps (30 on Switch) with update 1.0.5 |
 Pokémon Legends: Z-A IPA ~6 GB |
 Cuphead IPA ~5 GB |
 Super Mario Galaxy 2 IPA ~3 GB |
 FINAL FANTASY TACTICS - The Ivalice Chronicles IPA ~11 GB |
 Absolum IPA ~2 GB |
 Captain Toad: Treasure Tracker IPA ~2 GB |
 Brain Memory Training Academy IPA ~0.1 GB |
 The Great Ace Attorney Chronicles IPA ~4 GB |
 STEINS;GATE RE:BOOT IPA ~6 GB |
 Big Brain Academy: Brain vs. Brain IPA ~0.8 GB |
 Patrick's Parabox IPA ~0.2 GB |
 Celeste IPA ~0.9 GB |
 DRAGON QUEST XI S: Echoes of an Elusive Age – Definitive Edition IPA ~15 GB · 60 fps (30 on Switch) with update 1.0.4 |
 Monster Train 2 IPA ~1.6 GB · 60 fps (30 on Switch) with update 1.1.1 |
 Raging Loop IPA ~0.9 GB |
 DARK SOULS: REMASTERED IPA ~4 GB · 60 fps (30 on Switch) with update 1.0.3 |
 Paper Mario: The Thousand-Year Door IPA ~5 GB · 60 fps (30 on Switch) with update 1.0.1 |
 Hollow Knight: Silksong IPA ~6.4 GB |
 Catherine: Full Body IPA ~14 GB |
 Digimon Story Cyber Sleuth: Complete Edition IPA ~5 GB |
 Animal Crossing: New Horizons IPA ~10.5 GB with update 3.0.3 |
 DRAGON QUEST VII Reimagined IPA ~5.9 GB with update 1.2.0 |
 FINAL FANTASY RESONANCE IPA ~10 GB · 60 fps (30 on Switch) with update 1.0.1 |
 Luigi's Mansion 3 IPA ~7.5 GB · 60 fps (30 on Switch) with update 1.4.0 |
Pack an IPA
1. Get nxnative and its tools (once, on a Mac with Xcode and Homebrew):
git clone https://github.com/seedds/nxnative.git && cd nxnative
brew install xcodegen zstd spirv-cross glslang
brew install --cask dotnet-sdk
python3 -m pip install lz4 capstone fonttools "backports.zstd; python_version < '3.14'"
2. Put one game's NSPs in a folder: the base game (an NSP, or an XCI cartridge dump), plus its update and DLC if you have them:
~/Games/MarioWonder/
Super Mario Bros. Wonder [010015100B514000][v0].nsp
Super Mario Bros. Wonder [010015100B514800][v327680].nsp
Any version works, with or without an update: the script packs the newest version in the folder. DLC is optional too: the DLC in the folder is packed, and without it the game sees none, as on a Switch without it. Each game was tested on one version (an update named in the table above is the one its 60 fps needs). With another version the script builds the game with that version's own shaders and says that the version was not tested; fixes made for the tested version's code, such as the 60 fps ones, don't apply to it.
3. Run the script:
python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys
The IPA appears in the same folder (here ~/Games/MarioWonder/SMBWMobile.ipa). The first build takes 30–60 minutes, later ones about 10. You need free disk space of about twice the NSPs' size plus 10 GB. Options such as -o (output path) and --app-name are listed by -h.
4. Install the IPA with your sideloading tool (AltStore, Sideloadly, LiveContainer, …). The app gets the game's name, icon and version (the update's version, for example 1.2.1 for Mario Wonder; the base game's when there is no update). Sign it with the Increased Memory Limit capability (com.apple.developer.kernel.increased-memory-limit) if your tool can: without it iOS gives the app about 3.4 GB and closes the bigger games (Hyrule Warriors: Age of Calamity and Hades II use more, Breath of the Wild and Cuphead come close); with it a recent iPhone gives about 6 GB.
With an Apple developer account you can instead build and install from Xcode: --prepare-xcode makes an Xcode project for the game rather than an IPA (Build and run on a device with Xcode).
Play
Settings. A screen before the game starts offers what the game supports: frame rate, render scale, docked or handheld mode, game language, the frame-rate counter and Apple's performance HUD. Tap Play to start; the app remembers your choices.
Touch controls. Tap 2D / 3D at the top to switch layouts; the app remembers your choice. Wonder, Engage, Dread, 13 Sentinels, Link's Awakening, Ace Attorney Investigations Collection, Unicorn Overlord, Rhythm Heaven Groove, Octopath Traveler 0, Pokémon Legends: Z-A, Cuphead, Absolum, Brain Memory Training Academy, The Great Ace Attorney Chronicles, STEINS;GATE RE:BOOT, Big Brain Academy: Brain vs. Brain, Patrick's Parabox, Celeste and Raging Loop start in 2D, the other games in 3D (STEINS;GATE RE:BOOT's quick save is R3, in the 3D layout). In 3D, the right stick (the camera in most games) is not drawn: swipe on the right third of the screen, starting anywhere off the buttons. In Super Mario Galaxy and Super Mario Galaxy 2, other touches outside the controls move the pointer; in Captain Toad: Treasure Tracker they touch the game's screen (touch blocks, stun enemies), and in Big Brain Academy: Brain vs. Brain too (its menus and activities). A connected game controller hides the touch controls and keeps every button.
Shaking. Shake the iPhone to shake the controller, in games that read its motion: Super Mario Odyssey's motion moves (such as the cap throw on a shake) need it, and Odyssey only takes them in its default docked mode. A light bump does not count; a sharp flick of the phone does.
- Game language is English by default. Pick another when packing with
--language(-l), by code or by name:-l ja,-l zh-Hans,-l French(LANGUAGEin Spyder). It must be one the game has; the script prints the game's languages and stops on one it lacks. To change it without rebuilding, pick another on the settings screen. - Saves and logs are in the Files app, under the app's name:
save/andlog.txt. When something goes wrong, sendlog.txt(the previous run islog.prev.txt). - Short stutters the first time a new scene appears are normal: the app compiles graphics for it once and remembers them for the next launch.
- Reinstalling: some sideloading tools give a reinstalled app a new data folder. Copy
save/andpso_user.tsvover from the old one to keep your progress. - Settings in a file: lines like
DM_OPMODE=0(handheld mode: lower resolution, higher frame rate) inDocuments/env.txtwin over the settings screen, which then shows them greyed out.DM_FPS_TARGET=30keeps Breath of the Wild, Tears of the Kingdom and Octopath Traveler 0 at their original 30 fps, which saves battery;DM_PRESENT_INTERVAL=gamedoes the same for Monster Train 2.DM_SHOW_FPS=1shows the frame rate at the top left (--show-fpswhen packing turns it on from the start).DM_LAUNCHER=0skips the settings screen.
Known issues
- No amiibo and no online features.
- Fire Emblem Engage: after switching away from the app and back, some sounds may stay silent until you restart it.
- Fire Emblem: Three Houses: small square patches on the ground where decals land.
- Super Mario Galaxy and Super Mario Galaxy 2: effects drawn as points or lines come out one pixel wide.
For developers
How it works, the script's options, running games on the Mac, adding a game, and per-game notes: docs/development.md. In-depth bring-up and debugging notes: docs/agents.
License
MIT (see LICENSE). Third-party code keeps its own license; see dm/third_party.