Comment créer un plugin d'économie Minecraft

Étape par étape

1. 1.Décidez du rôle du plugin

   Soit il est l'économie (il stocke les soldes et s'enregistre comme économie Vault), soit il utilise une économie existante via Vault (une boutique, des primes, un plugin de métiers). La plupart des serveurs ont besoin d'un de chaque, pas de deux économies.

2. 2.Choisir le serveur et la version

   Indiquez le logiciel et la version du serveur, par exemple Paper 1.21.4. Le plugin est compilé pour l'API et la version de Java de cette version.

3. 3.Listez les commandes et les règles

   /balance, /pay <player> <amount>, /baltop, et des commandes admin comme /eco give|take|set. Ajoutez le solde de départ, le nom de la monnaie, les décimales et un paiement minimum.

4. 4.Choisissez où les soldes sont sauvegardés

   SQLite pour un seul serveur, MySQL si plusieurs serveurs doivent partager les mêmes soldes. L'argent doit survivre aux redémarrages et aux plantages, il n'est donc jamais gardé uniquement en mémoire.

5. 5.Laisser Codexe l'écrire et le compiler

   Décrivez le plugin et nommez explicitement Vault pour qu'il soit ajouté comme dépendance. Codexe écrit le code Java, plugin.yml et config.yml, le compile et corrige les erreurs de build avant que le projet soit prêt.

6. 6.Testez les paiements en jeu

   Cliquez sur Tester maintenant et rejoignez le serveur de test. Faites des paiements entre deux comptes, essayez des montants trop élevés, négatifs ou qui ne sont pas des nombres, puis redémarrez et vérifiez que les soldes sont toujours là.

7. 7.L'installer

   Placez Vault et votre .jar dans le dossier plugins/ du serveur et redémarrez. Retirez tout autre plugin d'économie, ou décidez lequel Vault doit utiliser.

Le rôle de Vault

Vault est un pont, pas une économie. Un plugin d'économie implémente l'interface Economy de Vault et l'enregistre auprès du gestionnaire de services du serveur ; les autres plugins la demandent avec getServer().getServicesManager().getRegistration(Economy.class) et appellent des méthodes comme getBalance, withdrawPlayer et depositPlayer.

Ainsi, un plugin de boutique n'a jamais besoin de savoir quelle économie vous utilisez. Dans plugin.yml, utilisez depend: [Vault] quand le plugin ne peut pas fonctionner sans, ou softdepend quand Vault est facultatif. L'API de Vault n'est nécessaire que pour compiler ; Vault lui-même est installé sur le serveur.

Les choix à préciser dans la demande

• Format de l'argent : nom de la monnaie au singulier et au pluriel, symbole, nombre de décimales.
• Limites : solde de départ, solde maximum, possibilité ou non d'avoir un solde négatif.
• Joueurs hors ligne : si /pay et /eco fonctionnent sur des joueurs qui ne sont pas connectés.
• Journalisation : un historique des transactions dans la base de données ou dans un fichier, pour que le staff puisse vérifier les litiges.
• Gagner de l'argent : en tuant des mobs, en récompense du temps de jeu, en vendant des objets, ou uniquement via des commandes admin.

Où sauvegarder les soldes

Exemple de description

« Un plugin d'économie Paper 1.21.4 appelé Coins qui s'enregistre comme économie Vault. /balance [player], /pay <player> <amount> avec un minimum de 1, /baltop avec le top 10, et /eco give|take|set pour les joueurs ayant coins.admin. Les nouveaux joueurs commencent avec 100 pièces. Deux décimales. Chaque paiement est enregistré avec la date, l'expéditeur, le destinataire et le montant. Soldes sauvegardés dans SQLite. Noms de la monnaie et tous les messages dans config.yml. »

Codexe utilise SQLite par défaut si vous ne demandez pas autre chose. Si vous demandez MySQL, le plugin est écrit avec un paramètre storage-type, et le serveur de test lui fournit sa propre base de données MySQL pendant vos essais.

Questions