NX2navi-Fehlerbehebung

Setup startet nicht

Bestätigen Sie, dass die Datei NX2navi-Setup-<version>.exe von tangerineturtle1/NX2navi Releases ist, kein in Setup umbenanntes Zip und nicht NX2navi-app-*.zip. Führen Sie sie aus dem Ordner aus, der den Dump schon hält. Erscheint SmartScreen, nutzen Sie Weitere Informationen und Trotzdem ausführen nur für diese GitHub-Datei. Hat der Browser den Download als blockiert markiert, entsperren Sie die Datei in den Eigenschaften oder laden Sie mit einem Browser, der nicht quarantänisiert. Firmen-Allowlists, die unsignierte Binaries ablehnen, löst diese Website nicht. Schalten Sie die Windows-Sicherheit nicht für die ganze Maschine aus, um „NX2navi zum Laufen zu bringen“.

• Nur Releases von tangerineturtle1/NX2navi
• Der Name muss NX2navi-Setup, dann eine Version, dann .exe sein
• Dump schon im selben Ordner

Launcher startet, Spiel nicht

Sieht der Launcher keinen Dump, erfindet er keinen. Scheitern Tool-Downloads, prüfen Sie, ob GitHub erreichbar ist und ein Proxy das Runtime-Zip nicht frisst. Stirbt der Build auf halbem Weg, ist Plattenspeicher der erste Check: die dreißig Gigabyte im README sind keine Metapher. Antivirus, der das Ausgabeverzeichnis mitten im Compile sperrt, sieht aus wie ein zufälliger Compiler-Crash; schließen Sie den Spielordner aus, den Sie angelegt haben, nicht die ganze Platte. Nach einem funktionierenden älteren Tag bevorzugen Sie das eigene Update des Launchers. Ein gemischter Ordner mit Git-Clone und Setup-Baum ist ein Support-Kopfschmerz; wählen Sie einen Weg.

Grafik, Ruckler und bekannte Abstürze

Vulkan 1.3 plus VK_EXT_external_memory_host und VK_EXT_mesh_shader sind Pflicht. Integrierte GPUs und ältere Karten ohne Mesh-Shader werden nicht kompatibel, weil Sie Setup zweimal geladen haben. Spätere Starts sind glatter als der erste. Holen Sie logs\nx2navi.log aus dem Spielordner, bevor Sie GitHub Issues öffnen. Folgen Sie CONTRIBUTING.md. Streichen Sie Dump-Pfade, die Sie nicht öffentlich posten würden.

Rollback und „ich habe das Falsche installiert“

Um einen schlechten Tag zu verlassen, öffnen Sie einen älteren Release und führen Sie dessen Setup aus. Installieren Sie nicht Setup von Tag A und überschreiben Sie dann zufällige Dateien aus dem App-Zip von Tag B. Wollten Sie aus dem Quellcode bauen, räumen Sie die Verwirrung auf und lesen Setup versus Quellcode statt Toolchains zu stapeln. Linux- und macOS-Fragen haben auf dieser Domain kein verstecktes Paket; die Antwort bleibt Windows. Steam Deck ist in diesem Leitfaden kein unterstütztes Installationsziel, selbst wenn ein Ini-Kommentar ein Geräteprofil nennt.

Was in ein nützliches Issue gehört

Ein nützlicher Bericht nennt den Tag, ob Sie Setup oder einen Quellbaum genutzt haben, GPU-Hersteller und Treiberversion und die letzten Zeilen von logs\nx2navi.log. Sagen Sie, ob SmartScreen beteiligt war, ob es eine Erstinstallation oder ein Launcher-Update war und in welchem Gebiet oder Menü Sie waren. Fügen Sie keine Binärwand ein. Unterscheiden sich zwei Maschinen, sagen Sie das. Sind Sie schon zurückgerollt, sagen Sie, welcher Tag noch läuft. Maintainer raten eine fehlende Mesh-Shader-Erweiterung nicht aus „es ist abgestürzt“. CONTRIBUTING.md existiert, damit Sie kein leeres Issue öffnen. Die Inbox dieser Website leitet Ihr Log nicht zu GitHub weiter. Zeigt das Overlay in F10 nach einem Treiber-Rollback 1 fps fest, nennen Sie diese Zahl; sie hilft mehr als ein vages „langsam“. Setup neu zu installieren ersetzt keinen Treiber. Schreiben Sie das Issue auf Englisch, wenn Sie können; Maintainer lesen Logs sorgfältiger als maschinenübersetzte Romane. Known issues im README umfassen noch einen seltenen Partikel-Crash und einen Ruck beim ersten Gebietsbesuch, während Pipelines erscheinen. Das sind keine „falsches Asset“-Fehler. Nebel- und Lichtregressionen, die 0.5.0 wiederhergestellt hat, sind der Grund, beide Tags zu nennen, wenn Sie Versionen übersprungen haben. RenderDoc versteckt Host-Memory-Import, daher kann eine Capture-Sitzung, die „in anderen Vulkan-Spielen ging“, hier trotzdem bei der Device-Erzeugung scheitern.

Häufige Fragen

Wo liegt das NX2navi-Log?

logs\nx2navi.log im Spielordner, den der Launcher angelegt hat. Hängen Sie das an GitHub Issues.

Kann ich ein Crash-Log an support@nx2navi.online mailen?

Nein. Diese Adresse gilt für den Text dieser Website. App-Crashes gehen an GitHub Issues mit logs\nx2navi.log.

Vulkan-Fehler nach einem GPU-Treiber-Update

Installieren Sie einen aktuellen Hersteller-Treiber, der noch Vulkan 1.3 und die nötigen Erweiterungen zeigt. Setup fügt einer GPU ohne Mesh-Shader keine hinzu. Prüfen Sie danach F10 nach einem sauberen Start aus demselben Ordner.