HOOKSHOT
GITHUB Symptom index
Hookshot troubleshooting
Start from the symptom, not from a graphics card brand. The four long pages are linked from the rows that have their own write-up.
Symptom table
If the grappling item in a Zelda game is what failed, this table is the wrong one. Those pages live under the Zelda section. The rows below are about the PC program.
| Symptom | Clue | What to try | Issue | Evidence status |
|---|---|---|---|---|
| Black picture, sound may continue | Shader prepare, no mesh shaders, device lost, AMD renderer wait | Black screen page | #998 | 1 issue report · 1 project platform |
| Closes immediately or device lost | Old driver, AMD | Crash page | #708 #614 | 2 issue reports · 1 project platform |
| Missing chunks, mesh-shader warning | GTX 900/1000, RX 400/500/5000, Iris Xe | Update the driver; fallback can skip draws | #640 #1001 | 2 issue reports · 1 project platform |
| Blocky AMD textures, solid sky, dark courtyard | ASTC converted to BC3 | RX_VK_ASTC_RGBA8=1, uses more VRAM | #57 #1006 | 2 issue reports · 1 project platform |
| Stripe shadows on Hyrule Field | Known picture bug | Glitch page | #468 | 1 issue report · 1 project platform |
| Stutter the first time you enter an area | Shaders preparing | Second visit is smoother | Readme | 1 publisher source |
| NVIDIA stutters every launch | Driver shader cache too small | NVIDIA control panel, shader cache Unlimited or 10 GB | Readme | 1 publisher source |
| Steam Deck freeze | gfx_0.0.0 timeout | Linux page | #817 | 1 issue report · 1 project platform |
| Tools deleted | Unsigned files | Protection history, then Repair | Readme | 1 publisher source |
| Wrong language | language.txt | Edit the code in that file | Readme | 1 publisher source |
| Saves from another project | Same save filenames | scripts/oot_saves.py | saves note | 1 publisher source |
| Windows SDK not found | Old builder | SDK page | #348 | 1 issue report · 1 project platform |
Questions
The game item will not latch. Is that this page?
No. Item behavior is on the Zelda pages. This index is for the PC program.
Which log do I attach to an issue?
hookshot_log.txt. The readme says the last five copies are that file plus .1 through .4.
Sources
| Source | Evidence status | Checked |
|---|---|---|
| Readme | 1 reference · shared publishers and mirrors count together | 2026-11-11 |
| Issue list | 1 reference · shared publishers and mirrors count together | 2026-11-11 |
| Saves note | 1 reference · shared publishers and mirrors count together | 2026-11-11 |