Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

FiveM

FiveM MLO und YMAP installieren: So fügen Sie eine eigene Map hinzu

26 August 2026 12 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

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-data und Ihre Datei server.cfg bereitstehen.
  • 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_licenseKey in server.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.cfg und Ihres Ordners resources. 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.

MerkmalYMAPMLO
FunktionPlatziert vorhandene Modelle auf der MapDefiniert 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-EngineGering; steigt mit der Anzahl der PropsHöher; Modell-, Textur- und Kollisionsdaten belegen Streaming-Speicher
Anforderung an das Manifestthis_is_a_map genügtthis_is_a_map; in den meisten Paketen außerdem data_file für die ytyp und eine _manifest.ymf
Häufige ProblemeZ-Fighting (Flackern überlappender Flächen), verrutschte PropsDurchfallen 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:

EndungInhaltAblageort
.ydr / .ydd / .yft3D-Modell (einzeln, Dictionary, Fragment)stream/
.ytdTextur-Dictionarystream/
.ybnKollisionsgrenzenstream/
.ytypArchetyp- und MLO-Definitionenstream/ + Eintrag im Manifest
.ymapPlatzierungstream/
_manifest.ymfEin mit dem Werkzeug Manifest Generator von CodeWalker erzeugtes Manifest; laut Cfx.re-Anleitung erforderlich, damit Modelle korrekt geladen werdenstream/
fxmanifest.luaRessourcendefinitionStammverzeichnis 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 aber hospital.ytyp, wird die ytyp nicht geladen.
  • Archive enthalten oft verschachtelte Ordner (my_hospital/my_hospital/stream). Die Datei fxmanifest.lua muss direkt im Stammverzeichnis des Ressourcenordners liegen, neben dem Ordner stream.
  • Legen Sie alle Spieldateien in stream ab; 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.lua und eine Zeile resource_manifest_version, übertragen Sie den Inhalt in eine neue Datei fxmanifest.lua und ersetzen Sie diese veraltete Zeile durch die Zeilen fx_version und game.
  • 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 (entspricht PERMANENT_ITYP_FILE in 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 Zeile lua54 '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:

  1. Maps hängen nicht vom Framework ab (es_extended, qb-core usw.); fassen Sie sie der Übersicht halber in einem eigenen Block unterhalb der Framework-Zeilen zusammen.
  2. 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 mit dependency fest.
  3. 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_licenseKey erhalten 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_ignore vom 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

EinstellungWertOrt
Ressourcenordnerresources/[maps]/my_hospitalserver-data
SpieldateienUnter stream/Ressourcenordner
fx_version / gamecerulean / gta5fxmanifest.lua
this_is_a_mapyesfxmanifest.lua
data_fileDLC_ITYP_REQUEST + ytyp-Pfadfxmanifest.lua
Startensure my_hospital (vor abhängigen Skripten)server.cfg
Pool vergrößernincrease_pool_size "TxdStore" 6000server.cfg
Kontrolle im Spielstrdbg, strlist, strmemF8-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 mit strlist, ob ybn und ytyp registriert sind; korrigieren Sie den data_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.ymf im Paket enthalten ist. Im zweiten Fall ist die LOD-Distanz (lodDist) zu niedrig oder der Streaming-Speicher voll; prüfen Sie dies mit strmem.
  • Spieler stürzen beim Verbinden mit einem Fehler ab, der einen vollen Pool meldet. Vergrößern Sie diesen Pool mit increase_pool_size und 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

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.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.