FiveM Garage: owned_vehicles und player_vehicles, fehlende Autos behoben

Typische Symptome:

You bought a car, and the garage says "No vehicles". Or the car was parked at the street, the server restarted, and it is gone.

Fast jedes Garage-Skript liest das Gleiche: eine Tabelle mit einer Zeile pro eigenem Fahrzeug. Wenn ein Auto fehlt, ist die Zeile falsch, nicht das Skript. Dieser Artikel erklärt die zwei Standard-Tabellen, was die stored- und state-Spalten bedeuten, und das SQL, das die üblichen Fälle behebt.

#Die zwei Tabellen

ESX verwendet owned_vehicles. QBCore und QBox verwenden player_vehicles. Die Namen sind auf allen Servern gleich, die genauen Spalten hängen von deiner Version und deinem Garage-Skript ab, also schau zuerst auf deine:

DESCRIBE owned_vehicles;
DESCRIBE player_vehicles;

#ESX: owned_vehicles

Die Haupt-Spalten in ESX Legacy:

Garage-Skripte fügen ihre eigenen Spalten hinzu, zum Beispiel für den Garage-Namen oder einen Pfand-Zustand.

#QBCore und QBox: player_vehicles

QBox verwendet die gleiche Tabelle mit den gleichen Ideen. Andere Spalten, wie Finanz-Daten, variieren.

#Eigenschaften als JSON

Die vehicle-Spalte auf ESX und die mods-Spalte auf QBCore halten das Aussehen und Tuning des Autos als JSON: Farben, Mods, Räder, Kennzeichen, Extras, Neon und so weiter. Eine Garage liest es, wenn du das Auto herausnimmst, und schreibt es erneut, wenn du es lagerst.

-- when storing, on the client
local props = lib.getVehicleProperties(vehicle)
TriggerServerEvent('my_garage:store', plate, json.encode(props))

Das JSON muss gültig sein. Wenn ein Skript einen gebrochenen String schrieb, kann das Auto nicht restauriert und spawnt Stock oder gar nicht. Der Artikel über vehicle properties zeigt, wie man sie baut und anwendet.

#Fahrzeuge fehlen in der Garage

Führe diese der Reihe nach aus.

#1. Die Zeile existiert, gehört aber zu jemand anderem

Die Garage-Liste filtert nach Besitzer. Wenn der Besitzer-Wert nicht der ist, den der Server für deinen Charakter verwendet, ist die Zeile unsichtbar:

SELECT owner, plate, stored FROM owned_vehicles WHERE plate = 'MIC 001';

SELECT citizenid, license, plate, state FROM player_vehicles WHERE plate = 'MIC 001';

Vergleiche den Besitzer mit deinem echten Charakter:

• ESX: der Identifier in users.identifier für diesen Charakter. Mit einem Mehrfach-Charakter-Skript kann es einen Präfix wie char1: haben, und ein Auto, das gekauft wurde, bevor du Mehrfach-Charakter installiert hast, hat den alten Wert ohne es.
• QBCore und QBox: die citizenid in der players-Tabelle.

Nach einer Framework-Änderung, einem Import von einem anderen Server oder einem manuellen Insert ist dies die häufigste Ursache. Behebe es, indem du die Zeile auf den richtigen Wert hinweist:

UPDATE owned_vehicles SET owner = 'char1:abcdef...' WHERE plate = 'MIC 001';
UPDATE player_vehicles SET citizenid = 'ABC12345' WHERE plate = 'MIC 001';

Ersetze die Werte mit den echten aus deinen Tabellen.

#2. Der state ist außer Kontrolle „raus"

Ein Auto, das du herausnommen hast und das nie zurückkam, zum Beispiel nach einem Absturz oder einem Neustart, bleibt als raus markiert. Die Garage listet nur gelagerte Autos auf.

ESX, setze das stored-Flag zurück:

UPDATE owned_vehicles SET `stored` = 1 WHERE `stored` = 0;

QBCore und QBox, setze den state auf garaged:

UPDATE player_vehicles SET state = 1 WHERE state = 0;

Achtung: auf einem Live-Server lagert dies auch Autos, die Spieler gerade fahren. Führe es beim Start aus, oder begrenzen Sie es mit einem WHERE auf ein Kennzeichen oder einen Besitzer.

Viele Server führen eine automatische Bereinigung wie diese durch, wenn die Ressource startet, da nach einem Neustart kein Fahrzeug noch draußen sein kann. Wenn deiner das nicht tut, kannst du es selbst tun:

-- server side, runs when the garage resource starts
AddEventHandler('onResourceStart', function(resource)
    if resource ~= GetCurrentResourceName() then return end
    MySQL.update('UPDATE player_vehicles SET state = 1 WHERE state = 0')
end)

Beachte die Backticks um stored in der ESX-Abfrage: stored ist ein reserviertes Wort in MySQL und schlägt ohne sie fehl. Einige Skripte senden diese Autos dann in einen Pfand-Zustand anstelle der Garage, also überprüfe, was deine Garage erwartet.

#3. Die Garage-ID passt nicht

Auf QBCore sagt die garage-Spalte, in welcher Garage das Auto lebt. Eine Garage, die in deiner Konfiguration benannt ist, aber nicht in der Zeile, oder eine umbenannte Garage, zeigt nichts. Auflisten der verwendeten Werte:

SELECT garage, COUNT(*) FROM player_vehicles GROUP BY garage;

Setze die Autos auf eine Garage, die in deiner Konfiguration existiert.

#4. Der Auto-Typ passt nicht

Garage-Skripte trennen Autos, Boote und Flugzeuge nach der type-Spalte oder der Fahrzeug-Klasse. Ein Boot, das als car gespeichert ist, zeigt sich nie in der Boots-Garage.

#Kennzeichen

Das Kennzeichen verbindet die Welt, die Datenbank und die Schlüssel. Halte diese Regeln ein:

• Das Kennzeichen ist eindeutig pro Zeile. Ein Duplikat führt dazu, dass das falsche Auto geladen wird.
• Das Kennzeichen ist höchstens 8 Zeichen im Spiel, die Spalte kann auf ESX länger sein.
• Leerzeichen zählen. MIC 001 und MIC001 sind zwei Kennzeichen, also verwende ein Format.

Für Schlüssel, siehe vehicle keys.

#Füge ein Auto einem Spieler per SQL hinzu

Du kannst ein Fahrzeug durch das Einfügen einer Zeile geben. Nimm die Spaltenliste von deiner eigenen DESCRIBE, da eine fehlende erforderliche Spalte das Insert fehlschlagen lässt:

INSERT INTO owned_vehicles (owner, plate, vehicle, type, `stored`)
VALUES ('identifier-here', 'MIC 001', '{"model":-1130810103,"plate":"MIC 001"}', 'car', 1);

Das model im JSON ist der Modell-Hash, nicht der Name. Dein Framework oder deine Garage hat normalerweise einen Befehl oder eine Funktion, die das ordnungsgemäß macht, was der sicherere Weg ist, wenn er existiert.

#Checkliste