FiveM MLO und YMAP installieren: So fügen Sie eine eigene Map hinzu
Diese Anleitung zeigt Ihnen Schritt für Schritt, wie Sie Ihrem FiveM-Server eine MLO-Map (einen begehbaren Innenraum) oder eine YMAP-Map (eine Platzierung im Außenbereich) hinzufügen: die richtige Ordnerstruktur, der Inhalt von fxmanifest.lua, die ensure-Reihenfolge in server.cfg und die Kontrolle nach der Installation. Außerdem erfahren Sie, wie Sie Konflikte, das Durchfallen durch den Boden und verspätetes Laden beheben, wie sich Maps auf die Performance auswirken und wie kostenpflichtige, per Escrow geschützte Maps funktionieren.
Bevor Sie beginnen
- Eine funktionierende FXServer-Installation. Falls Sie noch keine haben, folgen Sie der Anleitung zur Einrichtung eines FiveM-Servers von Grund auf mit FXServer; diese Anleitung setzt voraus, dass Ihr Ordner
server-dataund Ihre Dateiserver.cfgbereitstehen. - Dateizugriff auf den Server: Bei einem Windows-VDS verbinden Sie sich per RDP (3389) mit dem Desktop und kopieren die Dateien; bei einem Linux-VDS verwenden Sie einen SFTP-Client wie WinSCP oder FileZilla über SSH (22).
- Ein Lizenzschlüssel aus dem Cfx.re Portal (portal.cfx.re), eingetragen in der Zeile
sv_licenseKeyinserver.cfg. Die Berechtigung für Escrow-geschützte Maps wird über diesen Schlüssel geprüft; Einzelheiten finden Sie in der Anleitung zum Abrufen eines Lizenzschlüssels. - Die Hinweise des Map-Autors zu Abhängigkeiten (Dependencies). Manche MLOs benötigen eine zusätzliche Ressource für Türen, Aufzüge oder Beleuchtung; ohne sie öffnet sich der Innenraum zwar, funktioniert aber nicht vollständig.
- Ein Backup: eine Kopie Ihrer Datei
server.cfgund Ihres Ordnersresources. VDS-Pakete enthalten keine automatischen Backups; bewahren Sie die Kopie außerhalb des Servers auf. - Ein geeigneter Server. Spieler laden die Map-Dateien beim ersten Verbinden vom Server herunter; wie lange das dauert, hängt von der Datenträger- und Netzwerkgeschwindigkeit des Servers ab. Die von uns für FiveM empfohlene Produktfamilie ist der AMD Ryzen 9 9950X VDS mit NVMe-Laufwerken und 1G-Anbindung; die Pakete finden Sie auf der Seite FiveM-Server mieten.
1. Den Unterschied zwischen MLO und YMAP verstehen
Eine YMAP ist eine Platzierungsdatei, die festlegt, wo vorhandene Modelle (Archetypen) auf der Map stehen: Bäume, Absperrungen, Props, sogar die Außenhülle eines Gebäudes werden mit einer YMAP platziert. Eine YTYP enthält die Definitionen dieser Modelle: Name, LOD-Distanz (Level of Detail), Kollisions- und Innenraumdaten. Ein MLO ist ein spezieller Archetyp-Typ, der in einer YTYP als CMloArchetypeDef definiert ist: ein begehbarer Innenraum mit Räumen (Rooms), Übergängen (Portals) und eigenen Kollisionsdaten. Ein MLO-Paket kombiniert also eine YTYP und eine YMAP mit Modell-, Textur- und Kollisionsdateien.
| Merkmal | YMAP | MLO |
|---|---|---|
| Funktion | Platziert vorhandene Modelle auf der Map | Definiert einen begehbaren Innenraum mit Räumen und Türen |
| Typischer Inhalt | .ymap (+ manchmal .ydr, .ytd) | .ytyp, .ymap, .ydr/.ydd, .ytd, .ybn |
| Last für die Spiel-Engine | Gering; steigt mit der Anzahl der Props | Höher; Modell-, Textur- und Kollisionsdaten belegen Streaming-Speicher |
| Anforderung an das Manifest | this_is_a_map genügt | this_is_a_map; in den meisten Paketen außerdem data_file für die ytyp und eine _manifest.ymf |
| Häufige Probleme | Z-Fighting (Flackern überlappender Flächen), verrutschte Props | Durchfallen durch den Boden, schwarze Räume, verspätetes Laden |
2. Paket herunterladen und Inhalt prüfen
Für die Suche nach Ressourcen verweist die Cfx.re-Dokumentation auf den Cfx Marketplace und den Forenbereich „FiveM Releases“; bei kostenpflichtigen Produkten empfiehlt sie, den Verkäufer vor dem Kauf zu fragen, ob er über einen offiziellen Kanal (Cfx Marketplace oder Tebex) verkauft. „Geleakte“ Pakete auf Filesharing-Seiten können veraltete Versionen sein und eingeschleuste Skripte enthalten; sehen Sie eine Lua-Datei, die in der Beschreibung des Autors nicht erwähnt wird, verwenden Sie das Paket nicht.
Nach dem Entpacken des Archivs sehen Sie folgende Dateitypen:
| Endung | Inhalt | Ablageort |
|---|---|---|
.ydr / .ydd / .yft | 3D-Modell (einzeln, Dictionary, Fragment) | stream/ |
.ytd | Textur-Dictionary | stream/ |
.ybn | Kollisionsgrenzen | stream/ |
.ytyp | Archetyp- und MLO-Definitionen | stream/ + Eintrag im Manifest |
.ymap | Platzierung | stream/ |
_manifest.ymf | Ein mit dem Werkzeug Manifest Generator von CodeWalker erzeugtes Manifest; laut Cfx.re-Anleitung erforderlich, damit Modelle korrekt geladen werden | stream/ |
fxmanifest.lua | Ressourcendefinition | Stammverzeichnis des Ressourcenordners |
Auch .ymap- und .ytyp-Dateien im XML-Format werden ohne Konvertierung gelesen, sofern sie keine zusätzliche Endung tragen (nicht mh1_01.ymap.xml, sondern mh1_01.ymap). Da sie vom spieleigenen Parser gelesen werden, können sie sich anders verhalten als in CodeWalker.
3. Ressourcenordner und stream-Ordner anlegen
FXServer liest jeden Ordner unter resources als Ressource ein; Ordner in eckigen Klammern (etwa [maps]) gelten als Kategorien und gruppieren die darin enthaltenen Ressourcen. In der Beispielinstallation von Cfx.re sehen die Pfade so aus:
Windows: C:\FXServer\server-data\resources\[maps]\my_hospital\stream\
Linux: ~/FXServer/server-data/resources/[maps]/my_hospital/stream/
Haben Sie mit txAdmin über ein Recipe installiert, verwenden Sie statt server-data den Serverdatenordner, den Sie bei der Einrichtung gewählt haben. Die Regeln:
- Geben Sie dem Ressourcenordner einen Namen aus Kleinbuchstaben, Ziffern, Unterstrichen und Bindestrichen; vermeiden Sie Leerzeichen, Umlaute und ß. Dieser Name steht genau so in der
ensure-Zeile. - Unter Linux wird bei Dateinamen zwischen Groß- und Kleinschreibung unterschieden. Steht im Manifest
stream/Hospital.ytyp, heißt die Datei aberhospital.ytyp, wird die ytyp nicht geladen. - Archive enthalten oft verschachtelte Ordner (
my_hospital/my_hospital/stream). Die Dateifxmanifest.luamuss direkt im Stammverzeichnis des Ressourcenordners liegen, neben dem Ordnerstream. - Legen Sie alle Spieldateien in
streamab; die Cfx.re-Anleitung verlangt dies, damit die Dateien korrekt geladen werden.
4. Die Datei fxmanifest.lua schreiben
Bringt das Paket bereits ein Manifest mit, behalten Sie es und prüfen nur die Pfade. Andernfalls verwenden Sie diese Vorlage:
fx_version 'cerulean'
game 'gta5'
author 'Map Author'
description 'Sandy Shores hospital MLO'
version '1.0.0'
this_is_a_map 'yes'
-- If the pack includes a ytyp:
data_file 'DLC_ITYP_REQUEST' 'stream/my_hospital.ytyp'
fx_version 'cerulean': die aktuelle FXv2-Manifestversion. Finden Sie in älteren Paketen eine Datei__resource.luaund eine Zeileresource_manifest_version, übertragen Sie den Inhalt in eine neue Dateifxmanifest.luaund ersetzen Sie diese veraltete Zeile durch die Zeilenfx_versionundgame.game 'gta5': legt fest, dass die Ressource in FiveM läuft.this_is_a_map 'yes': kennzeichnet die Ressource als Map; laut Cfx.re-Dokumentation wird beim Laden der Ressource der Map-Store neu geladen. Der Wert spielt keine Rolle, die Zeile muss nur vorhanden sein.data_file 'DLC_ITYP_REQUEST' '...': meldet die ytyp-Datei beim Zusatzinhaltssystem des Spiels als dauerhafte Definition an (entsprichtPERMANENT_ITYP_FILEin der Dokumentation). Gibt es mehrere ytyp-Dateien, können Sie einen Platzhalter verwenden:data_file 'DLC_ITYP_REQUEST' 'stream/*.ytyp'.- Ist das Tür- oder Beleuchtungsskript eine eigene Ressource, fügen Sie dessen Manifest
dependency 'my_hospital'hinzu; diese Zeile erzwingt, dass die genannte Ressource zuerst geladen wird. Die in manchen Vorlagen zu sehende Zeilelua54 'yes'ist veraltet (Lua 5.4 ist inzwischen Standard); Sie müssen sie nicht hinzufügen.
Reine YMAP-Pakete, die nur eine .ymap und einige Props enthalten, benötigen die Zeile data_file nicht; fx_version, game und this_is_a_map genügen (author, description und version sind optional).
5. ensure in server.cfg eintragen und Reihenfolge festlegen
ensure startet eine Ressource, wenn sie nicht läuft, und startet sie neu, wenn sie läuft; deshalb wird es start vorgezogen. Es akzeptiert auch einen Kategorienamen:
# Maps
ensure [maps]
# or one by one
ensure my_hospital
ensure my_hospital_doors
Die Reihenfolge ist wichtig:
- Maps hängen nicht vom Framework ab (
es_extended,qb-coreusw.); fassen Sie sie der Übersicht halber in einem eigenen Block unterhalb der Framework-Zeilen zusammen. - Eine Ressource, die eine ytyp bereitstellt, muss vor der ymap starten, die diese ytyp verwendet. Liegen beide im selben Paket, gibt es kein Problem; bei getrennten Paketen legen Sie die Reihenfolge über die Abfolge der
ensure-Zeilen oder mitdependencyfest. - Tragen Sie Map-abhängige Skripte wie Türschlösser, Aufzüge und Teleports nach den Maps ein; ist ein Skript auf eine Map-Ressource angewiesen, fixieren Sie die Reihenfolge mit
dependency.
6. Server starten und im Spiel prüfen
Lesen Sie in der Serverkonsole den neuen Ordner ein und starten Sie die Ressource:
refresh
ensure my_hospital
Laut Cfx.re-Dokumentation durchsucht refresh den Ordner resources erneut und lädt alle gefundenen Manifeste; eine gerade kopierte Ressource wird erst danach sichtbar. Meldet die Konsole, dass die Ressource nicht gefunden wird oder kein Manifest hat, liegt fxmanifest.lua im falschen Ordner; meist handelt es sich um das Problem mit verschachtelten Ordnern. Bei großen Paketen liefert ein vollständiger Neustart das sauberste Ergebnis (wenn Sie txAdmin verwenden, siehe den Neustart-Schritt in der txAdmin-Anleitung).
Begeben Sie sich im Spiel zum Standort der Map und verwenden Sie in der F8-Konsole diese Client-Befehle:
strdbg true
strlist true
strdbg zeigt, was der Streamer gerade lädt; bleibt das Laden der Welt hängen, finden Sie hier die problematische Datei. strlist listet die beim Streamer registrierten Einträge und ihren Status auf; fehlt Ihre ytyp in der Liste, ist der Manifest-Pfad falsch. Wenn Sie fertig sind, schalten Sie die Befehle mit false wieder ab.
7. Auswirkungen auf die Performance messen
Reine Map-Ressourcen enthalten meist keine Skripte; deshalb spiegelt resmon (zeigt die CPU- und Speichernutzung pro Ressource) die tatsächliche Last eines MLO nicht wider. Die eigentliche Last ist der Streaming-Speicher auf dem Computer des Spielers. In der F8-Konsole:
strmem true
strmem listet den Speicherverbrauch der gestreamten Assets einzeln und insgesamt auf. Konzentrieren sich mehrere große MLOs im selben Gebiet, kann es bei Spielern mit wenig Speicher zu fehlenden Texturen und FPS-Einbrüchen kommen. Serverseitig steuern Sie zwei Dinge: die Größe der beim ersten Verbinden heruntergeladenen Dateien und die Pool-Kapazität. Stürzen Spieler mit einem Fehler ab, der einen vollen Pool meldet (zum Beispiel TxdStore), vergrößern Sie diesen Pool in server.cfg; das Beispiel aus der Cfx.re-Dokumentation:
increase_pool_size "TxdStore" 6000
Die Zahl ist nicht die neue Gesamtgröße, sondern der Wert, um den der Pool erweitert wird. Der Befehl wird nur beim Start gelesen; starten Sie den Server nach einer Änderung neu. Zum Messen und Verschlanken lesen Sie die Anleitung zu resmon und FPS-Optimierung.
8. Lizenzierte und Escrow-geschützte Maps
Cfx.re Asset Escrow ist das System, das verhindert, dass andere die Dateien eines Autors bearbeiten oder lesen; es schützt Lua-, YFT-, YDD- und YDR-Dateien. Geschützte Produkte werden nur als Tebex-Pakete verkauft; der Käufer erhält per E-Mail einen Download-Link.
- Damit die Ressource läuft, muss der Serverbetreiber das Produkt gekauft haben. Ihr Server wird über das Cfx.re-Konto erkannt, von dem Sie den
sv_licenseKeyerhalten haben; wurde das Produkt mit einem anderen Konto gekauft, startet die Ressource nicht, und die Konsole zeigt den Fehler „You lack the required entitlement“. - Übergeben Sie den Server an jemand anderen, verwendet der neue Betreiber seinen eigenen Schlüssel; hat auch dieses Konto keine Berechtigung, startet die Map nicht. Fragen Sie den Verkäufer nach den Übertragungsbedingungen.
- Endet das Abonnement eines abonnementbasierten Produkts, wird das Produkt aus dem Konto entfernt und startet nicht mehr auf dem Server.
- Geschützte Dateien können Sie nicht bearbeiten; bearbeitbar sind nur Dateien, die der Autor mit
escrow_ignorevom Schutz ausgenommen hat (zum Beispiel Konfigurationsdateien oder bestimmte Modelle). - Pakete, die als „escrow cracked“ verkauft werden, wurden ohne Erlaubnis des Autors verbreitet und sind nicht vertrauenswürdig; verwenden Sie sie nicht.
Übersicht der Beispielkonfiguration
| Einstellung | Wert | Ort |
|---|---|---|
| Ressourcenordner | resources/[maps]/my_hospital | server-data |
| Spieldateien | Unter stream/ | Ressourcenordner |
fx_version / game | cerulean / gta5 | fxmanifest.lua |
this_is_a_map | yes | fxmanifest.lua |
data_file | DLC_ITYP_REQUEST + ytyp-Pfad | fxmanifest.lua |
| Start | ensure my_hospital (vor abhängigen Skripten) | server.cfg |
| Pool vergrößern | increase_pool_size "TxdStore" 6000 | server.cfg |
| Kontrolle im Spiel | strdbg, strlist, strmem | F8-Konsole |
Häufige Fehler
- Die Map wird überhaupt nicht angezeigt. Prüfen Sie der Reihe nach: die
ensure-Zeile,refresh, die Manifest-Warnung in der Konsole und unter Linux die Groß-/Kleinschreibung der Dateinamen. - Der Spieler fällt durch den Boden. Die Kollisionsdatei (
.ybn) fehlt oder die ytyp wurde nicht geladen. Prüfen Sie mitstrlist, ob ybn und ytyp registriert sind; korrigieren Sie dendata_file-Pfad. - Zwei Maps überlappen sich, und Flächen flackern. Zwei Pakete sind an denselben Koordinaten platziert. Stoppen Sie das zuletzt hinzugefügte Paket vorübergehend mit
stop my_hospital, um das kollidierende zu finden, und entfernen Sie dann eines der beiden. - Props schweben oder sind verschoben. Die YMAP wurde für eine andere Map-Änderung erstellt, die Sie nicht haben, oder die ytyp, von der sie abhängt, wurde nicht geladen. Prüfen Sie die Abhängigkeitshinweise des Autors; starten Sie die Ressource, die die ytyp bereitstellt, zuerst.
- Der Innenraum ist dunkel und leer, oder das Gebäude erscheint aus der Entfernung verspätet. Im ersten Fall wurde die MLO-Definition nicht geladen; prüfen Sie, ob die ytyp in der
strlist-Liste steht und die Datei_manifest.ymfim Paket enthalten ist. Im zweiten Fall ist die LOD-Distanz (lodDist) zu niedrig oder der Streaming-Speicher voll; prüfen Sie dies mitstrmem. - Spieler stürzen beim Verbinden mit einem Fehler ab, der einen vollen Pool meldet. Vergrößern Sie diesen Pool mit
increase_pool_sizeund starten Sie den Server neu. - „You lack the required entitlement“. Die Escrow-Ressource ist nicht dem Cfx.re-Konto Ihres Serverschlüssels zugeordnet; prüfen Sie die in Schritt 8 beschriebene Kontozuordnung.
- Die Texturen einer anderen Map sind defekt. Zwei Pakete verwenden ein Textur-Dictionary (
.ytd) oder einen Archetyp mit demselben Namen; das später hinzugefügte überschreibt das frühere. Entfernen Sie eines der Pakete.
Häufig gestellte Fragen
Kann ich mehrere MLOs in einer einzigen Ressource zusammenfassen?
Ja; Sie können alle in denselben Ordner stream legen und die ytyp-Dateien mit dem Platzhalter 'stream/*.ytyp' angeben. Allerdings wirkt sich eine einzige defekte Datei auf die gesamte Ressource aus; jedes MLO in einer eigenen Ressource zu halten und alle über die Kategorie [maps] zu starten, ist leichter zu verwalten.
Wie viele Maps kann ich hinzufügen?
Es gibt keine feste Grenze; sie ergibt sich aus dem Streaming-Speicher der Spieler und der Downloadgröße beim ersten Verbinden. Prüfen Sie nach jedem neuen Paket die Gesamtnutzung mit strmem und testen Sie mit einem Spieler, der ein schwächeres System hat. Ungenutzte Maps aus den ensure-Zeilen zu entfernen, ist die einfachste Verbesserung.
Kann ich ein gekauftes MLO auch auf meinem zweiten Server verwenden?
Ja. Laut Cfx.re-Dokumentation funktioniert ein heruntergeladenes Escrow-Asset auf jedem Server, den Sie besitzen. Funktioniert es nicht, liegt das meist daran, dass der Schlüssel des zweiten Servers von einem anderen Cfx.re-Konto stammt.
Werden beim Entfernen einer Map gespeicherte Spielerdaten beschädigt?
Eine Map-Ressource schreibt nicht in die Datenbank; es genügt, die ensure-Zeile zu löschen und den Ordner zu entfernen. Aktualisieren Sie lediglich auch die Koordinaten der Skripte, die an diesen Innenraum gebunden sind (Geschäfte, Häuser, Garagen); andernfalls werden Spieler auf leeres Gelände teleportiert.
Verwandte Anleitungen
- FXServer einrichten: FiveM-Server von Grund auf (Windows und Linux)
- Add-on-Fahrzeuge zum FiveM-Server hinzufügen (fxmanifest und stream)
- FiveM-Server optimieren: Resmon lesen und FPS steigern
- txAdmin verwenden: Anleitung zur FiveM-Serververwaltung
- Server-Lizenzschlüssel im Cfx.re Portal erhalten
Alle FiveM-Anleitungen finden Sie in der Kategorie FiveM-Anleitungen. Offizielle Quellen: Cfx.re-Ressourcenmanifest, Cfx.re-Anleitung für Map-Mods und Asset-Escrow-Dokumentation.
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.