Tested GPUs, launch fixes, and log checks

If Triforce closes immediately on startup, stutters entering a new map, or rejects your game dump, check triforce_log.txt beside Triforce.exe and compare your driver version against upstream tested hardware.

Vulkan 1.3Mandatory driver baseline
3-37 msPost-v0.3.1 Hyrule Field waits
85-88%VRAM release threshold (>8 GB)
Gigabyte GeForce RTX 4070 Aero OC 12GB graphics card
Updating NVIDIA, AMD Adrenalin, or Mesa RADV drivers fixes almost every immediate Vulkan 1.3 mesh-shader startup exit.

Upstream tested GPU & OS configurations

Benchmarks below come directly from docs/tested-configurations.md and release engineering notes across Kokiri Forest, Great Deku Tree, and Hyrule Field.

GPU & VRAM CPU & RAM OS & Driver Observed Performance
NVIDIA RTX 5070 Ti (16 GB) Ryzen 7 9800X3D · 32 GB Windows 11 · Game Ready 576+ Locked 60 fps base / 120+ fps with frame generation at 4K Ultra
NVIDIA RTX 4070 Ti (12 GB) Ryzen 7 5800X · 32 GB Ubuntu 26.04 / Arch KDE Wayland · 595.58.03 48-60 fps native with HDR10 Wayland swapchain active
AMD Radeon RX 9070 XT (16 GB) Ryzen 7 7800X3D · 32 GB Windows 11 · Adrenalin 25+ Full hardware mesh shaders, foliage culling fixed in v0.3.6
AMD RX 6700 / 6800 / 6900 XT 16 GB+ system RAM Windows 11 / Linux RADV Uses compute task+mesh fallback (RX_VK_TASK_MESH_FALLBACK=1)
Intel Arc A750 (8 GB) 16 GB+ system RAM Windows 11 · latest Arc WHQL Balanced (8 GB) preset; Deku Tree shader-cache crash fixed in v0.3.5

Common failure symptoms and direct fixes

Inspect the bottom lines of triforce_log.txt first; every fatal initialization check prints the missing Vulkan feature or dump mismatch before exiting.

Closes immediately on launch

Almost always an outdated Vulkan runtime or missing VK_EXT_mesh_shader support. Update to the newest NVIDIA Game Ready, AMD Adrenalin, Intel Arc, or Mesa 24.3+ driver. On Radeon RX 6000 cards, add RX_VK_TASK_MESH_FALLBACK=1 inside triforce_env.txt beside Triforce.exe.

Unsupported game dump / Build ID error

Triforce only accepts Switch 2 Title ID 0400486024DEC000 with Update v131072 applied (main NSO Build ID e0f3ccfa). Unpatched base dumps (v65536 alone) or N64/3DS ROMs will never pass nx2/make_game.py --check.

Save-load freeze or exposure flicker

Update to Triforce v0.3.7 via Update & merge. Version v0.3.7 specifically resolves the freeze when loading saves after changing graphics settings, fixes exposure flicker on area loads, and keeps the GPU memory pool alive when full.

Brief hitch entering a new area

Although Triforce pre-walks 18,403 shader pipelines across all 80 maps (and lazy-loads pipelines on PCs with under 20 GB RAM since v0.3.5), your GPU driver compiles newly encountered state combinations once and caches them permanently on disk.

Overriding game language (language.txt)

Create a single-line language.txt file next to Triforce.exe containing one supported locale code such as en-US, en-GB, es-ES, es-419, fr-FR, de-DE, it-IT, nl-NL, ja-JP, ko-KR, zh-CN, or zh-TW.

Experimental threaded command recorder

CPU-bound systems can test RX_VK_RECORDER=thread in triforce_env.txt (introduced in v0.3.3). Remove the line if you observe intermittent scene flicker while reporting logs on Discord.

Controllers tested with SDL presets

Triforce maps Xbox, PlayStation, and Switch-layout controllers natively in Controls and supports background input.

8BitDo Ultimate 2C Wireless Controller

Hall-effect sticks and triggers with low-latency 2.4G dongle for Windows and Linux SDL input.

Check on Amazon

GameSir Super Nova Hall-Effect Gamepad

Drift-resistant Hall sensors, swappable ABXY layout, and quiet membrane face buttons for Ocarina melodies.

Check on Amazon

8BitDo Pro 2 Bluetooth Gamepad

Symmetrical dual-stick layout with Switch and X-Input modes plus rear paddles for quick camera centering.

Check on Amazon

GuliKit KK3 Max Wireless Controller

TMR electromagnetic sticks, 1000 Hz wired/wireless polling, and Switch-layout face button caps included.

Check on Amazon

Affiliate disclosure: As an Amazon Associate, triforcerecomp.wiki earns from qualifying purchases at no added cost to you.