„Wird nicht angezeigt“ kann verschiedene Fehler beschreiben. Die Ressource startet vielleicht nicht, die Karte platziert den Innenraum woanders, ein Archetyp fehlt oder ein Raum verschwindet nur aus einem bestimmten Blickwinkel. Trenne zunächst diese Beobachtungen.
Dies ist ein Entscheidungsablauf zur Diagnose. Er behauptet nicht, dass jedes Symptom nur eine mögliche Ursache hat.
Erfasse den Fehlerzustand
Notiere Ressourcenversion, Zieledition, Koordinaten, Kamerarichtung und aktive benachbarte Kartenressourcen. Bewahre vorhandene Client- und Serverfehler im Wortlaut auf. Speichere einen Screenshot mit genügend Kontext, um die Position wiederzufinden.
Bewahre den fehlerhaften Export vor Änderungen auf. Ein reproduzierbarer Fehler ist ein nützlicher Testfall. Verschwindet er nach sechs unzusammenhängenden Änderungen, lernst du kaum etwas daraus.
Fehlt die gesamte Ressource?
Prüfe Ressourcenpfad, Dateiname und Startausgabe. Untersuche fxmanifest.lua und kontrolliere die erwarteten Dateien einschließlich Groß-/Kleinschreibung und Endungen. Stelle sicher, dass du den vorgesehenen Ressourcenordner statt eines älteren Duplikats testest.
Prüfe bei eigenen Archetypen YTYP-Registrierung und Referenzen. Vergleiche die ausgelieferte Dateiliste mit der Anleitung zur Ressourcenpaketierung.
Ein erfolgreich eingegebener Konsolenbefehl bedeutet nicht, dass alle Abhängigkeiten verfügbar waren. Lies die Ausgabe und prüfe die sichtbare Platzierung getrennt.
Öffnet sich das Asset, erscheint aber nicht in der Welt?
Prüfe die Kette vom Asset über den Archetyp zur Entitätsplatzierung. Nutze die Dateiformatreferenz zur Trennung dieser Aufgaben. Bestätige den exakten MLO-Archetypnamen und die Welttransformation der Platzierung.
Prüfe, ob die exportierte Karte die letzten Änderungen enthält, gegebenenfalls mit neu berechneten Ausdehnungen. Eine auf deinem Rechner gespeicherte Projektdatei beweist nicht, dass der Server ein neues YMAP erhalten hat.
Prüfe bei lokal erstellter Geometrie auf doppelte Verschiebung oder Rotation in Exportdaten und Platzierung. Verschiebe das Asset nicht wiederholt, bis es zufällig erscheint, ohne zuerst die angewandte Transformation zu verstehen.
Verschwindet ein Raum an einer Türöffnung?
Kehre zum Raumgraphen zurück. Notiere Öffnung, Schwellenseite und Blickrichtung, die den Fehler auslösen. Prüfe Verbindung und Raumkonfiguration mithilfe der Portal-Testmatrix.
Ein unbeteiligter Weitwinkel-Screenshot beweist keine funktionierende Verbindung. Ein Fehler an einem bestimmten Übergang erfordert dessen gezielten Test.
Vergleiche dieselbe Route mit dem vorherigen funktionierenden Export. Begann der Fehler mit einem neuen Raum, grenze den Versuch auf diese Änderung ein, statt alle Materialien neu zu erstellen.
Ist der Raum sichtbar, aber die Bewegung fehlerhaft?
Wechsle zur Kollisionsdiagnose. Ein Eingang kann durch Kollision ohne passende sichtbare Öffnung blockiert werden. Wiederholtes Registrieren desselben YTYPs behebt kein Durchfallen durch den Boden.
Prüfe die exportierte Kollision und wiederhole die Gehroute. Prüfe überlappende Ressourcen am Standort. Deaktiviere Verdächtige nur in einer kontrollierten Entwicklungsumgebung und dokumentiere jeden Vergleich.
Hängt das Problem von der Entfernung oder anderen Ressourcen ab?
Nutze feste Annäherungswege, um Entfernungseffekte von Raumübergängen zu unterscheiden. Die README erklärt die LOD-Hierarchie, rechtfertigt aber keine pauschale Erhöhung aller Distanzen ohne Prüfung von Hierarchie und Grenzen.
Teste bei vermuteten Konflikten die Ressource allein und füge Nachbarressourcen in bekannter Reihenfolge wieder hinzu. Notiere die erste fehlerhafte Kombination. Die Reihenfolge ist ein Untersuchungshinweis, kein Ersatz für das Verständnis doppelter oder überlappender Assets.
Schließe den Prüfzyklus ab
Notiere bei jedem Lösungsversuch Hypothese, genaue Änderung und Ergebnis. Stelle bei widerlegter Hypothese die vorige Version wieder her. Reproduziere eine funktionierende Korrektur aus der Quelle und wiederhole Tests mit frischer Verbindung.
Cache-Aktionen sind keine Diagnose. Vermute veraltete Auslieferung nur bei entsprechenden Nachweisen und befolge aktuelle Plattformhinweise statt ritualmäßig unbeteiligte Ordner zu löschen.
YMAP erscheint nicht in FiveM: Grenze die erste fehlende Ebene ein
Beginne mit Ressourcenerkennung und Serverkonsole, prüfe dann die genaue native Datei in stream/, Zieledition und Weltkoordinaten. Ein funktionierender Ressourcenname mit Text-XML statt nativer Ausgabe ist keine funktionierende Karte. Vergleiche eine frische CodeWalker-Ladung mit der ausgelieferten Datei, nicht mit einer anderen Editor-Arbeitskopie.
Erscheinen Spiel-Props, aber keine eigenen Objekte, prüfe YTYP-Registrierung und Modell-/Texturabhängigkeiten. Erscheint nichts, kläre zuerst, ob das YMAP geladen wurde. Der Manifest-Generator hilft beim Deklarationsvergleich, prüft aber keine Dateien und beweist keine auflösbaren Referenzen.
MLO flackert an einer Türöffnung
Halte die Kamera auf beiden Seiten still und durchquere dieselbe Öffnung in beide Richtungen. Notiere verschwundenen Raum und Übergangsort. Vergleiche Portalgeometrie, verbundene Räume, Grenzen und Entitätszuordnungen. Ändere nicht alles gleichzeitig: Eine kontrollierte Änderung soll eine wiederholbare Beobachtung erklären.
Vergleiche denselben Weg ohne überlappende Entwicklungsressourcen. Scheitern nur Fernansichten, prüfe LOD- und Streaming-Beziehungen statt alle Distanzen zu erhöhen. Nutze die Anleitung zu Räumen und Portalen für die Graphprüfung und die Optimierungslektion für reproduzierbare Vergleiche.
Unsichtbarer Innenraum oder unsichtbare Kollision
Ein nicht gezeichneter Raum und ein bewegungsblockierender Raum sind verschiedene Symptome. Prüfe die physische Grenze bei unsichtbarer Oberfläche, danach Rendering- und Kollisionsassets getrennt. Kollisionsentfernung repariert keinen Archetyp-Registrierungsfehler; ein Portal schneidet kein Loch in einen festen Kollisionskörper.
Speichere die kleinste reproduzierbare Ressource samt Edition, Spiel-/Server-Build, Quellrevision und genauer Beobachtung. Scheitert die Anwendung vor dem Öffnen einer Karte, nutze die CodeWalker-Startfehlerdiagnose stattdessen.