QBESXStandalone

Agency-Vehiclekeys V2 Installation

Universelle Fahrzeugschlüssel für FiveM mit QBCore, Qbox, ESX oder vollständig standalone.

v2.0.0Bezahlt5 Seiten

Im Shop kaufen Zur Übersicht

01Installation

1Lege Agency-Vehiclekeys in deinen resources-Ordner
2Füge ensure Agency-Vehiclekeys in server.cfg hinzu, nach deinem Framework, oxmysql und deinem Inventar
3Beende andere Schlüssel-Skripte wie qb-vehiclekeys. Ihre Schlüssel-Events werden erkannt, damit Garagen und Shops weiterhin funktionieren
4Dietrich-Items: Auf den meisten QBCore-Servern sind lockpick und advancedlockpick bereits vorhanden, andernfalls siehe install/items_qbcore.lua, install/items_ox_inventory.lua oder install/items_esx.sql
5Optional: Füge add_ace group.admin agency.vehiclekeys.admin allow für die Admin- und Einstellungen-Tabs von /keys hinzu
6Update von V1: Ersetze den alten Ordner und verwende die neue config.lua. Schlüssel, die in V1 ausgegeben wurden (simple_carkeys_shared), werden beim ersten Start übernommen

02Abhängigkeiten

Keine Abhängigkeit erforderlich
QBCore, QBox oder ESX (optional, ohne Framework läuft es standalone)
oxmysql (optional, ohne oxmysql werden die Schlüssel im Key-Value-Speicher des Servers gespeichert)
Ein Inventar für Dietriche (optional: ox_inventory, qs-inventory, qb-inventory und dessen Forks oder ESX)
Ein Dispatch-Skript (optional: ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch oder lb-tablet)
Agency-Notify (optional, Nachrichten im klassischen V1-Look)

03SQL Datei

Optional: Die Resource legt diese Tabellen beim Start selbst an. Importiere die Datei nur, wenn du die Datenbank von Hand einrichtest:

-- Agency Vehiclekeys V2
-- Optional: the script creates this table by itself on the first start when
-- oxmysql runs. Run it by hand only if your database user may not create tables.

CREATE TABLE IF NOT EXISTS `agency_vehiclekeys` (
    `plate`      VARCHAR(16)  NOT NULL,
    `identifier` VARCHAR(96)  NOT NULL,
    `kind`       VARCHAR(12)  NOT NULL DEFAULT 'shared',
    `holder`     VARCHAR(64)  NULL DEFAULT NULL,
    `granted_by` VARCHAR(96)  NULL DEFAULT NULL,
    `model`      VARCHAR(32)  NULL DEFAULT NULL,
    `created`    INT UNSIGNED NOT NULL DEFAULT 0,
    PRIMARY KEY (`plate`, `identifier`),
    KEY `identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

+Gut zu wissen

Agency-Vehiclekeys V2 funktioniert direkt nach der ensure-Zeile. Vor dem ersten Start solltest du fünf Punkte prüfen: andere Schlüssel-Scripts, Dietrich-Gegenstände, die Datenbank, Admins und Job-Schlüssel sowie den Wechsel von V1.

Weitere wichtige Scripts: Stoppe qb-vehiclekeys, qbx_vehiclekeys und ähnliche Scripts, da sich sonst zwei Schlüssel-Scripts um dieselben Fahrzeuge kümmern würden. Ihre Schlüssel-Events werden erkannt, sodass Garagen und Shops weiterhin funktionieren. Bei einem Script, das auf dem Client exports['qb-vehiclekeys']:HasKeys(plate) aufruft, muss nur der Name zu Agency-Vehiclekeys geändert werden.
Dietrich-Items: Config.Lockpick.items legt die Item-Namen fest, standardmäßig advancedlockpick und lockpick. Die meisten QBCore-Server haben beide. install/items_qbcore.lua, install/items_ox_inventory.lua und install/items_esx.sql enthalten die Einträge für die anderen Inventare. Die Verwendung des Items im Inventar startet einen Versuch, mit H geht es ebenfalls.
Datenbank: Mit oxmysql werden die Schlüssel in der Tabelle agency_vehiclekeys gespeichert, die das Script selbst erstellt. Ohne oxmysql werden sie im Key-Value-Speicher des Servers abgelegt. install/agency_vehiclekeys.sql wird nur benötigt, wenn dein Datenbankbenutzer keine Tabellen erstellen darf.
Admins und Job-Schlüssel: Admins sind Spieler mit der ACE-Berechtigung agency.vehiclekeys.admin, der Gruppe group.admin oder group.superadmin oder einer Gruppe aus Config.AdminGroups. Auf Standalone-Servern werden Job-Schlüssel über ACE-Berechtigungen vergeben, zum Beispiel mit add_ace group.police agency.vehiclekeys.police allow.
Von V1 aktualisieren: Ersetze den alten Ordner durch den neuen und verwende die neue config.lua, da die V1-Konfiguration nicht passt. Schlüssel aus simple_carkeys_shared werden beim ersten Start übernommen. G sperrt weiterhin, die Motorfunktion wurde von M auf U verlegt und /givekey sowie /removekey funktionieren weiterhin.

?Häufige Fragen

Welche Inventare werden für Dietriche unterstützt?

ox_inventory, qs-inventory, qb-inventory und dessen Forks sowie das ESX-Inventar, das über Config.Inventory = 'auto' erkannt wird. Standalone-Server ohne Inventar können ihr eigenes über Config.Standalone.itemCount und removeItem anbinden oder Spielern erlauben, ohne Item zu knacken.

Meine Garage verwendet eine eigene Tabelle für Fahrzeuge im Besitz. Was muss ich tun?

Setze Config.OwnedVehicles auf die Tabelle und deren Spalten für den Besitzer und das Kennzeichen. Standardmäßig werden player_vehicles mit citizenid (QBCore, Qbox) und owned_vehicles mit owner (ESX) verwendet.