Guide 2026-05-06

FiveM Vehicle Keys Script: Agency-Vehiclekeys Guide 2026

OntelMonke

OntelMonke

Admin & Entwickler bei Agency Scripts

Das Problem mit dem Standard-Fahrzeugzugang in FiveM

Standardmäßig lässt GTA V bzw. FiveM jeden Spieler in jedes Fahrzeug einsteigen und losfahren — ohne Einschränkung. Es gibt keine Schlüssel, keine Besitzmechanik, keine Konsequenzen dafür, einfach in ein fremdes Auto zu springen und davonzufahren. Für Casual-Server ist das kaum ein Problem, aber für jede ernsthafte Roleplay-Community ist dieses Standardverhalten ein fundamentaler Immersion-Brecher. Jedes Auto wird zum gemeinschaftlichen Taxi. Autodiebstahl verliert jede Bedeutung. Das Parken des Wagens vor der Bank, während man einen Job erledigt, wird zum Glücksspiel gegen Mitspieler.

Ein FiveM Vehicle Keys Script löst dieses Problem auf Framework-Ebene. Es verknüpft Besitz und physische Schlüssel mit jedem Fahrzeug, das auf dem Server gespawnt oder gekauft wurde. Spieler brauchen das richtige Schlüssel-Item im Inventar, um ein Auto auf- und abzusperren und anzustarten. Fahrzeuge ohne Schlüssel sind gesperrt — wer versucht einzusteigen, wird schlicht abgewiesen. Um ein fremdes Auto zu fahren, muss man entweder den Schlüssel leihen, einen Hotwire-Mechanismus nutzen oder das Schloss knacken. Diese drei Mechaniken zusammen verwandeln die Fahrzeuginteraktion von einem Nicht-Event in eine bedeutungsvolle Schicht realistischen Roleplay-Widerstands.

Im Jahr 2026 ist Agency-Vehiclekeys die herausragende Wahl für Server, die dieses System sauber implementieren wollen — mit tiefer QBCore- und ESX-Integration, einem ansprechenden Hotwire-Minigame und einem einmaligen Niedrigpreis. Dieser Guide erklärt alles.

Was Agency-Vehiclekeys bietet

Agency-Vehiclekeys basiert auf fünf zentralen Feature-Säulen, die Fahrzeugbesitz gemeinsam realistisch machen:

1. Physische Schlüssel-Items

Wenn ein Spieler ein Fahrzeug spawnt oder kauft, landet ein einzigartiges Schlüssel-Item in seinem Inventar. Dieses Item ist der einzige Weg, das spezifische Fahrzeug auf- und anzusperren — es ist an die Netzwerk-ID oder das Kennzeichen des Fahrzeugs gebunden. Der Schlüssel kann physisch an einen anderen Spieler übergeben, fallen gelassen, in einem Stash aufbewahrt oder verloren werden. Wer seinen Schlüssel verliert, kann das Auto nicht starten — ohne Hotwire oder einen Schlüsseldienst (ein konfigurierbarer Job-Mechanismus). Diese eine Designentscheidung — Schlüssel zu echten Inventar-Items zu machen — erzeugt eine Kaskade authentischer Roleplay-Szenarien, die Standard-FiveM schlicht nicht unterstützen kann.

2. Schlüssel teilen

Das Schlüsselsharing-System erlaubt es dem Fahrzeugbesitzer, einen Duplikatschlüssel zu erstellen und ihn an beliebige andere Spieler weiterzugeben. Das ist unverzichtbar für gemeinsam genutzte Fahrzeuge, Familienautos, Werkstätten, die Fahrzeuge bewegen müssen, und kriminelle Crews mit einem gemeinsamen Fluchtauto. Das Teilen erfolgt über eine einfache In-Game-Interaktion — Spieler anvisieren, „Fahrzeugschlüssel geben" wählen, und das Duplikat erscheint im Inventar des Empfängers. Der Besitzer behält seinen Schlüssel; der Empfänger erhält eine voll funktionierende Kopie. Besitzer können alle geteilten Schlüssel jederzeit widerrufen und damit allen Zugriff entziehen.

3. Hotwire-Minigame

Wenn ein Spieler versucht, in ein gesperrtes Fahrzeug einzusteigen, für das er keinen Schlüssel hat, erscheint die Option zum Hotwiren. Agency-Vehiclekeys enthält ein ausgefeiltes NUI-Hotwire-Minigame — eine zeitgesteuerte Kabel-Zuordnungs-Challenge, die echte Spielerkompetenz verlangt statt eines einfachen Würfelwurfs. Ein erfolgreicher Abschluss startet das Auto, löst aber serverseitige Events aus, in die andere Scripts einhaken können: den Besitzer benachrichtigen, den Polizei-Dispatch alarmieren, den Vorfall ins MDT loggen. Schwierigkeit und Zeitlimit des Minigames sind vollständig konfigurierbar, mit optionalen Schwierigkeitsstufen je nach Fahrzeugklasse.

4. Lockpick-System

