Agency-Vehiclekeys: Wie kleine Hürden Autos realistischer wirken lassen

Das Anti-Feature, das keines ist

Eine Taste zum Starten eines Fahrzeugs zu verlangen, klingt nach einem Anti-Feature. Wer will schon mehr Schritte erledigen, bevor er losfahren kann? Doch immersives RP entsteht oft genau durch diese Art von sinnvoller Reibung. Fahrzeugdiebstahl wird zu Diebstahl mit Konsequenzen. Das Abschließen deines Autos wird zu einer echten Handlung. Das Kurzschließen wird zu einer erlernbaren Fähigkeit.

Wichtige Schlüsselzustände

Agency-Vehiclekeys bildet für jedes Fahrzeug drei Schlüsselzustände ab: im Besitz (du hast einen physischen Schlüsselgegenstand), geteilt (jemand hat dir einen Schlüssel überlassen), kurzgeschlossen (vorübergehend zugänglich, mit dem Risiko, dass die Polizei dich aufspürt). Jeder Zustand hat eigene Soundeffekte, Startanimationen und ein anderes Motorverhalten. Wer sich das Auto eines Freundes leiht, erlebt es anders als ein Dieb, und das sollte auch so sein.

Lockpicking-Minispiel

Wir liefern ein einfaches Lockpicking-Minispiel mit drei Schwierigkeitsstufen, die sich nach der Fahrzeugklasse richten. Bei einem Sultan RS dauert es länger und du scheiterst häufiger als bei einem Faggio. Das Minispiel basiert auf Geschick, ist aber nicht übermäßig bestrafend: Bei einem Fehlschlag verlierst du Zeit und Werkzeug, nicht deinen Charakterfortschritt. Das ist die richtige Schwierigkeitskurve für eine Mechanik, die Spannung erzeugen, aber kein Hindernis sein soll.

Framework-Integrationen

Fahrzeugbesitz in QBCore, ESX-Garagen und benutzerdefinierte Registrierungen in standalone lassen sich alle über einen gemeinsamen Satz Hooks einbinden. Schlüssel werden als Inventargegenstände gespeichert und funktionieren dadurch ganz natürlich mit Drops, Tausch und Inventarsuchen. Es gibt keine Sonderfälle.

Auswirkungen auf die Wirtschaft

Der schlüsselbasierte Zugang zu Fahrzeugen schafft realistische wirtschaftliche Rollen. Schlüsseldienste werden zu einem realistischen Beruf. Autodiebe werden zu einer echten Bedrohung. Versicherungen werden nützlich. Emergent Roleplay entsteht durch Systeme, die aufeinander reagieren. Agency-Vehiclekeys ist ein Teil dieses Puzzles.

Installation & Einrichtung

Agency-Vehiclekeys benötigt oxmysql, um den Schlüsselbesitz über Serverneustarts hinweg zu speichern. Importiere vehiclekeys.sql , lege den Ressourcenordner auf deinem Server ab und füge ensure agency-vehiclekeys in server.cfg. Die Ressource liest Fahrzeugbesitzdaten aus der Garage oder dem Fahrzeugregister deines Frameworks. QBCore- und ESX-Adapter sind im Paket enthalten und werden beim Start automatisch erkannt.

Schlüsselgegenstände müssen im Item-System deines Frameworks registriert werden. Die Config enthält Item-Namen und Metadaten-Definitionen für QBCore und ESX. Bei standalone-Setups wird die Verarbeitung der Items über Config-Hooks festgelegt.

Konfigurationsoptionen

Die config.lua bietet dir detaillierte Kontrolle über jede Schlüsselmechanik:

• Lockpick-Stufen, lege Erfolgswahrscheinlichkeit und Verhalten bei Fehlschlägen für jede Fahrzeugklasse fest. Supersportwagen lassen sich schwerer kurzschließen als Kleinwagen.
• Chance auf Entdeckung beim Kurzschließen, Wahrscheinlichkeit, dass ein erfolgreiches Kurzschließen bei jeder Minute aktiver Nutzung eine Polizeimeldung auslöst.
• Kosten für das Anfertigen eines SchlüsselduplikatsArtikel- und Geldkosten für die Erstellung eines Nachschlüssels an der Werkbank des Schlossers.
• Schlosser-Job erforderlich, beschränkt das Anfertigen von Schlüsseln optional auf Spieler mit der Jobrolle Schlosser.
• Automatisch beim Aussteigen verriegeln, ob Fahrzeuge automatisch verriegelt werden, wenn der Fahrer aussteigt. Standard: deaktiviert (realistischer).
• Ablauf gemeinsamer Schlüssel, temporäre Schlüssel können ein Zeitlimit in der realen Welt haben, nach dessen Ablauf sie automatisch deaktiviert werden.

Framework-Kompatibilität

Komplette QBCore- und ESX-Adapter sind im Paket enthalten. Für standalone-Setups musst du vier Konfigurationsfunktionen implementieren: Fahrzeughalter abfragen, Items geben/entfernen, Polizeialarm auslösen und optional den Schlosser-Job prüfen. Für die zentrale Schlüsselstatus-Logik, Animationen, das Minispiel und die Hotwire-Logik sind keine Framework-Kenntnisse erforderlich.

