sostenesfreitas/ocarina-recomp

项目介绍

Ocarina Recomp 是一个实验性项目：把《塞尔达传说：时之笛》的 ARM64 游戏代码翻译成 C，再编译成原生 Windows 程序，图形通过 Vulkan 渲染，而不是运行通用模拟器。流程完全基于用户自己持有的游戏副本：recomp/gen.py 负责代码翻译，tools/build_game.py 把生成的 C 与 runtime/ 一起编译，runtime/ 把 NVN 2 图形调用转成 Vulkan，Ampere 着色器先降级到 Maxwell，再经打过补丁的 Ryujinx 翻译为 SPIR-V 工作原理。

仓库不包含游戏、密钥或现成的游戏可执行文件，也不说明如何获取它们 仓库说明。它面向有兼容硬件、愿意自行构建和测试的 Windows 用户，而不是寻找开箱即玩下载的人。

当前状态

项目处于早期实验阶段，只在 Ryzen 9 9950X3D 加 RTX 5090 的一台机器上测试过游戏开头区域。Kokiri 村的画面、声音、手柄、存档和视频据称可用，该显卡下站立约 59 fps、行走约 51–55 fps；进入新区域仍有卡顿，吹奏陶笛的修复尚未在游戏中验证，海拉鲁平原及后续内容未测试，AMD 和 Intel 显卡也从未测试 状态表。

快速使用

最简单的方式是使用安装器：下载 Instalar-Ocarina.exe 并双击运行。由于未签名，Windows 可能提示风险，README 要求点击“更多信息”再选“仍要运行”。在窗口中选择游戏的 .nup 文件，或包含 exefs 和 romfs 的文件夹，点击安装，并在系统请求安装工具时允许。若想先检查脚本，这个可执行文件只会启动 Instalar-Ocarina.ps1，其启动器源码很短 launcher.c，发布页附带 SHA-256。

脚本方式需先安装工具，然后在 PowerShell 中执行：

git clone https://github.com/sostenesfreitas/ocarina-recomp C:\OcarinaRecomp
cd C:\OcarinaRecomp
powershell -ExecutionPolicy Bypass -File .\verificar.ps1 -Jogo "C:\caminho\seu-jogo.nup"
powershell -ExecutionPolicy Bypass -File .\compilar.ps1 -Simular -Jogo "C:\caminho\seu-jogo.nup"
powershell -ExecutionPolicy Bypass -File .\compilar.ps1 -Jogo "C:\caminho\seu-jogo.nup"

verificar.ps1 只检查缺少哪些条件；-Simular 只打印命令而不执行；最后一条命令真正构建，每一步前会询问，中断后可继续 脚本步骤。全手动流程见编译指南。构建据称需要 30 分钟到 2 小时。

构建完成后运行生成的 ocarina.exe。F1 或 Esc 打开选项菜单，F11 切换全屏，F10 显示帧率，完整按键见控制说明。首次进入游戏时草木可能要等几分钟才出现，这是着色器在后台编译。

使用约束

• Windows 10/11 64 位，CPU 需支持 AVX2。
• 显卡需支持 Vulkan 1.3 和 mesh shaders，驱动保持最新；推荐 NVIDIA。
• 建议 16 GB 内存；更低配置未测试。
• 需 60 GB 可用空间，若工具未安装再加 C: 盘约 15 GB，安装期间需要联网。
• 必须自备 1.1.1 版本的游戏；其他版本无法使用 运行要求。

安装器和脚本只写入项目文件夹，不会改动游戏文件，但安装工具可能请求管理员权限。生成的 ocarina.exe、生成代码、着色器缓存和存档都来自你的游戏，不应分享 安装行为。卸载时删除项目文件夹，单独安装的工具从 Windows 应用设置中移除。项目采用 GPL-3.0，第三方组件保留各自许可证 许可证。

HotRepo 点评

项目出现在 HotRepo 新项目榜：从 2026-11-06 到 2026-11-07 约 2.4 小时的统计窗口内新增 131 Star，当前累计 132 Star、6 Fork。这只是单次快照且没有日榜名次记录，能说明早期关注，但不足以判断趋势。技术上值得注意的一点是构建依赖用户自己的游戏文件，且只测过一种显卡配置；README 把可用范围限定在游戏开头，这应作为评估项目时的实际基准。