Zum Inhalt

Karten-Validator (Map Validator)

Der Karten-Validator ist ein fortschrittliches Diagnosewerkzeug in nEditor, das entwickelt wurde, um versteckte Fehler in OMSI 2-Kartendateien aufzuspüren.

Viele kritische Probleme in OMSI 2 äußern sich in kryptischen Fehlermeldungen (wie dem berüchtigten Fehler bei Bereichsprüfung), einer leeren Protokolldatei (logfile.txt) oder nicht ladenden Kacheln. Der Validator analysiert die gesamte Dateistruktur und weist präzise auf fehlerhafte Zeilen und Ursachen hin.

Karten-Validator Fenster

1. Start und Bedienung

  1. Klicken Sie im Hauptmenü von nEditor auf die Schaltfläche Map Validator.
  2. Klicken Sie im geöffneten Fenster auf Select OMSI 2 Map Folder.
  3. Wählen Sie das Kartenverzeichnis aus (z. B. .../OMSI 2/maps/Kartenname).
  4. Der Editor führt automatisch eine mehrstufige Prüfung durch und listet die Ergebnisse übersichtlich in einer Konsole auf, unterteilt in Informationen, Warnungen ([WARN]) und kritische Fehler ([ERROR]).

2. Umfang der Prüfungen

A. Integrität der Verzeichnisstruktur

  • Prüft das Vorhandensein der Konfigurationsdatei global.cfg. Fehlt diese, wird der Ordner abgewiesen.
  • Überprüft das Vorhandensein des Ordners TTData (Fahrpläne, Pfade und Haltestellen).

B. Überprüfung der Kacheln [map] und Duplikate

  • Kachelzählung: Prüft, ob alle in global.cfg deklarierten .map-Dateien physisch auf der Festplatte existieren.
  • Erkennung von Duplikaten: Findet mehrfache Kacheleinträge für dieselben Koordinaten (X, Y).
  • Warnung vor Deduplizierungsrisiken (Deduplication Risk): > [!WARNING] Warum sind Kachelduplikate gefährlich? > Auf vielen älteren Karten existieren doppelte Kacheleinträge in der global.cfg. Werden diese unüberlegt entfernt, verschieben sich die Kachelindizes. Verweisen Fahrplandaten in TTData auf höhere Indizes, führt das Entfernen sofort zum Absturz mit Fehler bei Bereichsprüfung!

C. Prüfung von Startpunkten [entrypoints] und Quaternionen

  • Deklarationsprüfung: Prüft, ob die Anzahl der deklarierten Startpunkte mit den tatsächlichen Zeilen übereinstimmt.
  • Prüfung von 3D-Rotationsquaternionen:
    • Quaternionen (X, Y, Z, W) müssen Einheitsvektoren mit einer Norm von 1.0 bilden.
    • Erkennt fehlerhafte Werte, Komponenten außerhalb von [-1.0, 1.0] und Rundungsfehler, die beim Platzieren von Bussen zu Abstürzen führen.
  • Gültigkeit des Kachelindex (tileIndex): Prüft, ob der Startpunkt auf eine existierende Kachel verweist.
  • Objektnummerprüfung: Stellt sicher, dass die objectNumber die tatsächliche Objektanzahl der Kachel nicht überschreitet.

D. Konsistenz der Fahrplandaten in TTData

  • Datei Busstops.cfg:
    • Prüft, ob der tileIndex jeder Haltestelle im gültigen Kachelbereich liegt (0 .. Kachelanzahl - 1).
  • Datei StnLinks.cfg:
    • Validiert alle Verknüpfungen [stnlink] und Segmente [stnlink_entry].
    • Erkennt fehlerhafte Kachelzuordnungen (tileIndex = -1), die auf unvollständige KI-Verkehrspfade hinweisen.
    • Überprüft, ob Start- und Zielhaltestellen (from_id, to_id) in Busstops.cfg existieren.
  • Fahrtendateien *.ttp:
    • Bestätigt, dass alle referenzierten Stationen in Busstops.cfg vorhanden sind.

E. Geländetexturskalierung [groundtex]

  • Erkennt Texturen in global.cfg mit einem Skalierungsfaktor über 255 (z. B. 300).
  • Werte über 255 führen in OMSI zu Speicherüberläufen und dem Fehler Fehler bei Bereichsprüfung.

3. Zusammenfassung

Nach Abschluss der Überprüfung erscheint am Ende der Konsole eine Zusammenfassung: * Gesamtzahl der kritischen Fehler (CRITICAL ERRORS), * Gesamtzahl der Warnungen (Warnings), * Erfolgsmeldung bei fehlerfreier Prüfung (All checks PASSED).