Corriger un plantage Hookshot Recomp
Comparez le message affiché à l'écran ou la ligne du journal avec le lisez-moi actuel. Si le jeu s'ouvre puis se referme immédiatement, ou si le journal indique « device lost », le lisez-moi conseille de mettre à jour le pilote graphique. common-issues.md est une note plus ancienne, portant principalement sur la v2.0.14, et ses liens vers les tickets GitHub ne fonctionnent plus.
dump
Linux
version du jeu
GPU
AMD
Steam Deck
Windows
shaders
langue
Du symptôme au correctif
| Symptôme | Quoi faire | Domaine |
|---|---|---|
| Où se trouve le fichier journal ? | hookshot_log.txt dans le dossier du jeu contient la dernière session. Les quatre sessions antérieures sont hookshot_log.1.txt (la plus récente) à .4.txt. S'il est lancé depuis un terminal, le jeu y écrit directement. Toutes les 600 images, une ligne vk: status: indique la mémoire vidéo consommée par rapport au quota alloué par le pilote, ainsi que les détails de rendu de DLSS ; la mention vk: over the driver's video-memory allowance signale un dépassement de quota. Vous pouvez partager ces journaux en toute sécurité : votre dossier personnel est masqué sous ~ (%USERPROFILE% sur Windows) et votre nom d'utilisateur apparaît sous la forme <user> dans les chemins, le reste étant conservé ; le fichier --log du builder utilise le même formatage. | journal |
| Texture incorrecte, sol ou mur invisible | Vérifiez la présence de hookshot_damaged_files.txt dans le dossier du jeu. La compilation le génère lorsque le dump du jeu est incomplet (environ 23.3 GB, contre environ 23.8 GB pour un dump valide) : il liste chaque fichier endommagé ainsi que le fichier de substitution utilisé. Effectuez un nouveau dump puis relancez la compilation pour supprimer ce fichier. | dump |
| Linux Builder Play s'est fermé avant l'apparition du journal du jeu | Une fois le jeu fermé, consultez hookshot_startup.log dans le dossier du jeu pour examiner jusqu'à 64 Kio de sortie stderr au démarrage ainsi que son code de sortie. | Linux |
| « Hookshot prend en charge la build e0f3ccfa » ou « Cette version n'est pas prise en charge » | Assurez-vous d'avoir sélectionné le bon jeu avec sa mise à jour correctement installée. | version du jeu |
| Le jeu s'ouvre puis se referme immédiatement, ou le journal indique « device lost » | Mettez à jour votre pilote graphique. Des plantages répertoriés affectent certaines cartes AMD (#708, #614). | GPU |
| Éléments graphiques manquants ou message indiquant l'absence de prise en charge des mesh shaders | La carte graphique ou son pilote ne prend pas en charge les mesh shaders. Mettez à jour le pilote ; les cartes graphiques plus anciennes ne sont pas prises en charge (#640). | GPU |
| AMD : textures pixelisées, rectangles opaques dans le ciel ou surfaces de cours anormalement sombres | Activez l'option de contournement des textures RGBA8. Elle sollicite davantage de mémoire graphique. | AMD |
| Linux, AMD : l'herbe et la végétation scintillent ou disparaissent, journal indiquant « not imported (VkResult -13) » et « storage buffer NOT bound » | La limite kernel udmabuf (64 Mo) est inférieure à certains pools de mémoire du jeu. Les versions intégrant le correctif sparse-queue les importent via la file clairsemée du pilote. Sur les versions plus anciennes, ou si le log indique toujours CANNOT be imported, quittez le jeu et exécutez echo 2048 | sudo tee /sys/module/udmabuf/parameters/size_limit_mb, puis relancez-le. Cette valeur reste active jusqu'au prochain redémarrage du PC ; la ligne w /sys/module/udmabuf/parameters/size_limit_mb - - - - 2048 dans /etc/tmpfiles.d/udmabuf.conf permet de l'appliquer à chaque démarrage. | Linux |
| Linux : le jeu refuse de se lancer ou le rendu graphique est corrompu | Le jeu requiert un pilote Vulkan 1.3 prenant en charge les mesh shaders. Vérifiez avec vulkaninfo | grep mesh : la ligne VK_EXT_mesh_shader doit apparaître. Mettez à jour Mesa ou le pilote NVIDIA. | Linux |
| Steam Deck : le jeu freeze et plante dans Kokiri Forest ou la Great Deku Tree (gfx_0.0.0 timeout dans journalctl -k) | Définir RX_VK_MESH_NOCULL=2c56dc1006942f74 dans hookshot_env.txt permet de dépasser ce point en affichant l'intégralité des modèles (la passe d'élimination/culling qui bloque pendant plusieurs secondes est désactivée). RX_VK_SKIP_CODE=2c56dc1006942f74 permet aussi de passer outre, mais fait disparaître les modèles correspondants (voir le guide de développement, #817). | Steam Deck |
| « L'antivirus Your a supprimé une partie des outils de compilation » | Il s'agit d'un faux positif fréquent sur les exécutables non signés. Restaurez les fichiers depuis l'Historique de protection de la Sécurité Windows, ou ajoutez %LOCALAPPDATA%\HookshotBuilder à ses exclusions, puis cliquez sur Réparer. | Windows |
| Micro-saccades lors de la découverte d'une nouvelle zone | Comportement normal au premier passage : les shaders sont en cours de compilation. La fluidité s'améliore dès que vous traversez à nouveau la zone. Vous pouvez contribuer à éliminer ces saccades pour tout le monde en envoyant votre liste de pipelines. | shaders |
| Windows, NVIDIA : saccades à chaque lancement dans des zones déjà explorées après compilation des shaders | Le cache de nuanceurs du pilote est trop petit pour tout conserver (le premier lancement y compile environ 2 GB de pipelines). Dans le panneau de configuration NVIDIA, Gérer les paramètres 3D, réglez la taille du cache des nuanceurs sur Illimité (ou 10 GB). Sous Linux, le jeu augmente automatiquement cette limite du pilote. | shaders |
| Le jeu ne s'affiche pas dans la bonne langue | Modifiez le code de langue dans language.txt au sein du dossier du jeu. Le fichier recense l'ensemble des codes disponibles, et les futures mises à jour conservent votre choix. | langue |
Consulter le journal avant de modifier les pilotes
hookshot_log.txt dans le répertoire du jeu correspond à la dernière exécution. Les quatre précédentes sont enregistrées dans hookshot_log.1.txt à hookshot_log.4.txt. Un lancement depuis le terminal redirige la sortie directement dans la console. Toutes les 600 frames, le journal peut inclure une ligne d'état vk sur la mémoire vidéo. Un plantage de Linux Builder Play avant l'apparition de ce fichier laisse hookshot_startup.log, qui contient jusqu'à 64 Kio du stderr initial.
Un message indiquant que Hookshot prend en charge la build e0f3ccfa, ou que cette version n'est pas prise en charge, signifie que la mise à jour sélectionnée pour le jeu est incorrecte. Effectuez à nouveau le dump du programme 0400486024DEC000 avec la mise à jour v131072. Des textures manquantes accompagnées d'un fichier hookshot_damaged_files.txt indiquent que le dump est incomplet.
Écrans noirs, shaders et saccades au premier lancement
Des parties d'image manquantes ou un message signalant l'absence de support mesh shader signifient que le pilote ou la carte ne gère pas les mesh shaders. Mettez le pilote à jour. Les cartes plus anciennes restent non prises en charge. Sous Linux, vulkaninfo doit lister VK_EXT_mesh_shader. En cas de textures pixelisées dans AMD, testez le contournement RGBA8, qui requiert plus de mémoire vidéo. Les saccades au premier démarrage proviennent de la compilation des shaders et s'estompent au passage suivant. Sous Windows avec NVIDIA, un cache de shaders trop restreint purge les pipelines déjà construits. Dans le panneau de configuration NVIDIA : Gérer les paramètres 3D, Taille du cache des nuanceurs, Illimité ou 10 GB. Linux augmente cette limite de pilote automatiquement.