cheemu21/plumber-racer-2

项目介绍

Plumber Racer 2 是 nxnative 的一个前端分发项目，目标是在 Apple 芯片上原生运行 Nintendo Switch 游戏的代码，而不是模拟整台主机。它面向已经拥有 Switch 游戏 dump、希望把游戏放到 iPhone、iPad 或 Mac 上玩的用户；仓库本身不包含任何游戏文件，使用者需自备对应版本的 dump。

对 Mario Kart World，README 限定必须使用 1.0.0 基础版（不含更新和 DLC，main build ID 为 9e244438c3d8ef1c703a6a85ef99c4f0），并单独提供了游戏说明。页面还列出了大量已测试游戏，部分标注了目标帧率或已知问题，例如缺少 Mii 头像、仅支持离线。

快速使用

构建需要 macOS 26.6 以上的 Mac、Xcode 27.2、Homebrew 和 Python 3.12+（arm64）。如需生成 iPhone 版本，还要在 Xcode 中安装 iOS 平台组件。

1. 选择正确的 Xcode 并下载 Metal 工具链，然后安装依赖：

sudo xcode-select -s /Applications/Xcode.app
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'"

2. 把游戏文件及更新、DLC 放进同一个文件夹，例如 ~/Games/MarioWonder/，文件格式可为 .nsp、.xci、.nsz 或 .xcz。

3. 用游戏目录和 prod.keys 构建：

python3 scripts/build_ipa_from_nsp.py ~/Games/MarioWonder -k ~/keys/prod.keys

生成的 IPA 会出现在游戏目录中。首次构建约需 30–60 分钟，并需要约为游戏体积两倍再加 10 GB 的可用空间。若想直接在 Mac 上运行，加上 --platform mac-app 生成 Mac 应用。完整参数见打包脚本说明。

4. 用 AltStore、Sideloadly 或 LiveContainer 等工具侧载 IPA；工具提供 Increased Memory Limit 选项时请打开。游戏过大装不下时，用 --romfs separate 重新构建，再执行脚本打印的复制命令把游戏文件传到手机（见快速重装说明）。操作、存档和设置见游玩文档。

Switch 2 游戏改为从解包后的文件夹构建，目前仅支持 Mac，且不需要 prod.keys，详见 Switch 2 部分。

使用约束

在 iPhone 或 iPad 上运行需要 iOS/iPadOS 26 以上，设备须为 iPhone 15 Pro 及更新机型（A17 Pro 或更新芯片），或搭载 M1 及以上芯片的 iPad，因为游戏纹理使用 BC 压缩，旧设备无法读取。未列入测试列表的游戏也会尝试打包，但可能无法启动。仓库不附带游戏数据，需自行提供合法 dump。代码采用 MIT 许可，内置的第三方组件各自保留原许可（见第三方说明）。

HotRepo 点评

该项目出现在 HotRepo 2026-11-10 的 Python 新项目榜上，统计窗口从 2026-11-09 开始，约 24 小时内增加 52 个 Star。采集到的 Star 曲线显示，数量从 2026-11-07 的 101 涨到 2026-11-10 的 166，其中 2026-11-09 晚间增速最快。目前没有记录到全语言日榜名次，因此这组数字反映的是新项目榜的收录，而不是广泛的趋势排名。项目直接基于 nxnative 构建，并复用了 d2r-mobile 与 Ryujinx 的组件（见第三方许可），对多数读者而言，实际价值取决于自己的游戏 dump 和硬件是否落在已测试范围内。