Plugin Minecraft DeluxeTags

🔌 À propos de DeluxeTags

DeluxeTags est un plugin Spigot pour Minecraft qui fournit des tags supplémentaires basés sur les permissions (préfixes) que les joueurs peuvent débloquer et alterner via une GUI en jeu ou des commandes. Les tags sont traités comme un « préfixe supplémentaire » et peuvent être affichés dans le chat, l’onglet et d’autres intégrations de chat via des placeholders.

🎯 Objectif

DeluxeTags résout le problème consistant à donner aux joueurs des tags cosmétiques facultatifs et déblocables, séparés des préfixes de rang/groupe. Il est utile pour les serveurs qui souhaitent proposer des tags achetables/déblocables ou obtenables en récompense, que les joueurs peuvent activer ou désactiver sans modifier leur groupe ou rang principal.

⚙️ Fonctionnalités

• Tags basés sur les permissions : donnez l’accès avec deluxetags.tag.<identifier> (exemple affiché dans la configuration : deluxetags.tag.example).
• GUI joueur pour parcourir et sélectionner les tags disponibles.
• Commandes pour lister, sélectionner et gérer les tags (commandes joueur et admin documentées par le projet).
• Prise en charge de PlaceholderAPI et placeholders pour insérer le tag actif, l’identifiant, la description et le nombre dans les formats de chat.
• Éléments de GUI, noms et paramètres de pagination configurables, présentés dans l’extrait de configuration du plugin.
• Options pour charger le tag d’un joueur à la connexion, intégration au formatage du chat et vérifications de mise à jour.

🧩 Pour qui c’est destiné

• Serveurs Survival / SMP qui veulent des tags de chat cosmétiques et déblocables, séparés des préfixes de rang.
• Serveurs qui utilisent des plugins de permissions pour attribuer des récompenses cosmétiques (par exemple via LuckPerms).
• Administrateurs qui veulent un sélecteur de tags simple basé sur une GUI pour les joueurs.

🏗️ Exemples d’utilisation

• Donner à un joueur la permission d’un tag VIP comme cosmétique achetable et lui permettre de l’activer/désactiver via la GUI des tags.
• Une récompense d’événement accorde une permission de tag spécifique, afin que les gagnants puissent sélectionner le nouveau tag parmi ceux disponibles.
• Les administrateurs créent des tags personnalisés via des commandes et définissent quels joueurs peuvent les utiliser via les permissions.

⌨️ Commandes

Remarque : la documentation du projet confirme ces commandes ; les nœuds de permission spécifiques aux commandes (autres que le schéma par tag) ne sont pas listés dans la source principale.

🔐 Permissions

Le plugin utilise des nœuds de permission par tag ; les autres nœuds spécifiques aux commandes ne sont pas explicitement documentés dans les fichiers principaux du projet disponibles.

⚙️ Installation

📥 Installation

• Téléchargez le fichier JAR du plugin depuis la ressource Spigot du projet ou les artefacts de build officiels.
• Placez le JAR dans le dossier plugins/ de votre serveur.
• Démarrez ou redémarrez le serveur et vérifiez la console pour confirmer que le plugin a bien été chargé.

📦 Dépendances

• PlaceholderAPI — pris en charge (le plugin inclut des placeholders et une option papi_chat), indiqué dans la configuration et les exemples de placeholders.

🧾 Configuration

• DeluxeTags utilise une configuration YAML qui définit les tags, les paramètres de la GUI et les messages. La configuration inclut des exemples pour les entrées de tags, les paramètres des objets de la GUI, les placeholders et les options de format de chat. Clés courantes visibles dans la configuration : deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Notes techniques

• Le code source du projet est disponible dans un dépôt GitHub public.
• Le projet Spigot liste des versions de Minecraft testées allant de 1.8 à 1.21 et inclut une entrée spécifique 1.20.6 dans la liste des versions testées.
• Les builds de développement et les artefacts CI sont fournis par le serveur CI du projet.
• Le dépôt ne montre pas de versions publiées sur l’hébergeur source ; les artefacts CI sont disponibles séparément.

🤝 Quand ce plugin est utile

Si vous voulez que les joueurs aient des tags cosmétiques optionnels, basés sur des permissions, qu’ils peuvent activer via une GUI ou des commandes sans changer leurs groupes de rang, DeluxeTags propose une solution simple et configurable avec l’intégration de PlaceholderAPI pour l’affichage dans le chat.