Plugin Minecraft ExcellentCrates

🔌 À propos d’ExcellentCrates

ExcellentCrates est un plugin Minecraft pour les serveurs Spigot/Paper qui met en place un système complet de crates (lootbox). Il se concentre sur des types de crates configurables, la gestion des clés (virtuelles et physiques) et des définitions de récompenses flexibles que les administrateurs du serveur peuvent gérer principalement via un éditeur GUI en jeu.

🎯 Objectif

Le plugin résout le problème de créer, configurer et présenter des récompenses basées sur des crates sur un serveur sans nécessiter de modifications manuelles de fichiers. Il est destiné aux propriétaires et administrateurs de serveur qui veulent utiliser des crates de récompenses (pour des événements, des récompenses quotidiennes, des fonctionnalités monétisées ou la progression des joueurs) tout en gardant la configuration et les aperçus accessibles en jeu.

⚙️ Fonctionnalités

• Éditeur GUI en jeu pour créer et gérer les crates, les clés et les récompenses.
• Prise en charge des clés physiques et virtuelles (les clés virtuelles empêchent l’échange/le partage).
• Hologrammes intégrés et effets de particules pour les blocs de crate (des plugins optionnels peuvent être requis pour certaines fonctions d’hologramme).
• Crate Blocks : reliez les crates à des blocs/zones physiques pour une interaction avec les crates dans le monde.
• GUI de prévisualisation personnalisée et GUI d’ouverture personnalisée par crate.
• Types de récompenses : récompenses d’objets et récompenses de commandes.
• Prise en charge des bundles : plusieurs piles d’objets par récompense (limite documentée jusqu’à 27 objets par récompense d’objet) et commandes illimitées par récompense de commande.
• Raretés et poids pour équilibrer les chances de récompense.
• Jalons et fonctionnalité d’ouverture en masse.
• Temps de recharge d’ouverture et coût d’ouverture par joueur (l’intégration à l’économie est implicite via la fonction de coût d’ouverture).
• Exigences de permission et de clé pour les crates et les récompenses.
• Limites de récompense (globales et par joueur) et diffusion/journalisation des récompenses.
• Prise en charge de PlaceholderAPI indiquée par les sources officielles.

🧩 Pour qui

• Serveurs Spigot/Paper publics et privés qui utilisent des crates pour des événements, la monétisation ou l’engagement des joueurs.
• Administrateurs de serveur qui préfèrent un éditeur en jeu à l’édition manuelle de YAML.

🏗️ Exemples d’utilisation

• Configurez une crate avec des raretés et des récompenses pondérées, placez un bloc de crate au spawn et donnez aux joueurs des clés virtuelles pour l’ouvrir.
• Créez des aperçus de crates et des hologrammes afin que les joueurs puissent inspecter les récompenses avant de dépenser des clés.
• Utilisez l’ouverture en masse et les jalons pour organiser des événements à durée limitée ou récompenser les joueurs actifs.

⚙️ Installation

📥 Configuration

• Téléchargez le JAR officiel du plugin et placez-le dans le dossier plugins/ de votre serveur sur une build de serveur confirmée comme prise en charge (Spigot ou Paper).
• Redémarrez le serveur et vérifiez la console pour confirmer que le plugin a été chargé.
• Si le plugin nécessite la dépendance du moteur compagnon, installez le plugin de dépendance requis (nightcore) avant ou en même temps qu’ExcellentCrates.

📦 Dépendances

• Requis : nightcore (moteur du plugin), comme l’indiquent les sources officielles.
• Optionnel : ProtocolLib ou PacketEvents pour les fonctionnalités avancées d’hologramme ; PlaceholderAPI est pris en charge pour les placeholders dans les textes.

🧠 Notes techniques

• Logiciel serveur pris en charge confirmé : Spigot et Paper.
• Version minimale confirmée du serveur : 1.21.8 ou supérieure (selon le projet).
• Exigence Java confirmée : Java 21 ou plus récent.
• La prise en charge de Folia et Forge n’est pas explicitement disponible.
• Le dépôt du projet indique une licence GPL-3.0.

🤝 Quand ce plugin est utile

Si vous avez besoin d’un système de crates configurable en jeu avec des clés virtuelles/physiques, des hologrammes et des définitions de récompenses flexibles (objets, commandes, raretés et limites) pour un serveur Spigot/Paper, ExcellentCrates fournit ces fonctionnalités et un flux d’édition qui maintient la majeure partie de la configuration gérable sans modifications manuelles de fichiers.