Solução de problemas do Hookshot Builder: compilação e Vulkan
Comece por versão, mensagem exata e hardware. Nem todo bug experimental terá solução garantida.
Nesta página+
Builder não abre
Windows: EXE oficial e conexão inicial. Investigue alertas sem desligar proteção global. Linux: x86-64, glibc 2.35+, AVX2 e permissão de execução; use terminal para ler erro. Só ZIP antigo exige tools junto do EXE.

Ilustração didática original · com auxílio de IA
Encontre a próxima verificaçãoFonteLicença e atribuiçãoDescrição em texto
- Se a compilação falhar: Entrada → Versão → Espaço livre → Log
- Se houver falhas na imagem: Driver · Vulkan 1.3 · Mesh shaders
- Registre um relato reproduzível: Versão · Sistema · GPU / Driver · CPU · RAM · Log + Etapas
Falha na compilação
- 1
Anote etapa e saída completa.
- 2
Confira cerca de 60 GB, permissão e pacote oficial íntegro.
- 3
Compare três identificadores e entrada completa.
- 4
Pesquise o erro nos releases e problemas atuais.
Versão incompatível
Compare os identificadores na página de versão. Hookshot supports build e0f3ccfa pede verificar o jogo e o update. Renomear não altera conteúdo.
Tela preta, crash e geometria ausente
Atualize o driver da GPU usada e confirme Vulkan 1.3 e Mesh Shaders. Veja hookshot_log.txt e anteriores hookshot_log.1.txt a .4.txt; no terminal a saída aparece ali. Relatos AMD de device lost não provam causa universal. O release conferido corrige rostos escuros, shaders e grade AMD; árvores flutuantes e buracos de Gerudo Valley permanecem.
O autor do relato descreve cintilação e imagem duplicada ao alterar o ritmo e a geração de quadros.
Gravação da comunidade de uma falha em uma compilação anterior. Não é um tutorial de instalação nem comprova uma falha ou correção na versão atual.
Etapas para investigar e relatar
- Faça backup dos saves, teste a versão oficial mais recente e procure o mesmo problema nas Issues.
- Anote versão, sistema, GPU e driver, CPU, RAM, local exato no jogo e etapas para reproduzir.
- Anexe os logs relevantes e, se necessário, uma captura ou vídeo. Não anexe dados do jogo, chaves ou resultados da compilação.
- Envie o relato em inglês conforme o guia de contribuição. Este site não é o suporte oficial.
O autor do relato descreve a falta do chão ao entrar em um buraco na Floresta Perdida. Informe a localização exata ao relatar um problema de renderização.
Gravação da comunidade de uma falha em uma compilação anterior. Não é um tutorial de instalação nem comprova uma falha ou correção na versão atual.
Etapas para investigar e relatar
- Faça backup dos saves, teste a versão oficial mais recente e procure o mesmo problema nas Issues.
- Anote versão, sistema, GPU e driver, CPU, RAM, local exato no jogo e etapas para reproduzir.
- Anexe os logs relevantes e, se necessário, uma captura ou vídeo. Não anexe dados do jogo, chaves ou resultados da compilação.
- Envie o relato em inglês conforme o guia de contribuição. Este site não é o suporte oficial.
Engasgos iniciais
O primeiro início e a atualização conferida preparam shaders por alguns minutos. Áreas novas ainda podem engasgar na primeira visita e melhorar depois. Adapte qualidade à VRAM e mude uma opção por vez. Interpolação não garante melhor taxa nativa.
Conferir Vulkan no Linux
Com vulkaninfo instalado, procure VK_EXT_mesh_shader neste comando e Vulkan 1.3 na saída completa do dispositivo. Se faltar, confira placa e driver.
vulkaninfo | grep meshRelatório útil
- Faça backup dos saves, teste a versão oficial mais recente e procure o mesmo problema nas Issues.
- Anote versão, sistema, GPU e driver, CPU, RAM, local exato no jogo e etapas para reproduzir.
- Anexe os logs relevantes e, se necessário, uma captura ou vídeo. Não anexe dados do jogo, chaves ou resultados da compilação.
- Envie o relato em inglês conforme o guia de contribuição. Este site não é o suporte oficial.
Fontes oficiais
Conteúdo conferido com o README e as notas oficiais. Os guias se baseiam em documentação; não testamos o programa de forma independente em hardware.
- README do projeto
- Notas da versão
- Histórico antigo de alterações
- Guia de contribuição
- Guia de desenvolvimento
- Licença e avisos de terceiros
- Problemas do projeto
Este guia foi escrito de forma independente e não é um documento oficial do projeto Hookshot.