QBESXStandalone

Agency-Blackmarket V2 Exports & API

Un marché noir vivant pour FiveM sur QBCore, Qbox, ESX ou entièrement en standalone.

v2.0.0Payant6 Pages

01Exports client

Export	Description
`OpenMenu()`	Ouvre le menu de /ablackmarket, par exemple depuis un menu radial ou une application de téléphone. Les mêmes vérifications que pour la commande s'appliquent.
`CloseMenu()`	Ferme le menu et rend la souris au jeu.
`IsMenuOpen()`	Renvoie true tant que le menu du marché noir est ouvert, chez un dealer ou n'importe où.

02Exports serveur

Export	Description
`GetReputation(source)`	Les points de réputation d'un joueur, 0 pour un joueur qui n'en a pas encore.
`SetReputation(source, value)`	Fixe la réputation d'un joueur à une valeur donnée, jamais en dessous de 0. Renvoie true en cas de succès.
`AddReputation(source, amount)`	Ajoute de la réputation, ou en retire avec un montant négatif. Un nouveau niveau est annoncé au joueur et à l'application Companion. Renvoie true en cas de succès.
`GetLevel(source)`	Renvoie deux valeurs : le numéro du niveau du joueur (1 à 5 par défaut) et son nom.
`AddCredit(source, amount)`	Ajoute du crédit dealer, que le joueur peut utiliser lors de son prochain achat ou de sa prochaine commande. Renvoie true en cas de succès.
`RelocateDealer(dealerId)`	Déplace immédiatement un dealer vers un autre de ses emplacements. Renvoie true s'il a bougé.
`SendDealerAway(dealerId, minutes)`	Le dealer disparaît pendant le nombre de minutes indiqué, puis réapparaît à un autre de ses emplacements, comme après une visite de la police.
`IsDealerPresent(dealerId)`	True tant que le dealer se trouve à l'un de ses emplacements et n'est pas parti.
`StartFlashSale(minutes)`	Lance une vente flash avec des objets au hasard à prix réduit. Sans minutes, la durée de Config.FlashSale est utilisée.

03Événements

Nom	Côté	Description
`agency-blackmarket:deal`	Serveur	Se déclenche sur le serveur avec (source, kind, data) après chaque transaction. kind vaut buy, sell, launder, order, pickup ou job, et data contient le détail de la transaction, comme le dealer, les objets et le total.
`agency-blackmarket:dealerMoved`	Serveur	Se déclenche sur le serveur avec (dealerId, pos, reason) quand un dealer change d'emplacement. reason vaut rotate, return, admin ou export.
`agency-blackmarket:flashSale`	Serveur	Se déclenche sur le serveur avec (items, minutes) au début d'une vente flash. items associe chaque objet en promotion à sa remise en pourcentage.

+Bon à savoir

Agency-Blackmarket V2 propose des exports et des événements pour que vos propres scripts puissent donner de la réputation et du crédit, contrôler les dealers et réagir aux transactions.

Réputation et crédit: GetReputation, SetReputation, AddReputation et GetLevel lisent et modifient la position d'un joueur, et AddCredit verse du crédit dealer. Ils prennent l'id serveur d'un joueur en ligne.
Dealers et ventes flash: RelocateDealer, SendDealerAway et IsDealerPresent contrôlent les dealers avec l'id de Config.Dealers, et StartFlashSale lance une vente depuis votre propre événement.
Événements: agency-blackmarket:deal se déclenche après chaque transaction, agency-blackmarket:dealerMoved après chaque déplacement et agency-blackmarket:flashSale au début d'une vente. Les trois se déclenchent uniquement sur le serveur et servent pour des logs, des outils de police ou vos propres jobs.

?Questions fréquentes

Comment ouvrir le menu depuis mon menu radial ?

Appelez exports['Agency-Blackmarket']:OpenMenu() côté client. Les mêmes vérifications que pour la commande s'appliquent, y compris un objet de Config.Menu.item.