Créer une économie et une boutique (Vault)

Une économie in-game permet aux joueurs d’échanger, d’acheter des blocs et de financer des events. Elle repose sur trois briques : Vault (le pont), un fournisseur d’économie, et un plugin de boutique.

Cause / Le problème

Sans Vault, chaque plugin gère sa propre monnaie et les soldes ne se synchronisent pas entre eux. La boutique et les jobs, par exemple, utiliseraient deux comptes distincts.

Solution

1. Installez Vault dans le dossier plugins/. C’est une API : aucun joueur ne l’utilise directement, mais les autres plugins en dépendent. Vérifiez au démarrage la ligne Vault enabled dans la console.
2. Ajoutez un fournisseur d’économie. EssentialsX (module EssentialsXEconomy) est le plus courant :

   # plugins/Essentials/config.yml
   starting-balance: 100.0
   currency-symbol: "$"

   D’autres options : XConomy, TNE. Un seul fournisseur à la fois.
3. Installez un plugin de boutique compatible Vault. Exemples courants : ShopGUI+, EconomyShopGUI, ou le /shop d’EssentialsX. Les prix et stocks sont définis dans un fichier YAML par catégorie.
4. Donnez un solde de départ. Les nouveaux joueurs reçoivent starting-balance automatiquement. Pour ajuster un joueur existant :

   /bal give <pseudo> 100

5. Reliez les sources de revenus. Jobs Reborn, Quests ou les drops de mobs alimentent le solde via Vault. Vérifiez que chaque plugin affiche [Vault] hooked dans ses logs.
6. Déboguez les problèmes courants :
   • Economy response: FAILURE → deux fournisseurs se disputent Vault. Désactivez-en un.
   • Soldes à zéro après redémarrage → le stockage (MySQL/LiteSQL) n’est pas configuré ou le fichier est en lecture seule.
   • /pay ne fonctionne pas → le plugin de commande ne déclare pas Vault comme dépendance soft.

Sauvegardez régulièrement le fichier d’économie (souvent plugins/Essentials/userdata/) pour éviter toute perte de soldes.