QBESXStandalone
Agency-Vehiclekeys V2 Exports & API
Des clés de véhicule universelles pour FiveM sur QBCore, Qbox, ESX ou en mode totalement autonome.
v2.0.0Payant5 Pages
01Exports client
| Export | Description |
|---|---|
HasKeys(plate) | Vrai lorsque le joueur possède une clé pour cette plaque : propriétaire, partagée ou temporaire. Les véhicules de métier s’ouvrent selon leur modèle et ne sont pas comptabilisés ici. |
GetKeys() | Toutes les clés du joueur sous forme de liste { plate, kind }. kind correspond à owner, shared ou temp. |
ToggleLock(vehicle) | Verrouille ou déverrouille un véhicule dont le joueur possède la clé, avec la même animation et les mêmes vérifications que G. En l’absence de véhicule, le véhicule le plus proche à portée est utilisé. |
ToggleEngine() | Démarre ou arrête le moteur du véhicule conduit par le joueur, comme avec U. |
OpenMenu() | Ouvre le trousseau, par exemple depuis un menu radial ou une application de téléphone. |
CloseMenu() | Ferme le trousseau et rend la souris au jeu. |
IsMenuOpen() | Vrai lorsque le trousseau est ouvert. |
useLockpick() | Lance une tentative de crochetage sur la voiture devant le joueur, ou un démarrage forcé depuis le siège conducteur. Prévu pour les objets ox_inventory : client = { export = 'Agency-Vehiclekeys.useLockpick' }. |
02Exports serveur
| Export | Description |
|---|---|
GiveKeys(source, plate, mode, hours) | Donne une clé. Le mode 'temp' (par défaut) correspond à une clé temporaire, éventuellement pour un certain nombre d’heures, et 'perm' à une clé enregistrée. Une source ou un identifiant peut être utilisé. |
RemoveKeys(source, plate) | Retire une clé partagée ou temporaire. Renvoie true si une clé a été retirée. |
HasKeys(source, plate) | Vrai lorsque le joueur possède une clé pour la plaque, y compris les clés de métier pour un véhicule à proximité. |
SetOwner(source, plate) | Fait du joueur le propriétaire d’une plaque, pour les garages et les boutiques sur les serveurs standalone. Un ancien propriétaire perd sa clé. |
RemoveOwner(plate) | Supprime le propriétaire enregistré par ce script pour une plaque. |
GetOwner(plate) | L’identifiant du propriétaire et sa provenance : 'framework' pour les véhicules possédés dans QBCore, Qbox ou ESX, 'store' pour les propriétaires enregistrés par ce script. |
GetKeyHolders(plate) | Toutes les autres personnes ayant une clé pour la plaque, sous forme de liste { identifier, kind, name, expires }. |
SetVehicleLocked(vehicle, locked) | Verrouille ou déverrouille un véhicule pour tout le monde, sans vérifier les clés. Pour les scripts qui doivent ouvrir une voiture. |
IsVehicleLocked(vehicle) | Vrai lorsque le véhicule est verrouillé. |
GetFramework() | Le framework détecté par le script : qbcore, esx ou standalone. |
03Événements
| Nom | Côté | Description |
|---|---|---|
Agency:Keys:GiveServer | Serveur | Demande une clé temporaire pour une plaque, comme le font Agency Garage et Agency Vehicleshop. Déclenchez cet événement côté client avec la plaque. La voiture doit être à côté du joueur ou lui appartenir. |
qb-vehiclekeys:server:AcquireVehicleKeys | Serveur | L'événement de clé de qb-vehiclekeys, interprété de la même manière, pour que les garages et les boutiques conçus pour qb-vehiclekeys continuent de fonctionner. |
vehiclekeys:client:SetOwner | Client | Événement client déclenché par de nombreux garages et boutiques après l'apparition d'une voiture. Donne une clé temporaire pour cette plaque après les mêmes vérifications côté serveur. |
qb-vehiclekeys:client:AddKeys | Client | L'événement client de qb-vehiclekeys pour remettre des clés, interprété de la même manière. |
simple_carkeys:client:toggleEngine | Client | Déclenché côté client lorsque le moteur est démarré ou arrêté avec une clé, afin que les HUD tels que Agency-Hud puissent suivre l'état du moteur. |
+Bon à savoir
Agency-Vehiclekeys V2 propose des exports et reconnaît les événements de clés habituels, ce qui permet aux scripts de garages, de magasins, de métiers et de braquages de donner, vérifier et retirer des clés.
- Donner et vérifier des clés
- GiveKeys donne une clé temporaire ou enregistrée, RemoveKeys la retire et HasKeys la vérifie, côté serveur avec une source ou un identifiant, et côté client pour le joueur lui-même.
- Propriétaires pour les garages autonomes
- Sur les serveurs autonomes, il n’existe pas de table de framework répertoriant les véhicules possédés. SetOwner attribue un véhicule à un joueur à partir de sa plaque, RemoveOwner retire cette attribution et GetOwner la récupère.
- Événements utilisés par d’autres scripts
- Agency:Keys:GiveServer, qb-vehiclekeys:server:AcquireVehicleKeys, vehiclekeys:client:SetOwner et qb-vehiclekeys:client:AddKeys donnent tous une clé temporaire après les mêmes vérifications : le véhicule doit se trouver à côté du joueur ou lui appartenir.
?Questions fréquentes
Comment donner une clé depuis mon script de garage ?
Côté serveur, appelez exports['Agency-Vehiclekeys']:GiveKeys(source, plate) une fois le véhicule apparu, ou déclenchez TriggerServerEvent('Agency:Keys:GiveServer', plate) côté client. Les scripts conçus pour qb-vehiclekeys n’ont pas besoin d’être modifiés.