Plugin Minecraft CommandPanels

🔌 À propos de CommandPanels

CommandPanels est un plugin Minecraft qui fournit un système d’interface/menu pour serveurs basé sur YAML. Il se concentre sur des panneaux basés sur l’inventaire, des panneaux de dialogue (formulaires) et des panneaux compatibles Floodgate pour les joueurs Bedrock. Le projet inclut un éditeur en ligne et un format structuré pour créer des menus interactifs, pilotés par des données, qui exécutent des commandes, affichent des placeholders dynamiques et réagissent à la logique et aux permissions.

🎯 Objectif

Le plugin est destiné aux administrateurs de serveurs et aux développeurs qui ont besoin d’interfaces flexibles et programmables pour des boutiques, des kits, des lobbies, des outils de modération ou des workflows personnalisés. Il est conçu pour permettre aux panneaux d’exécuter des commandes, de vérifier des conditions, d’animer des objets et d’exposer des données de session ou persistantes pour d’autres systèmes.

⚙️ Fonctionnalités

• Panneaux d’inventaire avec interactions d’objets, disposition des emplacements et chaînes d’animation.
• Panneaux de dialogue pour des formulaires structurés et la saisie des joueurs.
• Support des panneaux Floodgate pour présenter des panneaux compatibles aux joueurs Bedrock (via des configurations Geyser/Floodgate).
• Logique inline et conditions (opérateurs de type AND/OR/NOT) pour contrôler la visibilité et le comportement.
• Système de commandes/actions : hooks d’ouverture/fermeture, actions au clic, actions au clic en dehors et exécution conditionnelle de commandes.
• Support de PlaceholderAPI et mises à jour dynamiques des placeholders à l’intérieur des panneaux.
• Données de panneau de session et persistantes accessibles entre les panneaux et les commandes.
• Mises à jour périodiques et un observateur des permissions capable de relancer l’analyse complète de la logique lorsque les permissions changent.
• Éditeur en ligne avec aperçu YAML en direct et vérifications de structure.

🧩 Pour qui ?

Administrateurs et développeurs de plugins exploitant des serveurs modernes compatibles Paper et ayant besoin de menus GUI flexibles : serveurs survival/SMP, réseaux de mini-jeux, hubs PvP et serveurs nécessitant des interfaces d’administration/modération personnalisées.

🏗️ Cas d’utilisation exemples

• Créer une GUI de kit ou de boutique qui exécute des commandes du serveur et nécessite des permissions spécifiques ou un solde d’économie.
• Construire un menu de navigation du hub avec des objets animés et une visibilité conditionnelle selon le rang du joueur.
• Proposer un menu compatible Bedrock en utilisant des variantes de panneaux spécifiques à Floodgate.

⌨️ Commandes

(Les commandes et leurs permissions sont tirées de la documentation officielle de CommandPanels.)

🔐 Permissions

⚙️ Installation

📥 Configuration

• Télécharge le fichier officiel .jar de CommandPanels et place-le dans le dossier plugins/ de ton serveur.
• Démarre le serveur pour générer les données du plugin.
• Après le premier lancement, vérifie plugins/CommandPanels pour config.yml et le dossier panels/ contenant les fichiers de définition des panneaux.

📦 Dépendances

• PlaceholderAPI — optionnel mais recommandé pour les placeholders dynamiques.
• Floodgate — optionnel pour le support des panneaux Bedrock (Floodgate).

🧾 Configuration

• Les panneaux sont définis sous forme de fichiers YAML placés dans le répertoire panels/. Des sous-dossiers sont pris en charge pour l’organisation.
• Le plugin génère des panneaux d’exemple si le répertoire panels/ est supprimé puis que le plugin est redémarré.

🧠 Notes techniques

• La documentation officielle et les versions indiquent Paper et Folia (forks de Paper) comme plates-formes serveur prises en charge pour les versions modernes v4.
• La série de versions v4 se concentre sur les versions récentes du serveur Minecraft ; les définitions de panneaux prennent en charge des placeholders dynamiques et une logique conditionnelle analysée à l’exécution.
• Le plugin expose des nœuds de permission et une API basée sur des commandes pour ouvrir les panneaux ; il peut aussi être intégré comme bibliothèque dans d’autres plugins en chargeant du YAML de panneaux et en invoquant des actions d’ouverture.

🤝 Quand ce plugin est utile

Si vous avez besoin d’un système d’interface structuré et scriptable qui prend en charge des données dynamiques, une logique conditionnelle, la compatibilité Bedrock et un éditeur en ligne, CommandPanels propose une approche confirmée, centrée sur YAML, adaptée aux serveurs et réseaux basés sur Paper.