Custom Fahrzeuge zu deinem FiveM-Server hinzufuegen

Custom Fahrzeuge fallen auf den meisten FiveM-Servern als Erstes auf. Es gibt zwei Arten: Replace-Mods, die ein bestehendes GTA-Fahrzeug ersetzen, und Addon-Mods, die ein neues Fahrzeug neben den bestehenden hinzufuegen. Addon ist der Standard auf RP-Servern, weil du das originale GTA-Fahrzeug behaeltst.

Was du brauchst

Eine Fahrzeug-Mod, heruntergeladen von GTA5-Mods oder dem cfx.re Releases-Forum. Suche nach Mods, die "FiveM ready" sind; die haben die richtige Ordnerstruktur und eine fxmanifest.lua.
SFTP-Zugang zu deinem Server (schneller als das Web-Panel fuer viele Dateien).

Ordnerstruktur eines Addon-Fahrzeugs

Ein korrekt eingerichtetes FiveM-Fahrzeug sieht so aus:

resources/[fahrzeuge]/mein-auto/
    fxmanifest.lua
    stream/
        mein-auto.yft       (das 3D-Modell)
        mein-auto_hi.yft    (Hochqualitaets-Modell)
        mein-auto.ytd       (Texturen)
        vehicles.meta       (Fahrzeugeigenschaften)
        handling.meta       (Fahrverhalten)
        carvariations.meta  (Farben und Teile)
        carcols.meta        (Lichter und Sirenen)

Die fxmanifest.lua enthaelt mindestens:

fx_version 'cerulean'
game 'gta5'
this_is_a_map 'yes'
files { 'stream/**/*.meta' }
data_file 'HANDLING_FILE' 'stream/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'stream/vehicles.meta'
data_file 'CARCOLS_FILE' 'stream/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'stream/carvariations.meta'

Installation Schritt fuer Schritt

Stoppe den Server.
Lade den Fahrzeugordner nach resources/[fahrzeuge]/ hoch. Die eckigen Klammern im Ordnernamen sind eine FiveM-Konvention zur Kategorisierung.
Oeffne server.cfg und fuege hinzu: ensure mein-auto (der Ordnername des Fahrzeugs).
Starte den Server.
Tritt dem Server bei und spawne das Fahrzeug mit /car spawnname (der Name aus vehicles.meta).

Spawnen ueber vMenu oder dein Framework

Auf einem Freeroam-Server mit vMenu erscheint das Fahrzeug automatisch in der Fahrzeugliste, wenn es korrekt installiert ist. Auf einem RP-Server mit ESX oder Qbox fuegst du das Fahrzeug zur Dealership-Datenbank oder Garage-Konfiguration hinzu, damit Spieler es ueber die Wirtschaft kaufen koennen.

Texturen optimieren

Nicht optimierte YTD-Dateien sind die groesste Ursache fuer FPS-Probleme auf FiveM-Servern. Viele Custom Fahrzeuge werden mit 4096px-Texturen geliefert, waehrend FiveM intern auf 1024px begrenzt. Komprimiere YTDs auf 1024px vor dem Upload. Ein Server mit 200 Fahrzeugen, die jeweils 20 MB Texturen haben, streamt 4 GB Daten an jeden Client; nach Optimierung sind es 800 MB.

Haeufige Probleme

Fahrzeug spawnt nicht. Pruefe, ob der Ordnername exakt mit der Zeile in server.cfg uebereinstimmt und ob die fxmanifest.lua vorhanden ist.
Fahrzeug ist unsichtbar. Die YFT-Datei fehlt oder der Name in vehicles.meta stimmt nicht mit dem Dateinamen ueberein.
Texturen sind falsch. Der YTD-Dateiname muss exakt mit dem Modellnamen uebereinstimmen.
Server-Hitch beim Laden. Zu viele Fahrzeuge gleichzeitig oder nicht komprimierte Texturen.

Wie viele Fahrzeuge vertraegt mein Server?

Mit optimierten Texturen: hunderte. Ohne Optimierung kostet jedes Fahrzeug Speicher und Bandbreite. Eine Faustregel: 100 optimierte Fahrzeuge auf einem 8-GB-Server sind komfortabel.

Soll ich Replace oder Addon verwenden?

Addon fuer RP-Server, damit das Originalfahrzeug verfuegbar bleibt. Replace nur, wenn du alle GTA-Fahrzeuge ersetzen und ein streng kontrolliertes Fahrzeugangebot haben willst.

Muessen Spieler die Fahrzeuge auch herunterladen?

Nein. FiveM streamt die Dateien automatisch an den Client beim Verbinden. Das kostet Bandbreite und Ladezeit, aber der Spieler muss nichts manuell installieren.

Fahrzeuge laufen auf allen FiveM-Paketen. Fuer Server mit vielen Custom Assets empfehlen wir 8 GB oder mehr.