Plugin Minecraft ChestShop

🔌 À propos de ChestShop

ChestShop est un plugin Minecraft permettant de créer des boutiques gérées par les joueurs à l’aide de coffres et de panneaux. Il relie les actions de boutique à l’économie du serveur (via Vault ou Reserve) afin que les joueurs puissent acheter et vendre des objets avec la monnaie du serveur. Le projet est maintenu sur GitHub et distribue ses builds via des plateformes de plugins courantes.

🎯 Objectif

Fournir un marché simple et persistant en jeu, où les joueurs créent des boutiques en plaçant un panneau sur un coffre. ChestShop gère les transactions entre les inventaires des joueurs et l’économie du serveur, et inclut des protections ainsi que des hooks de compatibilité pour réduire le griefing et le travail d’intégration.

⚙️ Fonctionnalités

• Créer des boutiques d’achat/vente en plaçant un panneau formaté sur un coffre.
• Intégration avec Vault ou Reserve et d’autres plugins d’économie compatibles pour la gestion de l’argent.
• Options de protection de boutique et de compatibilité pour respecter les plugins courants de protection de coffres.
• Mesures anti-lag / de sécurité des transactions documentées par les auteurs.
• Extensible avec des add-ons communautaires et des plugins de compatibilité (la liste des add-ons est maintenue par le projet).
• Des commandes d’administration et d’information ont été ajoutées dans les versions récentes (exemples : /shopinfo, /iteminfo).

🧩 Pour qui

• Les serveurs Survival et SMP qui utilisent une économie basée sur une monnaie.
• Les serveurs qui veulent des boutiques simples basées sur des panneaux plutôt que des vitrines en GUI.
• Les admins qui préfèrent des boutiques gardant les objets dans des coffres vanilla (pas de base de données obligatoire pour le stockage de base des boutiques).

🏗️ Exemples d’utilisation

• Les joueurs placent un coffre, y mettent l’objet à vendre et créent un panneau pour définir les prix d’achat/de vente ; les autres joueurs cliquent sur le panneau pour échanger.
• Les administrateurs du serveur créent des boutiques admin pour la vente d’objets gérée par le serveur.
• Une communauté ajoute un plugin de compatibilité pour intégrer ChestShop à un add-on de protection ou d’affichage.

⌨️ Commandes

(Les commandes listées proviennent des notes de version et de la documentation du projet. Seules les commandes explicitement documentées par le projet sont affichées.)

🔐 Permissions

(Les nœuds de permission ne sont inclus que lorsqu’ils apparaissent dans les ressources officielles du projet et dans les notes de version.)

⚙️ Installation

📥 Installation

• Téléchargez le .jar officiel de ChestShop et placez-le dans le dossier plugins/ du serveur.
• Installez Vault ou Reserve et un plugin d’économie compatible fournissant une API d’argent.
• Redémarrez le serveur et vérifiez la console du serveur pour confirmer que ChestShop a bien été activé.

📦 Dépendances

• Vault (intégration prise en charge) ou Reserve (intégration prise en charge)
• Un plugin d’économie compatible exposant une API d’argent (installé avec Vault/Reserve)

🧾 Configuration

Le plugin génère des fichiers de configuration/yml au premier lancement ; les options de configuration et les bascules de compatibilité sont disponibles dans ces fichiers et dans la documentation du projet.

🧠 Notes techniques

• Le code source et le suivi des issues sont hébergés sur GitHub sous licence LGPL-2.1.
• Le projet répertorie les builds et les artefacts de release sur des sites de plugins courants ; les mainteneurs publient également des builds de développement sur un serveur CI.
• ChestShop est conçu pour les types de serveur Bukkit/Spigot/Paper (la documentation du projet et le dépôt l’indiquent explicitement).

🤝 Quand ce plugin est utile

Si vous voulez un marché simple en jeu, où les objets restent dans de simples coffres et où les transactions utilisent la monnaie de votre serveur, ChestShop propose un système de boutique coffre-et-panneau mature et extensible, avec intégration d’économie et compatibilité avec des add-ons.