Publikum: Serverbesitzer und Entwickler, die bereits eine funktionsfähige FiveM-Instanz betreiben und diese mit benutzerdefinierten Innen-/Außenkarten-Assets (MLOs) erweitern möchten.
1 · Voraussetzungen
| Erfordernis | Mindestversion | Warum es wichtig ist |
|---|---|---|
| FiveM-Serverartefakt | 6016 (Build 7116) oder neuer | Ältere Artefakte können moderne nicht laden himmelblau FX-Manifeste. |
| Kartenlader (bereits integriert) | Standardmäßig nativ | Kein zusätzliches Plugin erforderlich—FiveM streamt Map-Dateien automatisch. |
| Zugriff auf den Server | SFTP/SSH + Schreibberechtigungen | Du musst Dateien hochladen und bearbeiten server.cfg. |
| Rechtliche Lizenz | Kaufnachweis / Bedingungen zur kostenlosen Nutzung | Die DSGVO der EU und die Rockstar-Richtlinien verbieten die Verbreitung nicht lizenzierter Vermögenswerte. |
2 · MLO-Paket herunterladen und prüfen
- Quellenintegrität – Bevorzuge Händler mit SHA-256-signierten ZIPs oder öffentlichen Git-Tags.
- Struktur überprüfen – Eine konforme Ressource ähnelt:
my-mlo/ ├─ stream/ │ ├─ *.ydr ↰ (Modelle) │ ├─ *.ytyp ↰ (Elementdefinitionen) │ ├─ *.ybn ↰ (Kollisionen – falls vorhanden) │ └─ *.ytd ↰ (Texturen) ├─ fxmanifest.lua └─ README.md (optional)
- Erstellen
fxmanifest.luafalls fehlend – Minimale Vorlage:
fx_version 'cerulean'
games { 'gta5' }
author 'DeinName'
description 'Mein benutzerdefinierter 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'
ℹ️ Standards Ressourcenmanifeste folgen dem Schema in FiveM-Dokumente → „Ressourcenmanifest“ (Commit 20b7b15, 11.03.2025)
3 · Ressource hochladen
- Verbinde dich per SFTP mit dem Root deines Servers.
- Navigiere zu
/Ressourcen/[Karten]/—erstelle den bracket-Ordner, falls er nicht existiert. - Lade die gesamte
mein-mloVerzeichnis unverändert. Vermeide Leerzeichen und Großbuchstaben in Ordnernamen, um Linux-Pfadprobleme zu vermeiden.
4 · Registriere dich in server.cfg
Anhängen (oder ersetzen Start) nach wesentliche Basisressourcen:
Stelle sicher, dass my-mlo # beim Booten geladen wird; startet automatisch bei txAdmin Soft‑Neustarts neu.
Speichere die Datei und Neustart den server oder ausführen Aktualisieren ➜ Sicherstellen, dass mein MLO in der Live-Konsole.
5 · Cache leeren und neu starten (falls erforderlich)
FiveM zwischenspeichert Kartendaten. Um Geister älterer Versionen zu vermeiden:
# Linux rm -rf cache/* ./run.sh +exec server.cfg # Windows (PowerShell) Remove-Item -Recurse -Force .cache* run.cmd +exec server.cfg
Wie du den Cache von FiveM-Servern leerst
6 · Checkliste zur In-Game-Verifizierung
| Überprüfen | Befehl/Werkzeug | Kriterien für das Bestehen |
| Teleport | vMenü → Verschiedenes → Teleportieren → Koordinaten eingeben | Der Spieler erscheint im neuen Innen-/Außenbereich. |
| Texturintegrität | Profilrahmen dann lauf herum | Keine rosa/weißen Platzhalter; FPS-Verlust < 10%. |
| Kollision | Laufstege & Rampen | Keine unsichtbaren Barrieren oder Durchbrüche im Boden. |
| Beleuchtung | Zeitzyklusänderung mit /Zeit 23 0 | Der Innenraum wird korrekt abgedunkelt/aufgehellt, ohne dass Artefakte auftreten. |
Wenn Fehler auftreten, überprüfe die Dateiliste – fehlt .Jahresverlauf oder .ybn ist der übliche Übeltäter.
7 · Sicheres Streamen mehrerer MLOs
- Eine Ressource pro MLO. Dadurch werden Hash-Kollisionen umgangen.
- Präfixnamen mit Vendor-Tag, zB
BH-Bank-Lobby, zum einfacheren Deaktivieren. - Verwende dieselbe Manifestversion für alle Kartenressourcen, um Parse-Warnungen zu vermeiden.
8 · Kurzübersicht zur Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Auflösung |
| Konsole: Manifest konnte nicht analysiert werden | Schlechte Lua-Syntax | Laufen lua -p fxmanifest.lua lokal; Anführungszeichen/Kommas korrigieren. |
| MLO sichtbar, Texturen fehlen | .Jahresverlauf Dateien nicht referenziert | Füge sie hinzu Dateien{} oder platzieren in Strom/. |
| Spieler stürzen beim Beitritt ab | Duplikat des Prop-Hashes über alle Karten hinweg | Duplikat umbenennen .ydr oder in Konflikt stehende Ressourcen entladen. |
| Lange Downloadzeit | Groß .Jahresverlauf Texturen | Texturen komprimieren (DXT5 / BC3) oder verkleinern. |
9 · Compliance- und Datenschutzhinweise
| Regulierung/Richtlinie | Was du tun musst |
| Rockstar-Modding-Richtlinien (15.09.2015) | Verkaufe keine Assets, die Rockstar-IP enthalten. |
| EU-DSGVO Art. 44-49 | Speichere Rechnungen der Verkäufer; gib den Ursprung der Vermögenswerte auf Anfrage der Nutzer preis. |
| FiveM Nutzungsbedingungen §3.2 | Behalte die Credits bei; veröffentliche keine kostenpflichtigen Mods öffentlich. |
Abschluss
Hochladen → sicherstellen → Neustart; wenn das Manifest gültig ist, ist Ihr neues Interieur innerhalb von zwei Minuten live.
Brauchst du neue MLOs?
Quellen
- FiveM Docs – Ressourcenmanifeste (abgerufen am 22. Mai 2025)
- Rockstar Games – Modding-Richtlinie, 15. September 2015
- Verordnung (EU) 2016/679 (DSGVO), Artikel 44–49
Praktische Checkliste
Verwende diesen Leitfaden als Checkliste für die Vorbereitung, bevor du einen Live-FiveM-Server änderst. Bestätige die aktuelle Server-Artifact-Version, Framework-Version, Ressourcenabhängigkeiten, Datenbankänderungen und alle clientseitigen Dateien, bevor du die Änderung vornehmen.
- Sichere die betroffenen Konfigurationsdateien und Datenbanktabellen.
- Wende die Änderung zuerst auf einem Testserver an.
- Beobachte die Serverkonsole und die Client-F8-Konsole auf Fehler.
- Überprüfe, ob die Änderung Jobs, Inventar, Fahrzeuge, Karten, Sprache, Berechtigungen oder Spielerdaten betrifft.
- Dokumentiere genau die Datei, den Befehl oder die Einstellung, die du geändert hast, damit sie schnell rückgängig gemacht werden kann.
Tests vor der Produktion
Nach dem ersten Test, tritt mit einem normalen Spielerkonto bei und wiederhole den Ablauf aus der Spielerperspektive. Wenn das Thema Leistung betrifft, messe vor und nach mit der gleichen Spieleranzahl, Route und Ressourcensatz. Wenn es Admin-Tools oder Berechtigungen betrifft, überprüfe sowohl erlaubte als auch verwehrte Benutzer.
Häufige Fehler
Die meisten FiveM-Probleme entstehen durch fehlende Abhängigkeiten, veraltete Cache, falsche Ordnernamen, Framework-Inkompatibilität oder Konfigurationen, die von einem anderen Server kopiert wurden. Vermeide es, mehrere Systeme gleichzeitig zu ändern; mache eine Änderung, teste sie und fahre dann fort.
Verwandte Ressourcen
Für produktionsbereite Assets, vergleiche bezahlte Ressourcen in der FiveMX Shop. Für kostenlose Ressourcen, durchsuche kostenlose FiveM-Skripte und jede Ressource vor der öffentlichen Verwendung testen.
Produktionsausrollungsnotizen
Bevor du diese Anleitung auf einem Live-FiveM Server verwendest, definiere das genaue Ergebnis, das du von der Änderung erwartest. Für Wie man FiveM MLO zum Server hinzufügt bedeutet das, zu prüfen, welche Ressource, Einstellung, Befehl oder Arbeitsablauf betroffen ist und zu bestätigen, dass die Änderung zu deinem aktuellen Framework, der Artifact-Version und den Server-Regeln passt. Halte die Änderung klein genug, damit du sie schnell rückgängig machen kannst, falls Spieler Fehler melden.
Verwende einen Staging-Server mit dem gleichen Framework, Datenbankschema, Ressourcenreihenfolge und Schlüsselabhängigkeiten wie die Produktion. Wenn das Thema Gameplay, Berechtigungen, Visuals, Sprache, Fahrzeuge, Karten, Inventar oder Wirtschaftliches Verhalten ändert, teste mit mindestens einem Admin-Konto und einem normalen Spielerkonto. Beobachte die Serverkonsole, Client-F8-Protokolle und Ressourcen-Timing, während du den genauen Spielerablauf wiederholst, der auf dem Live-Server stattfinden wird.
Checkliste für den Rollback
- Speichere die vorherige Konfigurationsdatei, den Ressourcenordner und den Datenbankzustand, bevor du etwas änderst.
- Zeichne die Ressourcenversion, den Commit, die Download-Seite oder den Einstellungswert auf, den du getestet hast.
- Starte nur die betroffene Ressource zuerst, wenn möglich, und starte dann den gesamten Server neu, wenn Abhängigkeiten dies erfordern.
- Wenn Fehler auftreten, setze die einzelne geänderte Ressource oder Einstellung zurück, bevor du einen anderen Fix testest.
Wartungshinweise
Überprüfe diese Einrichtung erneut nach FiveM-Artifact-Updates, Framework-Updates oder größeren Ressourcenänderungen. Eine Konfiguration, die heute funktioniert, kann nach Abhängigkeitsupdates, umbenannten Exports, geänderten Ereignissen oder Datenbankmigrationen brechen. Halte Notizen mit deiner Serverdokumentation, damit zukünftige Admins verstehen, was geändert wurde, warum es geändert wurde und wie sie es erneut überprüfen können.
Laufende Überprüfung
Überprüfe Wie man FiveM MLO zum Server hinzufügt nach größeren FiveM Artifact-Updates, Framework-Änderungen oder Ressourcen-Migrationen. Bestätige, dass die Ratschläge noch mit dem aktuellen Serververhalten übereinstimmen, dass alle verlinkten Quellen noch verfügbar sind und dass die Installationsschritte noch mit den Dateien übereinstimmen, die ein Serverbesitzer tatsächlich herunterladen oder konfigurieren wird.
Bei öffentlichen Servern empfiehlt es sich, neben der Serverdokumentation ein kurzes Änderungsprotokoll zu führen. Darin sollten die getesteten Funktionen, die Änderungen, die zur Verifizierung verwendeten Accounts und die Vorgehensweise zum Zurücksetzen auf ältere Server vermerkt werden. Dies beschleunigt zukünftige Wartungsarbeiten und verhindert, dass alte Konfigurationshinweise unklar oder unsicher für die Spieler werden.
