Pepper Keys

Fahrzeugschlüssel als echte Items mit ox_inventory – wer den Schlüssel hat, fährt das Auto. Mit Schlüsseldienst, Schloss tauschen und Kurzschließen.

Überblick

Pepper Keys macht den Fahrzeugschlüssel zu einem echten Item. Wer den Schlüssel im Inventar hat, schließt auf und startet den Motor, auch wenn er ihn gestohlen hat. Der Besitzer ohne Schlüssel kommt dagegen nicht weiter. Gestohlen? Beim Schlüsseldienst das Schloss tauschen, dann sind alle alten Schlüssel wertlos. Ohne Schlüssel bleibt nur das Kurzschließen mit Mini-Spiel, Werkzeug und Alarm.

Gesperrt sind nur Spielerfahrzeuge. Fahrzeuge aus Job-Scripts bleiben frei fahrbar, du musst dort nichts anpassen.

• Schlüssel als ox_inventory-Item mit Kennzeichen und Fahrzeugname
• Schloss tauschen macht alte Schlüssel wertlos, Ersatzschlüssel beim Schlüsseldienst
• Kurzschließen mit Mini-Spiel, Werkzeug, Alarm und Schwierigkeit je Fahrzeugklasse
• Läuft mit jedem Garagen-Script, das die Fahrzeugtabelle des Frameworks nutzt
• Team-Befehl /pkeys, vier Server-Exporte und ein Alarm-Event für dein Dispatch-Script

Voraussetzungen

Ohne Framework oder ohne laufendes ox_inventory bleibt Pepper Keys inaktiv und meldet das in der Server-Konsole.

Installation

1. Ordner nach resources/[pepper]/pepper_keys kopieren.

   Ordnernamen nicht umbenennen. Andere Scripts rufen exports.pepper_keys auf, das funktioniert nur mit dem Namen pepper_keys.

2. Den Eintrag aus install/items/ox_inventory.txt in ox_inventory/data/items.lua einfügen.

3. install/images/pepper_carkey.png nach ox_inventory/web/images kopieren.

4. In der server.cfg nach Framework, oxmysql, ox_lib und ox_inventory:

ensure oxmysql
ensure ox_lib
ensure es_extended   # oder qb-core / qbx_core
ensure ox_inventory
ensure pepper_keys

add_ace group.admin pepper.keys.admin allow

5. Server starten. In der Konsole steht „Pepper Keys 1.0.0 gestartet (esx)“ (bzw. dein Framework).

Datenbank: Die Tabelle pepper_keys_locks legt das Script beim Start selbst an (server/db.lua). Die Datei install/pepper_keys.sql mit demselben Inhalt brauchst du nur, wenn dein Datenbank-Benutzer keine Tabellen anlegen darf. Dann importierst du sie einmal per HeidiSQL oder phpMyAdmin.

Items je Inventar:

Andere Inventare werden nicht unterstützt. Der Item-Eintrag hat eine deutsche Bezeichnung. Auf englischen Servern label und description in items.lua anpassen.

Erster Test

1. Als Admin /pkeys give <Kennzeichen> für ein eigenes Fahrzeug eingeben. Der Schlüssel liegt im Inventar.
2. Am Fahrzeug U drücken: Es schließt ab oder auf, mit Lichtsignal.
3. Einsteigen: Mit Schlüssel springt der Motor an. Schlüssel ablegen, aussteigen und wieder einsteigen: Der Motor bleibt aus.
4. Ohne Schlüssel und mit einem lockpick im Inventar K drücken und das Mini-Spiel spielen.
5. Zum Schlüsseldienst (Standard bei -205.5, -1313.3) fahren und mit E einen Ersatzschlüssel holen.

Konfiguration

Grundeinstellungen

Config.Locale = 'de'
Config.Framework = 'auto'
Config.Item = 'pepper_carkey'
Config.Range = 15.0
Config.PayAccounts = { 'bank', 'money' }

Kurzschließen

Config.Hotwire = {
    Enabled = true,
    Item = 'lockpick',
    ItemBreakChance = 40,
    AlarmChance = 70,
    Cooldown = 30,
    MinPolice = 0,
    PoliceJobs = { 'police', 'sheriff' },
}

Schlüsseldienst

Config.Locksmith = {
    CopyFee = 500,
    LockFee = 2500,
    FirstFree = true,
    Places = {
        { label = 'Schlüsseldienst', coords = vec3(-205.5, -1313.3, 31.3), radius = 3.0, blip = true },
    },
}

