FiveM Garage System: öffentliche Garagen, Fraktionsgaragen, Verwahrstelle und Schutz vor doppelten Fahrzeugen
Ein FiveM Garage System speichert die Fahrzeuge deiner Spieler in der Datenbank, holt sie beim Ausparken als Entity in die Welt und entfernt sie beim Einparken wieder. Damit das stabil läuft, braucht jedes Fahrzeug einen eindeutigen Status, den nur der Server ändert, und eine Verwahrstelle für alles, was außerhalb einer Garage verloren geht. Fast alle typischen Probleme, allen voran doppelte Fahrzeuge, entstehen dort, wo der Client statt des Servers entscheidet.
Dieser Beitrag erklärt die Bausteine eines Garagensystems aus Admin-Sicht: welche Garagentypen du brauchst, wie ein sauberer Ablauf aussieht, wie die Verwahrstelle in dein Roleplay passt und woran du ein fehleranfälliges System erkennst. Am Ende findest du eine Checkliste, mit der du ein eigenes oder fertiges Script prüfen kannst.
Was ein FiveM Garage System leisten muss
Auf einem Roleplay-Server ist die Garage mehr als ein Menü mit einer Fahrzeugliste. Sie ist der Ort, an dem Besitz, Wirtschaft und Regeln zusammenkommen. Ein Fahrzeug, das doppelt existiert, entwertet jeden Autohändler, und ein Fahrzeug, das spurlos verschwindet, erzeugt Supportfälle.
Ein vollständiges System besteht deshalb aus mehreren Teilen:
- Öffentliche Garagen, in denen Spieler ihre privaten Fahrzeuge abstellen.
- Fraktionsgaragen für Dienstfahrzeuge von Polizei, Rettungsdienst oder Gruppierungen.
- Eine Verwahrstelle (Impound), in der abgeschleppte oder verlorene Fahrzeuge landen.
- Eine Schlüssellogik, die regelt, wer ein Fahrzeug fahren und abschließen darf.
- Protokolle, die jede Bewegung eines Fahrzeugs nachvollziehbar machen.
Öffentliche Garagen und Fraktionsgaragen: wo liegt der Unterschied?
Öffentliche Garagen sind an einen Spieler gebunden. Der Eintrag in der Datenbank hat einen Besitzer, und nur dieser sieht das Fahrzeug in seiner Liste. Ob ein Fahrzeug in jeder Garage oder nur in der zuletzt genutzten ausgeparkt werden kann, ist eine Designentscheidung: Die zweite Variante erzeugt mehr Roleplay, weil Spieler ihr Auto wirklich abholen müssen, sie erzeugt aber auch mehr Fragen im Support.
Fraktionsgaragen sind an einen Job gebunden, nicht an eine Person. Entscheidend ist hier, welcher Rang welches Fahrzeug ausparken darf und ob Fahrzeuge der Fraktion gehören oder einzelnen Mitgliedern. Wenn ein Mitglied die Fraktion verlässt, darf es keine Dienstfahrzeuge in seiner privaten Liste behalten. Wie du Rechte pro Rang inklusive Garage organisierst, steht im Beitrag zum Bossmenü mit Fraktionskasse und Rechten pro Rang.
Ein- und Ausparken: der saubere Ablauf
Der Kern jedes Garagensystems ist ein Statusfeld pro Fahrzeug. Bei QBCore übernimmt das in der Tabelle player_vehicles eine Spalte state, bei ESX nutzen viele Garagen-Scripts in owned_vehicles eine Spalte wie stored. Unabhängig vom Framework reicht ein einfaches Modell:
0 = draußen (Fahrzeug existiert in der Welt)
1 = in einer Garage geparkt (Spalte garage = Garagen-ID)
2 = in der VerwahrstelleDas Ausparken läuft dann so ab:
- Der Spieler öffnet das Menü an einer Garage. Der Server liefert nur Fahrzeuge mit Status 1 in genau dieser Garage.
- Der Spieler wählt ein Kennzeichen. Der Client schickt nur das Kennzeichen und die Garagen-ID, keine Fahrzeugdaten.
- Der Server prüft die Entfernung des Spielers zur Garage und den Besitz.
- Der Server setzt den Status per Update von 1 auf 0. Nur wenn genau eine Zeile geändert wurde, geht es weiter.
- Erst jetzt wird das Fahrzeug gespawnt, und der Server merkt sich, welche Entity zu welchem Kennzeichen gehört.
Beim Einparken gilt die umgekehrte Reihenfolge: Der Server prüft, ob das Fahrzeug, in dem der Spieler sitzt, genau die gemerkte Entity ist, speichert Zustand und Status 1, löscht die Entity und entfernt den Eintrag aus seiner Liste.
Die Datenbank ist die einzige Quelle der Wahrheit: Ein Fahrzeug darf erst spawnen, wenn der Server seinen Status atomar von „geparkt“ auf „draußen“ gesetzt hat.
Doppelte Fahrzeuge: wie sie entstehen und wie du sie verhinderst
Doppelte Fahrzeuge sind der häufigste Garagen-Bug und fast immer ein Logikfehler, kein Zufall. Die üblichen Ursachen:
- Doppelklick oder Spam: Zwei Anfragen kommen fast gleichzeitig an, beide lesen „geparkt“, beide spawnen.
- Client spawnt selbst: Der Client erzeugt das Fahrzeug und meldet erst danach an den Server. Ein manipulierter Client meldet einfach nichts.
- Einparken per Kennzeichen: Das Script prüft nur das Kennzeichen. Wer ein beliebiges Fahrzeug mit gleichem Kennzeichen erzeugt, parkt es als Original ein, während das Original weiterfährt.
- Absturz oder Disconnect: Das Fahrzeug bleibt in der Welt, der Status steht aber schon wieder auf „geparkt“.
Die Lösung ist ein atomares Update mit Bedingung, kombiniert mit einer serverseitigen Liste aktiver Fahrzeuge. Ein vereinfachtes Beispiel mit oxmysql:
-- server.lua (vereinfacht, Hilfsfunktionen sind Platzhalter)
local activeVehicles = {} -- Kennzeichen -> netId
RegisterNetEvent('garage:takeOut', function(plate, garageId)
local src = source
if not IsNearGarage(src, garageId) then return end
if activeVehicles[plate] then return end
local changed = MySQL.update.await(
'UPDATE owned_vehicles SET stored = 0 WHERE plate = ? AND owner = ? AND stored = 1 AND garage = ?',
{ plate, GetIdentifier(src), garageId }
)
if changed ~= 1 then return end -- schon draußen oder nicht dein Fahrzeug
local netId = SpawnOwnedVehicle(src, plate, garageId)
activeVehicles[plate] = netId
end)Die Bedingung stored = 1 im Update sorgt dafür, dass von zwei gleichzeitigen Anfragen nur eine gewinnt. Wie du Queries mit Platzhaltern sicher aufbaust, erklärt der Beitrag zu oxmysql und sicheren Queries.
Ein oft übersehener Punkt sind die Fahrzeug-Properties. Tuning und Schäden kommen beim Einparken vom Client. Prüfe serverseitig, dass Modell und Kennzeichen in diesen Daten mit dem Datenbankeintrag übereinstimmen. Sonst kann ein manipulierter Client beim Einparken aus einem Kleinwagen einen Supersportwagen machen.
Abschleppen und Verwahrstelle im Roleplay
Die Verwahrstelle fängt alles auf, was nicht ordentlich geparkt wurde. Typische Wege dorthin sind das Abschleppen durch Polizei oder Abschleppdienst, ein Team-Befehl für falsch abgestellte Fahrzeuge und der Server-Neustart.
Beim Neustart musst du entscheiden, was mit Fahrzeugen im Status „draußen“ passiert. Bewährt hat sich, sie beim Start der Resource gesammelt in die Verwahrstelle zu setzen:
-- beim Start der Resource
MySQL.update('UPDATE owned_vehicles SET stored = 2 WHERE stored = 0')Beim Auslösen aus der Verwahrstelle prüft der Server, ob das Fahrzeug noch als Entity in der Welt existiert. Falls ja, wird es vorher entfernt. Ohne diesen Schritt hat der Spieler danach zwei Exemplare. Für das Roleplay legst du fest, wer auslösen darf (nur der Besitzer, nur mit Freigabe der Polizei), ob eine Gebühr fällig wird und ob beschlagnahmte Fahrzeuge für eine bestimmte Zeit gesperrt bleiben. Jede dieser Regeln gehört in die Konfiguration, nicht in Absprachen im Teamchat.
Fahrzeugschlüssel: getrennt von der Garage denken
Garage und Fahrzeugschlüssel beantworten zwei verschiedene Fragen. Die Garage sagt, wo ein Fahrzeug ist und wem es gehört. Der Schlüssel sagt, wer es gerade fahren und abschließen darf.
Diese Trennung macht Roleplay möglich: Ein Spieler leiht einem Freund das Auto, ohne den Besitz zu übertragen. Fraktionsmitglieder erhalten Schlüssel für Dienstfahrzeuge, solange sie im Dienst sind. Wichtig sind drei Regeln:
- Ein Schlüssel berechtigt nicht zum Einparken in die eigene Garage. Sonst wird aus einem geliehenen Auto ein gestohlenes.
- Beim Verkauf oder bei der Übertragung eines Fahrzeugs werden alle bisherigen Schlüssel ungültig.
- Schlüssel für Fraktionsfahrzeuge werden beim Verlassen der Fraktion entzogen.
Datenbank und Performance
Ein Garagensystem fragt die Datenbank häufig ab, aber nicht ständig. Die Fahrzeugliste wird geladen, wenn der Spieler das Menü öffnet, nicht in einer Schleife. Prüfe außerdem, ob die Spalten, nach denen gesucht wird, einen Index haben. Bei ESX ist das Kennzeichen meist Primärschlüssel, für den Besitzer fehlt der Index oft:
ALTER TABLE owned_vehicles ADD INDEX idx_owner (owner);Auf Client-Seite kosten vor allem Marker und Blips Leistung. Ein Thread, der jede Frame alle Garagen zeichnet, ist unnötig. Besser ist eine Entfernungsprüfung mit längerer Wartezeit, die erst in der Nähe einer Garage auf kurze Intervalle wechselt. Im Resource-Monitor sollte das Script im Leerlauf kaum messbar sein.
Für Nachvollziehbarkeit gehören Ausparken, Einparken, Abschleppen und Auslösen ins Log, jeweils mit Kennzeichen, Spieler und Garage. Wie du solche Logs gebündelt und ohne Rate-Limit-Probleme verschickst, zeigt der Beitrag zum Discord Webhook für Server-Logs.
Checkliste für dein Garagensystem
- Jedes Fahrzeug hat genau einen Status, und nur der Server ändert ihn.
- Ausparken nutzt ein bedingtes Update und prüft die Zahl der geänderten Zeilen.
- Der Client sendet beim Ausparken nur Kennzeichen und Garagen-ID.
- Einparken prüft die gemerkte Entity, nicht nur das Kennzeichen.
- Modell und Kennzeichen in den Properties werden gegen die Datenbank geprüft.
- Entfernung zur Garage wird serverseitig kontrolliert.
- Beim Neustart landen draußen stehende Fahrzeuge in der Verwahrstelle.
- Auslösen entfernt ein noch existierendes Exemplar aus der Welt.
- Schlüssel und Besitz sind getrennt, Schlüssel verfallen bei Besitzwechsel.
- Fraktionsfahrzeuge hängen am Job, nicht an der Person.
- Alle Fahrzeugbewegungen werden protokolliert.
Eigenbau oder fertiges Script?
Ein eigenes Garagensystem lohnt sich, wenn du sehr spezielle Regeln hast und jemanden im Team, der Race Conditions und Entity-Handling sicher beherrscht. Für die meisten Server ist ein erprobtes Script schneller und weniger riskant, solange es die Checkliste oben besteht.
Eine Möglichkeit für ESX-Server ist ws_garage-v2 von Web-Services. Es bringt Garagen und Verwahrstelle für Autos, Boote und Flugzeuge mit, protokolliert über Discord-Webhooks, entfernt ein Fahrzeug beim Auslösen aus der Verwahrstelle automatisch aus der Welt und ist gegen Exploits und Duping abgesichert. Positionen von Garagen und Verwahrstellen, Meldungen, Notify-Event und Bankbezeichnungen stellst du in der Konfiguration ein, die Farben des UI über style.css. Das Script setzt es_extended voraus und ist nicht für QBCore oder Qbox ausgelegt. Alle Details stehen auf der Seite, auf der du das FiveM Garage Script kaufen kannst.
FAQ
Warum gibt es auf meinem Server doppelte Fahrzeuge?
Meist liest das Script den Status und setzt ihn erst später, sodass zwei schnelle Anfragen beide durchkommen. Oder es parkt Fahrzeuge nur anhand des Kennzeichens ein. Ein bedingtes Update mit Prüfung der geänderten Zeilen und eine serverseitige Liste aktiver Entities beheben beides.
Was passiert mit ausgeparkten Fahrzeugen bei einem Neustart?
Das legst du selbst fest. Üblich ist, beim Start der Resource alle Fahrzeuge mit Status „draußen“ in die Verwahrstelle zu setzen. So geht nichts verloren, und Spieler haben einen klaren Ort, an dem sie ihr Fahrzeug abholen.
Brauchen Fraktionsgaragen ein eigenes System?
Nicht zwingend, aber eine eigene Logik. Fraktionsfahrzeuge gehören dem Job, die Berechtigung hängt am Rang, und beim Verlassen der Fraktion dürfen keine Fahrzeuge oder Schlüssel beim Spieler bleiben.
Sind Garage und Fahrzeugschlüssel dasselbe?
Nein. Die Garage verwaltet Besitz und Standort, der Schlüssel regelt, wer fahren und abschließen darf. Getrennt gedacht kannst du Fahrzeuge verleihen, ohne dass der Besitz wechselt.
