Wie füge ich Addon-Autos zu meinem FiveM-Server hinzu?

GTA V bringt von Haus aus hunderte Fahrzeuge mit, aber ein Roleplay- oder Race-Server hebt sich erst mit Custom Cars richtig ab. In dieser Anleitung installierst du ein Addon-Fahrzeug auf deinem FiveM-Server: Du lädst die Resource per SFTP hoch, aktivierst sie in der server.cfg, testest sie ingame und machst das Auto anschließend im Vehicleshop von ESX oder QBCore kaufbar.

Addon oder Replace: Was ist der Unterschied?

Custom Fahrzeuge werden auf zwei Arten angeboten. Ein Replace-Fahrzeug überschreibt ein bestehendes GTA-Modell: Die Dateien tragen den Namen eines Standardautos (zum Beispiel adder.yft), und jeder, der dieses Modell spawnt, sieht ab sofort das neue Auto. Ein Addon-Fahrzeug wird dem Spiel als komplett neues Modell mit eigenem Spawn Name hinzugefügt, ohne etwas zu überschreiben. Addon ist fast immer die bessere Wahl: Du behältst alle Originalautos, vermeidest Konflikte zwischen Resources und kannst dem Fahrzeug einen eigenen Preis und eine eigene Shop-Kategorie geben. Diese Anleitung geht deshalb von Addon-Autos aus.

Die Ordnerstruktur einer Fahrzeug-Resource

Ein Addon-Auto ist eine ganz normale FiveM-Resource. Im Ordner findest du meistens Folgendes:

• fxmanifest.lua — beschreibt die Resource und verweist auf die Meta-Dateien.
• stream/ — die Modelldateien: .yft (das 3D-Modell, oft auch eine _hi.yft-Variante) und .ytd (die Texturen).
• data/ — die Meta-Dateien: vehicles.meta (Modellname und Spawn-Daten), carvariations.meta (Farben und Varianten), carcols.meta (Tuning-Optionen und Lichter) und handling.meta (Fahrverhalten). Manche Autos haben zusätzliche Dateien wie vehiclelayouts.meta.

Den Spawn Name findest du in vehicles.meta im Tag <modelName> — in dieser Anleitung verwenden wir als Beispiel sultan3. Diesen Namen brauchst du gleich zum Spawnen und für den Shop.

Schritt 1: Lade die Resource per SFTP hoch

1. Verbinde dich per SFTP mit deinem Server, zum Beispiel mit FileZilla oder WinSCP. Wie das geht, liest du in unserem SFTP-Artikel.
2. Öffne den Ordner resources deines FiveM-Servers. Praktisch ist ein Unterordner in eckigen Klammern, etwa resources/[cars] — Ordner mit eckigen Klammern scannt FiveM automatisch mit.
3. Lade den kompletten Fahrzeugordner (zum Beispiel sultanclassic) in diesen Unterordner hoch.
4. Prüfe, dass fxmanifest.lua direkt im Fahrzeugordner liegt und nicht in einem zusätzlich verschachtelten Ordner — der häufigste Fehler bei entpackten Downloads.

Schritt 2: Aktiviere die Resource in der server.cfg

1. Öffne im MC-Node-Panel den Tab Files und öffne die Datei server.cfg.
2. Füge unten eine Zeile hinzu: ensure sultanclassic. Verwende hier den Ordnernamen der Resource, nicht den Spawn Name.
3. Speichere die Datei und starte deinen Server über den Tab Console neu.

Schritt 3: Teste das Auto ingame

1. Joine auf deinen Server, öffne dein Admin-Menü, zum Beispiel vMenu oder das txAdmin-Menü, und wähle die Option, ein Fahrzeug zu spawnen.
2. Gib den Spawn Name ein (sultan3). Auf einem ESX-Server mit Standardbefehlen funktioniert auch /car sultan3.
3. Erscheint das Auto, läuft die Resource. Prüfe am besten gleich das Fahrverhalten und ob alle Texturen laden.

Das Auto in ESX kaufbar machen

Der Standard-esx_vehicleshop liest sein Angebot aus der Datenbanktabelle vehicles.

1. Öffne im Panel den Tab Databases und melde dich mit den dort angezeigten Zugangsdaten am Datenbankpanel (phpMyAdmin) an.
2. Wähle die Datenbank deines Servers aus und öffne das SQL-Fenster.
3. Führe diese Query aus: INSERT INTO vehicles (name, model, price, category) VALUES ('Sultan RS Classic', 'sultan3', 125000, 'sports');
4. Achtung: model muss exakt der Spawn Name sein und die category muss in der Tabelle vehicle_categories existieren.
5. Starte die Vehicleshop-Resource oder den ganzen Server neu; das Auto steht jetzt beim Händler.

Das Auto in QBCore kaufbar machen

QBCore nutzt keine Datenbanktabelle, sondern eine geteilte Konfigurationsdatei.

1. Öffne über den Tab Files die Datei resources/[qb]/qb-core/shared/vehicles.lua.
2. Füge einen neuen Eintrag hinzu, zum Beispiel: { model = 'sultan3', name = 'Sultan RS Classic', brand = 'Karin', price = 125000, category = 'sports', type = 'automobile', shop = 'pdm' },
3. Der Wert shop = 'pdm' stellt das Auto in den Standard-Vehicleshop; category bestimmt, unter welchem Tab es im Shop-Menü erscheint.
4. Starte den Server über den Tab Console komplett neu — geteilte Dateien werden nur beim Start geladen.

Häufige Probleme

• Streaming-Lag oder unsichtbare Autos — Zu große .ytd-Dateien (4K-Texturen mit zig Megabyte) füllen den Texturspeicher der Spieler, mit Lag, Pop-in oder unsichtbaren Fahrzeugen als Folge. Verkleinere Texturen auf 2K oder nutze eine optimierte Version des Autos.
• Doppelte Spawn Names — Zwei Resources mit demselben modelName geraten in Konflikt: Das Auto spawnt nicht oder das falsche Modell erscheint. Entferne eine der beiden Resources oder benenne das Modell, die Dateinamen und alle Meta-Verweise konsistent um.
• Auto erscheint nicht im Shop — Meistens wurde die Shop-Kategorie vergessen oder ist falsch. Bei ESX muss die Kategorie in vehicle_categories existieren, bei QBCore muss sie zu den Kategorien der Shop-Config passen. Prüfe auch, ob der Spawn Name im Shop exakt stimmt.
• Resource startet nicht — Schau im Tab Console nach der Fehlermeldung. Stimmt der Ordnername in der ensure-Zeile und liegt fxmanifest.lua direkt im Fahrzeugordner?
• Model not found beim Spawnen — Die Resource läuft nicht oder du tippst einen falschen Spawn Name. Prüfe den Namen in vehicles.meta und starte den Server nach Änderungen neu.

Weiterlesen

Arbeitest du zum ersten Mal mit Datenbanken? Dann lies, wie du eine Datenbank anlegst und wie du dich mit deiner Datenbank verbindest. Bleibt dein Server nach dem Hinzufügen von Autos langsam, wirf auch einen Blick in unseren Guide zu Serverlag. Kommst du nicht weiter? Eröffne ein Ticket über unsere Supportseite und nenne den Namen der Resource und die Fehlermeldung aus der Konsole.