So fügst du Addon-Autos auf einem FiveM-Server hinzu: stream- und data-Dateien

Du hast ein Auto-Paket, das du auf deinem Server haben möchtest, und der Ordner enthält Dateien wie .yft, .ytd und mehrere .meta-Dateien. Diese Anleitung erklärt, wohin jede Datei geht, was die fxmanifest.lua braucht und wie du das Auto spawnst, mit dem Unterschied zwischen Addon- und Ersatz-Autos.

#Was ein Addon-Auto-Paket enthält

Ein Auto gibt es in zwei Arten von Dateien:

• Modell- und Texturdateien, die in einen stream-Ordner gehen: mycar.yft (das Modell), mycar_hi.yft (das hochdetaillierte Modell), mycar.ytd (Texturen) und manchmal .ydr oder .ytyp Dateien.
• Datendateien, die in einen data-Ordner gehen: vehicles.meta, carvariations.meta, carcols.meta und handling.meta, und manchmal vehiclelayouts.meta.

Der erste Satz ist das Aussehen des Autos, der zweite Satz ist, was es ist: sein Name, Farben, Handling und Sitze.

#Die Ordnerstruktur

Erstelle eine Ressource für das Auto oder eine für ein ganzes Paket:

resources/[cars]/mycar/
  fxmanifest.lua
  stream/
    mycar.yft
    mycar_hi.yft
    mycar.ytd
  data/
    vehicles.meta
    carvariations.meta
    carcols.meta
    handling.meta

Dateien in stream werden automatisch an Spieler gesendet. Du musst sie nicht im Manifest auflisten. Dateien in data werden nicht gestreamt, und das Manifest muss sie deklarieren.

#Die fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

files {
    'data/vehicles.meta',
    'data/carvariations.meta',
    'data/carcols.meta',
    'data/handling.meta',
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'

Der files {}-Block macht die Dateien für den Spiel-Client verfügbar. Jede data_file-Zeile teilt dem Spiel mit, welcher Typ eine Datei ist. Zwei Regeln sind wichtig:

• Jede Datei braucht beide: einen Eintrag in files und eine data_file-Zeile mit dem richtigen Typ.
• Ein Paket mit vielen Autos hat oft einen data-Ordner pro Auto. Du kannst ein Muster wie 'data/**/*.meta' in files {} verwenden, aber die data_file-Zeilen für diese Dateien müssen trotzdem geschrieben werden, eine pro Typ, und die Typ-Zeilen akzeptieren das gleiche Muster.

files { 'data/**/*.meta' }

data_file 'HANDLING_FILE' 'data/**/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/**/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/**/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/**/carvariations.meta'

Wenn das Paket auch eine vehiclelayouts.meta hat, deklariere sie auch mit data_file 'VEHICLE_LAYOUTS_FILE' 'data/vehiclelayouts.meta'.

#Starte es und spawne es

Füge in server.cfg die Ressource hinzu:

ensure mycar

Der Ressourcen-Ordnername und der ensure-Name müssen übereinstimmen. Wenn du einen Klammer-Ordner wie [cars] verwendest, startet ensure [cars] alles darin.

Der Spawn-Name ist die modelName in vehicles.meta:

<Item>
  <modelName>mycar</modelName>
  <txdName>mycar</txdName>
  <handlingId>MYCAR</handlingId>
  ...
</Item>

Hier spawnst du es mit mycar. In einem Skript:

local model = joaat('mycar')
lib.requestModel(model)
local veh = CreateVehicle(model, coords.x, coords.y, coords.z, heading, true, false)

lib.requestModel ist von ox_lib. Ohne dies aufrufen RequestModel(model) und warten, bis HasModelLoaded(model) wahr ist. Die meisten Admin-Menüs und das txAdmin-Menü spawnen ein Auto nach dem gleichen Namen.

Tipp: Die modelName, die Namen der .yft/.ytd-Dateien und die txdName sollten alle übereinstimmen. Eine Nichtübereinstimmung ist das erste, was überprüft werden sollte, wenn ein Auto nicht erscheint.

#Addon-Autos versus Ersatz-Autos

Ein Addon-Auto hat einen neuen Namen, den das Basis-Spiel nicht verwendet, zum Beispiel mycar. Es braucht die obigen Datendateien und fügt ein Auto zur Liste hinzu. Sowohl dein neues Auto als auch die ursprünglichen Autos existieren. Dies ist die richtige Wahl für fast alle Autos heute.

Ein Ersatz-Auto verwendet die Dateinamen eines Autos aus dem Basis-Spiel, wie sultan.yft, und legt sie in einen stream-Ordner. FiveM lädt dann dein statt des Originals, überall wo dieses Auto erscheint, einschließlich im Verkehr. Es braucht normalerweise keine vehicles.meta für das Modell, da das Spiel bereits den Namen kennt. Ein Ersatz-Auto ändert nur das Aussehen. Wenn du anderes Handling möchtest, brauchst du die passende handling.meta mit der ursprünglichen Handling-ID.

Vermische die beiden Ideen nicht in einem Ordner. Ein Paket, das Ersatz- und Addon-Dateien mischt, ist eine häufige Quelle für verwirrende Bugs.

#Überprüfe das Ergebnis

• Starte den Server und lese die Konsole. Ressourcenfehler, wie eine fehlende Datei in files, erscheinen beim Start. Wenn die Ressource überhaupt nicht startet, siehe konnte Ressource nicht starten.
• Tritt bei und spawne das Auto. Wenn ein Auto nicht gefunden wird, stimmt der Name nicht mit der modelName überein, oder die Ressource ist nicht gestartet.
• Öffne die Farben und das Handling des Autos im Spiel, um zu überprüfen, dass die Dateien carcols.meta und handling.meta verwendet werden.

#Häufige Probleme

• Das Auto existiert nicht. Überprüfe ensure, die files-Einträge und die modelName. Ein Tippfehler in einem Pfad in files stoppt die Ressource.
• Das Auto ist unsichtbar, weiß oder hat falsche Texturen. Die .ytd fehlt oder heißt anders als das Modell. Siehe Oversized Assets, wenn du auch Streaming-Warnungen siehst.
• Das Auto handelt sich wie ein Standard-Auto. Die handling.meta ist nicht deklariert, oder ihre handlingId stimmt nicht mit der in vehicles.meta überein.
• Ein auf DLC basierendes Auto wird als beschädigt angezeigt. Einige Autos brauchen einen neueren Spiel-Build. Stelle einen mit sv_enforceGameBuild in server.cfg ein: siehe sv_enforceGameBuild und DLC.

#Checkliste