Ocarina Recomp & Hookshot changelog

• Kokiri's trees have leaves again. The canopy was not drawn (bare branches), and without it the sun washed the fog white. Vegetation, filtered light and fog are now much closer to the original game. Fix from a contributor's Linux port.
• The leaves fall. They used to hang still in the air. On the first run they start falling after a while, once the game has prepared their shaders. It costs some fps (about 7 on an RTX 5090).
• Fewer stutters: the installer's shader preparation covers almost twice as many shaders, and an update adds the new preparations to yours.
• Blue-green blotches in the fog are much smaller (a fix to the fog sum, which also avoided a hang on AMD).
• Less video memory: the game's big memory blocks only take VRAM for the part the GPU uses (about 2.4 GB less), and textures use BC3 on cards up to 12 GB (half the memory).
• Installer: free space on other drives is read correctly (it showed 0 GB), and shaders are prepared again when the version changes.
• Fixes: the game no longer closes with FATAL: sm: service "hid" (vibration); laptops with two GPUs use the dedicated one.
• Still known: the falling leaves are dark, some trees lose their leaves up close, occasional black flicker.

Unpack the whole ZIP and open Instalar-Ocarina.exe. Install over the previous version, in the same folder. The first run after updating translates the shaders again and may stutter in the first minute. Experimental. Needs your own copy of the game, version 1.1.1.

SHA-256: 044c4584e16017caf19b6f9308bdd30f9977e50cd32516a68b89c2b7d09aee64

Files: Ocarina-Setup-0.2.7-windows.zip (115.8 MB). Full notes on GitHub

• Installer: fixed the "no file name was provided" error at "Copiar as ferramentas", which stopped the install on some Windows setups.
• Shaders: every shader the game uses up to Kokiri is now converted for the PC GPU (12 failed before). Fixes from a contributor's Linux port.
• Less memory: video memory is reserved in smaller blocks. In my test, about 0.7 GB less VRAM and 0.85 GB less RAM, at the same frame rate.
• AMD integrated GPUs (Vega): the game no longer closes when there is not enough memory for an upscale image.
• Experimental: the game's own upscaling network now works. With TOTK_BIG_CS=0 in totk.ini the picture is sharper, but still slightly darker, with outlines on some leaves. It is not the default yet.
• Still known: blue-green blotches in the Kokiri fog (under investigation).

Unpack the whole ZIP and open Instalar-Ocarina.exe. Install over the previous version, in the same folder: since 0.2.5, updating takes about a minute. Experimental. Needs your own copy of the game, version 1.1.1.

SHA-256: 2ed40e974b9df89a9ac2e5f73bc2d9a4d8a9dbd16cc097bcc5039dc6ca6eda4c

Files: Ocarina-Setup-0.2.6-windows.zip (115.8 MB). Full notes on GitHub

• Updating is much faster. Installing a new version over the previous one, in the same folder, recompiled the whole game (close to an hour on an average PC). Now only what changed is recompiled: from 0.2.4 to 0.2.5, about a minute. This applies from this version on.
• Graphics cards with up to 6 GB: textures take a quarter of the video memory (BC3). On a 4 GB GTX 1650 the game went past 6 GB of VRAM and closed (device lost) when entering a new area.
• 12 GB cards (RTX 5070 and others): the frame rate fell to 9–11 fps in Kokiri after a few minutes. Memory copies in VRAM are now capped at 1 GB.
• AMD: when the driver closes the game while building a shader, that shader is noted. At the next start it is built another way (without optimization), and if the driver closes the game again, it is skipped. The crash still happens once at that point, and the next start gets past it.
• Intel: fixed a driver crash when saving the shader cache, and a device lost when loading Kokiri on integrated GPUs (fixes by AlfaDev23).

Unpack the whole ZIP and open Instalar-Ocarina.exe. Install over the previous version, in the same folder. Experimental. Needs your own copy of the game, version 1.1.1.

SHA-256: 3bbcdce1c1d13468cfcf53161f727289441184c1afd3499554530be2955cf34e

Files: Ocarina-Setup-0.2.5-windows.zip (115.8 MB). Full notes on GitHub

• Leaves, canopy and grass are lit again. They rendered black because a lighting shader writes only some of an image's channels, and Vulkan zeroed the others. Fix by Akane.
• The game no longer closes at start after updating over an earlier version (FATAL: cfg: TOTK_OOT_RESOLUTION has no row). The installer now recompiles the runtime whenever the version changes.
• Memory warning: with 16 GB of RAM, Windows can close the game the first time, at the Deku Tree scene. The installer now warns when the Windows memory limit is low and shows how to enlarge the page file (initial 16384 MB, maximum 32768 MB).
• Save import: warns when your current save is newer than the one being imported. The previous save is still kept in perfil\save-antes-de-importar-<date>.
• The game's neural networks are much smaller (from 1.4 million to 92 thousand shader words), groundwork for console-quality upscaling.

Unpack the whole ZIP and open Instalar-Ocarina.exe. You can install over the previous version, in the same folder. Experimental. Needs your own copy of the game, version 1.1.1.

SHA-256: 45bdd73f3a1db16a3219e348cd494ecb8d3304d3e99296cb219ca379db55eaab

Files: Ocarina-Setup-0.2.4-windows.zip (115.8 MB). Full notes on GitHub

• Shaders prepared at install: the installer reads the shaders from your own copy of the game and prepares them before you play, in under a minute. On a first start, the 12 s stall at boot and the 25 s stall at the start of the Deku Tree scene are gone. For now this covers the start of the game; later areas still build shaders in play.
• Foliage: 15 compute shaders that were rejected at every boot now work. The foliage culling should be among them. The flickering grass and Link should be gone too.
• 6 to 8 GB cards: the game uses less video memory, which should prevent "device lost" on GTX 1060 and 1660, RTX 3050, 4060 and similar cards.
• AMD:
• buffers larger than the card's limit are split into smaller windows;
• a pipeline the driver refuses is built again without optimization;
• the huge shaders stay out of the boot prebuild.

Not tested on an AMD card yet: please report in the issues.

• Resolution: the oot_resolution option in totk.ini (auto or 25 to 200 %) fixes the 3D resolution on cards where the dynamic resolution drops.
• Linux: builds and starts.

Unpack the whole ZIP and open Instalar-Ocarina.exe. Experimental. Needs your own copy of the game, version 1.1.1.

SHA-256: f06f9138f63566a8afbfd5d0ea2c2b172e2e332fc1726e227870d90e18bdb50c

Files: Ocarina-Setup-0.2.3-windows.zip (115.7 MB). Full notes on GitHub

• Fixed the crash after the opening cutscene, at the start of the Deku Tree scene. A task shader was sometimes built as a vertex shader, and NVIDIA's compiler crashed.
• Better frame rate on NVIDIA: fewer background shader builds compete with the game.
• No more freezes of up to a minute after the Deku Tree, and less RAM at boot.
• AMD black screen after the intro: should be fixed, but untested on AMD so far. Please report in the issues.
• Installer:
• Portuguese/English button;
• accepts AVX2 on older Windows 10;
• no longer crashes without Notepad.
• Linux: two crash fixes.
• The log now says where a crash inside a driver happened.
• Still known: the first time, the start of the Deku Tree scene freezes for about 25 s while shaders build.

Unpack the whole ZIP and open Instalar-Ocarina.exe. Experimental. Needs your own copy of the game, version 1.1.1.

SHA-256: 06c86cdecf4ca79710cef1c2422bb082657f0b98d5afbc57412ad12e8c525ace

Files: Ocarina-Setup-0.2.2-windows.zip (115.1 MB). Full notes on GitHub

Brazilian Portuguese. Imports saves from Lichii and Eden. No more freeze of over a minute on a first run. The installer window can be minimized. Recognizes a finished install without asking for the game. Unpack the whole ZIP and open Instalar-Ocarina.exe. Experimental. Needs your own copy of the game, version 1.1.1. SHA-256: 89f20e58f6cdf1018a08db86a0f38c45b4fd48a215609b36d10969d522b326f4

