Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

Anleitungen

Schritt-für-Schritt-Anleitungen, um Ihren eigenen Server, Gameserver und Ihre Website einzurichten und zu betreiben – vom Team, das unsere Infrastruktur in Istanbul betreibt.

FiveM

Add-on-Fahrzeuge zum FiveM-Server hinzufügen (fxmanifest und stream)

26 August 2026 12 Min. Lesezeit Aktualisiert:
Diesen Beitrag teilen

In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie Ihrem FiveM-Server ein Add-on-Fahrzeug hinzufügen: wie der Ressourcenordner aufgebaut ist, welche Dateien in die Ordner stream und data gehören, wie Sie die Datei fxmanifest.lua schreiben und wie Sie das Fahrzeug über server.cfg starten. Am Ende können Sie auch selbst herausfinden, warum ein Fahrzeug im Spiel nicht erscheint oder warum es das Spiel abstürzen lässt.

Bevor Sie beginnen

  • Eine funktionierende FXServer-Installation. Falls Sie noch keine haben, arbeiten Sie zuerst die Anleitung zur FXServer-Einrichtung durch. Den Lizenzschlüssel erhalten Sie nicht mehr über Keymaster, sondern über das Cfx.re Portal (portal.cfx.re).
  • Zugriff auf die Serverdateien: Mit einem Windows-VDS verbinden Sie sich per RDP (3389), mit einem Linux-VDS per SSH (22). Um Dateien auf Linux hochzuladen, verwenden Sie einen SFTP-Client wie WinSCP.
  • Ein FiveM-kompatibles Add-on-Fahrzeugpaket. Das Paket enthält in der Regel .yft- und .ytd-Dateien in einem stream-Ordner sowie einige .meta-Dateien. Wurde das Paket als „Replace“ erstellt, funktioniert es mit der Methode aus dieser Anleitung nicht; den Unterschied erklären wir im ersten Schritt.
  • Ein Texteditor (Notepad++, VS Code, nano). Auch der Windows-Editor (Notepad) funktioniert, achten Sie beim Speichern aber darauf, dass die Dateiendung nicht .txt lautet.
  • Ein Befehl, um das Fahrzeug im Spiel zu spawnen: ein Admin-Menü wie vMenu oder das kleine Testskript aus Schritt sechs.

1. Den Unterschied zwischen Replace und Add-on verstehen

Es gibt zwei Wege, GTA V ein Mod-Fahrzeug hinzuzufügen. Ein Replace ersetzt die Modelldateien eines Fahrzeugs, das bereits im Spiel existiert (zum Beispiel adder): Das Originalfahrzeug verschwindet, der Spawn-Name (der Name, mit dem es im Spiel erzeugt wird) bleibt gleich, und sofern Sie sie nicht separat bearbeiten, werden die Handling-Werte (Fahrphysik) des Originalfahrzeugs verwendet. Ein Add-on dagegen definiert ein völlig neues Fahrzeug im Spiel: Es hat einen eigenen Spawn-Namen, einen eigenen Handling-Eintrag und eigene Farb- und Tuning-Definitionen; kein Originalfahrzeug wird entfernt.

MerkmalReplaceAdd-on
OriginalfahrzeugVerschwindetBleibt erhalten
Spawn-NameDer Name des OriginalfahrzeugsDer vom Paket definierte neue Name
Benötigte Dateienstream-Inhalt und eine schlichte fxmanifest.luastream, .meta-Dateien und data_file-Zeilen in einer fxmanifest.lua
HandlingDer Originaleintrag wird verwendetEin eigener Eintrag des Pakets
Anzahl der FahrzeugeSo viele, wie Sie ersetzenJedes Paket fügt ein neues Modell hinzu
Am besten geeignet fürGezieltes Ersetzen eines bestimmten FahrzeugsNeue Fahrzeuge zum Server hinzufügen

Für Serverbetreiber ist Add-on meist die richtige Methode. Replace-Pakete verändern Fahrzeuge, an die die Spieler gewöhnt sind, und wenn zwei Replace-Pakete dasselbe Fahrzeug betreffen, überschreibt das eine das andere.

2. Den Ressourcenordner anlegen

