Skip to content

Steam Deck build 2026-11-12 - rebased onto upstream main (+1771 commits)

Choose a tag to compare

@RufflezAU RufflezAU released this 12 Nov 05:19

⬇ 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 fps
  • RX_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_RT compares before bumping rt_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_LIB for the C++ headers and the static libstdc++ - without them every C++ file fails with 'algorithm' file not found
  • host/posix/glibc_compat.c: __isoc23_strtoul and arc4random, which the toolchain's libstdc++.a references 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.