XML zu YMAP ist eine formatspezifische Konvertierung, keine Dateiumbenennung. Ein Menyoo-Platzierungsspeicherstand, ein Guadmaz-Map-Editor-Speicherstand und CodeWalker-YMAP-XML können alle auf .xmlenden, beschreiben aber unterschiedliche Strukturen. Identifiziere das erzeugende Werkzeug vor der Wahl eines Importers.
Diese Anleitung behandelt statische Prop-Platzierungen. Sie verspricht keinen Erhalt von Scripts, beweglichen Entitäten, Peds, Pickups, angehängten Objekten oder vollständigen MLO-Innenräumen. Bewahre das Original auf und bearbeite eine Kopie. Eine konvertierte Platzierung liefert keine nie enthaltenen eigenen Modelle, Texturen oder Kollisionsdateien.
Identifiziere dein XML-Format
Öffne eine Kopie im Texteditor, ohne etwas auszuführen. Prüfe Wurzelelement und speichernde Anwendung; leite das Format nicht allein aus der Endung ab.
| Eingabe | Was es darstellt | Passender nächster Schritt |
|---|---|---|
CodeWalker-XML mit dem Wurzelelement CMapData als Wurzel |
Eine Textdarstellung von YMAP-Daten | Nutze den passenden XML-Import-/Kompilierungsworkflow in CodeWalker |
| Menyoo-Platzierungs-XML | Eine gespeicherte Object-Spooner-Szene | Nutze einen Importer mit ausdrücklicher Unterstützung dieses Menyoo-Formats |
| Guadmaz-Map-Editor-XML | Das Kartenspeicherschema dieses Editors | Nutze einen Konverter mit ausdrücklicher Map-Editor-XML-Unterstützung |
Nativ .ymap |
Kompilierte Kartendaten, kein Text-XML | Öffne es als Spieldatei statt es in XML umzubenennen |
| Eine Map-Studio-Projekt-JSON | Das bearbeitbare Planungsprojekt dieser Website | Öffnen in Map Studio, dann unterstützte Quelldaten exportieren |
Der Browser-Importer akzeptiert unterstütztes CodeWalker- CMapData XML, nicht beliebiges Menyoo- oder Map-Editor-XML. Karten mit Parent-Verknüpfungen werden ebenfalls abgewiesen, statt eine Teilbearbeitung als sicheren vollständigen Roundtrip auszugeben. Die Dateiformatanleitung erklärt den Unterschied zwischen nativer Ausgabe und Quelle.
Bereite einen kleinen Konvertierungskandidaten vor
Speichere eine Szene mit nur drei statischen Props, deren Namen in deiner Installation auflösbar sind. Notiere Modellnamen, Position, Rotation und Skalierung. Vermeide zunächst Objekte mit anderen Mod-Abhängigkeiten. Liste bewusst ausgeschlossene Funktionen getrennt auf; stiller Datenverlust ist keine erfolgreiche Konvertierung.
Speichere die Quelle unter neuem Namen. Eine Szene mit Hunderten Platzierungen eignet sich schlecht für die erste Diagnose: Fehlende Abhängigkeit, falsche Transformation und nicht unterstützte Entität können gleich aussehen. Drei bekannte Platzierungen lassen sich nach jeder Stufe einzeln vergleichen.
Konvertierungswege für Menyoo und Map Editor
Prüfe zuerst die Importoptionen des konkret installierten CodeWalker-Builds. Nutze einen formatspezifischen Importer nur, wenn er dein Quellformat nennt. Eine allgemeine XML-Funktion beweist keine Unterstützung jedes Schemas. Notiere Build und Importoption bei der Quellsicherung.
Der ursprüngliche Map Editor & Menyoo to YMap Converter bietet einen dokumentierten historischen Ausweichweg: unterstütztes Karten-XML öffnen, dessen openFormats-Datei .ymap.xmlexportieren und diese in OpenIV zu einer nativen Datei importieren. Der Entwickler dokumentiert ausgeschlossene Entitäten und historische Laufzeitanforderungen. Das belegt diesen Workflow, garantiert aber keine Kompatibilität mit jeder modernen Menyoo-Version.
Nutze nur die Entwicklerdistribution und die verlinkten Abhängigkeiten. Installiere keine beliebigen Ersatz-DLLs und deaktiviere keine Sicherheitssoftware, um ein altes Werkzeug zu starten. Bei Formatabweisung sichere den Fehler und teste einen kleineren Speicherstand statt wiederholter Umbenennung.
Die gepflegte Entwicklerseite von Menyoo unterscheidet versionsabhängiges Verhalten. Eine aktuelle Menyoo-Szene kann Funktionen enthalten, die ein alter Konverter nicht kennt. Halte diese Versionsgrenzen im Testprotokoll fest.
Prüfe und speichere das erzeugte YMAP
Öffne die native Karte in einem CodeWalker-Projekt derselben Zieledition. Prüfe die drei Archetypreferenzen und vergleiche gespeicherte Koordinaten mit der Quelle. Kontrolliere Rotation aus mehreren Winkeln; eine korrekte Draufsicht kann gekippte oder gespiegelte Platzierungen verdecken.
Berechne YMAP-Ausdehnungen und Flags anhand tatsächlich geladener Assets neu. Speichere, schließe und öffne die native Karte erneut. Das prüft die auszuliefernde Datei statt ungespeicherten Editorzustands. Die Lektion zum ersten YMAP beschreibt den Platzierungsworkflow.
Lade für eine Browser-Quellübung unser CodeWalker-XML und JSON mit drei Propsherunter. Dies sind Beispiele der ausgabeseitigen Quellstruktur, kein zertifizierter Menyoo-Konvertierungstestfall oder im Spiel getestetes natives YMAP.
Paketieren und in FiveM testen
Nutze einen neuen Ressourcenordner und den fxmanifest-Generator. Lege die kompilierte Karte ab in stream/; bewahre Arbeits-XML anderswo auf. Registriere eigene YTYPs nur bei tatsächlicher Abhängigkeit von mitgelieferten Definitionen. Folge der Streaming-Anleitung bevor du die Ressource einem Liveserver hinzufügst.
Prüfe Objektzahl, Position, Entfernungsverhalten und physische Kollision in einer Entwicklungssitzung. Wiederhole nach Neuverbindung. Ordne Fehler ihrer Stufe zu: Quellparsing, Konvertierung, CodeWalker-Neuladen, Ressourcenstart oder Spieltest.
Einzugrenzende Konvertierungsprobleme
Bei Parserfehlern prüfst du zuerst XML-Schema und Konverterunterstützung. Richtige Positionen bei fehlenden Modellen verlangen Abhängigkeits- und Editionsprüfungen. Große Versätze verlangen einen Vergleich lokaler und globaler Transformationen. Fehlendes Ped-, Fahrzeug- oder Scriptverhalten erfordert die Prüfung, ob es zur Quelllaufzeit statt zu Kartendaten gehörte.
Bestätige nicht die ganze Szene, nur weil ein Objekt erschien. Nutze der Diagnose fehlender Karten bei einer ladenden nativen Karte mit Fehlern in FiveM und bewahre die Originalquelle für einen anderen unterstützten Konvertierungsweg auf.