Server

So funktioniert es

• Einsteigen: Als Fahrer fragt das Script einmal beim Server nach. Mit passendem Schlüssel springt der Motor an, sonst bleibt er aus.
• Schlüssel weitergeben: Einfach das Item übergeben. Wer es hält, darf fahren.
• Läuft der Motor schon, läuft er weiter, auch wenn der Schlüssel abgenommen wird.
• Ein Schlüssel zeigt im Inventar Kennzeichen und Fahrzeugname.

Schlüsseldienst

Der Schlüsseldienst hilft nur dem Besitzer laut Fahrzeugtabelle des Frameworks.

• Ersatzschlüssel: gegen Gebühr (Config.Locksmith.CopyFee), passt zum aktuellen Schloss.
• Schloss tauschen: gegen Gebühr (Config.Locksmith.LockFee), du bekommst einen neuen Schlüssel. Alle alten Schlüssel passen nicht mehr.
• Bestandsfahrzeuge: Fahrzeuge aus der Zeit vor Pepper Keys haben noch keinen Schlüssel. Der erste ist kostenlos (Config.Locksmith.FirstFree).

Passt der Schlüssel nicht mehr ins Inventar, bekommt der Spieler sein Geld zurück.

Kurzschließen

• Nur ohne passenden Schlüssel, mit Werkzeug Config.Hotwire.Item (Standard lockpick, false = keines nötig).
• Mini-Spiel: Leertaste drücken, wenn die Nadel in der Zone ist. Die Schwierigkeit hängt von der Fahrzeugklasse ab (Config.Hotwire.Levels, Classes).
• Erfolg: Fahrzeug offen, Motor startet, bis es eingeparkt oder gelöscht wird.
• Misserfolg: Wartezeit (Cooldown) und Chance, dass das Werkzeug bricht (ItemBreakChance).
• Alarm mit Chance AlarmChance: Sirene am Fahrzeug und Server-Event pepper_keys:alarm.
• Mindestzahl Polizei im Dienst: MinPolice mit den Jobs aus PoliceJobs.

Garagen-Scripts

Pepper Keys liest nur die Fahrzeugtabelle des Frameworks (owned_vehicles bei ESX, player_vehicles bei QBCore und Qbox) und schreibt dort nichts. Damit läuft es mit jedem Garagen-Script, das diese Tabelle nutzt. Beim Ausparken entsteht kein neuer Schlüssel, der Spieler nimmt seinen vorhandenen Schlüssel mit.

Die Liste folgt aus der genutzten Tabelle. Mit den fremden Scripts haben wir Pepper Keys nicht einzeln getestet. Nutzt dein Garagen-Script eine eigene Tabelle, sind seine Fahrzeuge nicht gesperrt.

Nur ein Schlüssel-Script: Entferne andere Schlüssel-Scripts (z. B. qb-vehiclekeys, qbx_vehiclekeys, wasabi_carlock). Hat dein Garagen-Script eine Einstellung für das Schlüssel-System, stell sie auf „keins“ oder trag dort die Exporte von Pepper Keys ein.

OP Garages v3: Ausparken und Einparken laufen ohne Anpassung, OP Garages vergibt dabei keinen Schlüssel (Config.KeysDependency fällt auf none). Kaufverträge, Fake-Kennzeichen sowie Job- und Gang-Fahrzeuge brauchen eine eigene Anbindung in den „editable“-Dateien von OP Garages: Nach einem Vertrag ChangeLock + CreateKey für den neuen Besitzer aufrufen, damit der alte Schlüssel nicht mehr passt.

Andere Scripts, die selbst Schlüssel vergeben sollen (Autohaus, Vermietung, Fuhrpark), rufen die Exporte unten auf.

Befehle und Rechte

Rechte: Admin = ACE pepper.keys.admin (ServerConfig.AdminAce) oder eine Gruppe aus Config.AdminGroups. Der Befehl funktioniert nur im Spiel, nicht in der Server-Konsole. Jede Aktion geht ins Log, auf Wunsch auch an einen Discord-Webhook (ServerConfig.Webhook). Der Befehlsname steht in Config.AdminCommand.

Tasten: U abschließen, K kurzschließen, E Schlüsseldienst. Spieler können sie in den FiveM-Einstellungen (Tastenbelegung → FiveM) ändern, die Standardwerte stehen in Config.LockKey, HotwireKey und InteractKey.

Exports und Events

Server-Exporte:

