Minecraft plugin CommandPanels

🔌 About CommandPanels

CommandPanels is a Minecraft plugin that provides a YAML-driven GUI/menu system for servers. It focuses on inventory-based panels, dialog (form) panels, and Floodgate-compatible panels for Bedrock players. The project includes an online editor and a structured format for building interactive, data-driven menus that run commands, show dynamic placeholders, and react to logic and permissions.

🎯 Purpose

The plugin is intended for server administrators and developers who need flexible, programmable GUIs for shops, kits, lobbies, moderation tools, or custom workflows. It is designed to let panels execute commands, check conditions, animate items, and expose session or persistent data for use in other systems.

⚙️ Features

• Inventory panels with item interactions, slot layouts, and animation chains.
• Dialog panels for structured forms and input from players.
• Floodgate panel support to present compatible panels to Bedrock players (via Geyser/Floodgate setups).
• Inline logic and conditions (AND/OR/NOT style operators) to control visibility and behavior.
• Command/action system: open/close hooks, click actions, outside-click actions, and conditional command execution.
• PlaceholderAPI support and dynamic placeholder updates inside panels.
• Session and persistent panel data accessible across panels and commands.
• Periodic updates and a permissions observer that can trigger full logic re-parsing when permissions change.
• Online editor with YAML live preview and structure checks.

🧩 Who It Is For

Administrators and plugin developers running modern Paper-compatible servers who need flexible GUI menus: survival/SMP servers, minigame networks, PvP hubs, and servers that require custom admin/moderation interfaces.

🏗️ Example Use Cases

• Create a kit or shop GUI that runs server commands and requires specific permissions or economy balance.
• Build a hub navigation menu with animated items and conditional visibility based on player rank.
• Provide a Bedrock-compatible menu using Floodgate-specific panel variants.

⌨️ Commands

(Commands and their permissions are taken from the official CommandPanels documentation.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official CommandPanels .jar file and place it into your server's plugins/ folder.
• Start the server to generate plugin data.
• After first run, check plugins/CommandPanels for config.yml and the panels/ folder containing panel definition files.

📦 Dependencies

• PlaceholderAPI — optional but recommended for dynamic placeholders.
• Floodgate — optional for Bedrock (Floodgate) panel support.

🧾 Configuration

• Panels are defined as YAML files placed in the panels/ directory. Subfolders are supported for organization.
• The plugin generates example panels if the panels/ directory is deleted and the plugin restarted.

🧠 Technical Notes

• Official documentation and releases indicate Paper and Folia (Paper forks) as supported server platforms for the modern v4 releases.
• v4 release stream focuses on recent Minecraft server versions; panel definitions support dynamic placeholders and conditional logic parsed at runtime.
• The plugin exposes permission nodes and a command-based API for opening panels; it can also be embedded as a library in other plugins by loading panel YAML and invoking open actions.

🤝 When This Plugin Is Useful

If you need a structured, scriptable GUI system that supports dynamic data, conditional logic, Bedrock compatibility, and an online editor, CommandPanels provides a confirmed, YAML-first approach that fits Paper-based servers and networks.