FXServer liest jeden Ordner unter resources/ in Ihrem Server-Datenordner als Ressource ein. Ordner in eckigen Klammern (wie [cars]) gelten als Kategorien und können mehr als eine Ressource enthalten. Wenn Sie Fahrzeuge in einer eigenen Kategorie gruppieren, bleibt es übersichtlich, sobald Sie Dutzende davon haben. Bei der offiziellen Einrichtung ist der Server-Datenordner unter Windows C:\FXServer\server-data und unter Linux ~/FXServer/server-data; wenn Sie mit einer txAdmin-Vorlage installiert haben, verwenden Sie den Serverordner, den txAdmin angelegt hat.

server-data/
└── resources/
    └── [cars]/
        └── bmwm3/
            ├── fxmanifest.lua
            ├── data/
            │   ├── vehicles.meta
            │   ├── handling.meta
            │   ├── carvariations.meta
            │   └── carcols.meta
            └── stream/
                ├── bmwm3.yft
                ├── bmwm3_hi.yft
                └── bmwm3.ytd

Legen Sie die Ordner unter Windows im „File Explorer“ (Datei-Explorer) an. Unter Linux genügt ein einziger Befehl; setzen Sie den Namen mit den eckigen Klammern in Anführungszeichen, damit die Shell ihn nicht als Muster interpretiert:

mkdir -p ~/FXServer/server-data/resources/"[cars]"/bmwm3/{data,stream}

Geben Sie dem Ordner einen kleingeschriebenen Namen ohne Leerzeichen und ohne Umlaute oder Sonderzeichen (ä, ö, ü, ß). Dieser Name ist zugleich der Ressourcenname, den Sie im Befehl ensure verwenden; ein Name mit Leerzeichen wird in der Konsole als zwei separate Argumente gelesen. Die offizielle Dokumentation überlässt die Benennung Ihnen, wir empfehlen aber, diese Regel einzuhalten, damit die Verwaltung einfach bleibt.

3. Die Ordner stream und data befüllen

Verschieben Sie die Modell- und Texturdateien aus dem Paket in den Ordner stream. Die Dateien in diesem Ordner müssen Sie nicht einzeln im Manifest auflisten; FXServer sendet (streamt) sie selbstständig an die Spieler. Diese Dateitypen werden Ihnen begegnen:

  • .yft: das 3D-Modell des Fahrzeugs. Meist gibt es zwei Dateien, ad.yft und die hochdetaillierte ad_hi.yft, wobei „ad“ für den Modellnamen steht.
  • .ytd: das Texturwörterbuch (Texture Dictionary), also die Skins des Fahrzeugs.
  • Manche Pakete enthalten zusätzliche .yft- und .ytd-Dateien für Tuning-Teile (zum Beispiel bmwm3_mods.ytd); auch diese gehören in den Ordner stream.

Legen Sie die .meta-Dateien in den Ordner data. Sie können auch im Stammverzeichnis liegen; entscheidend ist, dass der Pfad im Manifest exakt dem tatsächlichen Pfad entspricht. Jede Datei hat eine andere Aufgabe:

  • vehicles.meta: registriert das Fahrzeug im Spiel. Der Wert <modelName> darin ist der Spawn-Name; <handlingId> verweist auf den Eintrag in handling.meta.
  • handling.meta: Fahrphysik wie Masse, Motorleistung, Bremsen und Federung. Der Wert <handlingName> muss hier exakt dem Wert entsprechen, den vehicles.meta als handlingId angibt.
  • carvariations.meta: werkseitige Farbkombinationen und welches Tuning-Kit (<kits>) das Fahrzeug verwendet.
  • carcols.meta: Tuning-Kits sowie Sirenen- und Lichteinstellungen. Der Kit-Name muss mit dem Verweis in carvariations.meta übereinstimmen.
  • vehiclelayouts.meta (nicht in jedem Paket): Sitz- und Einstiegsanimationen; die Datei liegt Fahrzeugen mit eigenen Kabinen bei.

4. Die Datei fxmanifest.lua schreiben

Legen Sie im Stammverzeichnis der Ressource eine Datei namens fxmanifest.lua an. Diese Datei teilt FXServer mit, zu welchem Spieldatentyp jede .meta-Datei gehört. Laut der offiziellen Manifest-Dokumentation ist die aktuelle Manifest-Version cerulean, und der Spielwert für FiveM ist gta5.

