Metroid Dread Recomp：PC 重编译工具

项目简介

Metroid Dread Recomp 基于 MZ Labs 的 SwitchRecomp 运行时（ARM64 → C 翻译器），为玩家自己转储的《Metroid Dread》2.1.0 提供原生 PC 版运行环境：Windows 端是一个集成了首次设置、编译、Play 界面和游戏内菜单的 EXE。仓库中不包含任何任天堂文件，没有游戏代码、RomFS、密钥，也没有生成的 C 代码。

项目仍处于开发中：0.x 版本都是早期预览，作者计划的首个正式版本为 1.0.0，可能遇到崩溃和安装问题。

主要功能

• 首次启动引导：EXE 会要求选择游戏文件，用自带的 GCC 编译游戏，然后进入 Play / 设置界面。
• 游戏内菜单：按 F1 或 Home / Guide 键呼出。
• 自动配置：Play 界面的 AUTO-SET 读取显卡、屏幕和内存，自动选择分辨率、帧率和画质，之后仍可手动修改。
• 内置更新：Play 界面检查本仓库的 Release，只下载发生变化的游戏文件并逐个校验 SHA-256，替换的文件保留以便 UNDO 回退；存档、设置和 mod 不会被改动。
• 画面与音频：5.1 声道、32:9 画面比例（实验性）、90 FPS 帧率上限等选项。
• 控制设置：键盘按键重映射、菜单按键互换、手柄按键图标（社区 mod）。
• 金手指：支持 Atmosphere 格式，放在 Metroid Dread_data\cheats\，在 F1 菜单中开关。
• Linux / Steam Deck：提供 AppImage，支持自更新，桌面模式下可「添加到 Steam」。

安装与使用

Windows：下载 Release 中的 zip 包（不要直接下载本仓库），首次启动时选择自己转储的 Metroid Dread 2.1.0 游戏文件。需要同时提供两部分：

• ExeFS：游戏代码，如 main、main.npdm 等文件
• RomFS：游戏数据，如 system、packs 等，且已合并 2.1.0 更新

只有 RomFS 不够。所选文件夹可以位于下几层；若本体与更新是分开的转储，把更新选为「Update folder」。编译前会用 2.1.0 文件清单逐个校验 RomFS 文件。

Linux / Steam Deck：使用 Release 中的 AppImage，需要 glibc 2.38 或更新版本、SDL2（手柄）和 OpenGL 4.3 驱动。游戏安装在 ~/.local/share/MetroidDreadRecomp，可用 METROID_DREAD_HOME 覆盖。

从源码构建需要自备 GCC 14.2.0（winlibs，UCRT、POSIX threads、x64）、Python 3.12 和 glslang 16.6.0，分别放在 gcc\、python\ 目录并设置 GLSLANG，然后运行 build.bat。

注意事项

• 0.x 为早期预览，在未测试的硬件上可能崩溃或出问题；反馈时请附上游戏目录中的 .log 文件，以及 CPU、GPU、内存和系统版本。
• 项目与任天堂无关，也未获其认可；《Metroid Dread》版权归任天堂所有，必须使用玩家自己的合法转储。
• 许可：各源文件保留自身许可（SwitchRecomp 为 Apache-2.0，ScarletNX 渲染器为 GPL-3.0，Dear ImGui 为 MIT 等），发布的 EXE 因包含 ScarletNX 渲染器而以 GPL-3.0 分发。
• DLSS 相关代码在仓库中，但 NVIDIA 的文件不在，官方发行版未包含 DLSS；自行启用 DLSS 的构建仅限自用，不要分享。

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