QBESXStandalone

Agency-Vehiclekeys V2 Installation

Des clés de véhicule universelles pour FiveM sur QBCore, Qbox, ESX ou en mode totalement autonome.

v2.0.0Payant5 Pages

Acheter Retour au catalogue

01Installation

1Placez Agency-Vehiclekeys dans votre dossier resources
2Ajoutez ensure Agency-Vehiclekeys à server.cfg, après votre framework, oxmysql et votre inventaire
3Arrêtez les autres scripts de clés, comme qb-vehiclekeys. Leurs événements de clés sont pris en charge, les garages et les boutiques continuent donc de fonctionner
4Objets de crochetage : la plupart des serveurs QBCore disposent déjà de lockpick et advancedlockpick. Sinon, consultez install/items_qbcore.lua, install/items_ox_inventory.lua ou install/items_esx.sql
5Facultatif : ajoutez add_ace group.admin agency.vehiclekeys.admin allow pour les onglets Admin et Settings de /keys
6Mise à jour depuis la V1 : remplacez l’ancien dossier et utilisez le nouveau config.lua. Les clés distribuées en V1 (simple_carkeys_shared) sont récupérées au premier démarrage

02Dépendances

Aucune dépendance requise
QBCore, QBox ou ESX (facultatif, fonctionne en standalone sans framework)
oxmysql (facultatif, sans lui, les clés sont enregistrées dans le stockage clé-valeur du serveur)
Un inventaire pour les crochets (facultatif : ox_inventory, qs-inventory, qb-inventory et ses forks, ou ESX)
Un script de dispatch (facultatif : ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch ou lb-tablet)
Agency-Notify (facultatif, messages au style classique de la V1)

03Fichier SQL

Optionnel : la ressource crée ces tables elle-même au démarrage. N'importez ce fichier que si vous préparez la base de données à la main :

-- 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;

+Bon à savoir

Agency-Vehiclekeys V2 fonctionne dès que la ligne ensure est ajoutée. Avant le premier démarrage, cinq points méritent votre attention : les autres scripts de clés, les objets de crochetage, la base de données, les admins et les clés de métier, ainsi que la migration depuis V1.

Autres scripts clés: Arrêtez qb-vehiclekeys, qbx_vehiclekeys et les scripts similaires, deux scripts de clés entreraient en conflit pour gérer les mêmes véhicules. Leurs événements de clés sont pris en charge, les garages et les boutiques continuent donc de fonctionner. Un script qui appelle exports['qb-vehiclekeys']:HasKeys(plate) côté client doit simplement remplacer le nom par Agency-Vehiclekeys.
Objets de crochetage: Config.Lockpick.items indique les noms des objets, par défaut advancedlockpick et lockpick. La plupart des serveurs QBCore ont les deux. install/items_qbcore.lua, install/items_ox_inventory.lua et install/items_esx.sql contiennent les entrées pour les autres inventaires. Utiliser l’objet depuis l’inventaire lance une tentative, H fait de même.
Base de données: Avec oxmysql, les clés sont enregistrées dans la table agency_vehiclekeys, que le script crée lui-même. Sans oxmysql, elles sont stockées dans le magasin de valeurs clés du serveur. install/agency_vehiclekeys.sql est nécessaire uniquement si l’utilisateur de votre base de données ne peut pas créer de tables.
Clés admin et de métier: Les admins sont les joueurs qui ont l’ACE agency.vehiclekeys.admin, le groupe admin ou superadmin, ou un groupe défini dans Config.AdminGroups. Sur les serveurs standalone, les clés de métier utilisent les permissions ACE, par exemple add_ace group.police agency.vehiclekeys.police allow.
Mise à jour depuis V1: Remplacez l’ancien dossier par le nouveau et utilisez le nouveau config.lua, la configuration V1 n’est pas compatible. Les clés de simple_carkeys_shared sont reprises au premier démarrage. G verrouille toujours le véhicule, le moteur passe de M à U, et /givekey et /removekey fonctionnent toujours.

?Questions fréquentes

Quels inventaires sont pris en charge pour les objets de crochetage ?

ox_inventory, qs-inventory, qb-inventory et ses forks, ainsi que l’inventaire ESX, détectés avec Config.Inventory = 'auto'. Les serveurs standalone sans inventaire peuvent connecter leur propre système avec Config.Standalone.itemCount et removeItem, ou permettre aux joueurs de crocheter sans objet.

Mon garage utilise sa propre table pour les véhicules possédés. Que dois-je faire ?

Définissez Config.OwnedVehicles sur la table et ses colonnes pour le propriétaire et la plaque. Par défaut, player_vehicles avec citizenid (QBCore, Qbox) et owned_vehicles avec owner (ESX) sont utilisés.