NX2navi to Triforce Handover

Hookshot & NX2navi join Triforce

In November 2026, tangerineturtle1/NX2navi (chrg6 and contributors) and NotRexed/Hookshot (continued by Evil's branch after the original GitHub repository returned HTTP 404) merged into one joint project: Triforce (triforceproject.com). Full GPL-3.0-or-later source code lives on Forgejo at git.triforceproject.com/triforce/source, and Windows installers publish at git.triforceproject.com/triforce/downloads.

Triforce targets the exact same legally obtained Nintendo Switch 2 Ocarina of Time dump (Program ID 0400486024DEC000, update v131072 / version 1.1.1, main build e0f3ccfa) across three core subsystems:

Power (AOT Recompiler)

Lifts Switch 2 ARM64 instructions to C via nx2/lift.py and compiles a native x86-64 executable locally with bundled llvm-mingw (nx2/build.py).

Wisdom (System Runtime)

Implements Horizon OS services in host/ for filesystems, raw save slots, 5.1/stereo audio, SDL3 controllers, threads, and frame pacing.

Courage (Vulkan 1.3 GPU)

Translates Switch 2 NVN and Ampere shaders to SPIR-V (host/nvn_native.c, gpu/vk/, lower_to_maxwell.h) with Vulkan 1.3 mesh shaders, upscalers, frame generation, and optional RenoDX HDR tone mapping.

Launcher v0.12.0 handover screen

On Windows, NX2navi published Stable v0.12.0 (NX2navi-app-0.12.0.zip, 3,333,988 bytes, sha256:45c9c50d98fa4771c6d7330e8fa2353c9db1e8b65e3b37ef14174fb4b57e1793) through its normal NX2navi-update.json feed. Existing Windows launchers download it into app/0.12.0/ while keeping app/<old version> on disk (rolling back automatically via exit code 86 if startup ever fails).

Nothing is deleted or overwritten: your compiled ocarina.exe, saves, data/launcher.json, build tools, mods/ folder, and .nup file remain intact. Instead of the build dashboard, the handover window exposes four direct actions:

Convert saves & flush save-tx

Both NX2navi and Triforce store identical raw Switch 2 save files per profile (account.sav, option.sav, and slot_00 through slot_NN containing progress.sav and caption.sav). Follow this four-step sequence so your newest progress imports cleanly:

1. Quit NX2navi cleanly first (flush save-tx): NX2navi writes active saves into a staging directory named profile/save-tx and moves them into profile/save/<account>/ on clean completion. Always save in-game and close both NX2navi and Triforce before converting so profile/save-tx flushes completely.
2. Copy your save path: In the NX2navi v0.12.0 handover window, click Copy path under Your NX2navi game and saves. For standard per-user Windows installs, saves live at %LOCALAPPDATA%\Programs\NX2navi\game\profile\save (portable installs use <game folder>\profile\save).
3. Open Convert saves in Triforce Setup: Run TriforceSetup.exe (requires 64-bit Windows 10/11, 16 GB+ RAM, Vulkan 1.3 GPU with mesh shaders, and ~60 GB free disk during the ~40-minute initial build). Once built, re-open Setup to reach Welcome back and click Convert saves.
4. Import with automatic backup: Triforce Setup automatically discovers NX2navi and emulator saves (in bundled v0.3.6, paste the copied path directly) and backs up any existing Triforce slots into save-backups/ beside TriforceSetup.exe before writing.

# Default Windows NX2navi save path copied by the v0.12.0 handover screen
%LOCALAPPDATA%\Programs\NX2navi\game\profile\save

# Optional source CLI helper inside git.triforceproject.com/triforce/source
python scripts/oot_saves.py list "%LOCALAPPDATA%\Programs\NX2navi\game\profile\save"
python scripts/oot_saves.py import "%LOCALAPPDATA%\Programs\NX2navi\game\profile\save" --keep-settings

When to keep NX2navi installed

Triforce installs into its own per-user directory and stores runtime settings in triforce_options.ini, so keeping NX2navi installed side-by-side causes zero file or registry conflicts:

Triforce guides & source links

Continue with our dedicated Triforce documentation hub and verified upstream repositories:

Triforce Recomp Wiki

triforcerecomp.wiki covers TriforceSetup.exe requirements, F1 options, quality presets, frame generation, and RenoDX HDR.

NX2navi & Hookshot Migration

triforcerecomp.wiki/nx2navi-and-hookshot-migration/ walks through save-slot conversion from NX2navi, Hookshot, and Switch 2 emulators.

Triforce Downloads & Hashes

triforcerecomp.wiki/download/ tracks verified TriforceSetup.exe packages alongside git.triforceproject.com/triforce/downloads.

Triforce Source & Architecture

triforcerecomp.wiki/github-and-source/ documents the GPL-3.0-or-later Forgejo tree (triforce/source) and Power/Wisdom/Courage modules.