FiveM-Addon-Auto spawnt nicht? Häufige Fehler und wie du sie findest

Du hast ein Auto hinzugefügt, neu gestartet, seinen Spawn-Namen eingegeben, und nichts passiert. Oder es spawnt ohne Texturen, oder es fährt genau wie ein anderes Auto. Ein Addon-Auto besteht aus einer Handvoll Dateien, die sich gegenseitig über ihre Namen finden müssen, und ein falscher Name reicht.

Woraus ein Addon-Auto besteht

• stream/: das Modell (<name>.yft, und <name>_hi.yft für die Nähe) und seine Texturen (<name>.ytd).
• Die Metas: vehicles.meta (das Auto selbst), handling.meta, carvariations.meta (Farben, Kits, Liveries) und oft carcols.meta (Sirenen, Lichter, Modkits).
• Das fxmanifest, das die Metas in files auflistet und jede mit ihrer data_file-Zeile lädt.

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

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

Die üblichen Fehler

• Kein fxmanifest.lua (auch kein altes __resource.lua, oder es heißt noch .off): FiveM lädt den Ordner gar nicht.
• Eine data_file-Zeile, die auf eine Datei zeigt, die nicht da ist, oder eine Meta im Ordner, die keine data_file-Zeile lädt.
• Kein files { }-Block: Die Metas müssen darin aufgeführt sein, sonst bekommen Spieler sie vielleicht nie.
• modelName, das nicht zur .yft passt. Der Spawn-Name ist der Modellname; eine Datei mit anderem Namen wird nie gefunden.
• txdName, der nicht zur .ytd passt: Das Auto erscheint ohne Textur.
• handlingId, das in keiner handling.meta steht, weder in der des Packs noch in der des Spiels.
• Eine Sirenen-ID oder ein Modkit-Name in carvariations.meta, den nichts definiert: keine Sirenen oder keine Tuningteile.
• Zwei Dateien mit demselben Namen im Stream-Ordner: Nur eine davon wird genutzt.

Namen mit mehr als 11 Zeichen sind eine weitere Falle: Das Spiel schneidet ein gameName dort ab, und manche Scripts machen dasselbe mit dem Modellnamen.

In Sekunden finden

Zieh den Ressourcenordner des Autos in den Vehicle Pack Check. Es läuft im Browser (es wird nichts hochgeladen) und prüft all das oben Genannte gegen die eigenen Handlings, Sirenen und Modkits des Spiels. Dann listet es die Befunde auf, Fehler zuerst, mit Meldungen wie "No fxmanifest.lua", "<model>.yft is not in the folder", "Its textures, <txd>.ytd, are not in the folder" oder "handlingId X is in no handling.meta here or in the game" (also etwa: keine fxmanifest.lua, <model>.yft fehlt im Ordner, die Texturen <txd>.ytd fehlen im Ordner, handlingId X steht weder hier noch im Spiel in einer handling.meta) …

Fehler verhindern, dass ein Auto lädt oder funktioniert: Behebe sie zuerst. Warnungen sind Dinge, die funktionieren, aber falsch aussehen, etwa eine fehlende _hi.yft (das Auto nutzt aus der Nähe sein normales Modell) oder eine gestreamte Datei über 16 MB.

Nur die .yft und .ytd vorhanden?

Wenn das Auto als lose .yft und .ytd ohne Metas kam, schreibt sie der Vehicle Addon Builder. Zieh das Modell hinein, wähle das nächste Spielauto als Vorlage (nach Größe, Rädern und Art vorgeschlagen), lege den Spawn-Namen fest (bis zu 11 Zeichen) und den Namen, der im Spiel angezeigt wird, passe Masse, Geschwindigkeit, Bremsen und Grip an, wenn du willst, und lade eine fertige Ressource mit den Metas, den data_file-Zeilen und einer README herunter. Es prüft auch das Modell: kein Sitz für den Fahrer, keine Kollision, unsichtbare Räder.

Dann ensure es, starte neu und spawn es über seinen Spawn-Namen (mit dem Befehl deines Frameworks, etwa /car <name> auf ESX, oder über txAdmin).

Fragen

Es spawnt, hat aber keine Texturen. Warum?

Sein txdName in vehicles.meta passt zu keiner .ytd im Stream-Ordner. Für Teile, die weiß bleiben, siehe warum FiveM-Texturen weiß oder lila sind.

Brauche ich carcols.meta?

Nur für Sirenen, Lichter oder Modkits des Autos selbst. Ohne sie nutzt das Auto, worauf seine carvariations.meta zeigt.

Das passende Tool

Vehicle Pack Check

Zieh den Ordner deiner Fahrzeugressource hinein: fehlende Metas, falsche Namen und Stream-Fehler, Fehler zuerst, mit dem, was zu beheben ist.

Vehicle Pack Check öffnen

Auch hier nützlich: Vehicle Addon Builder