ocarina-recomp README

项目的 README,来自 github.com/sostenesfreitas/ocarina-recomp。合并为一个 markdown 文件:README.md。

Ocarina Recomp

Read in English

Ocarina rodando nativo no Windows, sem emulador.

O código do jogo é traduzido para C e compilado como um programa do Windows. Os gráficos do Switch 2 são convertidos para Vulkan. Tudo isso acontece no seu PC, a partir do seu próprio arquivo do jogo.

[!NOTE] Mudança de rumo (novembro de 2026). Para jogar, hoje recomendamos o Hookshot: ele também compila o jogo no seu PC, a partir da sua cópia, e o instalador dele tem português.

Comparamos os dois no mesmo PC (RTX 5090), com os mesmos saves:

  • os dois seguram 60 fps, e o Hookshot desenha em resolução maior pelo mesmo custo;
  • o Hookshot desenha vegetação que aqui falta ou sai errada (os arbustos do pátio do Templo do Tempo, por exemplo).

Daqui em diante, nossas correções vão para o Hookshot como contribuições. Este repositório continua como ponto de apoio em português: dúvidas, relatos e guias.

Seus saves continuam valendo: são os mesmos arquivos. Eles ficam na pasta perfil\save da instalação. O guia de saves do Hookshot (docs/saves.md) mostra como copiá-los.

Não tem mais o .nup? O Hookshot Builder também aceita uma pasta com romfs e exefs (opção "romfs and exefs folders"): o jogar\hookshot-preparar-jogo.bat monta essa pasta a partir dos arquivos do jogo desta instalação, em cerca de 27 GB de espaço livre. Depois de compilar o Hookshot, o jogar\hookshot-copiar-save.bat copia o seu save para ele; se o Hookshot não estiver na pasta padrão, arraste a pasta do jogo dele para cima desse arquivo. Uma instalação feita antes desta mudança não tem esses arquivos: copie tools/oot/hookshot.py, jogar/hookshot-preparar-jogo.bat e jogar/hookshot-copiar-save.bat deste repositório para as mesmas pastas da instalação.

[!IMPORTANT] Este repositório não contém o jogo, keys nem executável, e não explica como obtê-los. Você precisa da sua própria cópia. O que a instalação gera (o ocarina.exe, o código gerado, o cache de shaders e os saves) sai do seu jogo: não compartilhe.

Estado do projeto

Experimental. Só foi testado em um PC (Ryzen 9 9950X3D, RTX 5090), na região do início do jogo.

O quê Situação
Abertura e jogo novo, até a Árvore Deku ✅ Funciona
Vilarejo Kokiri: árvores, plantas, casas, luz ✅ Funciona
Som, controle, saves e vídeos ✅ Funciona
Desempenho na RTX 5090 ✅ Cerca de 59 fps parado, 51 a 55 fps caminhando
Travadinhas ao entrar em áreas novas ⚠️ Ainda acontecem, principalmente na primeira vez
Tocar a ocarina ❓ Correção aplicada, ainda sem teste em jogo
Hyrule Field e o resto do jogo ❓ Ainda não testados
Placas AMD e Intel ❓ Nunca testadas

Como compilar

O jogo não vem pronto: ele é compilado no seu PC, a partir da sua cópia. Escolha um destes três jeitos.

1. Com o instalador em ZIP, o mais fácil: não instala nada no Windows e não pede administrador.

  1. Baixe o Ocarina-Setup-...-windows.zip da página de versões.
  2. Extraia o ZIP inteiro para uma pasta e abra o Instalar-Ocarina.exe que está dentro dela.
  3. O executável não tem assinatura digital, então o Windows pode avisar. Clique em Mais informações e depois em Executar assim mesmo.
  4. Na janela, escolha o .nup do seu jogo (ou uma pasta com exefs e romfs) e clique em Instalar.
  5. No fim, clique em Jogar, ou use o atalho Ocarina Recomp na Área de Trabalho.

Para desinstalar, apague a pasta de instalação. Prefere conferir antes? O executável só abre o script instalador\Instalar-Ocarina.ps1, que está ao lado dele no ZIP e pode ser lido em qualquer editor. O código do executável tem poucas linhas. Alguns antivírus reclamam de programas novos sem assinatura e de scripts do PowerShell: é um alarme possível, e o código está todo aqui para quem quiser conferir. A página de versões traz o SHA-256 do arquivo.

[!NOTE] A etapa "Preparar os arquivos do jogo" é lenta, principalmente em HD: enquanto o relógio da janela andar, está funcionando.

2. Com os scripts, que você pode ler antes de rodar (instale antes as ferramentas do passo 1 do guia):

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"
  1. O verificar.ps1 só olha e diz o que falta. Ele não altera nada.
  2. O compilar.ps1 -Simular mostra todos os comandos sem executar nenhum.
  3. O compilar.ps1 executa esses comandos, mostra cada um e pergunta antes de cada etapa. Se parar, rode de novo: ele continua de onde parou.

-ExecutionPolicy Bypass vale só para esse comando e não muda a configuração do Windows.

3. Totalmente à mão: siga o passo a passo para compilar.

No Linux: o compilar.sh faz os mesmos passos e o jogar/jogar-ocarina.sh abre o jogo. Os pacotes e o estado do port estão em docs/building.md.

git clone https://github.com/sostenesfreitas/ocarina-recomp
cd ocarina-recomp
./compilar.sh --jogo /caminho/seu-jogo.nup
./jogar/jogar-ocarina.sh

Trazer o save de um emulador

O save do Lichii, do Eden e de emuladores parecidos funciona aqui. No fim da instalação, clique em Importar save de emulador, ou rode depois:

powershell -ExecutionPolicy Bypass -File jogar\importar-save.ps1

