Windows 10/11 x64 または Linux x86_64（Steam Deck を含む）で Hookshot v2.0.11 をセットアップするには、この4段階のエンジニアリング手順に従ってください。NotRexed/Hookshot はクリーンルーム方式の静的リコンパイルであるため、まず『ゼルダの伝説 Ocarina of Time』の復号済み Nintendo Switch 2 ダンプ（Title ID 0400486024DEC000、パッチ v131072 適用済み、ExeFS main NSO SHA-1 プレフィックス e0f3ccfa）を verify し、HookshotBuilder を実行して RomFS アセットの抽出とネイティブ実行ファイルのコンパイルを行い、お使いの GPU VRAM 容量に合わせてゲーム内 Insert / F1 グラフィックスオーバーレイを調整した上で、scripts/oot_saves.py 経由でセーブデータを管理・移行する必要があります。
正規にダンプした Switch 2 リメイク版 Ocarina of Time を、単一のマージ済み .nup バンドル、または romfs/ と exefs/ を含む展開済みディレクトリとして用意します。Hookshot は7つのダンプシグナルを検査し、アップデート v131072 適用済み・ExeFS main NSO ビルド ID e0f3ccfa56256410941279ef0b2501356be2222c の Title ID 0400486024DEC000 を要求します。
TitleID 0400486024DEC000 / v131072Windows では、HookshotBuilder.exe をASCII/UTF-8書き込み可能なフォルダ（v2.0.11 で非ASCIIパス問題#1176修正済み）に配置してダンプを選択すると、自動的に builder-parts を取得してhookshot.exeをコンパイルします。Linux/Steam Deck では、chmod +x Hookshot-v2.0.11-x86_64.AppImage を実行して起動し、work/dump/の展開とバイナリのリンクを行います。
HookshotBuilder.exe / AppImage --extractゲーム内で Insert または F1 を押して Dear ImGui 設定オーバーレイを開きます。お使いの物理 VRAM に合わせて graphics_preset を設定し（Low = 4 GB、Medium = 6 GB、High = 8 GB、Max = 10+ GB）、Native TAA、NVIDIA DLSS、AMD FSR 3.1、または Intel XeSS を選択し、目標フレームレートを 60/120 FPS に設定して、SDL3 コントローラーのボタン表示とジャイロ照準を設定します。
graphics_preset / upscaler_mode / fps_limitHookshot は3つの64 KB手動セーブスロット（save_00.sav ～ save_02.sav）と autosave.sav を %APPDATA%/Hookshot/saves（Windows）または ~/.local/share/Hookshot/saves（Linux）に保存します。python scripts/oot_saves.py を実行することで、自動バックアップを取りながら Hookshot と Switch 2 エミュレータ（Lichii、Eglantine、Orchid、NX2navi）間でセーブデータを双方向に移行できます。
scripts/oot_saves.py (export-json / import-json / verify)全10件の設定項目をセットアップ段階またはメニュータブ（1. アセット抽出、2. グラフィックタブ (Insert / F1)、3. 操作＆カメラタブ、4. セーブ管理）ごとに絞り込めます。各行には対応する hookshot_options.ini / CLIキー、設定可能値、初期値、VRAM への影響を記載しています。
| 設定項目 / 処理ステップ | Section | 設定キー / コマンド | 設定可能値 | 初期設定値 | VRAM / ディスク負荷および関連情報 |
|---|---|---|---|---|---|
Switch 2 正規ダンプ検証（0400486024DEC000）HookshotBuilder は RomFS アセットを抽出する前に、パッチ v131072（v1.0.2）適用済みの Title ID 0400486024DEC000 を検証し、main NSO ビルド ID e0f3ccfa56256410941279ef0b2501356be2222c をチェックします。 | 1. アセット展開 | TitleID 0400486024DEC000 / v131072 | NSP、XCI、または展開済み RomFS + ExeFS フォルダ | Build ID e0f3ccfa56256410941279ef0b2501356be2222c | なし（ディスク上の検証処理のみ） |
HookshotBuilder GUI および CLI アセット生成Windows では HookshotBuilder.exe、Linux では chmod +x AppImage を実行し、ネイティブ Hookshot 実行ファイルと同じ階層のassets/フォルダへ RomFS アーカイブを展開します。 | 1. アセット展開 | HookshotBuilder.exe / AppImage --extract | GUI ウィザードまたは CLI --romfs <dir> --out assets | Hookshot バイナリ＋assets/フォルダを生成 | 再パック中に約 14 GB の空きディスク容量が必要 |
グラフィックス Quality ＆ VRAM ティア別プリセット4 GB から 10+ GB の GPU 向けに、内部レンダリング解像度、シャドウマップ解像度、および ASTC テクスチャプール割り当てを調整する Insert / F1 オーバーレイ内のマスタープリセット。 | 2. グラフィック設定 (Insert / F1) | graphics_preset (hookshot_options.ini) | 低（4 GB）、中（6 GB）、高（8 GB）、最高（10+ GB） | Medium（1.0x 1080p、2048px シャドウ、2.5 GB プール） | 1.5 GB（Low）から最大 5.0 GB（Max）のテクスチャプール |
テンポラルアップスケーラー＆アンチエイリアスモードネイティブの一時的アンチエイリアシング（TAA）、または NVIDIA DLSS Super Resolution、AMD FidelityFX Super Resolution 3.1.3、Intel XeSS 1.3 などのハードウェア/コンピュートアップスケーラーを選択します。 | 2. グラフィック設定 (Insert / F1) | upscaler_mode / upscaler_quality | Native TAA, DLSS, FSR 3.1, XeSS (Quality/Balanced/Perf/Ultra Perf) | Native TAA（100% スケール） | 描画ターゲットの VRAM 負荷を25%～55%削減 |
目標フレームレート（30 / 60 / 120 / 無制限）エンジンのデルタタイムペースとスワップチェーンの表示レートを制御します。30 FPS を超える設定ではサブフレームアクター補間が適用されます。 | 2. グラフィック設定 (Insert / F1) | fps_limit / vsync_mode | 30 FPS、60 FPS、120 FPS、制限なし (V-Sync On/オフ/Mailbox) | 60 FPS + V-Sync On | トリプルバッファリングにより 1440p で約 90 MB 増加 |
カスケードシャドウ解像度＆フィルタリングハイラル平原やダンジョン内のライティングに使用されるディレクショナルカスケードシャドウマップの解像度を調整します。 | 2. グラフィック設定 (Insert / F1) | shadow_resolution | 1024px（低）、2048px（中/高）、4096px（最高） | 2048px | 4096px カスケードには約 380 MB の追加 VRAM が必要 |
アスペクト比＆ウルトラワイド HUD ピラーボックスネイティブ16:9、16:10（Steam Deck 1280x800）、21:9、32:9のビューポートに対応しつつ、ハートやボタンなどの 2D HUD 表示を16:9セーフフレーム内に正確に収めます。 | 2. グラフィック設定 (Insert / F1) | aspect_ratio / hud_safe_frame | Auto、16:9、16:10、21:9、32:9（HUD センター固定または画面端） | Autoビューポート ＋ 16:9センター固定 HUD | 21:9設定時はフレームバッファメモリが約34%増加 |
フリーカメラ感度＆ジャイロモーション照準右スティックカメラの X/Y軸反転、デッドゾーン、視野角（FOV）倍率（0.8x～1.3x）、弓・パチンコ・フックショット照準時の SDL3 ジャイロ操作を設定します。 | 3. 操作とカメラ設定 | camera_fov / gyro_enabled / gyro_sensitivity | FOV 0.8x〜1.3x、ジャイロ オフ/エイム時のみ/Always On | FOV 1.0x、ジャイロ エイム時のみ (Switch Pro / DualSense) | なし |
SDL3 Controller ホットプラグ、ボタン表示＆キーボード割り当てXbox、DualShock/DualSense、Switch Pro、Steam Deck、WASD ＋マウスごとのボタンリマップ機能に加え、F11 全画面表示やCtrl+Rクイックリロードのショートカットを提供します。 | 3. 操作とカメラ設定 | button_glyphs / keybindings | 自動、Nintendo（A/B/X/Y）、Xbox、PlayStation ボタン表示 | Insert/F1 オーバーレイ、F11 全画面表示、WASD ＋ マウス | なし |
セーブファイルの保存場所＆ scripts/oot_saves.py 変換ツールユーザーデータディレクトリ内に3つのセーブスロット（save_00.sav ～ save_02.sav）と autosave.sav を保存し、scripts/oot_saves.py を介して Switch 2 バイナリセーブとJSONの双方向変換を行います。 | 4. セーブデータ管理 | scripts/oot_saves.py (export-json / import-json / verify) | save_00.sav、save_01.sav、save_02.sav、autosave.sav（各64 KB） | %APPDATA%/Hookshot/saves または ~/.local/share/Hookshot/saves | なし |
1つの C シャードをコンパイルする前に、nx2/dump.py と HookshotBuilder は入力ダンプに対して7つの暗号および構造シグナルを検証します。ゲームはアップデート v131072（v1.0.2）が統合された Title ID 0400486024DEC000 を持つ『ゼルダの伝説 Ocarina of Time』の Nintendo Switch 2 リメイク版である必要があります。具体的には、ExeFS main NSO バイナリが Build ID プレフィックス e0f3ccfa（完全な SHA-1 e0f3ccfa56256410941279ef0b2501356be2222c、非圧縮時 51.0 MB）を保持していなければなりません。パッチ未適用の v0 ベースダンプ、N64/GameCube ROM、または 3DS CIA を指定した場合、HookshotBuilder は Unsupported ExeFS Build ID メッセージ（#1176 / #990）を出力して即座に処理を中断します。
初回起動時、ビルダーは26.2 GBのRomFSアーカイブをwork/dump/romfsに展開し、work/sa/gen/内に57個のC変換チャンクを生成します。最新の8コアデスクトップCPUなら、初回のClang/LLDコンパイルは10〜25分で完了します（携帯型APUでは最大45分）。v2.0.8以降（#860）、コンパイル済みゲームを起動すると即座にSDL3ウィンドウが開き、リアルタイムのシェーダーパイプラインコンパイルバーが表示されるため（パイプライン予測の上限は90秒）、画面に何も表示されないバックグラウンド処理の完了を待つ必要がなくなりました。
プレイ中いつでも Insert または F1 を押すと、Hookshot のネイティブ Dear ImGui 設定メニューが開き（設定は hookshot_options.ini に保存）、安定性において最も重要な設定項目は graphics_preset です。4 GB の GPU（GTX 1650 や共有 APU プールなど）では Low（1.5 GB テクスチャプール、1024px シャドウ）を、6 GB の GPU では Medium（2.5 GB プール、2048px シャドウ）を、8 GB の GPU では High を選択し、10+ GB の GPU では Max（4096px シャドウカスケード）を選択可能です。全 GPU で内蔵の AMD FSR 3.1.3（FidelityFX SDK 1.1.4）を利用できるほか、NVIDIA RTX ユーザーは実行ファイルと同じ階層に nvngx_dlss.dll を配置することで DLSS Super Resolution（NGX SDK 310.9.16、Transformer プリセット K/M/L）を有効化できます。
Hookshot と Switch 2 エミュレータ（Lichii、Eglantine、Orchid、NX2navi）の間で既存の進行状況を移行するには、リポジトリのルートからpython scripts/oot_saves.py を実行します。ツールが自動的に save_00.sav から save_02.sav、および autosave.sav を検出し、ファイルを変更する前にoot-save-backups/内へタイムスタンプ付きバックアップを作成した上で、プラットフォーム間のセーブヘッダーを安全に変換します。
Windows の場合、セーブデータは %APPDATA%/Hookshot/saves に保存され、hookshot_options.ini は Hookshot.exe と同じフォルダに置かれます。Linux および Steam Deck の場合、セーブデータは ~/.local/share/Hookshot/saves に保存されます（環境変数 RX_SAVE_PATH で変更可能）。
AMD FSR 3.1 は Hookshot に直接組み込まれており、すべての GPU で追加設定なしで動作します。RTX GPU で NVIDIA DLSS Super Resolution を有効にするには、hookshot.exe と同じフォルダーに nvngx_dlss.dll（NGX SDK 310.9.16 以降）をコピーし、Insert または F1 を押して upscaler_mode を DLSS に切り替えてください。
v2.0.10 より前のバージョンでは、非ASCII文字が含まれる Windows ディレクトリでllvm-mingwを呼び出す際にUTF-8パス処理の不具合（#1176）が存在していました。Hookshot v2.0.11 にアップデートすることで完全に解決します。
Title ID 0400486024DEC000 v131072、Insert/F1 メニュー設定項目、およびコントローラー割り当てに関する主要ソース。
save_00.sav～save_02.savの配置構造、oot-save-backups/、およびscripts/oot_saves.pyに関する一次情報源。
ビルダーのアセット抽出ワークフローおよびバージョンアップグレード互換性に関する一次情報源。