Hookshot Recomp 闪退修复
请将屏幕报错或日志行与当前自述文件进行比对。如果游戏启动即闪退,或日志提示 device lost,自述文件建议更新显卡驱动。common-issues.md 为旧版说明,主要针对 v2.0.14,其附带的 GitHub issue 链接现已失效。
转储
Linux
版本
GPU
AMD
Steam Deck
Windows
着色器
语言
现象与处理
| 现象 | 处理办法 | 类别 |
|---|---|---|
| 日志文件在哪里? | 游戏文件夹内的 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 则会自动调高驱动程序的限制。