fx_version 'cerulean'
game 'gta5'

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

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

Beide Abschnitte sind erforderlich: files fügt die Dateien dem Paket hinzu, das die Spieler herunterladen, und data_file teilt dem System des Spiels für zusätzliche Inhalte mit, als welcher Typ jede Datei geladen werden soll. Wenn Sie nur files angeben, wird die Datei heruntergeladen, aber vom Spiel nicht als Daten geladen; wenn Sie nur data_file angeben, sucht das Spiel nach einer Datei, die nie heruntergeladen wurde. data_file unterstützt den Abgleich mit Platzhaltern (*): 'data/*_handling.meta' lädt jede Datei im Ordner data, deren Name auf _handling.meta endet; wie im offiziellen Beispiel tragen Sie denselben Pfad auch unter files ein.

Unter Linux wird bei Dateinamen zwischen Groß- und Kleinschreibung unterschieden: Wenn Sie im Manifest Handling.meta schreiben, die Datei aber handling.meta heißt, wird sie nicht gefunden. Am einfachsten ist es, alle Datei- und Ordnernamen kleinzuschreiben.

Wenn das Paket einen eigenen Motorsound mitbringt (.awc- und .rel-Dateien), braucht das Manifest auch Zeilen für den Sound; in der offiziellen Data-File-Liste sind das die Typen AUDIO_WAVEPACK, AUDIO_SOUNDDATA und AUDIO_GAMEDATA. Wenn das Paket ein fertiges Manifest mitbringt, verwenden Sie zuerst dieses; prüfen Sie nur, ob die Pfade in seinen Zeilen den tatsächlichen Dateipfaden entsprechen.

5. ensure in der server.cfg eintragen und den Server aktualisieren

Öffnen Sie die Datei server.cfg und fügen Sie den Ressourcennamen neben den anderen ensure-Zeilen hinzu:

ensure bmwm3

Laut der offiziellen Befehlsdokumentation startet ensure eine Ressource neu, wenn sie läuft, startet sie, wenn sie nicht läuft, und akzeptiert auch einen Kategorienamen. Sie können also auch alle Fahrzeuge einer Kategorie mit einer einzigen Zeile starten: ensure [cars].

Um die neue Ressource ohne Herunterfahren des Servers online zu bringen, geben Sie diese beiden Befehle in die Serverkonsole (oder die txAdmin-Konsole) ein:

refresh
ensure bmwm3

refresh durchsucht den Ordner resources erneut und liest die Manifeste ein; ensure startet dann die Ressource. In der Konsole sollte die Zeile Started resource bmwm3 erscheinen. Wenn ein Spieler, der gerade auf dem Server ist, das Fahrzeug nicht sieht, genügt es meist, das Spiel zu verlassen und sich neu zu verbinden.

6. Den Spawn-Namen ermitteln und das Fahrzeug testen

Der Spawn-Name ist nicht der Ordnername; er ist der Wert, den vehicles.meta in <modelName> angibt, und er entspricht meist dem Namen der im Ordner stream liegenden .yft-Datei. Der Name auf der Seite des Pakets und der Name in der Datei weichen manchmal voneinander ab; öffnen Sie daher die Datei und prüfen Sie es:

<modelName>bmwm3</modelName>
<txdName>bmwm3</txdName>
<handlingId>BMWM3</handlingId>

FiveM hat keinen eingebauten Befehl /car; er wird von einem Admin-Menü wie vMenu oder von einem Skript bereitgestellt. Wenn Sie kein Menü haben, verwenden Sie eine vereinfachte Version des Beispiels zum Spawnen von Fahrzeugen aus der offiziellen Dokumentation „first script“. Legen Sie einen Ordner resources/aractest/ an und legen Sie zwei Dateien hinein. fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'

client.lua:

