Hookshot Recomp 충돌 해결
화면에 표시된 문구나 로그 라인을 현재 readme 내용과 대조해 보세요. 게임이 켜지자마자 꺼지거나 로그에 device lost가 나타난다면 그래픽 드라이버를 업데이트해야 합니다. common-issues.md는 주로 v2.0.14를 다룬 구버전 문서이며, 여기에 포함된 GitHub 이슈 링크는 현재 연결되지 않습니다.
덤프
Linux
버전
GPU
AMD
Steam Deck
Windows
셰이더
언어
증상과 해결
| 증상 | 조치 | 영역 |
|---|---|---|
| 로그 파일은 어디에 있나요? | 게임 폴더의 hookshot_log.txt에 가장 최근 실행 기록이 저장됩니다. 이전 4회의 실행 기록은 hookshot_log.1.txt(직전 기록)부터 .4.txt까지 순환 저장됩니다. 터미널에서 실행한 경우 로그가 터미널 화면에 출력됩니다. 매 600프레임마다 vk: status: 라인이 출력되어 드라이버 허용 한도 대비 사용 중인 비디오 메모리와 렌더링 중 DLSS의 상세 정보를 확인할 수 있습니다. 드라이버의 비디오 메모리 허용량을 초과하면 vk: over 로그가 기록됩니다. 파일 경로의 홈 폴더는 ~(Windows에서는 %USERPROFILE%)로, 사용자 이름은 <user>로 치환되어 나머지 경로만 유지되므로 로그를 그대로 공유해도 안전합니다. 빌더의 --log 파일도 동일한 방식으로 기록됩니다. | 로그 |
| 특정 장소의 텍스처가 잘못되었거나 바닥 또는 벽면이 보이지 않는 경우 | 게임 폴더에서 hookshot_damaged_files.txt 파일을 확인하세요. 게임 덤프가 불완전할 때(정상 크기는 약 23.8 GB이나 23.3 GB 정도에 그칠 때) 빌더가 이 파일을 생성하며, 손상된 각 게임 파일과 이를 대체한 파일 목록이 적혀 있습니다. 게임을 다시 덤프한 뒤 새 덤프로 다시 빌드하면 해당 파일이 사라집니다. | 덤프 |
| 게임 로그가 생성되기 전에 Linux Builder 플레이 창이 닫힘 | 게임이 종료된 후 게임 폴더의 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)이 게임의 일부 메모리 풀보다 작아서 발생하는 현상입니다. 스파스 큐(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 백신 프로그램이 빌드 도구 일부를 삭제했습니다" | 서명되지 않은 프로그램에 대한 오탐(False Positive)입니다. Windows 보안의 보호 기록에서 파일을 복원하거나 %LOCALAPPDATA%\HookshotBuilder 폴더를 검사 예외 대상에 추가한 후 Repair를 누르세요. | 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 플레이 창이 닫히면 최대 64KiB 크기의 시작 stderr 기록인 hookshot_startup.log가 남습니다.
Hookshot가 빌드 e0f3ccfa를 지원한다는 메시지나 현재 버전이 지원되지 않는다는 메시지가 뜬다면 선택한 게임 업데이트 버전이 잘못된 것입니다. 프로그램 0400486024DEC000를 업데이트 v131072 상태로 다시 덤프하세요. hookshot_damaged_files.txt와 함께 텍스처가 누락되는 현상은 덤프가 불완전함을 의미합니다.
블랙스크린, 셰이더 및 첫 실행 스터터링
화면 일부가 누락되거나 그래픽카드가 메시 셰이더를 지원하지 않는다는 오류 메시지가 뜨면 그래픽카드나 드라이버가 메시 셰이더를 처리하지 못하는 상태입니다. 그래픽 드라이버를 업데이트하세요. 구형 그래픽카드는 계속 지원되지 않습니다. Linux 환경에서는 vulkaninfo 출력에 VK_EXT_mesh_shader가 표시되어야 합니다. AMD 텍스처 깨짐 현상이 생기면 그래픽 메모리를 더 많이 소모하는 RGBA8 임시 해결책을 적용해 볼 수 있습니다. 첫 실행 시 버벅임은 셰이더 생성 과정에서 발생하며, 동일한 장소를 다시 지나갈 때는 완화됩니다. Windows 환경에서 NVIDIA 사용 시 셰이더 캐시가 작으면 이미 빌드된 파이프라인이 누락될 수 있습니다. NVIDIA 제어판에서 3D 설정 관리로 들어간 뒤, 셰이더 캐시 크기를 '무제한' 또는 10 GB로 설정하세요. Linux 환경에서는 드라이버 제한치를 자체적으로 상향합니다.