Hookshot Recomp
說明文件條目14
日誌檔案hookshot_log.txt
版本資訊行e0f3ccfa
Deck 旗標RX_VK_MESH_NOCULL

Hookshot Recomp 閃退修復

請將畫面提示或日誌內容對照最新版說明文件。若遊戲啟動後立即閃退,或日誌顯示「device lost」,說明文件建議更新顯示卡驅動程式。common-issues.md 是主要針對 v2.0.14 的舊版紀錄,其中的 GitHub 問題連結已失效。

日誌

筆數 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: over... 則代表已超出驅動程式配額。日誌可直接分享:路徑中的家目錄已替換為 ~(在 Windows 上為 %USERPROFILE%),使用者名稱已替換為 <user>,其餘路徑維持原樣;建置器的 --log 記錄亦同。 日誌
特定場景貼圖異常,或地面與牆面消失 請在遊戲資料夾中尋找 hookshot_damaged_files.txt。當遊戲 Dump 檔不完整時(約 23.3 GB,完整大小約 23.8 GB),建置程序會產生此檔案:內容列出每筆損壞的遊戲檔案及替換檔案。請重新 Dump 遊戲並使用全新 Dump 檔重新建置,該記錄檔隨後便會自動刪除 轉儲
Linux Builder Play 在產生遊戲日誌前即關閉 遊戲結束後,請檢查遊戲資料夾中的 hookshot_startup.log,查看最多 64 KiB 的啟動錯誤輸出與結束狀態代碼。 Linux
顯示「Hookshot 支援版本組建 e0f3ccfa」或「不支援此版本」 請確認所選擇的遊戲已安裝對應的正確更新檔 版本
遊戲開啟後立刻關閉,或日誌顯示「device lost」 請更新顯示卡驅動程式。AMD 顯示卡有已知當機問題(#708、#614) GPU
畫面部分元件缺漏,或提示顯示卡不支援網格著色器 顯示卡或驅動程式不支援網格著色器。請更新驅動程式;舊款顯示卡不受支援(#640) GPU
AMD:貼圖呈現區塊狀破圖、天空出現色塊矩形,或庭院表面異常變暗 請嘗試開啟 RGBA8 貼圖因應方案(會消耗較多視訊記憶體) AMD
Linux、AMD:草地與小型植被閃爍不定,日誌顯示 not imported (VkResult -13) 與 storage buffer NOT bound 核心的 udmabuf 限制(64 MB)小於遊戲的部分記憶體集區。已套用稀疏佇列(sparse-queue)修復的版本會改由驅動程式的稀疏佇列匯入。在舊版本中,或者若記錄檔仍顯示 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 在產生該日誌前即關閉,則會留下 hookshot_startup.log,記錄最多 64 KiB 的啟動 stderr 錯誤訊息。

若出現 Hookshot 僅支援版本組建 e0f3ccfa 或版本不支援的提示,代表所選遊戲更新版本有誤。請重新轉儲更新版本為 v131072 的程式 0400486024DEC000。若遺失貼圖且出現 hookshot_damaged_files.txt,則代表轉儲不完整。

黑畫面、著色器與初次執行卡頓

畫面缺失或提示顯示卡不支援網格著色器,表示驅動程式或顯示卡缺少網格著色器功能。請更新驅動程式;較舊的顯示卡仍無法支援。在 Linux 上,vulkaninfo 應列出 VK_EXT_mesh_shader。若 AMD 出現塊狀貼圖破圖,可嘗試啟用 RGBA8 因應方案,但會消耗更多顯示記憶體。初次啟動卡頓屬於著色器編譯過程,再次經過相同場景後即會改善。在搭載 NVIDIA 的 Windows 上,著色器快取空間不足會導致已建置的管線被清除。NVIDIA 控制面板設定路徑為:管理 3D 設定 > 著色器快取大小,設為「無限制」或「10 GB」。Linux 則會自動提高驅動程式上限。

來源