FiveM MLO zum Server hinzufügen: Schritt-für-Schritt Anleitung
Schritt-für-Schritt Guide zum Hinzufügen von MLOs zu deinem FiveM Server. Erklärt fxmanifest.lua, Upload via SFTP, server.cfg Registrierung und Fehlerbehebung.
Einführung
Zielgruppe: Serverbetreiber und Entwickler, die bereits einen funktionierenden FiveM-Server betreiben und ihn mit Custom Interior/Exterior Map Assets (MLOs) erweitern möchten.
1 · Voraussetzungen
| Anforderung | Mindestversion | Warum wichtig |
|---|---|---|
| FiveM Server Artifact | 6016 (Build 7116) oder neuer | Ältere Artifacts können keine modernen cerulean fx-Manifeste laden |
| Map Loader | Native (eingebaut) | Kein Extra-Plugin nötig — FiveM streamt Map-Dateien automatisch |
| Server-Zugang | SFTP/SSH + Schreibrechte | Dateien hochladen und server.cfg bearbeiten |
| Legale Lizenz | Kaufnachweis / Freie Nutzungsbedingungen | EU DSGVO & Rockstar-Richtlinien verbieten unlizenzierte Assets |
2 · MLO-Paket herunterladen und prüfen
- Quell-Integrität — Bevorzuge Anbieter mit SHA-256-signierten ZIPs oder öffentlichen Git-Tags.
- Struktur prüfen — Eine konforme Ressource sieht so aus:
my-mlo/
├─ stream/
│ ├─ *.ydr (Modelle)
│ ├─ *.ytyp (Item-Definitionen)
│ ├─ *.ybn (Kollisionen — falls vorhanden)
│ └─ *.ytd (Texturen)
├─ fxmanifest.lua
└─ README.md (optional)
fxmanifest.luaerstellen falls fehlend — Minimales Template:
fx_version 'cerulean'
games { 'gta5' }
author 'DeinName'
description 'Mein Custom MLO'
version '1.0.0'
this_is_a_map 'yes'
files {
'stream/**/*.ydr',
'stream/**/*.ytyp',
'stream/**/*.ytd',
'stream/**/*.ybn'
}
data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'
3 · Ressource hochladen
- Via SFTP mit deinem Server verbinden.
- Zu
/resources/[maps]/navigieren — den Bracket-Ordner erstellen falls nicht vorhanden. - Das gesamte
my-mlo-Verzeichnis unverändert hochladen. Leerzeichen und Großbuchstaben in Ordnernamen vermeiden, um Linux-Pfadprobleme zu verhindern.
4 · In server.cfg registrieren
Nach den grundlegenden Ressourcen anfügen (oder start ersetzen):
ensure my-mlo # Wird beim Start geladen; startet bei txAdmin Soft-Restarts automatisch neu
Datei speichern und den Server neu starten oder refresh → ensure my-mlo in der Live-Konsole ausführen.
5 · Cache leeren & neu starten (falls nötig)
FiveM cached Map-Daten. Um Geister alter Versionen zu vermeiden:
# Linux
rm -rf cache/*
./run.sh +exec server.cfg
# Windows (PowerShell)
Remove-Item -Recurse -Force .\cache\*
run.cmd +exec server.cfg
6 · In-Game Verifikations-Checkliste
| Check | Befehl/Tool | Erfolgs-Kriterium |
|---|---|---|
| Teleport | vMenu → Misc → Teleport → Koordinaten eingeben | Spieler spawnt am neuen Interior/Exterior |
| Textur-Integrität | profile_frame, dann herumgehen | Keine rosa/weißen Platzhalter; FPS-Verlust < 10% |
| Kollision | Wände & Rampen abgehen | Keine unsichtbaren Barrieren oder Durchfallen |
| Beleuchtung | Timecycle-Wechsel mit /time 23 0 | Interior verdunkelt/erhellt korrekt ohne Artefakte |
Falls Fehler auftreten: fehlende .ytd- oder .ybn-Dateien sind meist die Ursache.
7 · Mehrere MLOs sicher streamen
- Eine Ressource pro MLO — vermeidet Hash-Kollisionen.
- Präfix-Namen mit Vendor-Tag, z.B.
bh-bank-lobby, für einfacheres Deaktivieren. - Identische Manifest-Version für alle Map-Ressourcen verwenden.
8 · Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Konsole: "Couldn't parse manifest" | Fehlerhafte Lua-Syntax | lua -p fxmanifest.lua lokal testen; Anführungszeichen/Kommas prüfen |
| MLO sichtbar, Texturen fehlen | .ytd-Dateien nicht referenziert | In files{} aufnehmen oder in stream/ ablegen |
| Spieler crashen beim Joinen | Doppelter Prop-Hash zwischen Maps | Doppelte .ydr umbenennen oder konfliktende Ressource entladen |
| Lange Download-Zeit | Große .ytd-Texturen | Texturen komprimieren (DXT5/BC3) oder skalieren |
9 · Compliance & Datenschutz-Hinweise
| Regelung / Richtlinie | Was zu tun ist | |---|---| | Rockstar Modding Policy (2015-09-15) | Keine Assets mit Rockstar-IP verkaufen | | EU DSGVO Art. 44-49 | Vendor-Rechnungen aufbewahren; Asset-Herkunft auf Anfrage offenlegen | | FiveM ToS §3.2 | Credits intakt lassen; bezahlte Mods nicht öffentlich weiterverteilen |
Fazit
Hochladen → ensure → Neustart; wenn das Manifest gültig ist, ist das neue Interior innerhalb von zwei Minuten live.
Stöbere im VertexMods Shop nach über 485+ MLOs für deinen Server.
