MetroidPrime2Port：银河战士2原生移植

项目简介

Echoes Unbound 是《银河战士 Prime 2：Echoes》的原生移植项目。它建立在 PrimeDecomp 的 GameCube 反编译工程之上，通过 Aurora（SDL3 / WebGPU）渲染，不使用模拟器。

目前提供 Linux、Windows、macOS、Android 版本，iOS 为实验性支持。本项目与 PrimeDecomp 无隶属关系，也不是 Nintendo 或 Retro Studios 的官方作品。

项目不包含任何游戏数据，需要自备光盘镜像。支持的光盘：GameCube 美版（G2ME01）、欧版（G2MP01），以及《Metroid Prime Trilogy》的 R3ME01（美版）与 R3MP01（欧版）。

主要功能

• 画面：过场跳过、宽屏与适配宽屏的 HUD、渲染分辨率缩放、垂直同步、高帧率与帧插值、第一人称 FOV、MSAA、各向异性过滤、动态分辨率、HUD 缩放、手臂炮偏移、隐藏头盔与面罩特效
• 操作：鼠标与双摇杆瞄准、陀螺仪瞄准、锁定自由瞄准、指针瞄准，按键全部可重映射；保存按键预设
• 可选项：Fast Morph、Spring Ball、锁定开关、蓄力粘滞、移动速度、扫描速度、提示延迟、电梯时长等；一个「原始体验」开关可恢复原版行为
• 存档：即时存档、退出后快速恢复；记忆卡文件导入导出，兼容 Dolphin 与 PrimeHack 的存档目录
• 三部曲支持：Trilogy 的 HUD 边框、准星，可选开启径向光束与面罩菜单（支持鼠标、手柄、触摸）
• 外观与扩展：Varia / Dark / Light 服装配色；drop-in mod 文件夹可替换光盘数据或单个资源，支持 HD 材质包（开启/关闭与 .zip 导入）
• 其他：拍照模式（自由相机与高分辨率截图）、游戏内时间显示、Discord Rich Presence、移动端触摸覆盖层
• F1 菜单（手柄为 Start + Back）：所有设置与作弊项都集中在这里

安装与使用

从 GitHub Releases 下载对应平台的压缩包；Linux 也可安装 Flatpak 包：

flatpak install --user MetroidPrime2Port.flatpak

启动后按提示选择自己的光盘镜像即可（Android 会弹出文件选择器并把镜像复制进应用）。支持的镜像格式：.iso、.gcm、.rvz、.wia、.gcz、.ciso、.wbfs。

也可以在终端直接运行：

./metroid_prime2_port "/path/to/Metroid Prime 2 - Echoes.iso"

此外可用环境变量 MP2_DISC 指定镜像路径。按 F1 打开全部设置。

Linux 的 AppImage 不打包系统库，需要系统中已有 FreeType、libpng 以及 Vulkan 驱动和 X11 或 Wayland。

自行编译需要 CMake 3.25+、Ninja 与 C++20 工具链：

cmake -S . -B build-port-link -G Ninja -DMP_SDK_HEADERS_ONLY=OFF
cmake --build build-port-link --target metroid_prime2_port

注意事项

• 需要自备受支持的光盘镜像；仓库与任何发行包都不含游戏资源。提示「unsupported disc」说明镜像版本不在支持列表内
• 数据保存在可执行文件旁的 user/ 文件夹（设置、按键、记忆卡、日志、缓存）。在无法写入该目录的场景（Flatpak、系统包、macOS 应用包）会改用用户目录，如 ~/.local/share/Metroid Prime 2: Echoes；MP2_USER_PATH 可覆盖
• 日志为 user/ 下的 metroid_prime2_port.log，反馈问题时可附上（F1 > System > Log）
• 设置异常时可在 F1 > System > Settings 中执行 Reset configuration，会备份并重置设置与映射，不影响存档
• 许可证：项目自身代码为 MIT；src/ 与 include/ 下的游戏代码来自反编译，权利仍属 Nintendo，详见仓库的 NOTICE

本作品整理自 GitHub 开源项目 Odrannnn/MetroidPrime2Port，原作者 @Odrannnn。中文介绍由 AI 根据项目 README 整理，以原仓库为准。