Nebula：超级马力欧银河原生移植

项目简介

Nebula 让《Super Mario Galaxy》以原生方式运行在 Windows 上。项目本身不包含任何任天堂的代码或素材，需要自备游戏副本。已发布版本为 1.0.2，可用北美版光盘（RMGE01）从头玩到尾：安装程序会把游戏的 PowerPC 代码翻译成 C++，并在你的电脑上编译。仓库 main 分支是开发中的 Nebula 2，尚未发布，可以自行从源码构建。

游戏自身的逻辑（包括马力欧的物理）来自 SMGCommunity 的 Petari 反编译；Nebula 的主机层、渲染器、安装程序和文档由作者在 AI 编程助手（Anthropic 的 Claude）协助下编写，并由作者指导、审查和测试。

主要功能

以下为 1.0.2 已发布版本具备的内容：

• 操作：键盘鼠标、Xbox 手柄、Switch Pro 与 Switch 2 Pro 手柄（USB），支持改键；Switch 手柄可用陀螺仪指向和倾斜，震动跟随 Wii Remote 的马达。
• 画面：4:3 到 32:9 的宽高比，内部分辨率最高 16 倍，帧率可超过 60。
• 画质：SMAA / FXAA 抗锯齿、AMD FidelityFX FSR 1 与 NVIDIA DLSS 放大、各向异性过滤、可选的逐像素光照。
• 游戏内设置菜单（F1；Xbox 手柄为 View + Menu，Switch 手柄为 Minus + Plus）。
• 文本速度：对话与罗莎塔故事书可保持原速、2 倍或 3 倍。
• 语言：北美版光盘的英语、法语、西班牙语。
• 存档：位于 %LOCALAPPDATA%\Nebula\saves，支持导出、导入，也能读取 Dolphin 存档。

安装与使用

1. 从 latest release 下载 Nebula-Setup.exe。文件未做代码签名，Windows SmartScreen 会显示“未知发布者”，请选择更多信息，再选择仍要运行。
2. 选择你的游戏，点击安装。
3. 从开始菜单启动 Nebula。

Setup 同时负责更新、修复和卸载；更新带签名，安装前会校验；每次更新都保留上一个版本，可通过 Nebula Setup > Restore the previous version 回退。从源码构建的说明见 docs/BUILDING.md。

运行需求：

• 《Super Mario Galaxy》修订版 0，ISO、RVZ 或解压文件夹；1.0.2 需要北美版（RMGE01）。
• Windows 10（1803 或更新）或 Windows 11，64 位。
• 支持 Direct3D 12 的显卡。
• 8 GB 内存；1.0.2 安装时另外需要 16 GB 空闲磁盘和网络连接，安装后约 5.5 GB。

迁移存档：在启动器的 Advanced 标签中使用 Export saves… / Import saves…。从 Dolphin 导入时，先在 Dolphin 中右键《Super Mario Galaxy》选择 Open Wii Save Folder，再在 Nebula 中选择 Advanced > Import saves… > From a folder… 并选中该文件夹。导入前当前存档会先备份到旁边的 saves-backup-<date>，操作时请先关闭游戏。

注意事项

• 不附带游戏，必须使用自己的游戏副本；项目与任天堂无关联，也未获其认可。
• 已知问题：1.0.2 中有玩家反馈，在某些银河（Beach Bowl、Sea Slide、Bonefin、Deep Dark、Freezeflame）马力欧进出水面时游戏会关闭。
• 后台 CPU 负载过重可能导致音频卡顿；4K 的 HD 替换影片需要硬件视频解码。
• 仓库 main 分支是开发中的 Nebula 2（欧洲版/日版光盘、更多手柄、Mod 与材质包、成就等都属于 2.0 计划），这些都不在 1.0.2 中。
• 许可证为 GNU GPL v3.0。

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