Add-on-Fahrzeuge zum FiveM-Server hinzufügen (fxmanifest und stream)
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 einemstream-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
.txtlautet. - 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.
| Merkmal | Replace | Add-on |
|---|---|---|
| Originalfahrzeug | Verschwindet | Bleibt erhalten |
| Spawn-Name | Der Name des Originalfahrzeugs | Der vom Paket definierte neue Name |
| Benötigte Dateien | stream-Inhalt und eine schlichte fxmanifest.lua | stream, .meta-Dateien und data_file-Zeilen in einer fxmanifest.lua |
| Handling | Der Originaleintrag wird verwendet | Ein eigener Eintrag des Pakets |
| Anzahl der Fahrzeuge | So viele, wie Sie ersetzen | Jedes Paket fügt ein neues Modell hinzu |
| Am besten geeignet für | Gezieltes Ersetzen eines bestimmten Fahrzeugs | Neue 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.yftund die hochdetailliertead_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 Beispielbmwm3_mods.ytd); auch diese gehören in den Ordnerstream.
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 inhandling.meta.handling.meta: Fahrphysik wie Masse, Motorleistung, Bremsen und Federung. Der Wert<handlingName>muss hier exakt dem Wert entsprechen, denvehicles.metaalshandlingIdangibt.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 incarvariations.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-Typ | Datei | Was er definiert | Folgen, wenn er fehlt |
|---|---|---|---|
VEHICLE_METADATA_FILE | vehicles.meta | Fahrzeugregistrierung, Spawn-Name, Klasse | Das Fahrzeug wird überhaupt nicht erkannt |
HANDLING_FILE | handling.meta | Fahrphysik | Das Fahrzeug spawnt nicht oder das Spiel stürzt ab |
VEHICLE_VARIATION_FILE | carvariations.meta | Farboptionen, Kit-Verknüpfung | Nur eine Farbe, kein Tuning |
CARCOLS_FILE | carcols.meta | Tuning-Kits, Sirenen und Lichter | Keine Teile in LS Customs |
VEHICLE_LAYOUTS_FILE | vehiclelayouts.meta | Einstiegs- und Sitzanimationen | Probleme beim Einsteigen in ein Fahrzeug, das ein eigenes Layout nutzt |
AUDIO_WAVEPACK | Der Ordner der .awc-Dateien | Wave-Pack für eigenen Motorsound | Stumm oder Standardsound |
AUDIO_GAMEDATA | *.dat151.rel | Sounddefinition | Der 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.metaund vergleichen Sie dessenmodelNamemit dem Namen der.yft-Datei. Wurde die Ressource tatsächlich gestartet? Geben Sieensure bmwm3in der Konsole ein und lesen Sie die Ausgabe; wenn SieCouldn't find resource bmwm3.sehen, ist der Ordnername falsch oder dasrefreshfehlt. - Das Fahrzeug spawnt, ist aber komplett weiß oder hat keine Texturen. Die
.ytd-Datei liegt nicht im Ordnerstream, oder ihr Name stimmt nicht mit dem überein, denvehicles.metaalstxdNameangibt. - Das Spiel stürzt ab, wenn Sie das Fahrzeug spawnen oder einsteigen. Meistens wurde
handling.metanicht geladen, oderhandlingIdundhandlingNamestimmen 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 inserver.cfgmitsv_enforceGameBuildeinen neueren Build (zum Beispielsv_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.metades Pakets mit den Werten eines ähnlichen Originalfahrzeugs;fMass,fInitialDriveForceundfTractionCurveMaxsind die Felder, die am häufigsten verwechselt werden. - Zwei Fahrzeuge ersetzen sich gegenseitig, oder eines verschwindet. Die beiden Pakete verwenden denselben
modelName, denselbenhandlingNameoder 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 resourceoder einen Manifest-Fehler sehen, prüfen Sie die Syntax vonfxmanifest.lua; achten Sie auf ein fehlendes Anführungszeichen oder Komma. Ältere Pakete werden mit__resource.luaausgeliefert: Benennen Sie die Datei infxmanifest.luaum, löschen Sie die Zeileresource_manifest_versionund fügen Sie die Zeilenfx_versionundgamehinzu.
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.
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.