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.
Как мне всё это запустить?Проще всего использовать ZIP-архив Ocarina-Setup со страницы релизов: полностью распакуйте его, запустите Instalar-Ocarina.exe, выберите файл .nup (или папки exefs и romfs) и нажмите «Установить». Есть также варианты через скрипты и полностью ручной. Сборка занимает примерно от 30 минут до 2 часов.
Что мне нужно в первую очередь?Windows 10 или 11 64-бит с процессором, поддерживающим AVX2, видеокарта с Vulkan 1.3 и mesh-шейдерами и обновлённым драйвером (рекомендуется NVIDIA), 16 ГБ оперативной памяти или больше, 40 ГБ свободного места при установке через ZIP-установщик (иначе 60 ГБ), интернет во время установки и ваша копия игры версии 1.1.1.
Насколько это стабильно сейчас?Это экспериментальная версия, протестированная только на одном ПК (Ryzen 9 9950X3D, RTX 5090) в начале игры. Начало игры до Дерева Дэку и деревни Кокири работает, а игра идёт примерно на 59 кадрах в секунду на месте и на 51–55 при ходьбе. При входе в новые области всё ещё случаются подвисания. Хайрульское поле и видеокарты 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/, который заменяет систему консоли, а вызовы графики NVN 2 преобразуются в Vulkan.
На каком языке работает игра?Она следует языку вашей системы Windows, включая бразильский португальский. Чтобы сменить язык, нажмите F1 и откройте Jogo → Idioma.
Как я могу помочь проекту?Очень помогает тестирование на других видеокартах и сообщения о результатах. При создании issue никогда не загружайте файлы игры.
Почему игре нужно так много памяти?При 16 ГБ оперативной памяти первый запуск может занимать около 24 ГБ, поэтому сначала увеличьте файл подкачки Windows (начальный 16384 МБ, максимальный 32768 МБ). Установщик предупредит, если лимит слишком мал.
Какие есть похожие проекты?NX2navi, MarathonRecomp, mkw-recomp, S2Arm, totk-pc-recomp, TriAevum, BLACK-XBERecomp, 1-Click-DLSS5
Автор
sostenesfreitas
Размер
6 MB
Звёзды
1.2K
Возраст
12 д
Коммиты · 90 дней