Plugin Minecraft EconomyAPI

🔌 À propos d’EconomyAPI

EconomyAPI est un plugin principal d’économie et une implémentation d’API, créée à l’origine par onebone. Il est publié et distribué pour les écosystèmes de serveurs de type Bedrock/PocketMine (variantes PocketMine/Nukkit) et vise à fournir un backend de monnaie partagé ainsi que des méthodes programmatiques que d’autres plugins peuvent appeler.

🎯 Objectif

EconomyAPI fournit un système monétaire centralisé afin que les auteurs de plugins puissent lire et modifier les soldes des joueurs, enregistrer des événements liés à l’économie et permettre aux administrateurs du serveur d’exposer des commandes économiques de base aux joueurs. Il résout le problème de plusieurs plugins nécessitant des implémentations d’économie distinctes en offrant une couche d’API commune.

⚙️ Fonctionnalités

• Expose des méthodes d’API programmatiques pour interroger et mettre à jour les soldes (les exemples de la documentation incluent un accès de type getInstance).
• Fournit des commandes d’économie côté joueur comme le solde, le paiement et les ajustements d’argent pour les administrateurs.
• Déclenche des événements et des hooks que d’autres plugins peuvent écouter pour gérer les transactions.
• Largement utilisé comme dépendance/composant central pour d’autres addons et extensions d’économie PocketMine/Nukkit.

🧩 À qui s’adresse-t-il

• Aux développeurs de serveurs et de plugins qui ont besoin d’un backend d’économie partagé sur un logiciel de serveur Bedrock de type PocketMine/Nukkit.
• Aux administrateurs de serveurs Bedrock de petite à moyenne taille qui s’appuient sur des écosystèmes de plugins intégrés à EconomyAPI.

🏗️ Exemples d’utilisation

• Un plugin de boutique ou de marketplace lit et débite les soldes des joueurs via des appels EconomyAPI.
• Un plugin d’enchères ou de récompenses attribue de la monnaie en appelant les méthodes add/reduce de l’API.
• Des réseaux de serveurs qui déploient des plugins addon s’attendant à un fournisseur d’économie commun.

⌨️ Commandes

(Les commandes et les nœuds de permission ci-dessus proviennent de listes de ressources PocketMine/Nukkit publiées ; la disponibilité exacte peut varier selon la build/fork.)

🔐 Permissions

⚙️ Installation

📥 Configuration

• Téléchargez la version officielle du plugin pour votre distribution de serveur (PocketMine/Poggit ou build communautaire Nukkit).
• Placez le fichier du plugin téléchargé dans le répertoire plugins/ du serveur.
• Arrêtez puis redémarrez le serveur et vérifiez la sortie de la console pour confirmer que le plugin a été chargé.

(Le format exact du paquet peut varier selon la distribution et la build ; suivez les étapes d’installation de la distribution choisie.)

🧠 Notes techniques

• EconomyAPI est distribué en plusieurs builds/forks pour les écosystèmes PocketMine et Nukkit ; différentes builds peuvent inclure des commandes ou des points d’entrée API légèrement différents.
• Le plugin expose des schémas d’accès programmatiques utilisés par d’autres addons (des exemples dans la documentation communautaire montrent des appels comme EconomyAPI::getInstance() ou EconomyAPI.getInstance().addMoney(...)).
• À certaines périodes, le plugin a été signalé dans les canaux de distribution pour des raisons de performance ou de maintenance ; tenez compte de l’état actuel de maintenance et des alternatives compatibles lors d’un déploiement sur des serveurs de production.

🤝 Quand ce plugin est utile

Si votre serveur ou votre écosystème d’addons attend un fournisseur d’économie commun pour des serveurs de type Bedrock/PocketMine/Nukkit, EconomyAPI propose une API largement adoptée ainsi qu’un ensemble de commandes de base pour les joueurs, avec lesquelles de nombreux autres plugins s’intègrent.