Plugin Minecraft EconomyShop

🔌 À propos d’EconomyShop

EconomyShop est un plugin Minecraft qui met en place une boutique du serveur (GUI) et des boutiques de coffres de joueurs. Il met l’accent sur des menus d’inventaire de type navigateur pour acheter et vendre, ainsi que sur des boutiques de coffres créées par les joueurs grâce à une configuration coffre + panneau et une GUI d’édition. Le plugin fait partie de l’écosystème économique d’ilius et est conçu pour les serveurs qui ont besoin d’une boutique côté serveur avec des prix configurables, des taxes et le suivi de l’historique.

🎯 Objectif

EconomyShop propose un système d’échange centralisé, pensé d’abord pour la GUI, afin que les propriétaires de serveurs puissent proposer des boutiques gérées par l’administration et permettre aux joueurs de créer et gérer des boutiques de coffres sans commandes de chat ni mise en forme manuelle des panneaux. Il vise les serveurs qui utilisent une économie compatible Vault et qui veulent un historique des prix intégré, des taxes et des contrôles d’administration pour la gestion des boutiques.

⚙️ Fonctionnalités

• Boutique du serveur basée sur une GUI : navigation par catégories, sélecteur de quantité et écrans de confirmation avant l’achat.
• Revente prise en charge : clic droit sur les objets de la boutique pour les vendre au serveur avec taxe et confirmation affichées.
• Boutiques de coffres de joueurs : créez des boutiques en plaçant un coffre et un panneau ; les prix et les modifications se gèrent via une GUI.
• Options de stock : stock infini ou limité avec réapprovisionnement automatique pour les boutiques administratives.
• Taxe sur les ventes : taxe de transaction configurable pour les ventes de la boutique du serveur et des boutiques de coffres.
• Historique des prix : graphiques de prix partagés (vues sur 7, 14 et 30 jours) combinant les ventes de la boutique admin, de la boutique de coffres et des enchères.
• GUI d’administration : créez des catégories, ajoutez des objets et modifiez les paramètres de la boutique via des menus (aucune modification manuelle de la configuration n’est requise pour les opérations de base).
• Stockage : SQLite par défaut avec prise en charge optionnelle de MySQL/MariaDB pour la montée en charge.
• Intégrations : prise en charge d’une économie compatible Vault, des placeholders de PlaceholderAPI et points d’intégration optionnels pour LuckPerms et WorldGuard.
• Mesures anti-exploit : verrous de transaction, prévention de duplication, blocage en mode créatif et limitation de débit.

🧩 Pour qui

• Serveurs Survival et SMP qui veulent une expérience de boutique en GUI.
• Serveurs où les joueurs doivent gérer leurs propres boutiques de coffres avec une charge administrative minimale.
• Serveurs utilisant une économie compatible Vault et pouvant vouloir un stockage adossé à une base de données.

🏗️ Exemples d’utilisation

• Un administrateur configure des catégories et alimente la boutique du serveur avec des objets et des prix personnalisés via la GUI d’administration.
• Un joueur place un coffre et un panneau pour ouvrir une boutique de coffre, définit des prix d’achat/vente depuis la GUI et vend des objets à d’autres joueurs.
• Les opérateurs du serveur consultent l’historique des prix des objets pour ajuster les prix de la boutique admin ou la taxation.

⌨️ Commandes

🔐 Permissions

⚙️ Installation

📥 Configuration

• Téléchargez le JAR du plugin et placez-le dans le dossier plugins/ de votre serveur.
• Redémarrez le serveur pour charger le plugin.
• Exécutez /shop admin depuis un compte opérateur pour créer des catégories et ajouter des objets.

📦 Dépendances

• Requis : Vault (tout plugin d’économie compatible Vault).
• Optionnels/intégrations : PlaceholderAPI, LuckPerms, WorldGuard, EconomyProvider, AuctionHouse.

🧠 Notes techniques

• Stockage : SQLite est disponible par défaut ; la prise en charge de MySQL/MariaDB est disponible pour les serveurs plus importants.
• Plateformes : le plugin déclare prendre en charge Paper et mentionne aussi la compatibilité avec Purpur et Folia.
• Le plugin inclut des protections anti-exploit intégrées, notamment des verrous de transaction et une limitation de débit.
• Fait partie de la pile d’économie d’ilius et s’intègre avec d’autres plugins d’ilius pour une base de données/un style cohérents.

🤝 Quand ce plugin est utile

Si votre serveur a besoin d’une boutique administrée par le staff ainsi que de boutiques de coffres pour les joueurs, avec configuration via GUI, historique des prix et intégration d’une économie compatible Vault, EconomyShop fournit un flux de travail centré sur la GUI et des outils d’administration pour gérer les objets de boutique, les taxes et les stockages sans parser manuellement les panneaux ni modifier lourdement la configuration.