Das Lockpick-System deckt den Türöffnungsschritt separat vom Hotwiren ab. Ein Spieler mit Dietrich-Item im Inventar kann versuchen, das Türschloss eines Fahrzeugs zu knacken. Das ist Voraussetzung für das Einsteigen, bevor gehotwired werden kann — erst Tür knacken, dann anlassen. Lockpicking hat sein eigenes Minigame, eine konfigurierbare Erfolgsrate und eine Verbrauchswahrscheinlichkeit für den Dietrich. Fehlgeschlagene Versuche können den Dietrich brechen und optional Benachrichtigungen an Spieler in der Nähe oder die Polizei auslösen. Dieser zweistufige Prozess — Schloss knacken, dann hotwiren — macht Autodiebstahl bedeutsam riskant und zeitaufwendig.

5. Tiefe QBCore- und ESX-Integration

Agency-Vehiclekeys integriert sich direkt in QBCore-Inventar (ox_inventory-kompatibel) und ESX-Inventar. Schlüssel-Items erscheinen als echte Inventar-Objekte mit Icons und Metadaten. Die Fahrzeugbesitzlogik bindet sich in QBCores Fahrzeugdatenbank (player_vehicles) und ESXs Äquivalent ein. Wenn ein Spieler sein Fahrzeug beim Händler oder aus dem Knast abholt, wird der Schlüssel automatisch generiert. Alle Benachrichtigungen — Ab- und Aufschließ-Bestätigungen, Hotwire-Alarm, Lockpick-Versuche — nutzen das native Benachrichtigungssystem des Frameworks.

Weitere Features

Neben den fünf Kernsäulen enthält Agency-Vehiclekeys mehrere Quality-of-Life-Mechaniken:

  • Ab- und Aufschließ-Animationen: Der Charakter spielt eine realistische Greifanimation ab, wenn er ein Fahrzeug ab- oder aufschließt — mit hörbarem Klick-Sound.
  • Proximity Locking: Fahrzeug aus konfigurierbarer Entfernung ab- und aufschließen per Keybind oder Radialmenü — kein Herantreten nötig.
  • Fahrzeugalarm: Optional kann ein Autoalarm ausgelöst werden, wenn ein Lockpick- oder Hotwire-Versuch stattfindet. Der Alarm zieht die Aufmerksamkeit nahestehender Spieler auf sich und kann den Besitzer per Handy-Benachrichtigung alarmieren.
  • Job-freie Fahrzeuge: Eine Liste von Job-Fahrzeugen (Polizei, Ambulanz, Abschleppwagen) kann vom Schlüsselsystem ausgenommen werden — Beamte können Dienstfahrzeuge ohne Schlüssel-Item betreten.
  • Knast-Integration: Wenn ein Fahrzeug eingezogen wird, wird der zugehörige Schlüssel automatisch ungültig gemacht. Beim Auslösen des Fahrzeugs wird ein neuer Schlüssel generiert.
  • Export-API: Eine saubere Export-API erlaubt es anderen Scripts, Schlüsselbesitz zu prüfen, Schlüssel programmatisch zu generieren oder zu widerrufen — nützlich für Werkstatt-Scripts, Händler-Scripts und individuelle Job-Integrationen.

Installation: Schritt für Schritt

Schritt 1 — Agency-Vehiclekeys kaufen

Gehe zu shop.agencyg.de/en/products/vehiclekeys und schließe den Einmalkauf für 5,99 € ab. Nach dem Checkout erhältst du Download-Zugang über das Agency-Scripts-Shop-Portal. Kein Abo, keine Verlängerung — du besitzt es dauerhaft.

Schritt 2 — Resource platzieren

Entpacke das Archiv und lege den Ordner agency-vehiclekeys in das resources-Verzeichnis deines Servers (oder einen Unterordner wie resources/[scripts]/).

Schritt 3 — server.cfg anpassen

Öffne deine server.cfg und füge die Ensure-Zeile nach Framework- und Inventar-Resources ein:

ensure agency-vehiclekeys

Schritt 4 — Config.lua konfigurieren

Öffne agency-vehiclekeys/config/Config.lua und stelle Framework, Inventarsystem und Feature-Einstellungen ein. Im nächsten Abschnitt findest du ein Beispiel.

Schritt 5 — Schlüssel-Item zum Inventar hinzufügen

Füge bei QBCore oder ESX die Schlüssel-Item-Definition zur Shared-Items-Datei hinzu. Die genaue Definition steht in der Dokumentation unter docs.agencyg.de/vehiclekeys. ox_inventory-Nutzer tragen das Item stattdessen in die items.lua ein.

Schritt 6 — Starten und testen

Starte deinen Server neu. Spawne ein Fahrzeug, prüfe dein Inventar auf das Schlüssel-Item, schließ das Fahrzeug ab, entferne dich, kehre zurück und versuche einzusteigen. Teste dann das Weitergeben des Schlüssels, die Lockpick-Interaktion und das Hotwire-Minigame.

Config.lua Beispiel

