SerenityG4K/SpaceAnimalsRecomp

项目介绍

SpaceAnimalsRecomp 是 Nintendo Switch 2 版《星际火狐》（2.0.0 更新）的静态重编译项目。它把游戏的 ARM64 代码翻译成 C++，在用户电脑上编译为原生 x86-64 程序，并通过 Vulkan 实现 Switch 2 的 NVN 图形 API，把游戏着色器翻译为 SPIR-V。运行方式是原生程序，不是模拟器。

项目附带的启动器会用 SHA-256 校验用户自备的 .nup 转储文件，提取可执行模块，重编译游戏（约 20–30 分钟），链接出 recomp_main.exe，再针对本机 GPU 预编译着色器。适合已拥有该游戏、希望获得原生 PC 版本的玩家，也适合研究静态重编译、NVN 到 Vulkan 移植和 Switch 2 逆向的开发者。README 说明其代码、工具、逆向和文档几乎全部由 Claude 在人工指导下编写和测试。

快速使用

环境要求：Windows 10/11 64 位、支持 AVX2 的 CPU、支持 Vulkan 1.3 的 GPU、构建期间约 6 GB 空闲磁盘空间，推荐 32 GB 内存。目前唯一测试过的配置是 AMD Ryzen 7 9700X 配 NVIDIA RTX 5070 Ti。你还需要自购的 Switch 2 版《星际火狐》并更新到 2.0.0（v131072，title ID 0400E88025B1A000），从自己的主机转储为单个 .nup 文件。

1. 从 Releases 下载 SpaceAnimalsRecomp-1.0.3-windows.zip，包内已含 Python、Clang、GCC 和 glslang。
2. 解压到可写、路径仅含拉丁字符的目录，例如 C:\Games\StarFox，不要放在 Program Files。
3. 运行 lanceur.exe，在 COPY › choose 选择 .nup 文件，点击 BUILD THE GAME。
4. 等待提取、重编译、链接和着色器翻译，随后首次启动会针对本机 GPU 预编译着色器（约一分钟）。
5. 点击 PLAY；全屏/窗口、语言、分辨率、帧率和按键在启动器或 SETTINGS 中设置。

你的游戏副本只读，不会被修改。存档位于 %APPDATA%\SpaceAnimalsRecomp\save。

使用约束

• 启动器目前仅支持 Windows，Linux 在路线图中；Steam Deck 等掌机未测试。
• 项目处于实验阶段且尚未优化：2,468 个着色器阶段中仍有 80 个未翻译，90/120 fps 不稳定，60 fps 是稳定目标。
• 暂无 DLSS/FSR 和帧生成，画面以原生分辨率渲染，对显卡性能要求高于主机版。
• 输入仅支持键盘（可改键）和一个 XInput 手柄；鼠标、PlayStation/Switch Pro 手柄、震动、amiibo、Mod 和联机都在计划中。
• 不包含也不提供游戏文件、密钥或固件；由自己副本生成的构建包含任天堂代码，只能自用。
• 项目自身代码采用 GPL-3.0，打包的构建工具各按自己的许可证分发。

HotRepo 点评

HotRepo 在 2026-11-13 首次记录该项目：它进入 C++ 新项目榜，约 9.5 小时窗口内新增 20 Star，逐时采样最终达到 121 Star、5 Fork。可用数据中没有 GitHub 全语言日榜记录，也没有 Hacker News 讨论，因此目前看到的是 C++ 榜上的早期小幅关注，而非广泛上榜的热度。技术侧信息很具体：本地、经文件校验的重编译流水线，Vulkan pipeline library 的预编译方案，公开的进度表，以及对未翻译着色器和仅一种测试硬件的坦率说明。