So installierst und überprüfst du ein FiveM MLO

Installiere ein FiveM MLO, indem du das Ressourcenpaket intakt lässt, es nach seinen Abhängigkeiten startest und den genauen Ort im Spiel überprüfst. Ein erfolgreicher Ressourcenstart ist nur die erste Überprüfung: Texturen, Kollisionen, Sichtbarkeit und andere Karten müssen ebenfalls funktionieren.

Bestätige die Ziel-GTA-Edition, bevor du Assets installierst oder exportierst. Legacy-Pakete sind nicht automatisch Enhanced-ready; befolge die offizielle Anleitung zur Enhanced-Asset-Konvertierung wenn dies dein Ziel ist.

Überprüfe das Paket vor dem Hochladen

Lies die unterstützte Spielversion, Abhängigkeiten, Installationshinweise und Lizenz des Erstellers. Behalte das Originalarchiv und die aktuell funktionierende Karte/Konfiguration. Teste zuerst auf einem isolierten Server.

Der Ressourcenordner sollte sein Manifest direkt und seine gestreamten Assets in der dokumentierten Struktur enthalten. Bewahre Namen und versteckte Dateien. Separate Ressourcenordner helfen beim Rollback, verhindern aber keine Modell- oder Karten-Hash-Kollisionen.

Installieren und registrieren

1. Lade die komplette Ressource unter resources hoch, optional in einem Gruppierungsordner wie [maps]. Vermeide einen versehentlichen zusätzlichen Archivordner oberhalb von fxmanifest.lua.
2. Behalte das mitgelieferte Manifest. Falls ein Paket keines hat, ermittle die tatsächlichen Asset-Typen und erforderlichen Deklarationen, bevor du es erstellst; gehe nicht davon aus, dass jede Karte die gleichen Dateien benötigt.
3. Für zusätzliche YTYP-Archetypen überprüfe, ob das Paket DLC_ITYP_REQUEST für seinen echten YTYP-Pfad deklariert. Siehe die offizielle data-file Referenz.
4. Füge ensure gefolgt vom genauen Namen des Ressourcenordners zu server.cfg nach den erforderlichen Abhängigkeiten hinzu. Starte auf der Staging-Umgebung und überprüfe den ersten Konsolenfehler.

Teste den Standort

1. Verwende die dokumentierte Teleportfunktion deines installierten Verwaltungstools oder reise zu den angegebenen Koordinaten. Es gibt keinen universellen Teleport-Slash-Befehl.
2. Gehe durch jede Tür und jede Etage. Überprüfe fehlende Kollisionen, unsichtbare Barrieren, Texturreferenzen, Flackern und Raum-Sichtbarkeit.
3. Teste verschiedene Lichtverhältnisse mit dem Zeit-/Wettersystem, das dein Server tatsächlich verwendet. Vergleiche dieselbe Kameraroute vor und nach der Aktivierung der Karte.
4. Tritt mit einem anderen Spieler bei, verbinde dich erneut und starte neu. Überprüfe einen Client ohne deine lokalen Entwicklungsdateien.

Konflikte lösen und zurücksetzen

Wenn der Bereich nur dann kaputtgeht, wenn eine andere Karte aktiviert ist, vergleiche überlappende Platzierungen und Archetyp-/Modellnamen auf der Staging-Umgebung. Benenne ein Drawable nicht allein um: Referenzen in anderen Dateien können davon abhängen.

Behalte den normalen Cache-Zustand für den ersten Vergleich bei. Lösche nur den spezifischen Cache, der für ein diagnostiziertes Problem mit veralteten Dateien dokumentiert ist, wobei der Client/Server entsprechend gestoppt werden muss. Eine breite rekursive Löschung ist kein Installationsschritt.

Wenn die Karte die Akzeptanzprüfung nicht besteht, stoppe sie, entferne ihre ensure-Zeile und stelle die vorherige Kartenkonfiguration wieder her. Korrigiere die Quelle oder besorge ein kompatibles Paket, bevor du es erneut versuchst.

Referenzdokumentation

Cfx.re — Ressourcenmanifest