Repository navigation
Steam Deck build 2026-11-12 - rebased onto upstream main (+1771 commits)
⬇ Download for Linux / Steam Deck
Rebased onto upstream 55b976c0. Our patch set is 7 files / 89 lines; everything else is upstream's.
| old base (fallback) | this build | |
|---|---|---|
| fps | 27.7 | 26.8 |
| frame p50 | 36.1 ms | 37.04 ms |
| p99 | 36.63 ms | 39.53 ms |
| GPU time | 14.6 ms | 12.6 ms |
| replay | 19.1 ms | 16.4 ms |
3% slower in total, but the renderer is 2 ms and the replay 2.7 ms faster - upstream does more per frame elsewhere. In exchange: 1771 upstream fixes, a working pipeline cache, and the lighting fix that removes our fog workaround.
Our patches, all in and verified live in the log
HOS_REALTIME_FLOOR- real time below 15 fps (upstream still hardcodes it). Log:vi: real-time step floor 10 fpsRX_VK_BATCH_IDLE_MIN- the throttle on NotRexed#1993's idle flush. Raw, it stalls this Deck for 35.9 s. Worth +20%.NOP_SET_RTcompares before bumpingrt_serial- push-constant dedupe,
RX_VK_GRID_CAP - alpha test from the NVN colour state (upstream has the emitter; nothing set it)
- texture refault pin (
RX_VK_STICKY_MB) - frame-gen pacer's 500/250 ms bounds
Build fixes needed for this toolchain (not upstream, not ours)
nx2/build.py:HOOKSHOT_CXX_INCLUDE/HOOKSHOT_CXX_LIBfor the C++ headers and the static libstdc++ - without them every C++ file fails with'algorithm' file not foundhost/posix/glibc_compat.c:__isoc23_strtoulandarc4random, which the toolchain'slibstdc++.areferences and the 2.35 sysroot does not export
Dropped because upstream has them (or because they were proven broken)
tree-shadow shader (NotRexed#1581), the handle guard (758e563), NotRexed#1338 noise volumes, NotRexed#1507 64-lane warps, NotRexed#1993, the count cap, the index dedupe, the PGO plumbing - all upstream, several as supersets. Dropped after measurement: the safe-mode interpolation, a sampler cache by id (broke the game), the fused FMA (broke the game). Dropped because upstream fixed the root cause: the OoT fog/exposure/blur workaround (NotRexed#2042) - RX_VK_OOT_VISUAL/OOT_FOG are now no-ops.
Known issues
- Frame time is CPU-bound and serialised: replay 16.4 ms + GPU 12.6 ms + game code. Overlapping the CPU and GPU is the remaining large win.
- Occasional fog/cloud/background flicker; this build runs the game's own lighting, unmodified, which is upstream's fix rather than our band-aid.
Files
hookshot_vk.so is the module from this source (md5 7db6d5f6). The game binary is not distributed - it is the user's own dump.
Which file do I download?
| On | Download |
|---|---|
| Windows | HookshotBuilder.exe, the setup |
| Linux, Steam Deck | the .AppImage |
You need your own copy of the game. hookshot-setup.txt, hookshot-linux.txt and the .zsync are for the updaters, and the -Windows-x64.zip (the setup and its recomplauncher.json) for RecompLauncher: on Windows, download HookshotBuilder.exe instead. To check a download: sha256sum -c --ignore-missing SHA256SUMS, or gh attestation verify <file> -R RufflezAU/Hookshot.