Hookshot Builder のトラブル対処：ビルド・起動・Vulkan

Builder が開かない

Windows は公式 EXE と初回取得のネット接続を確認します。警告は調査し、保護を全面停止しないでください。Linux は x86-64、glibc 2.35+、AVX2、実行権限を確認し、端末でエラーを読みます。旧 ZIP の場合のみ EXE と tools を一緒に保ちます。

ビルド失敗

1. 1

   失敗段階と完全な出力を記録します。

2. 2

   約 60 GB の空き容量と書き込み権限、公式パッケージの完全性を確認します。

3. 3

   ゲームの三つの識別子と入力の完全性を照合します。

4. 4

   最新リリースと同じエラーの Issues を確認します。

未対応のゲーム版

対応バージョンの三つの識別子を照合してください。Hookshot supports build e0f3ccfa なら元のゲームの更新を確認します。名前を変えても内容は変わりません。

黒画面・クラッシュ・欠けた形状

実際に使う GPU のドライバーを更新し、Vulkan 1.3 と Mesh Shaders を確認します。ゲームフォルダーの hookshot_log.txt と過去の .1.txt～.4.txt を参照します。端末起動では端末出力を使います。AMD の device lost 報告はありますが原因を一律に決めつけないでください。確認済み版では黒い顔、シェーダー準備、AMD 地形格子を修正していますが、浮く木や Gerudo Valley の穴が残っています。

初回のカクつき

初回や確認済み版への更新後はシェーダーを再準備し、数分かかる場合があります。新しい地域でも初回にカクつき、その後は改善するとの記載があります。VRAM に合わせ品質を下げ、一度に一項目だけ変更します。補間は低い元 FPS の万能な解決ではありません。

Linux の Vulkan 確認

vulkaninfo があれば下の結果に VK_EXT_mesh_shader があるか確認し、全出力で当該 GPU の Vulkan 1.3 も確認します。見つからなければ機能とドライバーを調べます。

vulkaninfo | grep mesh

役立つ報告

• セーブをバックアップし、最新の公式版を試して、既存の Issues で同じ問題を検索します。
• 版、OS、GPU とドライバー、CPU、RAM、ゲーム内の正確な場所、再現手順を記録します。
• 関連ログと、必要なら画像や映像を添付します。ゲームデータ、鍵、生成物は添付しないでください。
• 貢献ガイドに従い英語で報告します。本サイトは公式サポートではありません。