Ele acha o save sozinho ou pergunta a pasta, guarda uma cópia do seu save atual e não altera o emulador.

Idioma

O jogo escolhe o idioma pelo do Windows, inclusive português do Brasil. Para trocar, aperte F1 e vá em Jogo → Idioma.

O que isto faz no seu PC

Leva de 30 minutos a 2 horas, e você pode usar o PC enquanto isso. Para atualizar, rode de novo o instalador ou veja o fim do guia.

[!NOTE] Na primeira vez que abrir o jogo, a vegetação pode levar alguns minutos para aparecer, enquanto os shaders compilam em segundo plano. Melhora nas próximas vezes.

Do que você precisa

Se algo der errado

Problema O que fazer
"Este jogo não é a versão 1.1.1" Confira se escolheu o jogo certo e atualizado
O jogo abre e fecha Atualize o driver da placa de vídeo e veja o arquivo ultima-partida-erros.log na pasta de instalação
O jogo fechou no meio O log de cada partida fica guardado em logs\ (as últimas 10). jogar\medir-partida.ps1 mostra o crash e o desempenho.
Travadinhas na primeira vez É normal: os shaders estão sendo preparados. Melhora quando você passa de novo pelo mesmo lugar

Se continuar, abra uma issue com a mensagem de erro e o modelo da sua placa de vídeo. Nunca envie arquivos do jogo.

Controles

Use um controle ou teclado e mouse. F1 ou Esc abre o menu de opções, F11 alterna a tela cheia e F10 mostra o fps. A lista completa está em docs/controls.md.

Como funciona

  1. recomp/gen.py traduz o código ARM64 do jogo para C.
  2. tools/build_game.py compila esse C junto com o runtime/, que faz o papel do sistema do console.
  3. runtime/ converte as chamadas gráficas NVN 2 para Vulkan.
  4. Os shaders Ampere do Switch 2 são rebaixados para Maxwell (lower_to_maxwell.h) e traduzidos para SPIR-V por um Ryujinx com patches (tools/xlate/patches).

Quer ajudar?

Leia o guia de contribuição. Testar em outras placas de vídeo e relatar o resultado já ajuda muito.

Créditos

Projeto mantido por Miojo (sostenesfreitas). Dizem que ele deixou um recado escondido no instalador e outro dentro do jogo. 🍜

Este projeto existe graças ao trabalho de muita gente:

A lista completa está em THIRD_PARTY_NOTICES.md.

Licença

GPL-3.0, como o projeto original. Partes de terceiros mantêm as próprias licenças, listadas em THIRD_PARTY_NOTICES.md.

Projeto de fãs, sem nenhuma relação com a Nintendo. The Legend of Zelda e Ocarina of Time são marcas da Nintendo.

ocarina-recomp (sostenesfreitas/ocarina-recomp)

正在搜索数据库…

这是什么?这是 Ocarina of Time 的原生 Windows 移植版。游戏的 ARM64 代码被翻译为 C 语言并编译成 Windows 程序,构建过程在你自己的电脑上完成,使用的也是你自己的游戏副本。
这是模拟器吗?不是。游戏代码被翻译为 C 语言并编译成 Windows 程序,其 NVN 2 图形调用会被转换为 Vulkan。
我该怎么运行它?最简单的方法是从发布页面下载 Ocarina-Setup ZIP 压缩包:完整解压,运行 Instalar-Ocarina.exe,选择你的 .nup 文件(或 exefs 和 romfs 文件夹),然后点击“Install”。也有基于脚本的方式和完全手动的方式。构建大约需要 30 分钟到 2 小时。
我需要先准备什么?Windows 10 或 11 64 位系统,CPU 支持 AVX2;Vulkan 1.3 显卡,支持网格着色器(mesh shaders)并已更新驱动(推荐 NVIDIA);16 GB 或更多内存;使用 ZIP 安装程序时需要 40 GB 可用空间(否则需要 60 GB);安装过程中需要联网;游戏副本版本为 1.1.1。
现在稳定吗?目前仍处于实验阶段,仅在一台电脑(Ryzen 9 9950X3D,RTX 5090)上测试过,且只测到游戏开头。开场流程直到大树神殿和科克利村都可以正常进行,静止时约 59 fps,行走时约 51 到 55 fps。进入新区域时仍会出现卡顿,海拉尔平原、AMD 和 Intel 显卡尚未测试。
它能在 Linux 或 macOS 上运行吗?Windows 是主要目标。也提供 Linux 方案:使用 compilar.sh 构建,使用 jogar/jogar-ocarina.sh 启动游戏。文档中未提及 macOS。
它会往文件夹之外写入东西吗?它只会在项目文件夹内写入内容,从不修改你的游戏文件。安装过程中会下载 Python 和 .NET 包;如果游戏可执行文件被压缩,还会下载 zbic。
游戏究竟是怎么构建的?recomp/gen.py 将游戏的 ARM64 代码翻译为 C 语言。tools/buildgame.py 把这些 C 代码与 runtime/ 一起编译,其中 runtime/ 负责替代主机系统的功能。NVN 2 图形调用会被转换为 Vulkan。
游戏用什么语言?它会跟随你的 Windows 语言设置,包括巴西葡萄牙语。按 F1,进入“游戏 → 语言”即可更改。
我能怎样帮助这个项目?在其他显卡上进行测试并反馈结果会很有帮助。提交 issue 时,切勿上传任何游戏文件。
为什么它需要这么多内存?在 16 GB 内存的情况下,首次运行时内存占用可能达到约 24 GB,因此请先提高 Windows 的页面文件大小(初始 16384 MB,最大 32768 MB)。如果限制过低,安装程序会发出警告。
大小
6 MB
星标
1.2K
时长
12天
提交 · 90 天