Plugin Minecraft Shopkeepers

🔌 À propos de Shopkeepers

Shopkeepers est un plugin Minecraft pour Bukkit/Spigot qui permet aux propriétaires de serveur de placer des marchands villageois personnalisables vendant des objets configurés à des prix configurés. Le plugin prend en charge à la fois les boutiques d’administration (stock infini) et les boutiques de joueurs qui puisent leur stock dans un conteneur, et il fournit une ShopkeepersAPI pour l’intégration d’addons et les extensions.

🎯 Objectif

Le plugin fournit un système de boutique en jeu basé sur des PNJ afin que les serveurs puissent proposer des boutiques persistantes sans gestion manuelle de coffres ni magasins complexes basés sur des commandes. Il convient aux économies de serveur, aux boutiques de roleplay et aux serveurs survival/SMP qui veulent des marchands PNJ. ()

⚙️ Fonctionnalités

• Créez des marchands villageois personnalisés avec des échanges et des prix définis.
• Boutiques d’administration avec stock illimité.
• Boutiques de joueurs qui récupèrent des objets depuis un conteneur lié (coffre) pour le stock.
• ShopkeepersAPI pour permettre aux auteurs de plugins d’interroger et de gérer les marchands par programme.
• Personnalisation en jeu des objets/données d’objets et prise en charge des fichiers de langue via le wiki et les fichiers de langue du projet. ()

🧩 Pour qui

• Serveurs Survival et SMP qui veulent des boutiques gérées par des PNJ.
• Serveurs de roleplay ou d’économie qui utilisent des PNJ villageois comme marchands.
• Développeurs de plugins qui ont besoin d’une API pour intégrer le comportement des boutiques dans d’autres systèmes. ()

🏗️ Exemples d’utilisation

• Un admin crée une boutique d’administration infinie vendant des biens fournis par le serveur.
• Un joueur ouvre une boutique qui vend automatiquement des objets depuis un coffre lié.
• Un développeur crée un addon qui liste ou modifie des marchands à l’aide de ShopkeepersAPI. ()

⌨️ Commandes

(Remarque : seules les commandes explicitement documentées par les sources officielles sont सूचीées ci-dessus.) ()

⚙️ Installation

📥 Configuration

• Téléchargez le fichier jar officiel du plugin et placez-le dans le dossier plugins/ de votre serveur.
• Redémarrez le serveur et vérifiez la console pour confirmer que le plugin a été chargé.

(Ce sont les étapes d’installation standard pour les plugins Bukkit/Spigot et elles sont prises en charge par la documentation du projet.) ()

🧠 Notes techniques

• Shopkeepers est publié sous licence GPL-3.0 et le dépôt du projet inclut un module API (ShopkeepersAPI) ainsi que des instructions de compilation. ()
• Le projet fournit des artefacts Maven et une API publiée pour les développeurs d’addons ; le README documente l’utilisation du dépôt et les coordonnées de dépendance de l’API. ()
• La distribution officielle et l’assistance communautaire sont disponibles via la page de ressources Spigot et le serveur Discord du plugin. ()

🤝 Quand ce plugin est utile

Si vous avez besoin de marchands PNJ persistants et configurables, avec prise en charge des boutiques d’administration et de joueurs, et que vous voulez une API pour intégrer des boutiques dans d’autres plugins, Shopkeepers offre une implémentation éprouvée pour les serveurs Bukkit/Spigot. ()