QBESXStandalone
Agency-Shops Exports & API
Chaque 24/7, LTD, Rob's Liquor, quincaillerie, Ammu-Nation et station-service de la carte dans un seul script.
v1.0.0Payant5 PagesÀ partir du October 19, 2026, 20:00 CEST
01Exports client
| Export | Description |
|---|---|
GetFuel(vehicle) | Le niveau de carburant d'un véhicule de 0 à 100, de la même façon que LegacyFuel le renvoie. |
SetFuel(vehicle, level) | Définit le niveau de carburant d'un véhicule, de 0 à 100. |
02Exports serveur
| Export | Description |
|---|---|
GetOwner(id) | L'identifiant du propriétaire et le nom du propriétaire d'un magasin ou d'une station-service, ou nil si personne ne le possède. |
AddStock(id, item, amount) | Ajoute des unités au stock d'un magasin possédé, jusqu'à Config.Ownership.MaxStock. Renvoie true lorsque l'opération a réussi. |
AddFuelStock(id, litres) | Ajoute des litres au réservoir d'une station-service possédée, jusqu'à Config.GasStations.MaxFuel. Renvoie true lorsque l'opération a réussi. |
GetBalance(id) | L'argent dans la caisse d'un magasin ou d'une station-service possédée, ou nil. |
03Événements
| Nom | Côté | Description |
|---|---|---|
agency-shop:server:purchased | Serveur | Se déclenche avec (source, storeId, items, total, account) après qu'un achat a été effectué. items répertorie les articles remis et total indique le montant payé, de sorte qu'un script de statistiques ou de mission n'a pas besoin de faire du polling. |
agency-shop:server:shoplift | Serveur | Se déclenche avec (source, storeId, value, coords) lorsqu'un joueur sort d'un magasin avec des articles non payés dans le panier ou le chariot. Avec Config.Dispatch.System = 'event', c'est la seule alerte émise pour que votre propre script de dispatch puisse la récupérer. |
+Bon à savoir
Agency-Shops propose plusieurs exports et deux événements serveur afin que vos propres scripts de carburant, de logistique, d'alerte et de statistiques puissent interagir avec les magasins.
- Niveau de carburant
- GetFuel et SetFuel côté client fonctionnent comme les appels de LegacyFuel, avec un niveau de 0 à 100. Pour les scripts conçus pour LegacyFuel, il suffit de changer le nom de la ressource.
- Propriétaires et stock
- GetOwner et GetBalance récupèrent les informations d'un magasin ou d'une station-service détenu via son identifiant. AddStock et AddFuelStock ajoutent des unités ou des litres, par exemple depuis votre propre script de logistique ou de métier.
- Événements
- agency-shop:server:purchased se déclenche après chaque achat avec le joueur, le magasin, les articles, le montant total et le compte. agency-shop:server:shoplift se déclenche lorsqu'un joueur sort avec des articles non payés.
?Questions fréquentes
Comment récupérer le propriétaire d'un magasin ?
Côté serveur, exécutez exports['Agency-Shops']:GetOwner(id). Cela renvoie l'identifiant et le nom du propriétaire, ou nil si le magasin n'a pas de propriétaire.
Comment envoyer ma propre alerte de police pour un vol à l'étalage ?
Définissez Config.Dispatch.System = 'event' et écoutez agency-shop:server:shoplift. Cela fournit le joueur, l'identifiant du magasin, la valeur des articles et les coordonnées.