RegisterCommand('car', function(source, args)
    local vehicleName = args[1] or 'adder'

    if not IsModelInCdimage(vehicleName) or not IsModelAVehicle(vehicleName) then
        print('Model yok: ' .. vehicleName)
        return
    end

    RequestModel(vehicleName)
    while not HasModelLoaded(vehicleName) do
        Wait(500)
    end

    local playerPed = PlayerPedId()
    local pos = GetEntityCoords(playerPed)
    local vehicle = CreateVehicle(vehicleName, pos.x, pos.y, pos.z, GetEntityHeading(playerPed), true, false)
    SetPedIntoVehicle(playerPed, vehicle, -1)
    SetEntityAsNoLongerNeeded(vehicle)
    SetModelAsNoLongerNeeded(vehicleName)
end, false)

Geben Sie in der Konsole refresh und ensure aractest ein, dann im Spiel-Chat /car bmwm3. Wird das Modell nicht gefunden, erscheint in der F8-Konsole eine Warnung; daran erkennen Sie, dass das Problem bei stream oder .meta liegt. Das false in der letzten Zeile macht den Befehl für alle verfügbar; verwenden Sie dieses Skript nur zum Testen und entfernen Sie es von Ihrem Live-Server. Wenn das Fahrzeug spawnt, testen Sie nacheinander Farben, Tuning (LS Customs) und Fahrverhalten; jeder dieser Tests prüft eine andere .meta-Datei.

Beispielkonfiguration: data_file-Typen

Die folgende Tabelle fasst die Typen aus der offiziellen Data-File-Liste zusammen, die Ihnen in Fahrzeugpaketen begegnen, und zeigt, welche Datei jeder Typ definiert.

data_file-TypDateiWas er definiertFolgen, wenn er fehlt
VEHICLE_METADATA_FILEvehicles.metaFahrzeugregistrierung, Spawn-Name, KlasseDas Fahrzeug wird überhaupt nicht erkannt
HANDLING_FILEhandling.metaFahrphysikDas Fahrzeug spawnt nicht oder das Spiel stürzt ab
VEHICLE_VARIATION_FILEcarvariations.metaFarboptionen, Kit-VerknüpfungNur eine Farbe, kein Tuning
CARCOLS_FILEcarcols.metaTuning-Kits, Sirenen und LichterKeine Teile in LS Customs
VEHICLE_LAYOUTS_FILEvehiclelayouts.metaEinstiegs- und SitzanimationenProbleme beim Einsteigen in ein Fahrzeug, das ein eigenes Layout nutzt
AUDIO_WAVEPACKDer Ordner der .awc-DateienWave-Pack für eigenen MotorsoundStumm oder Standardsound
AUDIO_GAMEDATA*.dat151.relSounddefinitionDer Sound wird nicht geladen

Häufige Fehler

  • Das Fahrzeug spawnt nicht und Sie erhalten die Warnung „Model yok“ (kein Modell). Möglicherweise haben Sie den Spawn-Namen falsch geschrieben; öffnen Sie vehicles.meta und vergleichen Sie dessen modelName mit dem Namen der .yft-Datei. Wurde die Ressource tatsächlich gestartet? Geben Sie ensure bmwm3 in der Konsole ein und lesen Sie die Ausgabe; wenn Sie Couldn't find resource bmwm3. sehen, ist der Ordnername falsch oder das refresh fehlt.
  • Das Fahrzeug spawnt, ist aber komplett weiß oder hat keine Texturen. Die .ytd-Datei liegt nicht im Ordner stream, oder ihr Name stimmt nicht mit dem überein, den vehicles.meta als txdName angibt.
  • Das Spiel stürzt ab, wenn Sie das Fahrzeug spawnen oder einsteigen. Meistens wurde handling.meta nicht geladen, oder handlingId und handlingName stimmen nicht überein. Eine zweite Ursache: Das Paket hängt von DLC-Inhalten ab, die neuer sind als der Game-Build, den Ihr Server verwendet. Wählen Sie in server.cfg mit sv_enforceGameBuild einen neueren Build (zum Beispiel sv_enforceGameBuild 3407). Diese Einstellung wird nur beim Start gelesen; starten Sie den Server vollständig neu.
  • Das Fahrzeug rutscht, fliegt oder kommt nicht auf Geschwindigkeit. Die Handling-Werte sind falsch. Vergleichen Sie die Datei handling.meta des Pakets mit den Werten eines ähnlichen Originalfahrzeugs; fMass, fInitialDriveForce und fTractionCurveMax sind die Felder, die am häufigsten verwechselt werden.
  • Zwei Fahrzeuge ersetzen sich gegenseitig, oder eines verschwindet. Die beiden Pakete verwenden denselben modelName, denselben handlingName oder denselben Kit-Namen. Benennen Sie eines davon eindeutig um und ändern Sie den Namen in jeder Datei, in der er vorkommt.
  • Spieler warten beim Verbinden lange. Fahrzeugpakete mit vielen Polygonen können Dutzende Megabyte groß sein, und sie werden beim Verbinden heruntergeladen. Entfernen Sie ungenutzte Texturen und unnötige Dateien aus dem Paket; Details finden Sie in der Anleitung zur Optimierung.
  • Die Ressource startet nicht. Wenn Sie in der Konsole Couldn't start resource oder einen Manifest-Fehler sehen, prüfen Sie die Syntax von fxmanifest.lua; achten Sie auf ein fehlendes Anführungszeichen oder Komma. Ältere Pakete werden mit __resource.lua ausgeliefert: Benennen Sie die Datei in fxmanifest.lua um, löschen Sie die Zeile resource_manifest_version und fügen Sie die Zeilen fx_version und game hinzu.

