Hookshot Recomp
Readme項目一覧14
ログファイルhookshot_log.txt
バージョン表記e0f3ccfa
DeckフラグRX_VK_MESH_NOCULL

Hookshot Recomp が落ちる

画面上の表示やログ出力を最新のreadmeと照合してください。ゲームが起動直後に落ちる場合や、ログに「device lost」と記録されている場合、readmeではグラフィックドライバの更新を案内しています。common-issues.mdは主にv2.0.14を扱った古い文書であり、記載されているGitHubのIssueリンクは無効です。

ログ

件数 1

ダンプ

件数 1

Linux

件数 3

バージョン

件数 1

GPU

件数 2

AMD

件数 1

Steam Deck

件数 1

Windows

件数 1

シェーダー

件数 2

言語

件数 1
トラブルシューティング項目の一覧表(領域別)
最新のreadmeでは、修正手順がログ、ダンプ、GPU、Linux、シェーダー、およびSteam Deckごとに分類されています。

症状と対処

症状 対処 分野
ログはどこにありますか? ゲームフォルダ内のhookshot_log.txtに前回の実行ログが保持されます。それ以前の4回分はhookshot_log.1.txt(直近)から.4.txtに保存されます。ターミナルから起動した場合はそちらに出力されます。600フレームごとに「vk: status:」行が出力され、ドライバの許容量に対するビデオメモリ使用量や、描画中のDLSSの詳細が記録されます。「vk:」の許容量超過ログは、上限を超えたタイミングを示します。ログはパス内のホームフォルダが~(Windowsでは%USERPROFILE%)、ユーザー名が<user>に置換され、残りのパス構造はそのまま保持されるため、安全に共有できます。ビルダーの--logファイルも同様に出力されます。 ログ
特定箇所のテクスチャがおかしい、または床や壁が表示されない ゲームフォルダー内のhookshot_damaged_files.txtを確認してください。ゲームダンプが不完全(完全な状態が約23.8 GBに対し約23.3 GB)な場合にビルドによって書き出され、破損した各ゲームファイルと代替配置されたファイルが記録されます。ゲームを再ダンプし、新しいダンプから再ビルドすると、このファイルは削除されます ダンプ
ゲームログが生成される前にLinux Builder Playが終了した ゲーム終了後、ゲームフォルダ内のhookshot_startup.logを確認してください。最大64 KiBの起動時stderrと終了ステータスが記録されています。 Linux
「Hookshot supports build e0f3ccfa」または「This version isn't supported」と表示される アップデートが適用された正しいゲームデータを選択しているか確認してください バージョン
ゲームが起動直後に落ちる、またはログに「device lost」と記録される グラフィックドライバを更新してください。AMDカードでは既知のクラッシュが報告されています(#708、#614) GPU
画面の一部が欠落している、またはカードがメッシュシェーダー非対応である旨の警告が出る カードまたはドライバがメッシュシェーダーに対応していません。ドライバを更新してください。旧世代のカードは非対応です(#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 Securityの「保護の履歴」からファイルを復元するか、%LOCALAPPDATA%\HookshotBuilder を除外リストに追加して「修復」を押してください Windows
初めて見る場面でスタッター(画面のカクつき)が発生する シェーダーを事前生成しているため、現時点では正常な挙動です。同じ場所を再度通過すると改善されます。パイプラインリストを提供していただくことで、全体のカクつき改善に貢献できます シェーダー
Windows、NVIDIA: シェーダー生成済みにもかかわらず、通過済みの場所で起動するたびにカクつく ドライバーのシェーダーキャッシュ容量が小さすぎるため、すべてを保持できません(初回起動時に約2 GBのパイプラインがキャッシュ内に構築されます)。NVIDIAコントロールパネルの「3D 設定の管理」で、「シェーダー キャッシュ サイズ」を「無制限」(または「10 GB」)に設定してください。Linuxでは、ゲーム側がドライバーの制限を自動的に引き上げます シェーダー
ゲームが意図しない言語で表示される ゲームフォルダ内のlanguage.txtに記載されているコードを変更してください。ファイル内に全言語が一覧表示されており、アップデート時も設定したコードが保持されます 言語

ドライバを変更する前にログを確認

ゲームフォルダー内のhookshot_log.txtは直前の起動ログです。その前の4回分のログはhookshot_log.1.txtからhookshot_log.4.txtに保存されます。ターミナルから起動した場合はそちらへ出力されます。ログには600フレームごとにビデオメモリのvkステータス行を出力できます。ログが作成される前に終了したLinux Builder Playの場合、起動時のstderrが最大64 KiBまでhookshot_startup.logに残されます。

Hookshotがビルドe0f3ccfaに対応している旨のメッセージや、バージョン非対応のエラーが表示される場合、指定したゲームのアップデートが誤っています。プログラム0400486024DEC000をアップデートv131072で再度ダンプしてください。テクスチャ抜けとともにhookshot_damaged_files.txtが生成されている場合は、ダンプが不完全であることを示しています。

ブラックスクリーン、シェーダー、初回動作のカクつき

画面の一部が表示されない、またはカードがメッシュシェーダー非対応である旨のメッセージが出る場合は、ドライバーまたはカードがメッシュシェーダーに対応していません。ドライバーを更新してください。古いカードは引き続き非対応です。Linuxでは、vulkaninfoでVK_EXT_mesh_shaderがリストされるか確認してください。AMDのブロック状テクスチャはRGBA8回避策を試すことができますが、グラフィックメモリの消費量が増加します。初回プレイ時のカクつきはシェーダーのコンパイル処理によるもので、同じ場所を再度通過すると解消されます。NVIDIAを搭載したWindows環境では、シェーダーキャッシュが小さいと構築済みパイプラインが破棄されてしまいます。NVIDIAコントロールパネルの設定手順は、「3D 設定の管理」→「シェーダー キャッシュ サイズ」を「無制限」または「10 GB」にします。Linuxはドライバーの制限を自動で引き上げます。

出典