Warum das für Roleplay wichtig ist

Fahrzeugbesitz ohne sinnvolle Zugangskontrolle ist nur kosmetisch. Agency-Vehiclekeys sorgt dafür, dass sich der Unterschied zwischen dem Besitz eines Fahrzeugs und dem Zugang dazu echt anfühlt. Ein abgeschlossenes Auto vor einer Bank ist nicht einfach nur Kulisse, sondern je nachdem, wer es betrachtet, ein potenzielles Ziel oder ein sicheres Gut.

Die Schlosserwirtschaft ist der größte emergente Vorteil. Sobald Schlüssel physische Items sind, die du nachmachen, verlieren oder stehlen kannst, haben Schlosser-Charaktere eine echte Dienstleistung anzubieten. Wer seinen Schlüssel verliert, muss entweder das Fahrzeug kurzschließen (riskant) oder einen Schlosser finden (erfordert Vertrauen und Verhandlungsgeschick). Diese Interaktion ist pures RP, das es vor der Installation des Scripts nicht gab.

Die Hotwire-Erkennung macht Fahrzeugdiebstahl zu einem kalkulierten Risiko statt zu einer lächerlich einfachen Aktion. Wer ein Fahrzeug kurzschließt und eine Stunde damit fährt, geht ein echtes Risiko ein. Erfahrene Diebe lernen, regelmäßig das Fahrzeug zu wechseln. Die Polizei lernt, auf Hotwire-Meldungen zu achten. Das Script erzeugt organisches Kriminellen- und Polize-RP, ganz ohne geskriptete Events.

Häufig gestellte Fragen

Können Spieler ihren Schlüssel einem anderen Spieler geben?

Ja. Schlüssel sind Inventar-Items und können über jede standardmäßige Inventarübergabe getauscht, fallen gelassen oder weitergegeben werden. Dazu gehört auch, einen Schlüssel über den Marktplatz von Agency-Phone zu übergeben oder ihn an einem Ort abzulegen, damit ihn jemand abholen kann. Die gesamte Itemwirtschaft bleibt erhalten.

Was passiert, wenn ein Schlüssel-Item verloren geht oder gelöscht wird?

Das serverseitige Schlüsselregister erfasst den Besitz unabhängig vom Item. Spieler, die ihr physisches Schlüssel-Item verlieren, können sich in einer Schlosserei einen Ersatz anfertigen lassen (kostet Zeit und Geld) oder ihn über Admin-Befehle erhalten. Das Fahrzeug wird dadurch nicht dauerhaft unzugänglich.

Kann das Minispiel für bestimmte Spielerrollen deaktiviert werden?

Ja. Das Dietrich-Minispiel kann für Spieler mit bestimmten Jobrollen (zum Beispiel Meisterschlosser) oder bestimmten Items (professionelles Dietrichset statt einfachem Dietrich) übersprungen werden. Konfiguriere die Bedingungen zum Überspringen in Config.LockpickItems.

Gibt es Konflikte mit vorhandenen Garagen-Scripts?

Agency-Vehiclekeys liest die Fahrzeugbesitzdaten aus der Garage aus, verändert das Garagensystem aber nicht. Fahrzeuge erscheinen weiterhin über dein vorhandenes Garagen-Script. Das Schlüsselsystem wird darübergelegt: Wenn du ein Fahrzeug aus der Garage holst, wird automatisch ein Schlüssel-Item in deinem Inventar erstellt.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Vehiclekeys-Lizenz
• Kompatibles Garagen- oder Fahrzeugbesitzsystem

Einen Schlosser-Charakter auf einem Server mit Schlüsselsystem spielen

Agency-Vehiclekeys ermöglicht einen echten Schlosserberuf, den es auf Servern ohne Schlüsselsystem nicht gibt. So sieht das Gameplay für diesen Charakter in der Praxis aus:

Ein Schlosser-Charakter, der Schlüssel anfertigt, braucht eine Möglichkeit, über die Kunden ihn erreichen können. Dafür eignet sich Agency-Phone. Außerdem braucht er einen Arbeitsplatz-Prop für die Animation beim Anfertigen von Schlüsseln. Stimm dich dazu mit dem MLO-Team deines Servers ab oder verwende einen Workshop-Prop aus dem Basisspiel. Für den Service verlangt er Geld, das über dein Economy-Framework läuft. Vielleicht führt er höherwertige Dietrichwerkzeuge mit, mit denen er Fahrzeuge öffnen kann, die andere Spieler mit ihren Werkzeugen nicht öffnen können. Kriminelle Kunden, die Zugang zu einem bestimmten Fahrzeug brauchen, müssen ihm dafür vertrauen.

Die Vertrauensfrage ist besonders interessant. Ein Schlosser, der unerlaubte Schlüsselkopien anfertigt, Kunden, die Schlüssel nachmachen lassen, bei der Polizei meldet oder Fahrzeuge beim „Arbeiten daran“ absichtlich beschädigt, ist ein Charakter mit echter moralischer Komplexität und echten Folgen im Spiel für seine Entscheidungen. Agency-Vehiclekeys schafft die Voraussetzungen dafür, dass es diesen Charakter geben kann.