Wie man ein MLO auf einem FiveM-Server installiert: Stream, fxmanifest, ensure

Du hast ein Kartenpaket mit Dateien wie .ymap, .ytyp, .ybn und .ydr heruntergeladen, und du möchtest es auf deinem Server haben. Diese Anleitung zeigt das Ordnerlayout, die fxmanifest.lua, die server.cfg-Zeile und eine schnelle Weise, es im Spiel zu testen.

#Was ist in einem Kartenpaket

Ein MLO (ein benutzerdefiniertes Inneres) oder eine Karte ist eine normale Ressource. Die üblichen Dateien sind:

• .ymap: wo die Objekte und das Innere in der Welt sitzen.
• .ytyp: die Definition des Inneren und seiner benutzerdefinierten Props (ihre "Archetypes").
• .ybn: die Kollisionen. Ohne sie fällst du durch den Boden oder läufst durch Wände.
• .ydr und .ydd: die 3D-Modelle von Props und Teilen.
• .ytd: die Texturen.

All diese gehen in einen Ordner namens stream. FiveM sendet alles in stream von allein zu den Spielern, daher musst du diese Dateien nicht im Manifest auflisteten.

#Die Ordnerstruktur

resources/[maps]/my_mlo/
  fxmanifest.lua
  stream/
    my_mlo.ymap
    my_mlo.ytyp
    my_mlo.ybn
    my_mlo_props.ydr
    my_mlo.ytd

Viele Packs kommen mit einer anderen Ebene, z.B. my_mlo-master/my_mlo/. Verschiebe den Ordner, der fxmanifest.lua hält, in resources, oder der Server kann die Ressource nicht finden.

#Die fxmanifest.lua

Wenn das Pack ohne ein Manifest kommt, erstelle eines:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

this_is_a_map 'yes' teilt FiveM mit, dass die Ressource Kartendaten hält. Wenn das Pack eine .ytyp-Datei hat, füge die Zeile hinzu, die sie registriert:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

data_file 'DLC_ITYP_REQUEST' 'stream/my_mlo.ytyp'

Verwende eine data_file-Zeile pro .ytyp-Datei. Der Pfad ist der echte Pfad im Ordner, daher überprüfe den Namen und die Großschreibung der Buchstaben.

Tipp: Wenn das Pack bereits ein Manifest mitgebracht hat, behalte es. Der Autor schrieb es für diese genauen Dateien, und es listet oft mehrere .ytyp-Dateien oder zusätzliche Optionen auf, die du nicht raten möchtest.

#Füge es zu server.cfg hinzu

ensure my_mlo

Der Name nach ensure muss der Ordnername sein. Um eine ganze Gruppe zu starten, lege die Karten in einen Klammer-Ordner und verwende ensure [maps]. Karten hängen nicht von deinem Framework ab, aber starte sie nach deinen anderen Base-Ressourcen, damit ein Kartenfehler die wichtigen nicht blockieren kann. Mehr darüber in server.cfg resource order.

Starte den Server neu, oder geben ensure my_mlo in die txAdmin Live-Konsole ein. Ein neuer .ytyp ist zuverlässiger mit einem vollständigen Neustart.

#Game Build-Anforderung

Einige Karten verwenden Props oder Modelle aus einem neueren GTA V DLC. Auf dem Standard-Game-Build fehlen diese Props: Du siehst leere Räume, eine weiße Box oder gar kein Inneres. Die Seite des Packs sagt normalerweise den Build, den es braucht. Stelle ihn in server.cfg ein und starte neu:

set sv_enforceGameBuild 3095

Die Zahl oben ist nur ein Beispiel: Verwende die, die das Pack fragt. Die volle Liste und die Nebenwirkungen sind in sv_enforceGameBuild and DLC.

#Teste es im Spiel

1. Lese die txAdmin-Konsole beim Start. Fehler wie eine fehlende Datei in data_file zeigen sich dort. Wenn die Ressource nicht startet, siehe couldn't start resource.
2. Trittbei dem Server bei. Gehe zu den Koordinaten in der Readme des Packs, mit dem txAdmin-Menü-Teleport oder einem Koordinaten-Befehl aus deinem Admin-Skript.
3. Gehe durch die Tür. Ein benutzerdefiniertes Inneres lädt oft nur, wenn du nah bist, daher komm zu Fuß und nicht von weit weg mit hoher Geschwindigkeit.
4. Überprüfe den Boden und die Wände. Wenn du fällst oder hindurchgehst, fehlen die .ybn-Dateien oder sind nicht geladen. Siehe falling through the map.

#Häufige Probleme

• Das Innere erscheint nicht. Die Ressource ist nicht gestartet, die Koordinaten sind falsch, oder ein neuerer Game Build wird benötigt. Überprüfe auch, dass die Dateien in stream und nicht eine Ebene tiefer in einem Unterordner sind, den die Ressource nicht verwendet.
• Props fehlen, aber Wände sind da. Das .ytyp ist nicht registriert. Füge die DLC_ITYP_REQUEST-Zeile hinzu, mit dem richtigen Dateinamen.
• Ein Teil des Raums flackert oder Wände sind weg. Eine andere Karte bedeckt den gleichen Bereich. Siehe map conflicts.
• Texturen sehen falsch oder schwer aus. Große Texturen kosten Streaming-Speicher. Siehe oversized assets.
• Es funktionierte, dann brach nach einem Update ab. Lösche den Client-Cache und versuche es erneut: clear the FiveM cache.

#Viele Karten auf einem Server

Jede Karte fügt gestreamte Dateien hinzu, die jeder Spieler herunterlädt und im Speicher behält. Installiere nur die Karten, die du verwendest, lege jede in ihre eigene Ressource und benenne sie deutlich. Wenn etwas kaputt geht, kannst du dann eine Ressource nach der anderen stoppen und die Ursache finden.

#Checkliste