Windows 10/11 x64 또는 Linux x86_64(Steam Deck 포함) 환경에서 Hookshot v2.0.11를 설정하려면 다음 4단계 엔지니어링 절차를 따르세요. NotRexed/Hookshot은 클린룸 방식의 정적 재컴파일 프로젝트이므로, 먼저 복호화된 젤다의 전설 Ocarina of Time의 Nintendo Switch 2 덤프(타이틀 ID 0400486024DEC000, 패치 v131072 적용, ExeFS main NSO SHA-1 접두사 e0f3ccfa)를 verify하고, HookshotBuilder를 실행하여 RomFS 에셋을 추출하고 네이티브 실행 파일을 컴파일한 뒤, 사용자의 GPU VRAM 예산에 맞춰 인게임 Insert / F1 그래픽 오버레이를 조절하고, scripts/oot_saves.py를 통해 세이브 파일을 관리하거나 이전해야 합니다.
합법적으로 덤프한 Ocarina of Time의 Switch 2 리메이크 버전을 단일 병합 .nup 번들이나 romfs/ 및 exefs/가 포함된 압축 해제 폴더 형태로 준비하세요. Hookshot는 7가지 덤프 신호를 검사하며, 업데이트 v131072가 적용된 타이틀 ID 0400486024DEC000과 ExeFS main NSO 빌드 ID e0f3ccfa56256410941279ef0b2501356be2222c를 요구합니다.
TitleID 0400486024DEC000 / v131072On Windows의 경우, HookshotBuilder.exe를 ASCII/UTF-8 경로 폴더에 두고(v2.0.11에서 비-ASCII 경로 이슈 #1176 수정됨) 덤프를 선택하세요. builder-parts를 자동으로 가져와 hookshot.exe를 컴파일합니다. On Linux/Steam Deck에서는 chmod +x Hookshot-v2.0.11-x86_64.AppImage를 실행하여 work/dump/ 압축을 풀고 바이너리를 링크하세요.
HookshotBuilder.exe / AppImage --extract게임 내에서 Insert 또는 F1를 눌러 Dear ImGui 설정 오버레이를 엽니다. graphics_preset를 물리적 VRAM 사양에 맞추고(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개(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)설치 단계 또는 메뉴 탭(1. 에셋 추출, 2. 그래픽 탭(Insert / F1), 3. 조작 및 카메라 탭, 4. 세이브 관리)별로 10개의 설정 항목을 필터링해 확인하세요. 각 행에는 정확한 hookshot_options.ini 또는 CLI 키, 허용 값, 기본값, VRAM 영향이 명시되어 있습니다.
| 옵션 / 파이프라인 단계 | Section | 설정 키 / 명령어 | 허용 값 | 기본값 | VRAM / 디스크 영향 및 관계 |
|---|---|---|---|---|---|
Switch 2 정품 덤프 검증(0400486024DEC000)HookshotBuilder는 RomFS 에셋을 추출하기 전에 패치 v131072(v1.0.2) 적용 타이틀 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를 통해 실행되어 RomFS 아카이브를 네이티브 Hookshot 실행 파일과 함께 로컬 assets/ 폴더로 압축 해제합니다. | 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) 텍스처 풀 |
시간축 업스케일러 및 안티에일리어싱 모드네이티브 시간 축적 앤티앨리어싱 또는 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의 하트/버튼 UI 오버레이를 16:9 세이프 프레임 내에 안정적으로 고정합니다. | 2. 그래픽 탭 (Insert / F1) | aspect_ratio / hud_safe_frame | 자동, 16:9, 16:10, 21:9, 32:9 (HUD 중앙 또는 화면 가장자리) | 자동 뷰포트 + 16:9 중앙 HUD | 21:9 설정 시 프레임버퍼 메모리 약 34% 증가 |
자유 카메라 감도 및 자이로 모션 조준우측 스틱 카메라 X/Y 반전, 데드존, 화각(FOV) 배율(0.8배~1.3배), 그리고 활·새총·훅샷 조준 시 작동하는 SDL3 자이로스코프 모션 조준을 설정합니다. | 3. 조작 및 카메라 탭 | camera_fov / gyro_enabled / gyro_sensitivity | FOV 0.8x~1.3x, 자이로 끄기/조준 시에만/항상 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 | 없음 |
단 하나의 C 샤드를 컴파일하기 전, nx2/dump.py와 HookshotBuilder는 입력된 덤프를 대상으로 7가지 암호화 및 구조적 신호를 검증합니다. 게임은 업데이트 v131072(v1.0.2)이 통합된 타이틀 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는 지원되지 않는 ExeFS Build ID 메시지를 띄우며 즉시 중단됩니다(#1176 / #990).
On 최초 실행 시 빌더가 work/dump/romfs 경로에 26.2 GB 분량의 RomFS 아카이브를 추출하고, work/sa/gen/ 디렉터리에 57개의 C 변환 청크를 생성합니다. On 최신 8코어 데스크톱 CPU 기준 최초 1회 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, 트랜스포머 프리셋 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/ 폴더에 타임스탬프가 포함된 백업을 생성한 뒤 플랫폼 간 세이브 헤더를 깔끔하게 변환합니다.
On Windows에서 세이브 파일은 %APPDATA%/Hookshot/saves에 저장되며 hookshot_options.ini는 Hookshot.exe와 나란히 위치합니다. On Linux 및 Steam Deck에서는 세이브 파일이 ~/.local/share/Hookshot/saves에 저장됩니다(또는 RX_SAVE_PATH 환경 변수로 재지정 가능).
AMD FSR 3.1는 Hookshot에 직접 컴파일되어 모든 GPU에서 별도 설정 없이 작동합니다. RTX GPU 환경에서 NVIDIA DLSS Super Resolution을 활성화하려면 nvngx_dlss.dll(NGX SDK 310.9.16+) 파일을 hookshot.exe가 있는 폴더로 복사한 후 Insert 또는 F1를 누르고 upscaler_mode를 DLSS로 변경하세요.
v2.0.10 이전 버전에는 비-ASCII Windows 경로에서 llvm-mingw를 호출할 때 UTF-8 경로 처리 버그(#1176)가 있었습니다. Hookshot v2.0.11 버전으로 업데이트하면 완전히 해결됩니다.
타이틀 ID 0400486024DEC000 v131072, Insert/F1 메뉴 옵션, 컨트롤러 매핑 관련 주요 출처.
save_00.sav–save_02.sav 배치, oot-save-backups/ 및 scripts/oot_saves.py에 대한 1차 출처 자료입니다.
빌더 에셋 추출 워크플로 및 버전 업그레이드 호환성에 대한 1차 출처 자료입니다.