Plugin Minecraft AuctionHouse

🔌 À propos d'AuctionHouse

AuctionHouse est un plugin Minecraft qui ajoute une maison des enchères en jeu, accessible avec la commande /ah. Les joueurs peuvent mettre des objets en vente, parcourir et rechercher les annonces, puis acheter des objets via un marché basé sur une interface GUI. Le plugin se concentre sur les échanges entre joueurs avec des règles de publication, des frais et des annonces configurables.

🎯 Objectif

AuctionHouse fournit une place de marché centralisée, pilotée par une GUI, afin que les serveurs puissent proposer un système d'enchères géré plutôt que de compter sur des boutiques gérées par les joueurs ou des marchés basés sur des panneaux. Il est destiné aux serveurs qui veulent un marché public consultable avec des restrictions configurables et une intégration à l'économie.

⚙️ Fonctionnalités

• Maison des enchères en GUI ouverte avec /ah.
• Créer et annuler des annonces ; récupérer les objets annulés ou expirés.
• Rechercher et filtrer les annonces par nom, type, lore, enchants ou vendeur.
• Trier les annonces par date ou par prix.
• Contrôles des annonces : définir des prix minimum/maximum, des frais de publication (fixes et/ou en pourcentage), une taxe vendeur plafonnée et un délai entre les annonces.
• Restrictions d'objets par nom, type, lore, enchantements, dégâts, drapeau unbreakable, custom_model_data et motifs regex.
• Option pour lister des objets du serveur (annonces uniques ou illimitées).
• Déclencheurs spéciaux pour ouvrir l'enchère via des panneaux, des entités de bloc nommées (coffres, shulkers, distributeurs, etc.) ou des entités renommées.
• Les info-bulles au survol affichent le temps restant et les enchants.
• Annonces facultatives pour les nouvelles annonces et intégration Discord.
• Support de l'internationalisation et messages, matériaux et sons configurables.
• Journalisation des transactions dans un fichier de log séparé et nettoyage automatique des objets abandonnés.

🧩 Pour qui c'est fait

• Serveurs Survival et SMP qui veulent un marché partagé entre joueurs.
• Serveurs axés sur l'économie qui veulent une GUI d'enchères consultable.
• Administrateurs qui ont besoin de règles de publication, de frais et de restrictions d'objets configurables.

🏗️ Exemples d'utilisation

• Les joueurs mettent en vente leur surplus de butin et le font enchérir à la communauté du serveur au lieu d'utiliser des coffres ou des boutiques.
• Le staff du serveur crée des annonces limitées ou illimitées pour des objets proposés par le serveur.
• Les administrateurs appliquent les règles de l'économie du serveur en restreignant certains objets ou en appliquant des taxes de publication.

⌨️ Commandes

🔐 Permissions

⚙️ Installation

📥 Mise en place

• Télécharge le fichier .jar officiel du plugin et place-le dans le dossier plugins/ de ton serveur pour les serveurs compatibles Spigot.
• Redémarre le serveur (redémarrage complet) et vérifie la console pour confirmer que le plugin a bien été chargé.
• Configure le plugin à l'aide des fichiers de configuration fournis selon les besoins.

📦 Dépendances

• Vault (requis, 1.7.1+ recommandé).
• Un plugin d'économie adapté (par exemple EssentialsX economy ou un autre fournisseur d'économie compatible avec Vault).
• Un plugin de permissions adapté (si tu utilises des permissions au-delà des valeurs par défaut).

🧠 Notes techniques

• Stockage : le plugin utilise SQLite (aucune prise en charge d'une base de données externe n'est documentée).
• Le plugin journalise les transactions dans un fichier de log séparé et prend en charge l'internationalisation.
• Prend en charge les têtes HeadDatabase et les textures de crânes personnalisées comme boutons de GUI.
• L'auteur précise que les fonctionnalités et la compatibilité des versions ciblent Spigot ; le comportement peut varier sur d'autres logiciels de serveur.

🤝 Quand ce plugin est utile

Si vous voulez un système d'enchères configurable, basé sur une GUI et intégré à l'économie de votre serveur avec Vault, AuctionHouse offre des contrôles d'annonces, la recherche/le filtrage, des frais/taxes et la journalisation des transactions pour fournir un marché de joueurs gérable.