Hookshot Recomp
Readme-Zeilen14
Log-Dateihookshot_log.txt
Versionszeilee0f3ccfa
Deck-ParameterRX_VK_MESH_NOCULL

Hookshot Recomp Absturz beheben

Gleichen Sie die Meldung auf dem Bildschirm oder im Protokoll mit der aktuellen Readme ab. Wenn das Spiel kurz startet und sich direkt schließt oder das Log device lost meldet, empfiehlt die Readme ein Update des Grafiktreibers. common-issues.md ist ein älterer Hinweis, der sich hauptsächlich auf v2.0.14 bezieht; die dortigen Issue-Links zu GitHub sind ungültig.

Protokoll

Zeilen 1

Dump

Zeilen 1

Linux

Zeilen 3

Version

Zeilen 1

GPU

Zeilen 2

AMD

Zeilen 1

Steam Deck

Zeilen 1

Windows

Zeilen 1

Shader

Zeilen 2

Sprache

Zeilen 1
Übersicht der Fehlerbehebungs-Schritte nach Bereichen geordnet
Die aktuelle Readme unterteilt Problemlösungen nach Log, Dump, GPU, Linux, Shadern und Steam Deck.

Symptom und Abhilfe

Symptome Nächster Schritt Bereich
Wo befindet sich die Log-Datei? hookshot_log.txt im Spielordner enthält den letzten Durchlauf. Die vier vorherigen Durchläufe sind hookshot_log.1.txt (der jüngste) bis .4.txt. Beim Start über ein Terminal wird stattdessen dort ausgegeben. Alle 600 Frames erscheint eine vk: status:-Zeile: der belegte Videospeicher im Verhältnis zum vom Treiber erlaubten Limit sowie Details zu DLSS beim Rendern; vk: über dem VRAM-Limit des Treibers zeigt an, wann das Spiel dieses überschritten hat. Die Logs können gefahrlos unverändert weitergegeben werden: Der Home-Ordner wird als ~ (%USERPROFILE% unter Windows) und der Benutzername als <user> in den Pfaden maskiert, der Rest bleibt erhalten; die Datei --log des Builders wird identisch maskiert. Protokoll
Ein Ort hat fehlerhafte Texturen oder ein Boden bzw. eine Wand fehlt Prüfen Sie den Spielordner auf die Datei hookshot_damaged_files.txt. Sie wird angelegt, wenn der Spiel-Dump unvollständig ist (ca. 23.3 GB statt der vollständigen ca. 23.8 GB): Darin sind alle beschädigten Spieldateien sowie die jeweils als Ersatz dienenden Dateien aufgeführt. Dumpen Sie das Spiel erneut und erstellen Sie den Build neu; die Textdatei wird anschließend entfernt Dump
Linux Builder Play hat sich geschlossen, bevor das Game-Log erstellt wurde Prüfen Sie nach dem Schließen des Spiels hookshot_startup.log im Spielordner auf bis zu 64 KiB stderr der Startphase und den Exit-Code. Linux
„Hookshot unterstützt Build e0f3ccfa“ oder „Diese Version wird nicht unterstützt“ Prüfen Sie, ob das richtige Spiel mit installiertem Update ausgewählt wurde. Version
Das Spiel öffnet und schließt sich sofort, oder das Log meldet „device lost“ Grafiktreiber aktualisieren. Auf AMD-Karten gibt es bekannte Abstürze (#708, #614). GPU
Teile des Bildes fehlen oder die Karte hat laut Meldung keinen Mesh-Shader-Support Die Grafikkarte oder ihr Treiber unterstützt keine Mesh-Shader. Treiber aktualisieren; ältere Karten werden nicht unterstützt (#640). GPU
AMD: Blockige Texturen, einfarbige Rechtecke am Himmel oder ungewöhnlich dunkle Hof-Oberflächen Versuchen Sie den RGBA8-Textur-Workaround. Dieser benötigt mehr Grafikspeicher. AMD
Linux, AMD: Gras und kleine Pflanzen flackern, und das Log meldet not imported (VkResult -13) sowie storage buffer NOT bound Das kernelbasierte udmabuf-Limit (64 MB) ist kleiner als einige Speicherpools des Spiels. Builds mit dem Sparse-Queue-Fix importieren diese über die Sparse-Queue des Treibers. Bei älteren Builds oder wenn das Log weiterhin CANNOT be imported anzeigt: Spiel beenden, echo 2048 | sudo tee /sys/module/udmabuf/parameters/size_limit_mb ausführen und neu starten. Die Einstellung bleibt bis zum Neustart von PC aktiv; eine Zeile w /sys/module/udmabuf/parameters/size_limit_mb - - - - 2048 in /etc/tmpfiles.d/udmabuf.conf setzt sie dauerhaft bei jedem Systemstart. Linux
Linux: Das Spiel startet nicht oder das Bild ist fehlerhaft Das Spiel erfordert einen Treiber für Vulkan 1.3 mit Mesh-Shadern. Überprüfen Sie dies mit vulkaninfo | grep mesh: VK_EXT_mesh_shader sollte aufgeführt sein. Mesa oder den NVIDIA-Treiber aktualisieren. Linux
Steam Deck: Das Spiel friert in Kokiri Forest oder auf dem Great Deku Tree ein und schließt sich (gfx_0.0.0 timeout in journalctl -k) RX_VK_MESH_NOCULL=2c56dc1006942f74 in hookshot_env.txt behebt das Problem, indem jedes Modell gerendert wird (der sekundenlange Culling-Pass wird deaktiviert). RX_VK_SKIP_CODE=2c56dc1006942f74 umgeht es ebenfalls, blendet jedoch die dadurch gerenderten Modelle aus (siehe Entwickler-Leitfaden, #817). Steam Deck
„Your-Virenschutz hat Teile der Build-Tools entfernt“ Ein Fehlalarm bei unsignierten Programmen. Stellen Sie die Dateien über den Schutzverlauf von Windows Security wieder her oder fügen Sie %LOCALAPPDATA%\HookshotBuilder zu den Ausschlüssen hinzu und klicken Sie dann auf Reparieren. Windows
Ruckeln, wenn ein Element zum ersten Mal angezeigt wird Vorerst normal: Die Shader werden kompiliert. Es bessert sich, sobald derselbe Ort erneut durchquert wird. Sie können helfen, das für alle zu beheben: Senden Sie Ihre Pipeline-Liste ein. Shader
Windows, NVIDIA: Ruckler bei jedem Start an bereits besuchten Orten, nachdem Shader vorbereitet wurden Der Shader-Cache des Treibers ist zu klein, um alle Daten zu halten (beim ersten Start werden etwa 2 GB an Pipelines darin abgelegt). Öffnen Sie die NVIDIA-Systemsteuerung, gehen Sie auf 3D-Einstellungen verwalten und stellen Sie die Shader-Cache-Größe auf Unbegrenzt (oder 10 GB). Auf Linux hebt das Spiel dieses Limit des Treibers selbstständig an Shader
Das Spiel läuft in der falschen Sprache Ändern Sie den Code in language.txt im Spielordner. Die Datei listet alle Optionen auf, und ein Update behält den dort gewählten Eintrag bei. Sprache

Vor Treiber-Änderungen das Protokoll prüfen

hookshot_log.txt im Spielordner protokolliert den letzten Durchlauf. Die vier vorherigen Sitzungen liegen als hookshot_log.1.txt bis hookshot_log.4.txt vor. Bei einem Start über das Terminal erfolgt die Ausgabe direkt dort. Alle 600 Frames kann das Log eine vk-Statuszeile zum Grafikspeicher ausgeben. Schließt sich Linux Builder Play, bevor dieses Log existiert, wird eine hookshot_startup.log mit bis zu 64 KiB stderr-Startmeldungen hinterlassen.

Meldet das Programm, dass Hookshot den Build e0f3ccfa unterstützt oder diese Version nicht unterstützt wird, ist das ausgewählte Spiel-Update falsch. Dumpen Sie Programm 0400486024DEC000 mit Update v131072 erneut. Fehlende Texturen in Verbindung mit hookshot_damaged_files.txt bedeuten, dass der Dump unvollständig ist.

Schwarzer Bildschirm, Shader und Ruckeln beim Erststart

Fehlende Bildelemente oder der Hinweis auf fehlende Mesh-Shader-Unterstützung bedeuten, dass Grafikkarte oder Treiber keine Mesh-Shader ausführen können. Aktualisieren Sie den Treiber; ältere Karten bleiben nicht unterstützt. Unter Linux sollte vulkaninfo die Erweiterung VK_EXT_mesh_shader aufführen. Bei blockigen Texturen unter AMD hilft der RGBA8-Workaround, der mehr Grafikspeicher belegt. Ruckler beim ersten Durchlauf entstehen durch Shader-Kompilierung und verschwinden beim erneuten Betreten des Bereichs. Unter Windows mit NVIDIA verwirft ein zu kleiner Shader-Cache bereits erstellte Pipelines. Navigieren Sie in der NVIDIA-Systemsteuerung zu 3D-Einstellungen verwalten, Shader-Cache-Größe, und wählen Sie Unbegrenzt oder 10 GB. Unter Linux erhöht das Spiel dieses Treiberlimit automatisch.

Quellen