Files: Ocarina-Setup-0.2.1-windows.zip (115.1 MB). Full notes on GitHub

Everything is in the ZIP: it installs nothing in Windows and asks for no administrator. Fixes the black screen at the Great Deku Tree in a new game and the missing voices. Unpack the whole ZIP and open Instalar-Ocarina.exe. Experimental. Needs your own copy of the game, version 1.1.1. SHA-256: 7e06d8bc274bd34eab117d1837375e37b7321ec3c265a625be1d309a51bd30af

Files: Ocarina-Setup-0.2.0-windows.zip (120.9 MB). Full notes on GitHub

Installs only the 3 Python packages the build needs. Test version, experimental. Needs your own copy of the game, version 1.1.1. SHA-256: 39e54454a67a2c8b5a057c6672b369978323dc78c9978b28428826ef74cde9ad

Files: Instalar-Ocarina.exe (0.1 MB). Full notes on GitHub

Fixes the PowerShell not found error and adds the dav1d package, missing on clean PCs. Test version, experimental. Needs your own copy of the game, version 1.1.1. SHA-256: c9992c4ad0fc5c5213dffc601ca415a249151ba266f02d69ee60f78ae92b848d

Files: Instalar-Ocarina.exe (0.1 MB). Full notes on GitHub

Fixes winget, py and git not being found on PCs with a long PATH. Test version, experimental. Needs your own copy of the game, version 1.1.1. The executable has no digital signature; Windows may warn you. SHA-256: 4103d9112e36c3695943d09e2ec8656973fe1de017b350777440b60b2bef49a0

Files: Instalar-Ocarina.exe (0.1 MB). Full notes on GitHub

No RAM limit: below 16 GB, the installer only warns. Test version, experimental. Needs your own copy of the game, version 1.1.1. The executable has no digital signature; Windows may warn you. SHA-256: 30e37720e8bc48dc55fd7ef2a1a83a2184e4f4b4ad1b3f14b312508a4ec56c8e

Files: Instalar-Ocarina.exe (0.1 MB). Full notes on GitHub

Test version, experimental. Needs your own copy of the game, version 1.1.1. The executable has no digital signature; Windows may warn you. SHA-256: 0cb407952ab3fa1eb082de5ac25e6d17ba8e96a05e221ec3d39a490e9271a8c9

Files: Instalar-Ocarina.exe (0.1 MB). Full notes on GitHub

Versão de testes, experimental. Precisa da sua própria cópia do jogo, versão 1.1.1. Não há nada pronto para baixar: para compilar, siga o passo a passo.

Test version, experimental. Needs your own copy of the game, version 1.1.1. There is nothing ready to download: to build it, follow the step-by-step guide.

Files: no files. Full notes on GitHub

First test version, experimental. Needs your own copy of the game, version 1.1.1. To build it, follow the step-by-step guide.

Files: no files. Full notes on GitHub

Build again with this Hookshot Builder (Windows: HookshotBuilder.zip, no Visual Studio needed; Linux: the .AppImage below, added a few minutes after this release). Your saves and settings stay where they are.

Fixes

