QBESXStandalone
Agency-Minerjob V2 Exports & API
Un métier de mineur pour FiveM sur QBCore, Qbox, ESX ou en mode totalement autonome, réparti sur trois sites.
v2.0.0Payant5 Pages
01Exports client
| Export | Description |
|---|---|
OpenMenu(page) | Ouvre le menu, par exemple depuis un menu radial ou une application de téléphone. page peut être overview (par défaut), market, tools, smelter, cutting ou contracts. |
CloseMenu() | Ferme le menu et rend la souris au jeu. |
IsMenuOpen() | Vrai lorsque le menu est ouvert. |
IsWorking() | Vrai lorsque le joueur mine ou taille une gemme. |
GetLevel() | Le niveau de minage du joueur. |
02Exports serveur
| Export | Description |
|---|---|
GetLevel(source) | Le niveau de minage d’un joueur, 0 si le joueur est inconnu. |
GetProgress(source) | Niveau et progression sous la forme { level, xp, need, pct, max }. |
AddXp(source, amount) | Ajoute de l’XP, avec les montées de niveau et leur message. Renvoie true si le joueur a été trouvé. |
SetLevel(source, level) | Définit le niveau entre 1 et le niveau maximal et le démarre à 0 XP. |
GetStats(source) | Ce que le joueur a fait jusqu’à présent : { mined, smelted, cut, broken, sold, earned, contracts }. |
GetPrice(item) | Le prix actuel du marché d’un objet à l’unité. |
03Événements
| Nom | Côté | Description |
|---|---|---|
agency-minerjob:mined | Serveur | Déclenché sur le serveur après le paiement d’une session de minage, avec source, item, count et la zone minière. Utilisez AddEventHandler pour l’écouter, par exemple pour des quêtes ou des statistiques. |
agency-minerjob:sold | Serveur | Déclenché sur le serveur après une vente, avec source, item, count et le montant total payé. |
agency-minerjob:contract | Serveur | Déclenché sur le serveur lorsqu’un contrat a été livré, avec source, item, count et le paiement. |
+Bon à savoir
Agency-Minerjob V2 propose des exports et des événements serveur, afin que les quêtes, les succès, les téléphones et les outils d’administration puissent consulter les niveaux et les prix, attribuer de l’XP et réagir à l’extraction, aux ventes et aux contrats.
- Niveaux et XP
- GetLevel, GetProgress, AddXp et SetLevel consultent et modifient le niveau d’un joueur côté serveur. AddXp affiche le message de montée de niveau comme lors d’une extraction minière.
- Statistiques et prix
- GetStats renvoie ce qu’un joueur a extrait, fondu, taillé, cassé, vendu, gagné et livré. GetPrice consulte le prix actuel de n’importe quel objet.
- Événements serveur
- agency-minerjob:mined, agency-minerjob:sold et agency-minerjob:contract sont déclenchés côté serveur une fois la récompense versée. Écoutez-les avec AddEventHandler ; ils servent uniquement à signaler l’action, le paiement a déjà eu lieu.
?Questions fréquentes
Comment ouvrir le menu depuis mon menu radial ?
Appelez exports['Agency-Minerjob']:OpenMenu() côté client, ou passez une page comme 'market' ou 'contracts' pour ouvrir directement cette page.