MetroidPrimePort：银河战士原生移植

项目简介

Metroid Prime Unbound 是基于 PrimeDecomp 反编译代码编译的《银河战士 Prime》原生移植版，通过 Aurora（SDL3/WebGPU）渲染，不使用模拟器。支持 Linux、Windows、Android、macOS 和 iPhone/iPad。仓库不包含任何游戏内容，需要自备正版光盘镜像。

主要功能

• 现代操作：键鼠、双摇杆视角、陀螺仪，移动端提供原生触控。
• Remastered 资源导入（实验性）：从自备的 Metroid Prime Remastered dump 导入模型、特效与光照（F1 > Remastered）。
• Metroid Prime Trilogy：可从 Wii 光盘运行三部曲中的 Metroid Prime，带三部曲 HUD、扫描镜与放射状光束/面罩菜单。
• 从自备的 Metroid Dread dump 导入萨姆斯装甲，含第一人称手炮；支持第三人称视角与装甲配色自定义。
• 画面：宽屏与 HUD 贴边、帧率不设上限，FOV、MSAA、各向异性过滤、分辨率缩放与动态分辨率、HUD 缩放、手炮偏移、隐藏头盔与面罩效果、可选渲染器（含 OpenGL）。
• 操作：鼠标与双摇杆瞄准、陀螺仪、锁定自由瞄准、完整按键重映射与预设、Morph Ball 独立绑定。
• 可选调整：Fast Morph、Spring Ball、Toggle Lock-On、Sticky Charge 等。
• 可跳过过场动画、存档状态、退出后快速恢复。
• 存档可从 USA/PAL GameCube、Wii Trilogy 与 Dolphin 导入导出。
• 拍照模式：自由相机与高分辨率截图。
• 地图与追踪：揭示地图，并进行物品、扫描与房间追踪。
• 支持 Dolphin 纹理包，包括 HD 纹理替换。
• Mods：可放入 mod 文件夹替换光盘数据，另有社区 mod。
• 桌面端 Discord Rich Presence；Android/iOS 触控覆盖层与布局编辑器。
• 随机化器与 Archipelago 多世界联机，所有设置集中在 F1 覆盖菜单。

安装与使用

从 GitHub Releases 下载对应平台构建，启动后按提示选择光盘镜像。支持的镜像：GameCube USA 1.00/1.01/1.02（GM8E01）、PAL（GM8P01），以及 Trilogy USA（R3ME01）与 PAL（R3MP01）；格式可为 .iso、.gcm、.rvz、.wbfs、.ciso 或 .nkit。

从源码构建需要 CMake 3.25+、Ninja 和 C++20 工具链，具体步骤见 docs/NATIVE_PORT.md 与 docs/ANDROID.md。

运行：

./build/native/metroid_prime_port "/path/to/Metroid Prime (USA) (v1.00).iso"

按 F1（手柄 Start+Back）打开全部设置与附加功能。

随机化器与 Archipelago：用 Metroid Prime APWorld 生成游戏并开房，在 F1 > Archipelago 填入服务器 host:port、槽位名与密码即可连接，无需种子文件；每个种子与槽位各有一份存档，离线完成的检查会在下次连接时上传，支持聊天命令与 DeathLink。

注意事项

• 项目不附带任何光盘镜像或游戏资源，发布包中也没有。
• 提示 "unsupported disc" 表示镜像版本不在支持列表，可在日志中查看识别到的 disc id，重新 dump 或确认选的是 GameCube 光盘。
• 设置错乱时：F1 > System > Settings > Reset configuration... 会备份并重置所有设置与映射，不影响存档。
• 日志为用户目录下的 metroid_prime_port.log（F1 > System 可查看路径）；Android 副本在 Documents/MetroidPrime/，iOS 在「文件」App 的 Metroid Prime 目录。
• 本项目独立于 PrimeDecomp，问题请反馈到本仓库；与任天堂、Retro Studios 无关。

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