seedds/nxnative

选用指南

AI 根据 README 整理 · 2026/10/18 02:56:11

使用方式

通过命令行脚本将游戏 NSP 文件打包为 IPA，然后使用侧载工具安装。

查看 README 依据

brew install --cask dotnet-sdk python3 -m pip install lz4 capstone fonttools ``` **2. Put one game's NSPs in a folder**, base game and update (and any DLC): ``` ~/Games/MarioWonder/ Super Mario Bros. Wonder [010015100B514000][v0].nsp Super Mario Bros. Wonder [010015100B514800][v327680].nsp ``` **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). ## Play

部署要求

需要 iOS / iPadOS 26 或更高版本，打包需在装有 Xcode 和 Homebrew 的 Mac 上进行，并安装相关依赖。

查看 README 依据

| <br>The Legend of Zelda: Link's Awakening | | Needs iOS / iPadOS 26 or later. 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. ## Pack an IPA **1. Get nxnative and its tools** (once, on a Mac with [Xcode](https://apps.apple.com/app/xcode/id497799835) and [Homebrew](https://brew.sh)): ``` git clone https://github.com/seedds/nxnative.git && cd nxnative brew install xcodegen zstd spirv-cross

**1. 获取 nxnative 和所需工具**（只需一次，在装有 [Xcode](https://apps.apple.com/app/xcode/id497799835) 和 [Homebrew](https://brew.sh) 的 Mac 上）： ``` 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 ``` **2. 把一个游戏的 NSP 放进一个文件夹**，本体和更新（有 DLC 也放进去）： ``` ~/Games/MarioWonder/ Super Mario Bros. Wonder [010015100B514000][v0].nsp Super Mario Bros. Wonder [010015100B514800][v327680].nsp ``` **3. 运行脚本：** ```

已知限制

仅支持列出的游戏，其他游戏可能无法启动；没有 amiibo 和联网功能，部分游戏存在已知问题。

查看 README 依据

| <br>The Legend of Zelda: Link's Awakening | | Needs iOS / iPadOS 26 or later. 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. ## Pack an IPA **1. Get nxnative and its tools** (once, on a Mac with [Xcode](https://apps.apple.com/app/xcode/id497799835) and [Homebrew](https://brew.sh)): ``` git clone https://github.com/seedds/nxnative.git && cd nxnative brew install xcodegen zstd spirv-cross

- **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/` and `pso_user.tsv` over from the old one to keep your progress. - **Settings without rebuilding:** put lines like `DM_OPMODE=0` (handheld mode: lower resolution, higher frame rate) in `Documents/env.txt`. ## 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. - Super Mario 3D World: a few small magenta squares can appear near the birds in World 1-1. ## For developers How it works, the script's options, running games on the Mac, adding a game, and per-game notes: [docs/development.md](docs/development.md). In-depth bring-up and debugging notes: [docs/agents](docs/agents/README.md). ## License MIT (see [LICENSE](LICENSE)). Third-party code keeps its own license; see [dm/third_party](dm/third_party/README.md). --- # 中文说明