Hookshot Recomp
自述文件排查项14
日志文件hookshot_log.txt
版本信息行e0f3ccfa
Deck标志RX_VK_MESH_NOCULL

Hookshot Recomp 闪退修复

请将屏幕报错或日志行与当前自述文件进行比对。如果游戏启动即闪退,或日志提示 device lost,自述文件建议更新显卡驱动。common-issues.md 为旧版说明,主要针对 v2.0.14,其附带的 GitHub issue 链接现已失效。

日志

条数 1

转储

条数 1

Linux

条数 3

版本

条数 1

GPU

条数 2

AMD

条数 1

Steam Deck

条数 1

Windows

条数 1

着色器

条数 2

语言

条数 1
按类别划分的故障排查速查图
当前自述文件将修复方案按日志、导出文件、GPU、Linux、着色器以及 Steam Deck 进行分类汇总。

现象与处理

现象 处理办法 类别
日志文件在哪里? 游戏文件夹内的 hookshot_log.txt 保存最近一次运行记录。更早的四次记录依次为 hookshot_log.1.txt(上一次)至 .4.txt。若从终端启动,游戏会直接将内容打印到终端。每 600 帧会输出一行 vk: status:,显示驱动允许显存中的当前占用量,以及 DLSS 渲染时的详细数据;vk: 提示超出驱动显存配额时,表示游戏已超出上限。日志可直接对外发送:路径中的家目录已脱敏为 ~(在 Windows 上为 %USERPROFILE%),用户名记为 <user>,其余路径保持原样;构建器的 --log 文件也采用相同格式记录 日志
局部贴图错误,或地面、墙体缺失 在游戏目录中查找 hookshot_damaged_files.txt。当游戏转储不完整时构建程序会生成该文件(不完整约 23.3 GB,完整版本约为 23.8 GB):其中列出了每个受损的游戏文件以及替换该文件的具体文件。请重新转储游戏并基于新转储文件构建;构建完成后该提示文件会被自动移除 转储
Linux Builder Play 在游戏日志生成前即已退出 游戏退出后,检查游戏文件夹中的 hookshot_startup.log,查看最多 64 KiB 的启动标准错误输出及退出状态码。 Linux
“Hookshot 支持版本 e0f3ccfa”或“当前版本不受支持” 请检查选择的游戏文件及其已安装的更新补丁是否正确 版本
游戏秒退,或日志显示“device lost” 请更新显卡驱动。AMD 显卡已知存在偶发崩溃问题(#708, #614) GPU
画面局部缺失,或提示显卡不支持网格着色器(mesh shader) 显卡或驱动不支持网格着色器。请更新显卡驱动;较旧的显卡型号不受支持(#640) GPU
AMD:纹理呈现块状马赛克、天空出现实心矩形或庭院表面异常变暗 尝试启用 RGBA8 纹理临时方案。该选项会占用更多显存 AMD
Linux、AMD:草地与低矮植物忽隐忽现闪烁,且日志提示 not imported (VkResult -13) 与 storage buffer NOT bound 内核 udmabuf 限制(64 MB)小于游戏的部分内存池大小。包含稀疏队列修复的构建版本会改由驱动稀疏队列导入这些内存。在较旧构建中,或日志仍提示 CANNOT be imported 时,请退出游戏并执行 echo 2048 | sudo tee /sys/module/udmabuf/parameters/size_limit_mb,随后重新启动游戏。该配置在重启 PC 后失效;若需每次开机生效,可在 /etc/tmpfiles.d/udmabuf.conf 中添加一行 w /sys/module/udmabuf/parameters/size_limit_mb - - - - 2048 Linux
Linux:游戏无法启动或画面显示异常破坏 游戏需要支持网格着色器的 Vulkan 1.3 驱动。可使用 vulkaninfo | grep mesh 进行检查,正常应列出 VK_EXT_mesh_shader。请更新 Mesa 或 NVIDIA 驱动 Linux
Steam Deck:游戏在 Kokiri Forest 或 Great Deku Tree 中卡死并闪退(journalctl -k 报 gfx_0.0.0 timeout) 在 hookshot_env.txt 中设置 RX_VK_MESH_NOCULL=2c56dc1006942f74 可跳过卡死并正常绘制所有模型(此操作会关闭持续数秒的剔除流程)。设置 RX_VK_SKIP_CODE=2c56dc1006942f74 同样可以跳过,但对应绘制生成的模型会缺失(详见开发指南,#817) Steam Deck
“Your杀毒软件删除了部分构建工具” 这是对未签名程序的误报。请从 Windows 安全中心的“保护历史记录”中恢复文件,或将 %LOCALAPPDATA%\HookshotBuilder 添加至排除项,随后点击“修复” Windows
首次进入新场景时出现卡顿 目前属于正常现象:系统正在后台编译着色器。再次途经同一地点时情况便会好转。你也可以提交你的管线列表,帮助全体玩家消除此类卡顿 着色器
Windows、NVIDIA:着色器准备完成后,每次启动游戏在已知场景仍频繁卡顿 驱动程序的着色器缓存过小,无法容纳所有管线(首次启动会向其中构建约 2 GB 的管线数据)。请在 NVIDIA 控制面板的“管理 3D 设置”中,将“着色器缓存大小”设为“无限制”(或 10 GB)。在 Linux 上,游戏会自动调高驱动程序的上限 着色器
游戏语言显示不正确 修改游戏文件夹中 language.txt 内的语言代码即可。该文件内列出了所有可用代码,后续更新会保留你在此处修改的值 语言

更换驱动前请先查阅日志

游戏目录下的 hookshot_log.txt 记录了最近一次的运行日志。此前四次的运行记录分别保存在 hookshot_log.1.txt 至 hookshot_log.4.txt 中。通过终端启动时则会直接输出到终端窗口。日志每 600 帧可输出一行显存 vk 状态信息。若 Linux Builder Play 在生成该日志前意外关闭,会留下记录最多 64 KiB 启动 stderr 输出的 hookshot_startup.log。

若出现提示 Hookshot 仅支持版本 e0f3ccfa,或该版本不受支持,说明所选的游戏更新补丁不正确。请重新导出版本为 v131072 的程序 0400486024DEC000。若纹理缺失且生成了 hookshot_damaged_files.txt,则表明导出文件不完整。

黑屏、着色器与初次运行卡顿

画面部分缺失或提示显卡不支持网格着色器,说明驱动程序或显卡无法运行网格着色器。请更新驱动程序。旧款显卡仍无法获得支持。在 Linux 上,vulkaninfo 中应当列出 VK_EXT_mesh_shader。AMD 遇到贴图发块的情况可尝试启用 RGBA8 临时修复方案,但这会占用更多显存。首次启动时的卡顿属于着色器预编译现象,再次经过相同场景时便会好转。在搭配 NVIDIA 的 Windows 平台上,过小的着色器缓存会丢弃已构建的管线。NVIDIA 控制面板的设置路径为:管理 3D 设置 -> 着色器缓存大小,设为“无限制”或 10 GB。Linux 则会自动调高驱动程序的限制。

来源