Hookshot Recomp
Linhas do readme14
Ficheiro de loghookshot_log.txt
Linha de versãoe0f3ccfa
Deck sinalizadorRX_VK_MESH_NOCULL

Corrigir travamentos do Hookshot Recomp

Compare a mensagem no ecrã ou a linha no registo com o readme atual. Se o jogo abrir e fechar de imediato, ou se o log indicar "device lost", o readme recomenda atualizar o controlador gráfico. O ficheiro common-issues.md é uma nota antiga, focada sobretudo na v2.0.14, e as suas hiperligações para problemas no GitHub já não abrem.

registo

Linhas 1

despejo

Linhas 1

Linux

Linhas 3

versão

Linhas 1

GPU

Linhas 2

AMD

Linhas 1

Steam Deck

Linhas 1

Windows

Linhas 1

shaders

Linhas 2

idioma

Linhas 1
Tabela de resolução de problemas agrupada por área
O readme atual agrupa as soluções por log, dump, GPU, Linux, shaders e o Steam Deck.

Do sintoma à correção

Sintoma O que fazer Área
Onde se encontra o log? O ficheiro hookshot_log.txt na pasta do jogo guarda a última execução. As quatro sessões anteriores são hookshot_log.1.txt (a anterior) até .4.txt. Iniciado a partir de um terminal, o jogo imprime aí diretamente. A cada 600 fotogramas apresenta uma linha vk: status: com a memória de vídeo em uso face ao permitido pelo controlador e detalhes do DLSS durante a renderização; a indicação de vk acima do limite de memória do controlador avisa quando foi ultrapassado. É seguro partilhar os ficheiros de log tal como estão: a pasta pessoal é convertida em ~ (%USERPROFILE% no Windows) e o seu nome de utilizador em <user> nos caminhos, preservando o resto; o ficheiro --log do builder funciona da mesma forma registo
Um local apresenta texturas erradas ou não tem chão nem paredes Verifique o arquivo hookshot_damaged_files.txt na pasta do jogo. A compilação gera esse arquivo quando o dump do jogo está incompleto (cerca de 23.3 GB, contra cerca de 23.8 GB de um arquivo completo): ele lista cada arquivo danificado e o substituto aplicado. Extraia o jogo novamente e compile a partir do novo dump; o arquivo será então removido despejo
O botão Jogar da Linux Builder fechou antes da geração do log do jogo Após o jogo fechar, consulte o ficheiro hookshot_startup.log na pasta do jogo para ver até 64 KiB do stderr inicial e o respetivo código de saída. Linux
"Hookshot suporta a build e0f3ccfa" ou "Esta versão não é suportada" Confirme que selecionou o jogo correto com a devida atualização instalada versão
O jogo abre e fecha de imediato, ou o log apresenta "device lost" Atualize o controlador gráfico. Existem falhas conhecidas em placas AMD (#708, #614) GPU
Faltam partes da imagem ou surge um aviso de que a placa gráfica não suporta mesh shaders A placa gráfica ou o respetivo controlador não suportam mesh shaders. Atualize o controlador; placas mais antigas não são suportadas (#640) GPU
AMD: texturas com blocos, retângulos sólidos no céu ou superfícies de pátio anormalmente escuras Experimente a solução alternativa de texturas RGBA8. Consome mais memória gráfica AMD
Linux, AMD: a relva e as plantas pequenas piscam ou desaparecem, e o log indica not imported (VkResult -13) e storage buffer NOT bound O limite de udmabuf do kernel (64 MB) é inferior a alguns pools de memória do jogo. As builds com a correção de sparse-queue importam-nos através da fila esparsa do controlador. Em builds mais antigas, ou se o log continuar a indicar CANNOT be imported, feche o jogo e execute echo 2048 | sudo tee /sys/module/udmabuf/parameters/size_limit_mb, iniciando-o novamente a seguir. A definição vigora até reiniciar o PC; a linha w /sys/module/udmabuf/parameters/size_limit_mb - - - - 2048 em /etc/tmpfiles.d/udmabuf.conf aplica-a em cada arranque Linux
Linux: o jogo não arranca ou a imagem apresenta falhas visuais graves O jogo requer um controlador Vulkan 1.3 compatível com mesh shaders. Verifique com vulkaninfo | grep mesh: deve listar VK_EXT_mesh_shader. Atualize o Mesa ou o controlador da NVIDIA Linux
Steam Deck: o jogo bloqueia e encerra no Kokiri Forest ou no Great Deku Tree (tempo limite gfx_0.0.0 em journalctl -k) Definir RX_VK_MESH_NOCULL=2c56dc1006942f74 em hookshot_env.txt permite ultrapassar o problema desenhando todos os modelos (desativando a fase de oclusão que demora segundos). Definir RX_VK_SKIP_CODE=2c56dc1006942f74 também resolve, mas os modelos originados por essas chamadas deixam de ser desenhados (consulte o guia de desenvolvimento, #817) Steam Deck
"O antivírus do Your removeu parte das ferramentas de compilação" Falso alarme habitual em programas sem assinatura. Restaure os ficheiros a partir do Histórico de proteção da Segurança do Windows ou adicione %LOCALAPPDATA%\HookshotBuilder às exclusões e carregue em Reparar Windows
Soluços na primeira vez que uma área ou elemento é carregado Comportamento expectável por agora: os shaders estão a ser preparados. A fluidez normaliza ao voltar a passar pelo mesmo sítio. Pode ajudar a eliminar este problema para todos os utilizadores: partilhe a sua lista de condutas shaders
Windows, NVIDIA: soluços em todos os arranques em locais já visitados, mesmo após os shaders terem sido compilados O cache de sombreadores do driver é pequeno demais para reter tudo (a primeira inicialização gera cerca de 2 GB de pipelines). No Painel de Controle da NVIDIA, em Gerenciar configurações 3D, defina o Tamanho do cache de sombreador como Ilimitado (ou 10 GB). No Linux, o próprio jogo ajusta esse limite do driver shaders
O jogo está no idioma errado Altere o código em language.txt na pasta do jogo. O ficheiro lista todas as opções disponíveis, e as atualizações preservam a que tiver configurado idioma

Consulte o log antes de alterar controladores

O arquivo hookshot_log.txt na pasta do jogo corresponde à última sessão. As quatro execuções anteriores ficam salvas de hookshot_log.1.txt a hookshot_log.4.txt. Ao iniciar pelo terminal, a saída é exibida diretamente nele. A cada 600 quadros, o registro pode incluir uma linha de status do Vulkan referente à memória de vídeo. Se o botão Jogar da Linux Builder fechar antes da criação desse log, será gerado o hookshot_startup.log, com até 64 KiB de saída de erro de inicialização.

Uma mensagem indicando que o Hookshot suporta a build e0f3ccfa, ou que esta versão não é suportada, significa que a atualização do jogo selecionada está incorreta. Extraia novamente o dump do programa 0400486024DEC000 na atualização v131072. Texturas em falta acompanhadas do ficheiro hookshot_damaged_files.txt indicam um dump incompleto.

Ecrãs pretos, shaders e soluços no primeiro arranque

Falhas em partes da imagem ou avisos indicando ausência de suporte a mesh shaders significam que a placa de vídeo ou o driver não oferecem suporte ao recurso. Atualize o driver. Placas mais antigas permanecem sem suporte. No Linux, o comando vulkaninfo deve listar VK_EXT_mesh_shader. Texturas com aspecto quadriculado em AMD podem usar a alternativa RGBA8, que exige mais memória gráfica. Engasgos na primeira execução decorrem da compilação de shaders e diminuem ao passar pelo mesmo local novamente. No Windows com NVIDIA, caches de shader pequenos descartam pipelines compiladas previamente. No painel de controle da NVIDIA, vá em Gerenciar configurações 3D, Tamanho do cache de sombreador e selecione Ilimitado ou 10 GB. No Linux, o próprio jogo eleva o limite definido pelo driver.

Fontes