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…

508 ·GitHub
TriAevum
这是什么？TriAevum 是面向《塞尔达传说：时之笛 3D》的原生 PC AOT（提前编译）重编译运行时，带有现代的 NRI/Vulkan 渲染器、单屏界面和可自定义的图形选项。
这是模拟器还是别的东西？它不是 3DS 模拟器，而是一种 AOT 重编译，与 Xbox 360 recomp 项目精神相同，把游戏代码转换成原生 Windows 构建，构建于 Azahar、Ship of Harkinian 和 NVIDIA NRI 等基础之上。
怎么让它跑起来？下载 Windows-x64 的 ZIP（不是 GitHub 的源码压缩包），解压，运行 TriAevumForge.exe 并选择你解密好的 ROM；设置完成后即可启动游戏，之后直接使用 TriAevum.exe。
实际运行它需要什么？一台配备支持 Vulkan 的 GPU 和最新驱动的 Windows x64 电脑，加上你合法解密的《时之笛 3D》ROM 转储（.3ds 或 .cci 格式）；Forge 检查的是 ROM 的内容，而不只是文件名。
它现在的完成度和测试程度如何？它是实验性的 alpha 版，不是经过完整测试的移植：游戏性测试目前只覆盖游戏前期内容，美版 ROM 也只在安装、标题开场和存档选择环节验证过，未经过完整通关测试。
设置完成后还需要联网吗？首次设置时，Forge 会下载官方 TopScreen 纹理包，因此需要联网，除非你在本地提供该纹理包；设置完成后无需联网即可运行。
我的显卡重要吗？重要，你需要一块支持 Vulkan 且驱动为最新版本的 GPU；卡通着色、AO、反射、阴影、抗锯齿和额外的草地特效都是消耗 GPU 性能的选项，可根据你的硬件调整。
60/90 FPS 模式真的会加快游戏速度吗？不会。它只是对原始 30 Hz 游戏状态做视觉插值；底层的游戏逻辑和玩法速度与原版完全一致。
TopScreen 是什么？为什么它获得如此突出的致谢？TopScreen 是 rlgcarrot 最初为一个类似 3DS 重编译项目开发的单屏界面；TriAevum 为自己的渲染器重新实现了这种单屏体验，并对原始设计和贡献致谢。
我拥有的任何《时之笛 3D》ROM 都能用吗？任何个人拥有的、已解密的欧版或美版 ROM 转储（.3ds 或 .cci 格式）应该都可以；Forge 验证的是实际文件内容，而不是轻信文件名。
相比原版 3DS 游戏，它增加了哪些额外图形特性？带描边的赛璐璐/卡通着色、环境光遮蔽、可选的反射/阴影/抗锯齿、视场角（FOV）可调的真宽屏、程序化草地，以及与 Azahar 兼容的自定义纹理，全部可通过游戏内设置菜单（F1）配置，F2 可开关这些新增效果。
What are similar projects?BLACK-XBERecomp, The-Darkness-Recomp, RyGT, TheSimpsonsGameRecomp, MacNativeGames, uncharted_pc, ShadowOfTheColossus-PC, ps2-web-recomp
Which topics is it in?shaders, emulation, retrogaming, vulkan, ai-coding, native, rendering, game-development, graphics, game, 3d, windows-app
Creator
coccofresco
Size
230.3 MB
Stars
508
Updated
CommitOct 18
Age
1mo
Commits · 90 Days