TriAevum README

The project's README from github.com/coccofresco/TriAevum. As one markdown file: README.md.

TriAevum

A native PC AOT recompilation of The Legend of Zelda: Ocarina of Time 3D, with a modern NRI/Vulkan renderer, single-screen UI and customizable graphics.

Credit Where It Belongs

Before the shaders, settings and excessive grass: TriAevum would not exist in its current form without TopScreen, developed by rlgcarrot. Its single-screen experience is reimplemented here for our runtime, but the vision, care and tremendous work behind it deserve a special thank-you. Please consider buying rlgcarrot a coffee to support that fantastic work.

Just as essential are Azahar, Ship of Harkinian, libultraship, NVIDIA NRI, and the SDL controller-mapping community. And, of course, Nintendo and Grezzo, who created the original game. Full credits and licenses.

Download v0.6.0-alpha.1c for Windows x64

About

TriAevum is an AOT recomp in the same general spirit as the Xbox 360 recomp projects. I just ended up spending most of my time on the renderer instead of, you know, actually playing the game. The goal is to push the visuals further without completely losing the original look.

Development of this project is entirely AI-assisted, under human direction. That describes the TriAevum-specific work, not the mature donor projects and libraries it builds on: Azahar, Ship of Harkinian, NRI and others. Aside from those foundations, you could fairly call this concentrated AI slop. Apparently, even AI slop can still consume several months of your life.

Install

Requires Windows x64, a Vulkan-capable GPU with current drivers, and your own supported decrypted ROM. Forge accepts .3ds and .cci and checks the contents, not just the filename.

It should work with any personal EUR or USA ROM dump, provided it is decrypted and in .cci or .3ds format. See ROM compatibility details.

  1. Download the Windows-x64 ZIP, not GitHub's source-code archive, and extract it into a writable folder.
  2. Run TriAevumForge.exe and select your decrypted ROM.
  3. When setup finishes, choose Launch game. Afterwards, use TriAevum.exe.

No compiler or SDK is needed. Forge downloads the official TopScreen texture package during setup; an Internet connection is required unless that package is provided locally. No ROM or original game assets are included. Keep and back up data/: it holds your saves, settings and locally prepared game data.

Graphics and controls

Press F1 for settings. F2 temporarily disables the main added graphics effects, then restores them without losing your configuration. Most of the presentation is configurable, so if my artistic decisions offend you personally, you can probably undo them. Effects can be expensive; adjust them to suit your GPU.

Testing and contributing

This is an experimental alpha, not a fully tested port. Gameplay testing currently covers the early parts of the game. The USA adapter has been checked through installation, the title intro and file selection, not a full playthrough. I find tweaking shaders considerably more entertaining than finishing Zelda again, so people willing to actually play through it are especially welcome.

Please report issues with the version, ROM input/revision, GPU/driver, settings and steps to reproduce. Normal in-game save files are particularly useful for problems later in the game. Review logs for personal information before sharing; do not upload ROMs, extracted assets or memory savestates containing game code.

Contributions, experiments and forks taking the renderer in other directions are welcome. Longer term, I would like to explore a proper ray-tracing path and finish features still in the traditional state known as "technically implemented". Ray tracing is a wishlist item, not a feature of this release.

Release notes and known limitations.

Screenshots

Captured with the default profile: toon shading, outlines, grass, 1.10x FOV, x2 interpolation and TopScreen. No additional HD texture pack.

Hyrule Field at night

Kokiri Forest gameplay with the TopScreen HUD

Link and Epona in the title sequence

Source and license

Original contributions are licensed under GPL-3.0-or-later. Third-party components retain their own licenses and notices: license scope and third-party notices. See the release and build contract for source availability and developer packaging.

TriAevum is independent and is not affiliated with or endorsed by Nintendo.

Worst case scenario, at least we got more grass.

TriAevum (coccofresco/TriAevum)

Searching Database…

493 ·GitHub
TriAevum
Что это такое?TriAevum — нативный рантайм AOT-рекомпиляции (ahead-of-time) для The Legend of Zelda: Ocarina of Time 3D на ПК, с современным рендерером NRI/Vulkan, одноэкранным UI и настраиваемыми графическими опциями.
Это эмулятор или что-то иное?Это не эмулятор 3DS; это AOT-рекомпиляция в духе проектов recomp для Xbox 360, превращающая код игры в нативную сборку для Windows на базе основ вроде Azahar, Ship of Harkinian и NVIDIA NRI.
Как его запустить?Скачайте ZIP для Windows-x64 (не архив исходников GitHub), распакуйте его, запустите TriAevumForge.exe и выберите вашу расшифрованную ROM; после завершения настройки вы запускаете игру, а в дальнейшем используете TriAevum.exe напрямую.
Что нужно, чтобы реально его запустить?ПК с Windows x64, GPU с поддержкой Vulkan и актуальными драйверами, плюс ваша собственная легально расшифрованная копия ROM Ocarina of Time 3D в формате .3ds или .cci; Forge проверяет содержимое ROM, а не только имя файла.
Насколько он готов и протестирован прямо сейчас?Это экспериментальная альфа, а не полностью протестированный порт: игровое тестирование сейчас покрывает только ранние части игры, а вариант ROM USA проверен лишь на установку, вступительную заставку и выбор файла, но не на полное прохождение.
Нужен ли интернет после настройки?При первой настройке Forge скачивает официальный пакет текстур TopScreen, поэтому интернет-соединение требуется, если вы не предоставите этот пакет локально; после настройки он должен работать без него.
Имеет ли значение моя видеокарта?Да, нужна GPU с поддержкой Vulkan и актуальными драйверами; toon-шейдинг, AO, отражения, тени, сглаживание и дополнительная трава — все эти опции нагружают GPU, и их можно подстроить под ваше железо.
Режим 60/90 FPS действительно ускоряет игру?Нет. Это визуальная интерполяция исходного игрового состояния на 30 Гц; базовая игровая логика и скорость игры остаются точно такими же, как в оригинальной игре.
Что такое TopScreen и почему он так заметно упоминается в заслугах?TopScreen — одноэкранный UI, изначально разработанный rlgcarrot для похожей 3DS-recomp; TriAevum заново реализует этот одноэкранный опыт для собственного рендерера и указывает авторство оригинального дизайна и работы.
Можно ли использовать любую принадлежащую мне ROM Ocarina of Time 3D?Подойдёт любая личная расшифрованная копия ROM EUR или USA в формате .3ds или .cci; Forge проверяет фактическое содержимое файла, а не доверяет имени.
Какие дополнительные графические возможности он добавляет к оригинальной игре 3DS?Cel/toon-шейдинг с контурами, ambient occlusion, опциональные отражения/тени/сглаживание, настоящий широкоформатный режим с настраиваемым FOV, процедурная трава и пользовательские текстуры, совместимые с Azahar, — всё настраивается через игровое меню настроек (F1), а F2 включает и выключает добавленные эффекты.
What are similar projects?The-Darkness-Recomp, TheSimpsonsGameRecomp, uncharted_pc, ShadowOfTheColossus-PC, ps2-web-recomp, bbhost, dxvk, Vulkan
Which topics is it in?shaders, emulation, retrogaming, vulkan, ai-coding, native, rendering, game-development, game, graphics, windows-app, 3d
Creator
coccofresco
Size
204.6 MB
Stars
493
Updated
CommitOct 15
Age
1mo
Commits · 90 Days