Plugin Minecraft CommandButtons

🔌 À propos de CommandButtons

CommandButtons est un plugin Minecraft permettant d’associer des commandes à des interactions avec des blocs. Il permet aux administrateurs du serveur d’attacher des ensembles de commandes à des blocs (boutons, panneaux, plaques de pression ou blocs cliquables) afin que ces commandes s’exécutent lorsqu’un joueur interagit avec le bloc configuré. Le plugin prend en charge l’exécution des commandes en tant que console et/ou en tant que joueur ayant déclenché le bloc, et fournit un éditeur GUI en jeu pour gérer les boutons et leurs propriétés.

🎯 Objectif

Le plugin résout le problème de créer des éléments interactifs dans le monde qui exécutent des actions administratives ou de gameplay sans obliger les joueurs à taper des commandes. Les usages courants incluent les panneaux de téléportation, les sélecteurs de kits, les actions payantes et les mécaniques personnalisées déclenchées par des interactions avec des blocs.

⚙️ Fonctionnalités

• Associe un nombre illimité de commandes à un seul bouton de commande (commandes console et commandes joueur).
• Éditeur GUI en jeu pour créer et modifier des boutons de commande et des emplacements.
• Cooldowns par joueur et globaux ; les cooldowns persistent après les redémarrages du serveur.
• Intégration économique optionnelle via Vault pour facturer les joueurs lors de l’utilisation des boutons.
• Nœuds de permission personnalisés pour restreindre l’utilisation de boutons spécifiques.
• Messages personnalisables via un fichier messages.
• Plusieurs emplacements par bouton de commande afin qu’une seule configuration puisse s’appliquer à de nombreux blocs.
• Commandes de base fournies pour créer, modifier et recharger les données du plugin.

🧩 Pour qui

• Les administrateurs et constructeurs de serveurs qui veulent des éléments cliquables dans le monde exécutant des commandes.
• Les serveurs de mini-jeux et de lobby qui ont besoin de menus interactifs ou de panneaux de téléportation/sélection de kits.
• Les serveurs utilisant des plugins d’économie et voulant des mécaniques de paiement à l’usage.

🏗️ Exemples d’utilisation

• Un panneau de téléportation au spawn où chaque bouton téléporte le joueur qui clique vers une arène différente.
• Un mur de sélection de kits : l’appui sur un bouton lance un ensemble de commandes pour donner des kits et des messages.
• Une action achetable : un bouton débite la monnaie du jeu et exécute une commande de récompense.

⌨️ Commandes

🔐 Permissions

⚙️ Installation

📥 Configuration

• Téléchargez le fichier jar officiel du plugin et placez-le dans le dossier plugins/ du serveur.
• Redémarrez le serveur et vérifiez les journaux de la console pour confirmer que le plugin s’est chargé correctement.
• Utilisez les commandes /commandbuttons fournies pour créer et modifier les configurations de boutons en jeu.

📦 Dépendances

• Facultatif : Vault pour activer les fonctionnalités de facturation économique. Un plugin d’économie qui s’intègre à Vault (par exemple, EssentialsX economy) est requis pour utiliser la fonctionnalité de paiement à l’usage.

🧠 Notes techniques

• Le plugin fournit un éditeur GUI et crée des fichiers de configuration/messages pour la personnalisation.
• Les cooldowns sont conservés après les redémarrages du serveur.
• Les modes d’exécution des commandes en console et en tant que joueur sont pris en charge ; les commandes exécutées en tant que joueur utiliseront les permissions du joueur (les commandes nécessitant des permissions supérieures à celles du joueur ne s’exécuteront pas lorsqu’elles sont lancées en tant que joueur).
• Les fonctionnalités d’économie nécessitent Vault et un plugin d’économie pris en charge.

🤝 Quand ce plugin est utile

Utilisez CommandButtons lorsque vous avez besoin d’actions configurables liées à un emplacement, déclenchées par les interactions des joueurs (boutons, panneaux, plaques) avec des cooldowns intégrés, des vérifications de permissions et des coûts économiques optionnels, le tout géré via un éditeur en jeu.