Wie installiere ich MLOs und Custom Maps auf meinem FiveM-Server?

Willst du deinem FiveM-Server mit eigenen Interieurs und Map-Anpassungen einen individuellen Look verpassen? Dann landest du schnell bei MLOs und ymap-Dateien. In dieser Anleitung installierst du Schritt für Schritt ein MLO oder eine Custom Map auf deinem Server bei MC-Node: Du legst die richtige Ordnerstruktur mit einem stream-Ordner an, erstellst eine korrekte fxmanifest.lua, lädst die Resource per SFTP hoch und aktivierst alles mit ensure in deiner server.cfg. Außerdem erfährst du, wie du die bekanntesten Probleme löst, etwa Interieurs, die nicht laden, oder Spieler, die durch den Boden fallen.

Was ist der Unterschied zwischen einem MLO und einer ymap?

Beide verändern die Spielwelt, aber auf unterschiedliche Weise:

• Ymap — eine Platzierungsdatei, die vorhandene Objekte (Props) in der Welt platziert oder verschiebt: Zäune, Deko, Straßensperren oder ein zusätzliches Gebäude von außen. Leicht und simpel; oft genügt eine einzelne .ymap-Datei.
• MLO (Multi-Level Object) — ein vollwertiges, begehbares Interieur mit eigenen Räumen, Portalen, Collision und Beleuchtung. Ein MLO besteht meist aus mehreren Dateien: .ydr (Modelle), .ybn (Collision), .ytd (Texturen), einer .ytyp (Interieur-Definition) und einer .ymap (Platzierung).

Kurz gesagt: Eine ymap stellt etwas hin, ein MLO baut etwas, das du betreten kannst. Die Installation läuft fast identisch ab, aber ein MLO ist fehleranfälliger, weil die .ytyp korrekt geladen werden muss.

Schritt 1: Lege die richtige Ordnerstruktur an

1. Entpacke das heruntergeladene MLO oder die Custom Map auf deinem Computer und schau dir an, welche Dateien enthalten sind.
2. Erstelle einen Resource-Ordner mit einem kurzen Namen ohne Leerzeichen oder Großbuchstaben, zum Beispiel vanilla_hotel.
3. Lege alle Stream-Dateien (.ydr, .ybn, .ytd, .ytyp und .ymap) in einen Unterordner mit dem Namen stream.
4. Lege im Hauptordner der Resource eine Datei fxmanifest.lua an.

Die Struktur sieht dann so aus:

vanilla_hotel/
├── fxmanifest.lua
└── stream/
    ├── hotel_interior.ydr
    ├── hotel_interior.ybn
    ├── hotel_textures.ytd
    ├── hotel.ytyp
    └── hotel.ymap

Eine minimale, korrekte fxmanifest.lua für eine Map-Resource:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

Die Zeile this_is_a_map 'yes' teilt FiveM mit, dass diese Resource Weltdaten enthält, damit die Map beim Neustart der Resource sauber neu geladen wird. Liefert der Ersteller zusätzliche Zeilen mit, etwa data_file 'DLC_ITYP_REQUEST' 'stream/hotel.ytyp', lass sie einfach stehen.

Schritt 2: Lade die Resource per SFTP hoch

1. Verbinde dich per SFTP mit deinem Server. Wie du das einrichtest, liest du in SFTP mit WinSCP oder FileZilla.
2. Navigiere zum Ordner resources deines FiveM-Servers.
3. Lade den kompletten Resource-Ordner hoch, inklusive des stream-Unterordners. Du kannst die Resource auch in einen Kategorie-Ordner wie [maps] legen.
4. Nutzt du FileZilla? Stelle dann vor dem Hochladen Übertragen → Übertragungstyp → Binär ein. Im ASCII- oder Auto-Modus kann FileZilla Binärdateien wie .ydr und .ybn beschädigen, wodurch dein Interieur nie lädt.

Kleine Resources kannst du auch über den Tab Files im Panel hochladen, aber bei MLOs mit großen Stream-Dateien ist SFTP zuverlässiger. Die allgemeine Vorgehensweise findest du in Wie lade ich ein Script hoch?

Schritt 3: Trage die Resource mit ensure in die server.cfg ein

1. Öffne die server.cfg über den Tab Files im Panel (oder per SFTP).
2. Füge die Zeile ensure vanilla_hotel hinzu, mit exakt demselben Namen wie dein Resource-Ordner.
3. Achte auf die Reihenfolge: Setze Map-Resources über Scripts, die das Interieur benötigen, etwa Housing-, Garagen- oder Teleport-Scripts. Bei falscher ensure-Reihenfolge startet so ein Script, während das Interieur noch gar nicht existiert.
4. Speichere die Datei und starte deinen Server über den Tab Console neu.
5. Prüfe in der Konsole, ob Started resource vanilla_hotel erscheint, und lauf im Spiel zur Location.

Häufige Probleme

• Interieur ist unsichtbar oder lädt nicht — Prüfe zuerst in der Konsole, ob die Resource wirklich gestartet ist. Startet sie, wurde die Datei oft beschädigt hochgeladen oder die .ytyp wird nicht geladen: Lade den kompletten stream-Ordner erneut im Binär-Modus hoch und prüfe, ob this_is_a_map 'yes' in der fxmanifest.lua steht.
• Du fällst durch den Boden — Die Collision-Datei (.ybn) fehlt oder ist beschädigt. Vergleiche die Dateigrößen auf dem Server mit denen auf deinem PC; weichen sie ab, ist beim Hochladen etwas schiefgelaufen.
• Zwei MLOs an derselben Stelle — Flackernde Wände, doppelte Türen oder ein schwarzes Interieur deuten meist auf zwei Resources hin, die dasselbe Gebäude verändern. Entferne die ensure-Zeile von einer der beiden und starte den Server neu.
• Fehlermeldung wegen zu großer Assets — Eine Konsolenmeldung, dass ein Asset das Size-Limit überschreitet, liegt fast immer an zu schweren .ytd-Texturdateien. Nutze eine optimierte Version oder verkleinere die Texturen (zum Beispiel von 4K auf 2K); zu schwere Maps sorgen außerdem für lange Ladezeiten und Client-Crashes.
• Script-Errors nach dem Hinzufügen der Map — Prüfe die Reihenfolge in der server.cfg: Die Map-Resource muss vor den Scripts geladen werden, die darauf verweisen.

Fertig!

Dein Server streamt jetzt deine eigenen MLOs und Custom Maps. Kommst du trotzdem nicht weiter? Eröffne ein Ticket über unsere Supportseite und gib den Namen der Resource sowie die exakte Fehlermeldung aus der Konsole an.