• GPU crash ("device lost") while the game loads or right after it starts (#150, about 1 start in 7 on NVIDIA): the renderer's table of the game's memory now changes in the GPU's own order, so a running shader can no longer follow an entry into memory that isn't ready. 14 of 14 test starts without it, with the same fps and no extra flashes.
• Faster builds: the builder runs one compiler per CPU thread, as many as your free memory holds (it used half the threads). HOOKSHOT_JOBS=<n> still chooses.
• One more per-draw lookup saved (SkippySteve, #416).

Everything from no-visual-studio is in here too: no Visual Studio, fewer flashes, the Controls page, text speed, quality presets, ~15% more fps, Linux AMD batching and the crash fixes.

Files: Hookshot-device-lost-fix-x86_64.AppImage (215.5 MB), HookshotBuilder.zip (398.2 MB). Full notes on GitHub

Build again with this Hookshot Builder (Windows: HookshotBuilder.zip; Linux: the .AppImage below, added by the build a few minutes after this release). Your saves and settings stay where they are.

No more Visual Studio or Windows SDK

The builder now brings its own compiler (llvm-mingw, as the TotK port does). You no longer need Visual Studio, the Build Tools or the Windows SDK: unzip, pick your game files, build. "Windows SDK not found" is gone.

Fixes

• Flicker and white flashes: CPU reads of GPU results now wait for the work that writes them (EvilBoyce's fix, #296), and the VRAM mirrors no longer overwrite the GPU query results that decide which passes run (fewer one-frame dark frames).
• Missing geometry on every GPU: 30 mesh shaders that failed to translate (LoadGlobalS16, #351) now work.
• CPUs without AVX2 (older Xeons, Ivy Bridge): the game is built for your CPU and no longer crashes at start (#363).
• User folders with accents (e.g. Magalhães) no longer break the build (#230).
• Movie thread crash when memory runs short (#342).
• Black movies on Windows: if Windows has no AV1 decoder, the game now tells you and opens the free "AV1 Video Extension" page (#380).
• Incomplete .nup files are named as such right away, instead of failing late with "short read" (Linux and Windows).
• Linux on AMD (RADV): the renderer's submits are batched (#413, thanks myylkn): ~10 fps -> 30-50 fps on a Radeon 8060S.

Faster

• About 15% more fps on the CPU side (27 -> 31 fps in Kokiri here): texture lookups, vertex streams, descriptors, programs/pipelines and uniform words are no longer looked up again for every draw (SkippySteve's PRs #300, #322, #327, #345, #349, #362, #373, #392, #397).

New

• Controls page in the Insert menu: rebind every Switch button on the gamepad and the keyboard (gab9281, #335 #343 #350); the menu works from a controller.
• Controller in background: keep playing with the controller while another window has the focus (#359).
• Text speed: dialogue at 2x, 4x or instant (#402).
• Quality presets for 4 GB to 16 GB cards, with a safe texture budget (#398).
• Alt+Enter toggles fullscreen on Windows too (#405).
• Newer SDL (sdl2-compat on SDL 3.4.20): more controllers work, Steam Controller included.
• Mods folder for RomFS mods (#321), an opt-in plain movie upscale for small GPUs (#358), hookshot --prepare-shaders (#320), and more fixes from the community (#73, #162, #206, #207, #217, #225, #235, #237, #341, #404, #412).

Thanks to everyone who sent PRs, logs and videos.

Files: Hookshot-no-visual-studio-x86_64.AppImage (215.5 MB), HookshotBuilder.zip (398.2 MB). Full notes on GitHub

Build again with this Hookshot Builder (Windows: HookshotBuilder.zip; Linux: the .AppImage below, added by the build a few minutes after this release). Your saves and settings stay.

New

• Foliage and lighting from EvilOOT's fork: the tree canopy, grass and falling leaves draw in more places; signs, ferns and Link are lit again instead of near black; Kokiri's pond is green; the game's own fog. Thanks evilmfkr.
• Updates from the game: from this version on, the game tells you at start when a newer release is out and Hookshot Builder downloads it and rebuilds your folder. Set HOOKSHOT_NO_UPDATE_CHECK=1 in hookshot_env.txt to turn it off.
• Linux: an AppImage of the builder (PR 66 by SkippySteve), with the link fix (PR 274).
• Frame generation up to 8x in the Insert menu, which now explains every option (PR 239).
• Rumble you can feel on DualSense, Xbox and other SDL controllers (#263).

Fixed

• Slow motion at 30 fps: Game speed is now Real time by default, also for existing settings.
• Freeze after Load (the movie player's lock, from EvilOOT).
• Builds with Visual Studio 2019 no longer fail with std::projected errors (#100, #163, #185, #201, #259), and __iob_func link errors from an earlier failed build are gone (#231).
• Load-zone freeze on 16 GB PCs from retried memory imports (#218, PR 240).
• Blank menu text on AMD (PR 228). Builder failures now show the real compiler error (PR 272). The FPS counter's first reading (PR 262).

Still open (being worked on)

• Some PCs still lose the graphics device while a save loads (black screen with sound), and there are occasional one-frame dark flashes and fog flicker. Please attach hookshot_log.txt if it happens to you.
• The first start after this update translates every shader again and is slow, and the first visit to new areas can stutter while the driver compiles.

Files: Hookshot-foliage-linux-updater-x86_64.AppImage (215.1 MB), HookshotBuilder.zip (281.9 MB). Full notes on GitHub

Every release includes all the fixes from the releases before it: always take the newest one. Includes everything from less-stutter.

• Intro movie in sync with its sound (#146, #179): the game showed one movie picture per frame, so whenever the frame rate dropped under 60 the picture fell behind and the sound ran ahead for the rest of the movie ("slow motion intro"). Pictures that fall behind are now skipped, so the movie keeps time with its sound.
• Laptops with two GPUs (#176): the game now asks the NVIDIA/AMD driver to run it on the dedicated GPU instead of the integrated one.
• Builder (#180): a translation step could stop on a character the console's code page can't show ("UnicodeEncodeError: 'charmap'"). Every step now writes UTF-8.

Still being worked on: missing leaves and grass (#35), low fps in busy scenes (CPU-bound), dark bars at the screen edges (#95, #145), black screen on a second start on some PCs (#195: please try the cache test in that issue), GPUs without mesh shaders (GTX 10xx, RX 5000).

Files: HookshotBuilder.zip (281.7 MB). Full notes on GitHub

Every release includes all the fixes from the releases before it: always take the newest one. Back up user\save, or build over the same folder with the same .nup.

Less stutter

• No more multi-second freezes when entering a new area. A new shader used to stop the frame until it was built (0.2-3 s each). Now the draw waits a frame or two in the background instead. Measured here on a first start after an update: worst freeze 2.6 s down to 1.2 s, lowest fps 20 down to 30. (RX_VK_PIPE_SKIP=0 in hookshot_env.txt restores the old behaviour.)
• 8 GB cards (RTX 3070, 3060 Ti, 4060...): the GPU-side copies of game memory get their full budget back. small-vram had halved it on 8 GB cards. The smaller budget now only applies to cards with 6 GB or less.
• Some per-frame overhead removed from the renderer.

AMD (from contributor testing on an RX 9070 XT, thanks to AyyBeeDee20738, PR #138)

• Resolution "Auto" no longer gives a black 3D picture on AMD: the dynamic-resolution pass now runs on AMD too.
• Depth-compare sampling fixed (AMD's driver doesn't compare without being told: black blobs and shadows).
• Yellow-white haze from NaN values fixed, and colour channels a shader doesn't write are left alone.
• 30 mesh programs that failed to translate now translate.
• Bright/dark flicker from storage buffers bound one frame and not the next fixed.
• Save loading on AMD: buffers stay within AMD's 2 GB limit, and BC texture views are created correctly (thanks to klimovich008, PRs #139, #142).

Other fixes from contributors

• Shader validation fixes (klimovich008: #140, #141, #143), a crash in the shader dump tool (#182), and the builder now checks your Visual Studio's C++ library before the long compile (monsterlag, #184).

Builder

• The builder app is now a regular folder instead of one compressed program. The single file was often flagged by antivirus. If your antivirus removed the builder's Python, it now says so.

Still being worked on

• Missing tree leaves, grass and ferns (#35): the cause is found, the fix isn't working yet.
• Low fps in busy scenes: preparing ~3000 draws a frame costs the CPU 15-20 ms; that is next.
• Dark bars at the screen edges (#95, #145).
• GPUs without mesh shaders (GTX 10xx, RX 5000) can't render the world.

Files: HookshotBuilder.zip (281.7 MB). Full notes on GitHub

"something went wrong": when the builder hit an error it didn't expect, it hid the reason. It now shows the actual error, and the full text is under Show details**. If you still get stuck, please post that text in an issue so it can be fixed.

• A failed step is named again (it said "-u stopped", #154).
• A leftover code chunk from an earlier build no longer breaks the link with "duplicate symbol" (thanks to leonidasmark, PR #155, #153).
• Output with non-English letters in file names can no longer crash the builder.

Windows Defender / antivirus warnings: the builder is a new, unsigned program that starts other programs (Python, the compiler, the game), which is what Defender's generic "Trojan" verdict reacts to. It's a false positive; all of the source is in this repository. You can report it to Microsoft at https://www.microsoft.com/wdsi/filesubmission ("Incorrectly detected as malware").

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Back up user\save, or build over the same folder with the same .nup: it skips re-reading the game (a rebuild over the same folder took under 6 minutes here). Includes everything from amd-shared-memory.

• Laptops with 4-6 GB of VRAM (#96, #132): the renderer keeps fewer GPU-side copies of game memory on cards with 8 GB or less, and none when VRAM is nearly full. Before, it could run past what the card allows and the GPU timed out (black screen or "device lost").
• Resolution 100% set before starting no longer gives black 3D (thanks to vzeol, PR #102).
• Builder:
• a different .nup now replaces both the old game files and code, instead of mixing old assets with new modules (thanks to monsterlag, PR #129);
• game file paths can't escape the output folder (PR #128);
• builds from a source checkout without the hot profile work (thanks to klimovich008, PR #74).

Still being worked on: missing leaves and grass (the game's foliage culling now produces draw counts, the leaves don't show yet), AMD black screens (please test amd-shared-memory or this one and report), GTX 10xx noise.

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Back up user\save, or build over the same folder with the same .nup: it skips re-reading the game. Includes everything from brighter.

AMD

• Possible fix for AMD black screens and gray Kokiri: every compute shader asked for 48 KB of shared memory, more than an RX 9070 XT allows (32 KB), which made those shaders invalid on AMD. Each shader now asks for what it actually uses. Thanks to klimovich008 (PR #91). Please tell me whether your AMD card shows the game now.

Everyone

• Menu text and the logo no longer go missing on the first start after an update (thanks to d3zessete, PR #54).
• Fixed a crash at boot with a controller connected, and a crash at one cutscene point (thanks to chrispository, PR #55).
• The game's foliage culling now runs and produces draw counts (it produced none before). The leaves still don't show yet; that's the next step.

Testing switches without environment variables

Create hookshot_env.txt next to hookshot.exe with one NAME=VALUE per line. If you're on AMD and still see a black or gray screen, try these one at a time and report which ones (if any) help:

HOS_NO_RENDERER_WAIT=1 RX_VK_NO_FOLLOW=1 RX_VK_OOT_VISUAL=0

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Back up user\save, or build over the same folder with the same .nup: it skips re-reading the game. Includes everything from pointer-lighting-2.

• Brighter, as the game intends (#103): an old workaround darkened every scene to 65% of the game's own exposure. It was there for the washed-out look that the lighting fix solved, and now it only made things too dark. Kakariko is sunlit again.
• Less VRAM (#105, #106): the texture cache now uses at most 6 GB. On 16 GB cards it used to fill most of the card, which looked like a leak.
• AMD testing switch: if you get a black screen on AMD, start the game with the environment variable RX_VK_NO_FOLLOW=1 set and tell me whether the picture comes back. This turns off the newest lighting change.

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Back up user\save, or build over the same folder with the same .nup: it skips re-reading the game.

Kokiri's lighting is back, with menu text

• The shaded forest from pointer-lighting is back, and menu, title and save text show (#92, #93). That release blanked the text because the change also ran in shaders that had no access to the game's memory. Text was checked in English, French, German and Brazilian Portuguese.

Faster second starts

• Shaders that read the game's memory used to change every run, so the graphics driver recompiled them at every start. They are now the same each run, and from the second start on they come from the driver's cache. This should help most on AMD cards, which took 5-6 seconds per shader on a first start (#82, #97).

Fewer black screens

• On 4 GB cards, a full VRAM no longer leaves the screen black; textures that don't fit go to system memory instead (#96). Slower, but drawn.
• Fixed a GPU crash ("device lost") that could happen when entering Kokiri Forest.

Builder

• "stdio.h not found" with Visual Studio installed (#89): the Windows SDK is now found even when it was installed separately, and the message names the right component.
• undefined symbol: __iob_func at the end of the compile (#80): an old Visual Studio's C library was being used. The builder now ignores it and catches this before the 40-minute build.
• Builds that sat at 0% CPU (#87): the builder now keeps the PC awake and stops Windows from throttling the build, and shows the build's output as it happens.

Still being worked on

• Tree leaves, grass and ferns are still missing (#35, #46, #61, #78, #84).
• GTX 10xx cards show noise (#98).
• Shader stutter in new areas on a first visit (#69).

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Hotfix for pointer-lighting: that release left every menu and save text blank. Use this one.

• Menu, title and save text show again. The pointer change that caused it is off; it brought Kokiri's better lighting, which will come back once it no longer breaks text.
• Languages: language.txt now works even when Notepad saves it with a BOM, and a stray line no longer silently leaves the game in English (#75). French, German and Spanish were checked to show their text.
• Everything from lighting-fix stays: no dark characters or holes in the ground, thinner fog, and the AMD movie fix.

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Back up user\save, or build over the same folder with the same .nup: it skips re-reading the game.

Lighting, much closer to the real game

• Shaders can now read through pointers into the game's memory, as the console's GPU does. Before, those reads returned nothing. The fix follows Lichii's work on Ocarina's foliage data (thanks to the Lichii contributors).
• Kokiri Forest is now shaded and moody instead of washed out in white haze, and Kakariko matches the game's own save screenshots.
• Includes the previous release's fixes: no lost startup work (no more dark characters or holes in the ground) and thinner fog.

Still being worked on

• Tree leaves and ferns are still missing in Kokiri Forest (#35, #46, #61). The game's foliage pass still produces nothing; this is next.
• Main menu text sometimes missing (#40, #44).
• Shader stutter in new areas (#69).
• If you used an older builder and see "rtld: not an NSO", download this one (#71).

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Back up user\save, or build over the same folder with the same .nup: it skips re-reading the game.

Lighting

• Fixed dark or black characters, black ferns and pots, streaked ground and holes in the terrain. The game's first work for the GPU was being lost while shaders were prepared, which hit first launches hardest.
• Much less white fog. Skies in Kokiri are pale blue instead of a white wall, and characters are properly lit.

AMD and cards without the matrix unit

• The opening movie and title background should no longer be black (reported on the last release). It now uses a shader. I tested this path by forcing it on an NVIDIA card, not on a real AMD card, so please report back.
• The rainbow noise on these cards is gone (confirmed on an RX 7900 XTX), and they use a fast upscale in play.

Still being worked on

• Tree leaves, grass and ferns are still missing in Kokiri Forest (#35, #46, #61). I found the likely cause, the game's foliage culling reading empty data, and I'm working on the fix now. The forest stays too bright until the canopy is back.
• Green movies: install the AV1 Video Extension from the Microsoft Store.

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Delete your old game folder first (back up user\save), or use this builder on the same folder and the same .nup: it now skips re-reading the game.

AMD

• Fixed the black screen with only sound ("stuck on shader 13"). The movie upscaler no longer gets compiled on cards without the console's matrix unit (all AMD cards so far).
• Movies, the title screen and menus should no longer be stuck at 10 fps. Movies use a plain upscale on these cards, so they are slightly softer.
• Gameplay uses a fast upscale on these cards too (less sharp, much faster).
• The game no longer locks to 30 fps when it can't hold 60 (vsync was forced on AMD). You may see some tearing.
• A crash inside AMD's shader compiler now skips that one thing instead of closing the game.

Thanks to JaredEzz (#26) and LNagad (#52) for the analysis. I tested the AMD path by forcing it on an NVIDIA card, not on a real AMD card, so please report back.

Everyone

• Fixed the one-frame black or bright flashes while moving.
• Added a Fullscreen row to the Insert menu (same as F11). F1 also opens the menu.
• Menu text that sometimes vanished should be fixed (#40, #44). Not reproduced here, so tell me if you still see it.
• Things that were skipped every frame (mesh line draws) now draw.

Builder

• Works with older Visual Studio installs (#39, #48).
• Updating from the same .nup no longer re-reads the whole game (#21, #28). The first build with this version still reads it once.

Still being worked on

• Thick white fog, white sky, dark characters and missing foliage (#30, #34, #35, #36, #46, #51). Likely cause found, fix coming.
• Green movies: install the AV1 Video Extension from the Microsoft Store.
• If Windows or Chrome flags the zip: that's a false positive on an unsigned new program (#37).

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

title

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

No release notes.

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

read title

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

title

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

Fix .nup support

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

First version of the builder, supports .nup files and romfs + exefs

Files: HookshotBuilder.zip (275.9 MB). Full notes on GitHub

TriAevum v0.8.0-beta.1.2

The Grass Learned to Stay Put (and So Did the Credits)

Beta.1.2 is what happens when you publish a beta and people actually play it. Every item in the first section below is somebody's bug report, and the rest is the grass, 4K and input-lag work that had been waiting for a release to ride on. Windows and Linux, as usual.

You reported it, we fixed it, you get to check

• The pause map forgot how stairs work (#89): in dungeons, the D-pad and the circle pad change floor again. Jabu-Jabu's belly is navigable once more, which is more than Jabu-Jabu can say.
• Holding A turned the lights off (#91, #95, #99): with Roll Dash on, holding A to run flickered the lighting, the shadows and Navi's hat into the "no scene" state, as if Link had sprinted out of the game world. The dash hook had been clobbering the game's own idea of which scene it was in. It keeps it now; Navi enters the hat only while Link actually dashes, and the scene identity survives the whole run.
• "Won't launch from a long folder" (#92) and "crashes on installation" (#103): same culprit, Windows' 259-character path limit, which the game's title files were cheerfully exceeding under any deep folder (OneDrive, Documents\Games\... and friends). The game and Forge keep their files within the limit now. If your folder path is very long, it works; if it is absurdly long, Forge tells you exactly how many characters to give back instead of letting Windows find out for you.
• Crash on the very last scene (#104): the end credits asked the DSP to flush and invalidate its data cache, two commands the host had never implemented, because who finishes the game? The reporter did. Both commands are served now and the credits roll to the end.
• Video memory growing until it crashed (#98): textures that no draw has sampled for a while are released, the grass refuses buffers past its VRAM budget and frees them after the frame, and the texture-pack cache no longer keeps the previous pack as a souvenir. The budget is read through the Vulkan loader at run time, so the executable still starts on a loader older than Vulkan 1.1 (the 0xC0000139 reports of the first beta, #12 and #35, stay fixed; the release audit caught the import before you could).
• Barinade, round two (#76): the precompiled Enhanced shader library is recorded again on this exact runtime, on both machines, and a release refuses a library that does not match its own source, or a recording made on a runtime that decides shaders differently. From an empty cache, the fight still compiles zero shaders. Round three is not planned.
• AMD (#78, #84, #93): this is the first release qualified on an AMD GPU (Radeon, Mesa RADV, Linux), because there is finally one in the room. Forge installed from the ROM, the game booted to the file select with zero shader compiles, twice, from both the AppImage and the Flatpak. Windows AMD drivers remain untested by us; please keep the reports coming.

Ocarina Reframed's file selection

The file select is now Ocarina Reframed's: Link stands beside the three files on the upper screen, with the copy and erase confirmations, all drawn by typed code at the game's own block boundaries. The title logo is drawn as a layer over the resolved scene, and the file select has its own scene lighting identity, so starting a new game and loading a save look the same, instead of one of them looking like a different game.

SingleScreen 3.1 and the HD interface

• Sheikah Stone Visions list on the upper screen (3.1): play, complete and cancel without losing the game (#83 asked for the 3.1 update; here it is).
• HD interface by language: Forge offers the HD UI texture pack for the language your ROM boots in, downloaded with your consent and never bundled, and ships the SingleScreen HD font (with its author's permission). The SingleScreen 3.1 archive is preselected when you drop it beside Forge.
• Vanilla+ Link (optional): a local RomFS overlay in mods/ remodels Link without touching the ROM. Your ROM stays yours; Link gets a tailor.

Grass, 4K and input lag

• Grass that stays: its placement and residency now live within a VRAM budget; when the budget is tight the visible grass is thinned evenly instead of vanishing by cluster order in one camera direction. Hyrule Field no longer mows itself when you turn left. Whole blades draw with early depth, as camera-facing ribbons by default, and two more surface rules find grass where the first ones missed it.
• 4K without an upscaler: water reflections and ambient occlusion run at half resolution with a depth-aware upsample, which is where the 4K frame went. On an RTX 3060 at 3840×2160, Kokiri Forest goes from about 19 to 18 ms and Hyrule Field with the river from 26 to 18 ms per frame, with the same image and a lot less heroism from the GPU.
• Input lag: input is sampled after the previous frame ended and the presentation cadence was fixed; at 60 Hz with interpolation the time from button to screen goes from about 33 ms to 9 ms on the development PC. Link now jumps when you press the button, not shortly after.

In-game menu

Esc (or R3) opens a settings menu in the game's own UI renderer, with a photo mode tab and an aspect ratio picture. F1 stays for everything else, because some habits deserve respect.

Windows package layout

The ZIP's root holds TriAevumForge.exe, README.md and LICENSE; Forge puts TriAevum.exe at the root when it installs, with its DLLs in runtime/. Launch the game from the root as before. Fewer files to stare at, same game.

Updating

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.8.0-beta.1.2-Linux-x86_64.AppImage (465.8 MB), TriAevum-v0.8.0-beta.1.2-Linux-x86_64.flatpak (269.9 MB), TriAevum-v0.8.0-beta.1.2-Windows-x64.zip (550.5 MB). Full notes on GitHub

TriAevum v0.8.0-beta.1.1

The Mod Moved House, So It Lives With Us Now

It is called beta.1.1 and not beta.1d because beta.1d sounded like a vitamin. It is the update for everyone: Windows and Linux, beta.1b and beta.1c.

Forge installs again

• No download, no archive, no TopScreen 2.1.1 (#81, #82, #86, #88). The author of TopScreen replaced version 2.1.1 on GameBanana with its successor, SingleScreen 3.0, so Forge's pinned download received a web page instead of a ZIP and every new installation stopped at "Could not prepare TopScreen textures". Hosting someone else's mod on a random drive is not a plan, so: with the author's permission, the two SingleScreen 3.0 files TriAevum needs (the low-resolution UI atlas and Link's extra animations) now ship inside the package. Forge needs your ROM and nothing else. All rights in those files stay with M-1 (rlgcarrot), the author of SingleScreen; see LICENSES/SingleScreen-3.0.md.
• HD interface, if you want it. Place the official SingleScreen 3.1 (singlescreen_31_989c3.zip) or 3.0 (singlescreen_30_25aeb.zip) archive beside TriAevumForge.exe, in mods/ beside it, or in data/downloads/: Forge verifies it and imports its HD UI atlas and HD fonts. Without it you get the native resolution, as on a 3DS.

TopScreen grows into SingleScreen 3.0 and 3.1

TriAevum's TopScreen profile is now a port of SingleScreen 3.0 with the 3.1 fixes, written as typed code at the game's own block boundaries. None of the mod's code or patches is executed.

• Items page with the four-row shortcut column: circle pad and D-pad navigation, reordering, the in-page D-pad picker (hold A, also from the Gear page) and held-X clearing.
• View Model: X on the Gear page, or Y in the D-pad picker, shows the item's 3D model; the circle pad turns it, X and Y zoom, the D-pad pans it, B closes it. Yes, you can now inspect the Hylian Shield like it owes you money.
• Gameplay options: quick put away, landing roll, roll dash and the aiming reticle, plus 3D rain.
• SingleScreen 3.0's HUD: its button circles, D-pad cross and labels, its placement of the A and button groups, the rupee counter, the C-stick aim speed, the Items hint and the D-pad cycle marks, the cutscene rules (no HUD during cutscenes) and the pause page titles. Compared side by side with the real mod running in an emulator, not eyeballed.
• SingleScreen 3.1 fixes: the landing roll breaks the Deku Tree's floor web again, as any self-respecting landing should; leaving a scene while objects were still loading could corrupt memory, and no longer can; room changes wait for their files the same way; the roll dash cross-fades its animation.

One TopScreen layout for everyone

The maintainer's layout is now the standard: HUD at 70 %, its margins, every gameplay option and 3D rain on. F1 → Display → TopScreen HUD offers one choice, Native (100 %) or Optimized (70 %, the default), and the SingleScreen credit. The HUD tab is gone; the TopScreen sections of Controls (shortcuts, gameplay options, C-stick aiming, free camera) stay where they were. Fewer sliders, fewer ways to make Link's hearts sit on his head.

Fewer crashes

• AMD Radeon cards dying during preparation (#78, #84). When the driver refused a Vulkan pipeline, NVIDIA's NRI library called DebugBreak(), which outside a debugger simply means "close the game". A refused pipeline is now retried as a whole pipeline and reported in the log (TRIAEVUM_NRI_PIPELINE_CREATE_FAILED), and the game carries on. There is no AMD GPU in the test lab, so this is unverified on AMD hardware. The access violation inside amdvlk64.dll reported later in #84 may be a different problem: if it still happens, the console output and a crash dump would help a lot.
• Changing the window or display settings on the title screen no longer closes the game (#87), and runs with the TopScreen profile no longer end after a minute with "native PICA display transfer source has no Vulkan render target". Resizing during parallel presentation also kept its GPU copies instead of reaching into the running game.
• SELECT opens Save/Quit again (#80), as in TopScreen.
• "Cannot query the playable runtime: Expecting value" (#85): the cause on the affected machines is still unknown. Forge now saves everything the runtime printed in TriAevum-preflight-error.json and ignores lines another program prints before the answer. If it happens to you, please attach that file.

Faster, and no shader compiling in the middle of a boss fight

• Barinade stops stuttering (#76). The Enhanced graphics preset relies on a library of precompiled shaders, and that library had quietly fallen behind the renderer: from an empty cache, the boss fight compiled shaders on the spot, for about 22 seconds in total. The library is now rebuilt from recorded play, every scene of the game under both the default and the maintainer's settings, plus boss fights, storms, a game over, a cutscene and the boot to the file select. A release now refuses a library that does not match its own source code. With an empty cache, the Barinade fight compiles zero shaders.
• 4K is faster. At 3840×2160 without an upscaler, the water reflections searched every pixel for a pond that was not on screen. They now look only where water can be: on an RTX 3060, Kokiri Forest goes from 37 to 55 fps, the opening scenes from 52 to 54, with the same image.
• Grass is cheaper: its selection runs on the GPU, entering Hyrule Field stalls less, and trees, bushes, rocks and signposts shadow the grass again (their shadows are cached instead of redrawn every frame).
• Texture packs reach the TopScreen HUD (#73): with Henriko's 4K pack the hearts, item icons, rupees, button rings and digits are upscaled too.
• A video memory leak is gone: each change of the texture pack setting kept about 15 MiB of the previous textures until the game closed.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.8.0-beta.1.1-Linux-x86_64.AppImage (228.1 MB), TriAevum-v0.8.0-beta.1.1-Linux-x86_64.flatpak (150.3 MB), TriAevum-v0.8.0-beta.1.1-Windows-x64.zip (320.5 MB). Full notes on GitHub

TriAevum v0.8.0-beta.1c

Save States Found a Place to Live

A Linux hotfix for beta.1b. Windows players can stay on beta.1b: on Windows this version changes nothing.

• Save states work in the AppImage and the Flatpak (#61). Pressing F5 (or F1 → Game → Save states → Save state) failed with "Save state failed: cannot create the folder (Read-only file system)": the default folder sat next to the game's executable, inside the read-only package. On Linux, save states now go beside your save data:
• AppImage: ~/.local/share/TriAevum/data/savestates
• Flatpak: ~/.var/app/io.github.coccofresco.TriAevum/data/TriAevum/data/savestates

A folder you chose with Browse... in that tab is still used as before. On Windows, save states stay in the savestates folder next to TriAevum.exe.

Updating: back up your saves first; it is still a beta.

• Linux: replace the AppImage, or install the new Flatpak bundle with the same flatpak install --user command; saves stay where they are.
• Windows: nothing to do. If you install it anyway, extract the ZIP to a new folder, run TriAevumForge.exe and copy the data\savedata folder of your previous folder into the new one before starting the game.

Everything else is beta.1b: release notes. Use your own decrypted EUR/USA .3ds or .cci dump (original or Rev 1); Japanese, Korean and Taiwanese releases are not supported yet.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.8.0-beta.1c-Linux-x86_64.AppImage (224.0 MB), TriAevum-v0.8.0-beta.1c-Linux-x86_64.flatpak (148.6 MB), TriAevum-v0.8.0-beta.1c-Windows-x64.zip (316.2 MB). Full notes on GitHub

TriAevum v0.8.0-beta.1b

The Upscaler Has Left the Building (and Came Back Properly Dressed)

A hotfix for beta.1. Same game, same data, fewer ways to leave it.

• DLSS actually ships now. In beta.1, choosing *NRI Upscaler* on an NVIDIA GPU picked DLSS, which had nothing to run with, and the game closed; since the choice was saved, it closed at every launch after that. DLSS now comes with NVIDIA's own runtime in a separate module, and it works. Your saved DLSS setting from beta.1 simply starts working.
• No upscaler can close the game any more. F1 offers only the upscalers your machine can really run, and greys out the rest with the reason. If one still fails mid-game, you get the picture unscaled and the option is withdrawn, instead of a goodbye.
• FSR works on Windows (its runtime was missing too). On Linux FSR is not offered: AMD's runtime for it exists for Windows only.
• Too-old graphics drivers get a straight answer. A GPU whose driver stops before Vulkan 1.2 is no longer picked, and the message names the GPU, its Vulkan version and the fix (update the driver from the GPU maker's site), instead of vkCreateRenderPass2.
• Better crash reports. Errors that close the game now reach the log file, and a crash on Windows lists each frame's module and offset instead of the same wrong name.
• The item description no longer stays on screen after closing the Items menu with START at the wrong moment (#60). Closing it while the game was still preparing the description now closes both; closing it a moment earlier, while the item's icon was loading, could also crash the game, and no longer does. That crash is also the one behind pressing START over and over (#67).
• The START menu opens without the wait. The first START of a session froze the game for one to two seconds, and every later open or close stuttered: the scene drawn behind the page made the grass rebuild itself each time. Now nothing is rebuilt, and START opens the page directly, the way TopScreen 2.1.1 does, about a tenth of a second sooner than before.
• TopScreen catches up with 2.1.1. On an open Items or Gear page, SELECT shows the item's description over the page, like the 3DS mod; START reopens the page you left (Items, Gear or Map); L and R hints sit beside the page tabs; the Navi prompt sits in its 2.1.1 place and also shows with View unmapped or the D-pad icons hidden; the horse-stamina row and the dungeon key counter follow 2.1.1.
• Dungeon maps show their markers again with TopScreen. The boss skull and the chests (with the compass) were missing from the dungeon map page, because the minimap layout of the HUD also moved them; it now leaves them alone while a pause page is open, as TopScreen 2.1.1 does.
• The TopScreen FOV setting works. It never changed the view: it watched the wrong camera value. Release builds also skipped the TopScreen steps that sit in the middle of the game's code, such as the FOV, the scene guards behind the pause pages and the touch-button rule. The title module now starts a block at each of them, and the game refuses a title module that does not.
• The Items page uses the full width of the upper screen, as in TopScreen 2.1.1: the grid and the ZR/X/Y/ZL column move outward and the right stone edge gives way to the column. Dungeon maps widen the same way, with the map, compass and key icons on the left and the floors on the right.
• The Save page shows the game behind it, as in TopScreen 2.1.1, instead of the brown pause background and stone edges.
• No more thin lines across empty Gear slots. The Gear page samples its textures the way 2.1.1 does.
• Link no longer flattens when he turns round at 60 or 90 FPS. Between two game frames, a model turning to face the other way was squashed for a frame; it is now shown turned part of the way.
• No more freezes on scene changes with Extended draw distance (#69,

#74). With the option on, the game drew more characters and objects than

its per-frame lighting space holds. The overflow spilled into the queue that loads scenes and writes saves, so a door, a scene change or a save could hang or crash the game. Extended draw distance now adds only as many extra actors as that space has room for. Savestates made after an overflow may already be damaged: load an in-game save instead.

• New default grass, for everyone. The default grass profile now has 25 maps that decide where grass grows, up from 6; Lon Lon Ranch gets its grass back. A configuration from beta.1 takes the new maps once, at the first start of this version, and keeps every other grass setting (density, draw distance, performance and the rest).
• One lighting standard for outdoor areas whose time is set on entry. Lon Lon Ranch no longer ships a lighting profile of its own, so it follows that group's standard, which has a new sun direction. Kokiri Forest keeps its own daytime profile.
• Smoother motion at 60 or 90 FPS. The frames drawn between game frames move each character as one piece (Link's hand stays on his arm, the Iron Knuckles stop trembling), and scrolling textures such as the clouds no longer jump for a frame. Motion vectors follow each actor by its own identity, so a repeated model no longer borrows another one's motion.
• DLSS with frame interpolation no longer loses the GPU after a scene change (the game closed with VK_ERROR_DEVICE_LOST).
• A resolution or display mode that crashes no longer locks you out (#65). If a launch ends within its first minute, the next one starts with the default resolution, window mode, anti-aliasing and upscaler, says so in the log, and keeps everything else.
• The AppImage starts more than once (#66). It used to remember where it was mounted the first time and could not find its own files afterwards ("OTR file not found"); an installation from beta.1 repairs itself on the first start of this version.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.8.0-beta.1b-Linux-x86_64.AppImage (224.0 MB), TriAevum-v0.8.0-beta.1b-Linux-x86_64.flatpak (148.6 MB), TriAevum-v0.8.0-beta.1b-Windows-x64.zip (316.2 MB). Full notes on GitHub

TriAevum v0.8.0-beta.1

Hyrule Gets Its Lights Back On

The first beta. Hyrule now has weather in its lighting, fire that actually lights things, and water that knows it is water. The grass is still there. We checked.

• Two lighting models. *Native* keeps the 3DS look. *Modern* lights every pixel: a key light that follows the scene's own sun, a rim light, ambient occlusion, and shadows. Fresh installs start on the tuned Enhanced preset.
• Scenes come with their own light. Day and night environment profiles, per scene or per group of scenes, blend on the game's own clock. This release ships the profiles authored so far (Temple of Time included) as read-only defaults. Edit any of them in F1 and save your own; *Use group standard* brings back the default.
• Fire lights things. Torches while lit, the Poe sisters' torches, fire Keese, flame traps, fire walls and other flames light the Modern scene. Interior lamps and doorway daylight become real lights, prepared by Forge from your own RomFS. Place your own sun, spot, point, surface and omni lights from F1; surface lights have a spread to aim them.
• Shadows everywhere they should be. Point lights cast cube-map shadows, contact shadows add the small ones, smooth surfaces stop shadowing their own facets, and the sun reaches into interiors through their openings.
• Water. Reflections from the game's own water bodies, flow from the texture scrolling, ripples, white water where rivers step down.
• MXAO. iMMERSE MXAO by Pascal Gilcher joins GTAO and CACAO, with face normals and temporal accumulation. It is a separately licensed module (triaevum_immerse), used with the author's permission; TriAevum runs without it if it is removed.
• DLSS reconstructs the frame upright, with the transformer model on Enhanced. OptiScaler users can try DLSS 5 neural rendering on their own; see docs/TRIAEVUM_OPTISCALER_DLSS5.md. Nothing from OptiScaler is shipped.
• F1 reorganized into seven tabs, with your own graphics presets and a save-state tab. Save states hold the game moment, not your graphics settings, and are compressed.
• Faster where it counts. The precompiled title is profile-guided, shader programs are prepared ahead from recorded game sessions, and the title intro runs above 60 fps at 2160p on the development PC. Results vary by hardware; this is not a promise of zero stutter.

First setup: after reading your ROM, Forge prepares this GPU's pipelines once; the rooms' interior sunlight and light sources come precomputed with the release and are matched to your own ROM's rooms. On the development PC (12 threads) this part takes about 3 minutes; slower PCs take longer. Later launches reuse the work. The first frames show a short preparation screen.

Before updating: back up saves and settings. Prefer normal in-game saves. Global illumination is still experimental and not offered by this build. The game's simulation remains 30 Hz; 60/90 FPS modes interpolate visuals. Android and macOS are not included in this release.

Windows: extract the portable ZIP and run TriAevumForge.exe. Linux: make the AppImage executable and open it; use --forge to return to setup. Or install the Flatpak with flatpak install --user TriAevum-v0.8.0-beta.1-Linux-x86_64.flatpak (the Freedesktop 25.08 runtime comes from Flathub) and start it from the menu or with flatpak run io.github.coccofresco.TriAevum; it updates an alpha.2 Flatpak in place, keeping its saves. Use your own decrypted EUR/USA .3ds or .cci dump (original or Rev 1). Japanese, Korean and Taiwanese releases are not supported yet: Forge declines them.

Special thanks to Pascal Gilcher (Marty's Mods) for MXAO and the permission to use it, to rlgcarrot, whose TopScreen mod is reimplemented here (please consider supporting their work), and to Sion (999sian) for the Linux foundation; see the contribution record. And thank you to Ship of Harkinian, Azahar, NRI, Godot, FidelityFX, and the other donor projects. The lights did not place themselves; well, some of them did.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.8.0-beta.1-Linux-x86_64.AppImage (176.9 MB), TriAevum-v0.8.0-beta.1-Linux-x86_64.flatpak (117.0 MB), TriAevum-v0.8.0-beta.1-Windows-x64.zip (262.3 MB). Full notes on GitHub

999sian for their PR contributions, and Ship of Harkinian, Azahar, NRI** and the other donor projects.

Files: no files. Full notes on GitHub

TriAevum v0.6.0-alpha.3

BROKEN - WITHDRAWN. Do not use this release. Downloadable packages have been removed pending further verification. The original notes below are retained for historical reference, not as a current reliability claim.

Sheik Can Finish a Sentence

More game, fewer arguments with the window. Still an unreasonable amount of grass.

• Linux travels lighter. One AppImage replaces Flatpak, with Forge included. Prepare in Desktop Mode, then add the AppImage to Steam for Gaming Mode. Steam Deck is a compatibility target, not a hardware-tested certification.
• TopScreen gets its bearings. Centered, proportion-preserving HUD, minimap and contextual-menu fixes, and Game Over choices that actually show up. The game may defeat you; the menu should not.
• Sharper words. TopScreen HD fonts are prepared by Forge and used automatically at 480p and above. No magnifying glass DLC required.
• Controllers cooperate more. Unified SDL routing, improved mouse/stick aiming and automatic motion aiming on supported controllers. Gyro affects aiming, not free camera. Virtual/third-party sensor support still varies.
• Cutscenes can finish their business. Sheikah Stone Visions playback and the Temple of Time revelation now progress through their previously blocked paths. The latter returns to gameplay on Windows and Linux.
• Renderer housekeeping. Improved frame pacing, grass visibility work and native shader infrastructure, plus the black-background/toon correction. This is not a promise of zero stutter or a universal FPS increase.

Before updating: back up saves and settings. Prefer normal in-game saves; restoring a savestate made during the revelation's flashback remains unreliable. F1 keeps the established settings menu. 60/90 FPS modes interpolate visuals; game simulation remains 30 Hz. Android/macOS are not included in this release.

Windows: extract the portable ZIP and run TriAevumForge.exe. Linux: make the AppImage executable and open it; use --forge to return to setup. Use your own decrypted EUR/USA .3ds or .cci dump. Existing Flatpak data is not migrated automatically: keep it backed up and separate from the new AppImage installation.

Special thanks to rlgcarrot, whose TopScreen mod is reimplemented here: please consider supporting their work. Thanks to Sion (999sian) for the Linux foundation and PR contributions informing display, shader preparation and TopScreen support; see the contribution record for individual PRs and integration scope. And thank you to Ship of Harkinian, Azahar, NRI, and the other donor projects. The grass did not write itself.

Files: no files. Full notes on GitHub

Alpha 2c: Fullscreen, Not Full Stop

A small maintenance update for Windows and Linux. Same game, fewer window dramas.

• Fixes a reproduced crash when minimizing or restoring the game around fullscreen transitions: the runtime now waits for a valid graphics frame instead of submitting to an unavailable window surface.
• Keeps window events responsive while the display surface is being recreated, without advancing game time during the pause.
• Adds repeatable checks for fullscreen/windowed transitions, resolution changes and automatic rollback of unconfirmed settings.

USA/EUR ROM support, Forge's bundled shader preparation, TopScreen and save formats are unchanged. No title recompilation or SDK is needed.

Back up your saves and settings before updating. Windows users should extract the ZIP into a fresh folder and keep their previous installation until the new one is working. Linux users can install the Flatpak over the previous version; application data remains outside the package.

This fixes a concrete reproduced failure, not every possible driver or fullscreen issue. Physical Steam Deck testing and unrelated Windows loader investigations remain outstanding.

Thanks to Sion (@999sian) for the Linux, compatibility, cache and TopScreen contributions retained from alpha.2; individual PR credits. And to rlgcarrot for the TopScreen design reimplemented here, plus Azahar, Ship of Harkinian, libultraship and NRI for the foundations.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.6.0-alpha.2c-Linux-x86_64.flatpak (86.8 MB), TriAevum-v0.6.0-alpha.2c-Windows-x64.zip (108.4 MB). Full notes on GitHub

Alpha 2b: USA Is Back on the Guest List

Small packaging fix, same excessive grass.

• Restores USA ROM import and equivalent EUR/USA dump recognition accidentally omitted from alpha.2, on both Windows and Linux.
• Adds a release audit that rejects packages missing these qualified input contracts. A matching Program ID alone is still not enough: Forge checks the actual decrypted content.
• Keeps the tested alpha.2 game, Forge, renderer and bundled shader preparation unchanged. No compiler or SDK is needed, and no new Flatseal permissions are required to fix this particular rejection.

Use your own decrypted EUR/USA .3ds or .cci dump. If alpha.2 rejected it, update and run Forge again. Windows users should extract into a fresh folder; keep the previous installation and back up saves/settings before moving data. Linux users can install this Flatpak over the previous version; application data remains outside the package.

Verified with real frozen Forge installations and 300-presentation intro runs on Windows and Linux, including a logically equivalent repacked USA input on Linux. This is not a full-game compatibility claim; physical Steam Deck testing is still outstanding. Unrelated Windows loader failures remain under investigation.

The packages retain the exact corresponding source for their unchanged alpha.2 binaries (source freeze 72e4c37). The input-coverage correction is b1702ea, with verification recorded in fb8161c and this release's tagged source.

Thanks again to Sion (@999sian) for the Linux, compatibility, cache and TopScreen contributions incorporated into alpha.2; see the contribution record for individual PR attribution. And to rlgcarrot for TopScreen, whose single-screen design is reimplemented here, and Azahar, Ship of Harkinian, libultraship and NRI for the foundations.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.6.0-alpha.2b-Linux-x86_64.flatpak (71.0 MB), TriAevum-v0.6.0-alpha.2b-Windows-x64.zip (106.7 MB). Full notes on GitHub

TriAevum v0.6.0-alpha.2

More Hyrule, less housekeeping

The renderer obsession continues. This time, a little more attention went to the part where you actually play the game.

Special thanks to Sion (999sian) for the Linux foundation (#6), display feedback (#14), and contributions informing shader preparation (#11) and TopScreen fixes (#13, #18). These were selectively integrated or adapted, not blindly merged. Thanks also to Pablo Souza for the capture work from #16.

• Linux joins the party. One Flatpak for Linux desktops and the Steam Deck target, with Forge included. Windows stays portable: unzip, prepare, play.
• Forge does more homework. The bundled shader corpus is prepared automatically for your GPU during setup. No extra files to choose; missing variants are still learned and cached while playing.
• Grass has learned some restraint. Adaptive clusters, better distant coverage, and closer matching to the terrain's color and lighting. Still grass. Just less determined to occupy your entire GPU.
• TopScreen gets a tune-up. Fixes for item slots, ocarina guidance, HUD flickering, mounted layouts, minimap markers and ammunition placement.
• Fewer arguments with the controls. A clearer F1 binding interface, press-to-bind controls, and fixes for mouse aiming and camera recapture.
• Less window wrestling. Resolution/fullscreen fixes, clearer display-error feedback, ROM-aware language selection in Forge and F1, and Linux presentation and shutdown fixes.

Still an alpha, not a full-playthrough certification. Steam Deck hardware and Gaming Mode have not been tested directly. Android is not part of this release. Shader coverage is not complete, and first encounters can still compile shaders. 60/90 FPS modes interpolate presentation; game simulation remains at 30 Hz.

Use your own decrypted EUR or USA dump in .cci or .3ds format. On Windows, extract the entire ZIP to a writable folder and run TriAevumForge.exe. On Linux, install the Flatpak and open TriAevum; Forge handles the first setup. For the Steam Deck target, prepare in Desktop Mode before adding it to Steam. Back up saves and settings before updating. F1 configures the renderer; F2 temporarily disables the main graphical additions without discarding settings.

In pictures

Actual alpha.2 framebuffer captures, using the default graphics profile.

Windows: Kokiri Forest outside Link's house

Windows: Link and Epona in the title intro

Linux Flatpak: mounted gameplay with TopScreen

TriAevum would not exist in its current form without rlgcarrot's TopScreen mod, whose behavior is reimplemented here. Please consider supporting their work. Thank you to Ship of Harkinian, Azahar, NRI, and all the other donor projects and contributors. See the contribution record for the exact integration scope and attribution.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.6.0-alpha.2-Linux-x86_64.flatpak (71.0 MB), TriAevum-v0.6.0-alpha.2-Windows-x64.zip (106.6 MB). Full notes on GitHub

Should work with any personal EUR or USA ROM dump, provided it is decrypted and in .cci or .3ds format.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.6.0-alpha.1c-source.zip (12.0 MB), TriAevum-v0.6.0-alpha.1c-Windows-x64.zip (94.4 MB). Full notes on GitHub

TriAevum v0.6.0-alpha.1b

Windows x64 experimental update: controller initialization is fixed, required input/runtime files are included, and Forge accepts the exact tested decrypted USA input through an offline adapter. No new game compilation is required.

Changes

• Initialize SDL controller input in the native game, independently of the unused legacy N64 startup path. Preserve controller handles across hotplug.
• Enable controller, keyboard and mouse together on fresh installations. Existing saved control preferences remain unchanged. The fix was confirmed by the maintainer with a connected physical controller.
• Bundle the additional SDL controller mappings and shaderc's Visual C++ runtime DLLs. SDL2 itself is statically linked; no separate SDL2 DLL is needed.
• Add the audited USA ROM input to Forge. Adaptation happens during setup, using that ROM's assets with the existing canonical EUR logic; no runtime asset replacement and no second USA port.
• Update the README with the project's entirely AI-assisted development approach, renderer focus and limited gameplay-test coverage.

Install or update

Download TriAevum-v0.6.0-alpha.1b-Windows-x64.zip and extract all files into a writable folder. Run TriAevumForge.exe, select your supported decrypted .3ds or .cci ROM, then choose Launch game. TopScreen's official texture archive is downloaded during setup unless provided locally. No SDK or compiler is needed. Use TriAevum.exe for subsequent launches.

Before updating an existing installation, back up its entire data/ folder. Do not discard your saves or settings. To keep using them in a newly extracted installation, copy data/ into it before running Forge with the same ROM. If you previously saved a keyboard-only control profile, enable the controller in F1 > Controls; updates do not silently overwrite your bindings.

Supported inputs and limits

The original supported EUR input remains supported. New USA support is bound to exact extracted hashes in ROM identification, not a filename or a claim that every USA Rev 1 dump works. The tested USA file does not exactly match either referenced No-Intro full-image hash.

USA installation, title intro and file selection have been exercised. A full playthrough, all regional hint/language paths and cross-region saves are not qualified. Only English/French/Spanish dialogue is supplied by the USA input. Do not treat its EUR-compatible execution as preservation of every USA behavior.

General gameplay testing remains limited to the early game. Graphics, audio, input and advanced effects are experimental; use F1 to configure and F2 to compare with the main enhancements disabled. Interpolation smooths visual presentation to 60/90 FPS while retaining 30 Hz logic and normal game speed.

The ZIP is unsigned. SHA-256 sums verify transfer integrity, not publisher identity. A clean Windows installation and modest-PC performance have not yet been qualified. Current Vulkan drivers are required.

The package includes corresponding runtime/Forge and translated title sources, licenses and donor notices, but no ROM, extracted assets, save data or mod ZIP. Please report reproducible issues and, where useful, ordinary in-game save files. Do not upload ROMs, extracted assets or memory savestates with game code.

Package checks

188 Forge/release tests passed, along with native input and SDL controller-lifecycle tests. Both EUR and the exact supported USA input were installed in fresh folders using the frozen Forge executable with zero compiled objects, then booted with NRI/Vulkan and the default TopScreen/x2 profile. Intro framebuffers were inspected for both; USA also reached file selection. These are checks on the development PC, not a clean-Windows or full-playthrough certification.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.6.0-alpha.1b-Windows-x64.zip (94.6 MB). Full notes on GitHub

Ship of Harkinian, libultraship, Azahar, NRI and the independent TopScreen mod/reverse-engineering work. See THIRD_PARTY_NOTICES.md and LICENSE_SCOPE.md.

No ROM, keys, extracted game assets, save data, mod archive, proprietary graphics SDK or development cache is included. TopScreen textures are obtained separately by Forge from the official archive.

Report issues with the release version, GPU/driver, relevant settings and steps to reproduce. Review logs before attaching them: remove personal paths and never upload ROMs, extracted assets or private save states. This project has no official Discord support server.

Files: SHA256SUMS.txt (0.0 MB), TriAevum-v0.6.0-alpha.1-Windows-x64.zip (92.4 MB). Full notes on GitHub