Häufig gestellte Fragen

Kann ich mehrere Fahrzeuge in eine einzige Ressource packen?

Ja. Legen Sie alle .yft- und .ytd-Dateien in denselben Ordner stream; fassen Sie dann entweder die Einträge jedes Fahrzeugs nacheinander in der jeweiligen .meta-Datei zusammen, oder laden Sie separate Dateien mit einem Platzhalterpfad wie data_file 'HANDLING_FILE' 'data/*_handling.meta'. Da es die Fehlersuche erleichtert, empfehlen wir, jedes Fahrzeug anfangs als eigene Ressource zu führen.

Lässt sich ein Replace-Paket in ein Add-on umwandeln?

Die Modell- und Texturdateien sind dieselben; es fehlen die .meta-Definitionen. Sie können es in ein Add-on umwandeln, indem Sie die Einträge in vehicles.meta, handling.meta und carvariations.meta des originalen Gegenstücks des Fahrzeugs übernehmen und den Modellnamen ändern. Das ist fortgeschrittene Arbeit; suchen Sie nach Möglichkeit stattdessen die Add-on-Version.

Wofür ist der Ordner stream_enhanced?

Er ist ein separater Asset-Ordner für FiveM for GTAV Enhanced (den Client der neuen Generation). Laut der offiziellen Dokumentation verwendet der Enhanced-Client den Ordner stream_enhanced, sofern er existiert; andernfalls nutzt er den klassischen Ordner stream. Auf Servern, die beide Clients bedienen, legen Sie Gen8-Dateien in stream und Gen9-Dateien in stream_enhanced.

Wie füge ich das Fahrzeug dem Fahrzeughändler hinzu?

Das hängt von Ihrem Framework ab. In QBCore wird ein Fahrzeug in der Datei qb-core/shared/vehicles.lua mit Feldern wie model, name, price, category und shop eingetragen; das Feld model ist der Spawn-Name. Bei ESX hängt die Liste von der verwendeten Shop-Ressource ab und liegt meist in einer Datenbanktabelle. Wie Sie die Datenbank bearbeiten, erfahren Sie in der HeidiSQL-Anleitung.

Welcher Server reicht für Add-on-Fahrzeuge?

Fahrzeugpakete beanspruchen eher den Speicher und die Bandbreite des Servers als seine CPU; die Dateien werden beim Verbinden zu den Spielern heruntergeladen. Die Ryzen 9 9950X VDS-Familie mit NVMe-Speicher und 1G-Anbindung ist die Option, die wir für FiveM empfehlen; die Optionen finden Sie auf der FiveM-Server-Seite.

Verwandte Anleitungen

Kommentare0

Noch keine Kommentare

Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.

Diskutieren Sie mit

Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.

Keinen Beitrag verpassen

Erhalten Sie unsere neuesten Tutorials, Anleitungen und Produktneuigkeiten direkt in Ihr Postfach.

Sie haben unseren Newsletter abonniert.