Créer un plugin d'économie pour ton serveur Minecraft

Les quatre briques d'un plugin d'économie

Avant d'écrire ta description, décide de quoi ton économie est faite. Presque toutes les économies de serveur se ramènent aux mêmes quatre briques, et c'est la façon dont tu les relies qui rend la tienne intéressante : une monnaie, un endroit où la dépenser, un endroit où les joueurs échangent entre eux, et une source qui alimente le tout.

Tu n'as pas besoin des quatre dès le premier jour. Beaucoup de serveurs démarrent avec la monnaie et une boutique d'administration, puis ajoutent l'hôtel des ventes quand la population devient assez grande pour qu'un marché entre joueurs ait du sens. Découper en plusieurs générations donne souvent un résultat plus propre qu'un plugin monolithique décrit en une fois.

• La monnaie : un solde par joueur, gagné, dépensé, transféré
• La boutique : le serveur achète et vend des objets à prix fixes
• L'hôtel des ventes : les joueurs se vendent des objets entre eux
• Les métiers et les salaires : la source qui fait entrer l'argent
• Les puits : ce qui fait ressortir l'argent du jeu, contre l'inflation

La monnaie : solde par joueur, /pay et sauvegarde

Une monnaie, techniquement, c'est un nombre attaché à un identifiant de joueur, plus les commandes pour le lire et le déplacer. Nomme tout dans ta description : le nom de ta monnaie et son symbole, la commande pour consulter son solde, celle pour payer un autre joueur, celle réservée au staff pour créditer ou débiter. Précise aussi le solde de départ d'un nouveau joueur.

Le point que les gens oublient, c'est la persistance. Dis explicitement que les soldes doivent survivre à un redémarrage et où ils sont stockés, dans un fichier du dossier du plugin ou dans une base de données si ton serveur en a une. Précise aussi le comportement dans les cas limites : paiement à un joueur hors ligne, montant négatif, solde insuffisant, joueur qui n'existe pas. Ces cas limites sont exactement ce qui casse une économie en production.

• Le nom, le symbole et le format d'affichage de ta monnaie
• Les commandes voulues, par exemple /money, /pay, /eco give
• Qui a le droit de créditer : la permission du staff
• Où les soldes sont enregistrés, et qu'ils survivent au redémarrage
• Le refus propre quand le solde est insuffisant, avec ton message

Boutique et hôtel des ventes

La boutique du serveur est le premier endroit où l'argent se dépense. Décide de sa forme : une commande qui ouvre un menu d'inventaire par catégories, des panneaux à cliquer posés dans une zone marchande, ou les deux. Donne les objets, un prix d'achat et un prix de vente, et garde toujours le prix de vente sous le prix d'achat, sinon tes joueurs trouveront la boucle infinie en une soirée.

L'hôtel des ventes, c'est autre chose : là, ce sont les joueurs qui fixent les prix. Décris comment on met un objet en vente, combien de ventes simultanées par joueur, ce qui se passe quand une annonce expire, et si le serveur prend une commission au passage. Cette commission est d'ailleurs l'un des meilleurs puits d'argent que tu puisses avoir, parce qu'elle retire de la monnaie du jeu à chaque transaction.

• Boutique en menu d'inventaire, en panneaux, ou les deux
• Prix d'achat et prix de vente par objet, cohérents entre eux
• Mise en vente joueur : durée de l'annonce, nombre d'annonces max
• Retour des objets au vendeur quand une annonce expire
• Commission du serveur sur chaque vente, comme puits d'argent
• Recherche et filtre dans les annonces si ton serveur est peuplé

Métiers, salaires et lutte contre l'inflation

Les métiers sont la brique qui rend l'économie vivante, parce qu'ils paient une activité de jeu plutôt qu'une simple présence. Un métier, c'est un ensemble d'actions rémunérées : mineur payé au bloc miné, pêcheur payé à la prise, bûcheron, fermier, chasseur. Tu peux y ajouter des niveaux, une progression, un bonus qui grandit. Décris les actions, le gain par action, et la façon d'entrer et de sortir d'un métier.

Un salaire versé à intervalle régulier est une variante plus douce, souvent liée à un grade. Attention au piège classique : payer la pose ET la casse d'un même bloc crée une machine à argent gratuite. Dis-le dans ta description, demande explicitement qu'un bloc posé par un joueur ne rapporte rien quand il est recassé, et prévois un plafond de gains par période pour les activités faciles à automatiser.

• Les métiers disponibles et l'action payée dans chacun
• Le gain par action, et une progression par niveau si tu en veux
• Un salaire périodique par grade, en plus ou à la place
• Anti-abus : pas de gain sur un bloc posé puis recassé
• Un plafond de gains par période pour les fermes automatiques
• Des dépenses obligatoires en face : réparations, taxes, cosmétiques

Vault, le standard d'interopérabilité

Vault est la couche d'abstraction historique de l'écosystème Bukkit, Spigot et Paper pour l'économie et les permissions. Le principe est simple : ton plugin d'économie s'enregistre auprès de Vault comme fournisseur de monnaie, et les autres plugins interrogent Vault au lieu de te parler directement. Ils n'ont donc pas besoin de connaître ton plugin pour lire ou modifier un solde.

C'est ce qui compte si tu veux qu'une boutique, un plugin de protection de parcelles ou un système de grades payants utilisent la même monnaie que le reste de ton serveur. Concrètement : écris noir sur blanc dans ta description que le plugin doit s'enregistrer comme fournisseur d'économie Vault, garde en tête que Vault est un plugin séparé à installer sur ton serveur, et vérifie en jeu que tes autres plugins lisent bien le solde. Si tu ne veux aucune interopérabilité, une économie fermée sur elle-même est parfaitement viable et plus simple.

• Demande explicitement l'enregistrement comme fournisseur Vault
• Vault reste un plugin séparé, à installer sur ton serveur
• Vérifie en jeu qu'un autre plugin voit bien le même solde
• Sans besoin d'interopérabilité, tu peux t'en passer

Décrire, générer, tester en jeu

Décris ton économie en français comme tu l'expliquerais à un ami, mais complètement : les commandes avec leur nom exact, les permissions par grade, les messages que les joueurs verront dans le chat, ta version de Minecraft et ta version de serveur. Plus la description est précise, moins tu as d'aller-retours ensuite. Ajoute tes prix et tes gains, même approximatifs, plutôt que de laisser l'IA les inventer.

À partir de là, Minax écrit le code Java, le compile en .jar et repasse sur les erreurs de compilation dans une boucle d'auto-correction. Tu peux ensuite lancer le plugin en ligne et l'essayer en jeu : gagner de l'argent, payer un autre joueur, acheter en boutique, mettre un objet aux enchères. C'est le seul moyen sérieux de vérifier un équilibrage. Si quelque chose ne colle pas, tu le dis en une phrase et tu régénères, puis tu installes le .jar dans le dossier /plugins de ton serveur.

• Nomme tes commandes et tes permissions exactement
• Donne tes prix, tes gains et tes messages de chat
• Précise ta version de Minecraft et ton serveur, Paper ou Spigot
• Teste en jeu chaque brique, surtout les paiements entre joueurs
• Corrige en une phrase, régénère, puis installe dans /plugins

Questions fréquentes