exports.pepper_keys:CreateKey(src, plate, label) -- Schlüssel ins Inventar legen
exports.pepper_keys:HasKey(src, plate)           -- hat der Spieler einen passenden Schlüssel?
exports.pepper_keys:ChangeLock(plate)            -- neues Schloss, alte Schlüssel wertlos
exports.pepper_keys:RemoveKeys(src, plate)       -- Schlüssel zu diesem Kennzeichen abnehmen

Events:

AddEventHandler('pepper_keys:alarm', function(data)
    print(('Autoalarm: %s bei %.1f, %.1f'):format(data.plate, data.coords.x, data.coords.y))
end)

Eine eigene Dispatch-Anbindung trägst du alternativ in bridge/server/dispatch.lua ein (offene Datei).

FAQ

Pepper Keys startet nicht oder bleibt inaktiv – was tun?

ox_inventory, ox_lib, oxmysql und dein Framework müssen vor pepper_keys starten. Ohne ESX, QBCore oder Qbox oder ohne laufendes ox_inventory meldet das Script „bleibt inaktiv“ in der Konsole.

Der Schlüssel hat kein Bild im Inventar.

install/images/pepper_carkey.png nach ox_inventory/web/images kopieren und den Server neu starten.

Mein eigenes Auto lässt sich nicht starten.

Fahrzeuge aus der Zeit vor Pepper Keys haben noch keinen Schlüssel. Hol ihn beim Schlüsseldienst, der erste ist kostenlos (Config.Locksmith.FirstFree).

Ein Job-Fahrzeug ist gesperrt.

Gesperrt ist nur, was in der Fahrzeugtabelle des Frameworks oder in pepper_keys_locks steht. Prüfe, ob das Kennzeichen dort eingetragen ist.

„Dir fehlt das passende Werkzeug“ beim Kurzschließen.

Das Item aus Config.Hotwire.Item (Standard lockpick) muss im Inventar liegen. Mit Item = false geht es ohne Werkzeug.

/pkeys tut nichts.

Setze die ACE aus der Installation (add_ace group.admin pepper.keys.admin allow) oder trag deine Gruppe in Config.AdminGroups ein. In der Server-Konsole ist der Befehl ohne Wirkung.

Muss ich die SQL-Datei importieren?

Nein. Die Tabelle pepper_keys_locks entsteht beim Start automatisch. install/pepper_keys.sql ist nur für Datenbank-Benutzer ohne Recht zum Anlegen von Tabellen.

Läuft Pepper Keys mit qs-inventory oder qb-inventory?

Nein, der Schlüssel ist ein ox_inventory-Item mit Metadaten. Ohne ox_inventory bleibt das Script inaktiv.

Kann ich Pepper Keys zusammen mit qb-vehiclekeys nutzen?

Nein, nutze nur ein Schlüssel-Script. Entferne andere (qb-vehiclekeys, qbx_vehiclekeys, wasabi_carlock), sonst sperren oder entsperren sie sich gegenseitig.

Wie gibt mein Autohaus- oder Vermietungs-Script einen Schlüssel aus?

Über den Server-Export exports.pepper_keys:CreateKey(src, plate, label). Beim Weiterverkauf erst ChangeLock(plate), dann CreateKey für den neuen Besitzer.

Wie ändere ich Texte oder die Sprache?

Sprache über Config.Locale ('de' oder 'en'), Texte in locales/de.json bzw. locales/en.json. Den Namen des Items änderst du in ox_inventory/data/items.lua.

Wie verschiebe ich den Schlüsseldienst oder lege weitere an?

In Config.Locksmith.Places die coords ändern oder weitere Einträge mit label, coords, radius und blip ergänzen.

Können Cheater die Motorsperre umgehen?

Die Motorsperre läuft im Client und ist für Cheater umgehbar. Abschließen, Besitz, Item-Prüfung, Gebühren und Kurzschließen prüft der Server.

Wie melde ich den Autoalarm an mein Dispatch-Script?

Hör auf das Server-Event pepper_keys:alarm oder trag den Aufruf deines Dispatch-Scripts in bridge/server/dispatch.lua ein.

Support

Discord → Ticket (Kategorie „Script Support“) unter https://discord.gg/6NaFJWKDYu, Kauf vorher mit /verify verknüpfen.

Permanent auf dem Dev-Server von Pepper Scripts getestet.

Changelog

Aktuell: 1.0.0 (08.11.2026), erste Veröffentlichung. Alle Änderungen stehen in CHANGELOG.md in der Ressource.

Fehler gefunden? Melde ihn im Discord.