Hier ist eine repräsentative Konfiguration mit den wichtigsten Optionen von Agency-Vehiclekeys:

-- Agency-Vehiclekeys: Config.lua

Config = {}

-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"

-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"

-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"

-- Item name for lockpicks
Config.LockpickItem = "lockpick"

-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0

-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30  -- seconds

-- Hotwire mini-game settings
Config.Hotwire = {
    enabled    = true,
    timeLimit  = 20,         -- seconds to complete mini-game
    difficulty = "medium",   -- "easy", "medium", "hard"
    -- Per-class overrides (GTA vehicle class numbers)
    classOverrides = {
        [6]  = "easy",   -- off-road: easier
        [7]  = "hard",   -- supercars: harder
        [14] = "hard",   -- military: very difficult
    },
}

-- Lockpick settings
Config.Lockpick = {
    enabled          = true,
    breakChance      = 0.25, -- 25% chance lockpick breaks on failure
    alertPolice      = true, -- send notification to online police on attempt
    alertRadius      = 30.0, -- metres within which police are notified
}

-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }

-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"

-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true

Framework- und Inventar-Kompatibilität

Agency-Vehiclekeys unterstützt folgende Kombinationen direkt:

  • QBCore + qb-inventory: Vollständige Integration — Schlüssel erscheinen im QBCore-Inventar, Fahrzeugbesitz synchronisiert mit player_vehicles
  • QBCore + ox_inventory: Vollständige Integration — Schlüssel als ox-Items mit Metadaten, kompatibel mit allen ox_inventory-Features
  • ESX + ESX-Inventar: Vollständige Integration — Schlüssel im ESX-Inventarsystem, Besitz synchronisiert mit der ESX-Fahrzeugtabelle

Für andere Inventarsysteme ermöglichen die Export-API und der offene Lua-Code das einfache Hinzufügen einer Custom-Bridge. Die Dokumentation enthält ein Bridge-Template.

Dokumentation

Die vollständige Dokumentation — alle Config-Optionen, Inventar-Item-Definitionen, Export-API-Referenz, Job-Exempt-Setup und FAQ — findest du unter docs.agencyg.de/vehiclekeys. Die Docs werden mit jedem Release aktualisiert und enthalten Copy-Paste-Item-Definitionen für QBCore, ESX und ox_inventory.

Preis: 5,99 € Einmalzahlung

Agency-Vehiclekeys kostet 5,99 € als einmalige Zahlung über den Agency-Scripts-Shop. Kein Abo, keine Verlängerung, keine Server-Lizenzgebühr. Einmal zahlen, für immer besitzen — alle zukünftigen Updates der aktuellen Hauptversion sind ohne Aufpreis enthalten. Unter sechs Euro ist das eines der preiswertesten Premium-FiveM-Scripts auf dem Markt. Ein vergleichbares Vehicle-Keys-System eines anderen Entwicklers im Abo-Modell würde allein im ersten Monat genauso viel kosten — Agency-Vehiclekeys liefert gleiche oder bessere Qualität zum Einmalpreis, den die meisten Serverinhaber in einer Woche für Kaffee ausgeben.

Für wen eignet sich Agency-Vehiclekeys?

Agency-Vehiclekeys ist die richtige Wahl für:

  • Ernsthafte RP-Server, bei denen Fahrzeugbesitz echtes Gewicht haben soll — kein beliebiges Einsteigen mehr
  • Kriminelles RP, das authentische Hotwire- und Lockpick-Mechaniken will, die Autodiebstahl zu einer riskanten, fertigkeitsbasierten Aktivität machen
  • Server mit Autohäusern — nahtlose Integration bedeutet automatische Schlüsselgenerierung beim Kauf
  • Polizei-RP-Server — Alarm-Alerts und Polizei-Benachrichtigungen bei Lockpick- und Hotwire-Versuchen erzeugen echte Einsatzszenarien
  • QBCore- und ESX-Server, die eine bewährte, gepflegte Schlüssellösung suchen, die bestehende Framework-Konventionen respektiert

Fazit

Fahrzeugschlüssel sind eine grundlegende Mechanik für jeden Server, der Roleplay ernst nimmt. Agency-Vehiclekeys liefert das vollständige Paket — physische Schlüssel-Items, Schlüsselsharing, ein fertigkeitsbasiertes Hotwire-Minigame, ein zweistufiges Lockpick-System, Fahrzeugalarm und tiefe Framework-Integration — für einmalige 5,99 €. Das ist objektiv eines der kaufkräftigsten Investments für deinen FiveM-Server. Besuche den Shop, schnapp es dir und verändere, wie Fahrzeuge auf deinem Server funktionieren.

Agency-Vehiclekeys kaufen — 5,99 € Einmalzahlung

Kein Abo. Realistisches Schlüsselsystem, Hotwire-Minigame, Lockpick, Sharing und Alarm — alles in einem Script.

Artikel teilen

Deinen Server upgraden?

Schau dir unsere Premium-FiveM-Scripts im Agency-Scripts-Store an oder tritt unserem Discord bei — für Support und Updates.