Hookshot Recomp
Filas del readme14
Archivo de loghookshot_log.txt
Línea de versióne0f3ccfa
Opción de DeckRX_VK_MESH_NOCULL

Arreglar cierres de Hookshot Recomp

Compara el mensaje en pantalla o en el log con el readme actualizado. Si el juego se abre y se cierra al instante, o si el log indica «device lost», el readme recomienda actualizar el controlador gráfico. common-issues.md es una nota antigua orientada a v2.0.14 cuyos enlaces a issues de GitHub ya no funcionan.

registro

Filas 1

volcado

Filas 1

Linux

Filas 3

versión

Filas 1

GPU

Filas 2

AMD

Filas 1

Steam Deck

Filas 1

Windows

Filas 1

sombreadores

Filas 2

idioma

Filas 1
Tabla de soluciones organizada por categorías
El readme clasifica las soluciones por log, volcado, GPU, Linux, shaders y la Steam Deck.

Del síntoma al arreglo

Síntoma Qué hacer Área
¿Dónde está el archivo de log? hookshot_log.txt en la carpeta del juego guarda la última sesión. Las cuatro ejecuciones previas van de hookshot_log.1.txt (la más reciente) a .4.txt. Si se inicia desde la terminal, el juego mostrará los mensajes allí. Cada 600 fotogramas incluye una línea vk: status: con la memoria de vídeo en uso frente a la asignada por el controlador y detalles de DLSS durante el dibujado; vk: over the driver's video-memory allowance avisa si el juego superó el límite. Puedes compartir los logs sin problemas: la carpeta personal aparece como ~ (%USERPROFILE% en Windows) y el usuario como <user> en sus rutas, manteniendo el resto intacto; el archivo --log del builder aplica el mismo formato. registro
Una zona muestra texturas incorrectas, o falta el suelo o una pared Busca el archivo hookshot_damaged_files.txt en la carpeta del juego. Se genera durante la compilación si el volcado está incompleto (unos 23.3 GB frente a los cerca de 23.8 GB de una copia íntegra), detallando cada archivo dañado y su reemplazo provisional. Vuelve a volcar el juego y compila a partir de la nueva copia para eliminar este aviso. volcado
La opción Jugar de Linux Builder se cerró antes de generar el registro de la partida Tras cerrarse el juego, revisa hookshot_startup.log en la carpeta del juego para consultar los hasta 64 KiB del stderr de inicio y su código de salida. Linux
"Hookshot supports build e0f3ccfa" o "This version isn't supported" Verifica que hayas seleccionado el juego correcto con su correspondiente actualización instalada. versión
El juego se abre y se cierra solo, o el log indica "device lost" Actualiza el controlador gráfico. En tarjetas AMD existen fallos conocidos documentados (#708, #614). GPU
Faltan partes de la imagen o un aviso indica que la gráfica no admite mesh shaders La tarjeta gráfica o el controlador no son compatibles con mesh shaders. Actualiza el controlador; las tarjetas más antiguas no son compatibles (#640). GPU
AMD: texturas pixeladas, rectángulos opacos en el cielo o superficies anormalmente oscuras en el patio Prueba la solución provisional de texturas RGBA8. Ten en cuenta que consumirá más memoria de vídeo. AMD
Linux, AMD: el césped y la vegetación pequeña parpadean, y el log muestra not imported (VkResult -13) y storage buffer NOT bound El límite de udmabuf del kernel (64 MB) es inferior al de algunos bloques de memoria del juego. Las compilaciones que incluyen el arreglo de cola dispersa los importan mediante la cola dispersa del controlador. En versiones previas, o si el log continúa indicando CANNOT be imported, cierra el juego y ejecuta echo 2048 | sudo tee /sys/module/udmabuf/parameters/size_limit_mb antes de volver a iniciarlo. Este ajuste dura hasta reiniciar el PC; añadir la línea w /sys/module/udmabuf/parameters/size_limit_mb - - - - 2048 en /etc/tmpfiles.d/udmabuf.conf lo aplicará en cada inicio. Linux
Linux: el juego no arranca o la imagen se ve corrupta El juego requiere un controlador Vulkan 1.3 con soporte para mesh shaders. Compruébalo con vulkaninfo | grep mesh: debe mostrar VK_EXT_mesh_shader. Actualiza Mesa o el controlador de NVIDIA. Linux
Steam Deck: el juego se congela y se cierra en Kokiri Forest o en el Great Deku Tree (tiempo de espera gfx_0.0.0 agotado en journalctl -k) Usar RX_VK_MESH_NOCULL=2c56dc1006942f74 en hookshot_env.txt permite continuar dibujando todos los modelos (se deshabilita el pase de oclusión/culling que tarda varios segundos). RX_VK_SKIP_CODE=2c56dc1006942f74 también evita el cuelgue, pero los modelos de esas llamadas dejarán de verse (consulta la guía de desarrollo, #817). Steam Deck
"El antivirus de Your eliminó parte de las herramientas de compilación" Falso positivo común en aplicaciones sin firmar. Restaura los archivos desde el Historial de protección en Seguridad de Windows, o agrega %LOCALAPPDATA%\HookshotBuilder a la lista de exclusiones y haz clic en Reparar. Windows
Tirones la primera vez que se carga un escenario Comportamiento normal por ahora: los shaders se están compilando en segundo plano. La fluidez mejora al transitar nuevamente por la misma zona. Si deseas ayudar a mitigarlo para toda la comunidad, comparte tu lista de pipelines. sombreadores
Windows, NVIDIA: tirones en cada inicio en zonas ya visitadas tras haberse generado los shaders La caché de shaders del controlador es insuficiente para almacenarlos todos (la primera ejecución genera alrededor de 2 GB de pipelines). En el Panel de control de NVIDIA, ve a Administrar configuración 3D y establece el Tamaño de la caché de sombras en Ilimitado (o 10 GB). En Linux, el juego se encarga de aumentar automáticamente el límite del controlador. sombreadores
El juego se ejecuta en el idioma equivocado Modifica el código dentro de language.txt en la carpeta del juego. Dicho archivo lista todas las opciones disponibles, y las actualizaciones respetarán el idioma configurado. idioma

Revisa el log antes de cambiar de controlador

El archivo hookshot_log.txt ubicado en la carpeta del juego corresponde a la última sesión. Las cuatro ejecuciones previas se guardan de hookshot_log.1.txt a hookshot_log.4.txt. Al iniciar desde la terminal, la salida se mostrará allí. Cada 600 fotogramas, el registro puede detallar una línea de estado vk para la memoria gráfica. Si la opción Jugar de Linux Builder se cierra antes de generar este archivo, se creará hookshot_startup.log con un registro de arranque de hasta 64 KiB en stderr.

Si aparece un mensaje avisando que Hookshot admite la compilación e0f3ccfa, o que esta versión no es compatible, la actualización del juego seleccionada es incorrecta. Vuelve a volcar el programa 0400486024DEC000 con la actualización v131072. Texturas faltantes junto a hookshot_damaged_files.txt indican un volcado incompleto.

Pantallas negras, shaders y tirones al iniciar por primera vez

Si faltan partes de la imagen o aparece un aviso de falta de compatibilidad con mesh shaders, la tarjeta o el controlador carecen de dicha compatibilidad. Actualiza los controladores. Las tarjetas de generaciones previas continúan sin soporte. En Linux, vulkaninfo debe listar VK_EXT_mesh_shader. En caso de texturas pixeladas en AMD, activa la solución provisional RGBA8 a cambio de un mayor uso de memoria de video. Los tirones iniciales se deben a la generación de shaders y desaparecerán al volver a transitar por la misma zona. En Windows con NVIDIA, una caché de shaders reducida descarta pipelines ya construidos. En el panel de control de NVIDIA, dirígete a Administrar configuración 3D, Tamaño de la caché de sombras, Ilimitado o 10 GB. En Linux, el propio juego incrementa este límite del controlador.

Fuentes