Plugin Minecraft QuickShop-Hikari

🔌 À propos de QuickShop-Hikari

QuickShop-Hikari est un plugin Minecraft qui implémente des boutiques d’achat/vente basées sur les coffres (ChestShops). Les joueurs créent et utilisent des boutiques en interagissant avec des coffres ; la plupart du gameplay ne nécessite aucune commande. Le projet est maintenu par la QuickShop-Community et se concentre sur la compatibilité moderne, la sécurité des données et des intégrations extensibles.

🎯 Objectif

Fournir une économie en jeu basée sur les objets, où les joueurs peuvent mettre des objets en vente ou créer des boutiques d’achat à l’aide de coffres. Le plugin s’adresse aux administrateurs de serveur qui veulent une économie physique, pilotée par des coffres, et un contrôle par boutique sans forcer les joueurs à apprendre des commandes.

⚙️ Fonctionnalités

• Créer des boutiques d’achat et de vente à l’aide de coffres et de panneaux (boutiques basées sur des coffres).
• Prise en charge des données NBT, des enchantements, de la durabilité des objets, des données de potions et des œufs de monstres.
• Objet d’affichage virtuel au-dessus des boutiques, activable/désactivable (ProtocolLib ou PacketEvents pris en charge).
• Prise en charge des coffres illimités et du comportement mixte achat/vente sur les doubles coffres.
• Prise en charge des listes noires avec options de permission de contournement.
• Gestion des permissions par boutique et avantages de boutique entre propriétaires et autres joueurs.
• Prise en charge i18n pour les noms d’objets et d’enchantements, ainsi que la syntaxe MiniMessage pour les messages.
• Prise en charge des sources de données H2 (locale) et MySQL (distante).
• Hooks d’intégration pour les plugins courants de protection et d’utilitaires (modules de compatibilité disponibles).
• API développeur (coordonnées Maven/Gradle fournies) pour interroger les boutiques et intégrer des fonctionnalités.
• Télémétrie bStats avec désactivation possible via la configuration.

🧩 À qui cela s’adresse

Aux propriétaires et administrateurs de serveurs exécutant Survival/SMP ou des serveurs axés sur l’économie qui veulent un marché physique basé sur des coffres. Le plugin convient aux serveurs de petite à grande taille utilisant des plugins d’économie compatibles avec Vault et souhaitant un contrôle par boutique ainsi qu’un stockage basé sur une base de données.

🏗️ Exemples d’utilisation

• Les joueurs placent des objets dans un coffre et l’étiquettent pour vendre automatiquement des piles à d’autres joueurs.
• Un administrateur active les permissions par boutique pour que les modérateurs puissent gérer des boutiques dans des mondes ou régions spécifiques.
• Un réseau utilise le stockage MySQL pour conserver les boutiques entre plusieurs instances du serveur.

⌨️ Commandes

Remarque : la documentation du projet indique que le gameplay normal des joueurs ne nécessite pas de commandes ; les commandes sont principalement administratives.

🔐 Permissions

⚙️ Installation

📥 Installation

• Téléchargez le jar officiel de QuickShop-Hikari depuis la distribution du projet (versions Modrinth/Spigot/GitHub).
• Placez le fichier jar dans le dossier plugins/ de votre serveur.
• Démarrez le serveur et vérifiez que le plugin a bien été chargé (la documentation montre l’exécution de la commande qs dans la console pour afficher l’aide/la sortie de test).

📦 Dépendances

Intégrations requises/optionnelles confirmées par le projet :

• Vault (requis pour l’interfaçage de l’économie)
• Un plugin d’économie compatible avec Vault (exemples fournis par le projet)
• ProtocolLib ou PacketEvents (requis pour les objets d’affichage virtuels / la localisation par joueur)
• LuckPerms (recommandé pour la gestion des permissions)

🧾 Configuration

• Le plugin crée et utilise un config.yml (la documentation fait référence à des clés config.yml pour le protocole d’affichage et les paramètres de confidentialité).
• Le stockage des données prend en charge H2 local ou MySQL distant ; les options de configuration sont disponibles dans les fichiers de configuration du plugin.

🧠 Notes techniques

• La documentation officielle recommande une exécution sur un serveur basé sur Paper et précise une exigence de Java 21.
• Le projet fournit une API développeur et des coordonnées Maven/Gradle pour une utilisation à la compilation.
• QuickShop-Hikari inclut des modules de compatibilité pour des plugins tiers (par ex. WorldGuard, WorldEdit, OpenInv) en téléchargement optionnel.
• Télémétrie : utilise bStats ; désactivation possible via les paramètres de configuration.

🤝 Quand ce plugin est utile

Si vous voulez un marché visible par les joueurs, basé sur des coffres, avec stockage persistant et contrôles par boutique (plutôt que des boutiques uniquement en GUI ou pilotées par commande), QuickShop-Hikari propose une implémentation moderne, basée sur une base de données, avec des hooks pour les plugins d’économie et de protection courants.