NSMBU Recomp：新超级马力欧兄弟U原生移植

项目简介

本项目把 Wii U 游戏《New Super Mario Bros. U》的素材编译成独立的原生可执行程序，可在 Windows、macOS、Linux 和 Android 上运行。发布包只包含运行时、构建工具和安装器，不含任何任天堂的游戏代码、素材或密钥，需要用户提供自己合法导出的游戏副本。项目基于 Wind Waker HD 重编译项目分支而来，采用 MPL-2.0 许可证。

主要功能

• 首次启动时由安装器在本机完成构建，之后启动直接进入游戏。
• 支持键盘与最多四个手柄，每只手柄可作为独立玩家。
• 完整的设置覆盖层：按键与手柄映射、音量与静音、TV / GamePad 输出切换。
• F1–F5 读取即时存档，Shift+F1–F5 保存。
• 支持碰撞查看器等调试功能。

安装与使用

1. 从 Releases 下载对应系统的压缩包，解压到有写入权限的文件夹，然后启动：

2. 首次启动打开安装器，选择自己的游戏副本，支持三种形式：
   • 光盘镜像 .wux / .wud，需要 disc key、Wii U common key，可选配套 1.3.0 更新；
   • Cemu 归档 .wua，无需密钥；
   • 已解包的含 code、content、meta 的游戏文件夹。
3. 等待安装器解包、把代码翻译为 C、编译并链接运行时。首次需要几分钟，完成后再次启动即可游玩。

按键方面，默认键盘布局为 W A S D 移动、方向键控制镜头、K/Space 或 J 跳跃、L/Left Shift 奔跑与持物、Enter 暂停、Tab 打开道具栏。按 ` 或 F12 打开设置覆盖层，手柄上按 Home、R3 或 Start+Select 组合。

需要修复、更换游戏文件时重新打开安装器：macOS / Windows 启动时按住 Shift；Linux 运行 nsmbu-launcher --setup。

注意事项

• 支持情况：USA 1.3.0（00050000-10101d00）、Europe 1.3.0（00050000-10101e00）、两者的基础光盘版，以及 USA / Europe 的 NSMBU + NSLU 合集包；日版暂不支持。
• 发布目录是便携式的，构建产物、游戏文件、存档和设置都保存在该目录的 data/ 下；控制映射默认存于 data/nsmbu/controls.json。
• macOS 应用未签名，需右键「打开」或在「隐私与安全性」中选择「仍要打开」；Windows 可能触发 SmartScreen，选择「更多信息 → 仍要运行」。
• 图形窗口无法运行时，可使用 tools/ 目录下的终端安装脚本。

本作品整理自 GitHub 开源项目 nsmbu-recomp/nsmbu-recomp，原作者 @nsmbu-recomp，许可证 MPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。