Minecraft plugin CommandPanels

🔌 Over CommandPanels

CommandPanels is een Minecraft-plugin die een op YAML gebaseerd GUI-/menusysteem voor servers biedt. De focus ligt op panelen op basis van de inventaris, dialoogpanelen (form) en Floodgate-compatibele panelen voor Bedrock-spelers. Het project bevat een online editor en een gestructureerd formaat voor het bouwen van interactieve, datagestuurde menu's die opdrachten uitvoeren, dynamische placeholders tonen en reageren op logica en permissies.

🎯 Doel

De plugin is bedoeld voor serverbeheerders en ontwikkelaars die flexibele, programmeerbare GUI's nodig hebben voor shops, kits, lobbies, moderatietools of aangepaste workflows. Hij is ontworpen zodat panelen opdrachten kunnen uitvoeren, voorwaarden kunnen controleren, items kunnen animeren en sessie- of permanente data kunnen blootstellen voor gebruik in andere systemen.

⚙️ Functies

• Inventarispanelen met iteminteracties, slotindelingen en animatieketens.
• Dialoogpanelen voor gestructureerde formulieren en invoer van spelers.
• Floodgate-panneelondersteuning om compatibele panelen aan Bedrock-spelers te tonen (via Geyser/Floodgate-opstellingen).
• Inline logica en voorwaarden (AND/OR/NOT-stijl operators) om zichtbaarheid en gedrag te sturen.
• Commando-/actiesysteem: open/sluit-hooks, klikacties, acties bij klikken buiten het paneel en voorwaardelijke commando-uitvoering.
• Ondersteuning voor PlaceholderAPI en dynamische placeholder-updates binnen panelen.
• Sessiedata en permanente paneldata die toegankelijk zijn over panelen en opdrachten heen.
• Periodieke updates en een permissie-observer die bij wijziging van permissies een volledige heranalyse van de logica kan triggeren.
• Online editor met live YAML-voorbeeld en structuurcontroles.

🧩 Voor wie is het

Voor beheerders en pluginontwikkelaars die moderne, met Paper compatibele servers draaien en flexibele GUI-menu's nodig hebben: Survival/SMP-servers, minigame-netwerken, PvP-hubs en servers die aangepaste admin-/moderatie-interfaces vereisen.

🏗️ Voorbeelden van gebruik

• Maak een kit- of shop-GUI die servercommando's uitvoert en specifieke permissies of een economiebalans vereist.
• Bouw een hub-navigatiemenu met geanimeerde items en voorwaardelijke zichtbaarheid op basis van de rang van de speler.
• Bied een Bedrock-compatibel menu aan met Floodgate-specifieke panelvarianten.

⌨️ Commands

(Commando's en hun permissies komen uit de officiële CommandPanels-documentatie.)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | Geeft toegang tot het basiscommando /pa. | true | | commandpanels.command.reload | Staat het herladen van de plugin toe. | op | | commandpanels.command.generate | Toegang tot het paneelgenerator-commando. | op | | commandpanels.command.version | Staat toe om de pluginversie te controleren. | true | | commandpanels.command.data | Geeft toegang tot het configureren van paneeldata. | op | | commandpanels.command.open | Staat toe om panelen te openen met /pa open. | op | | commandpanels.command.open.other | Staat toe om panelen voor andere spelers te openen. | op | | commandpanels.command.help | Geeft toegang tot /pa help. | true |

⚙️ Installatie

📥 Setup

• Download het officiële CommandPanels .jar-bestand en plaats het in de plugins/-map van je server.
• Start de server om plugindata te genereren.
• Controleer na de eerste start plugins/CommandPanels op config.yml en de map panels/ met paneldefinitiebestanden.

📦 Dependencies

• PlaceholderAPI — optioneel maar aanbevolen voor dynamische placeholders.
• Floodgate — optioneel voor Bedrock-(Floodgate-)panelondersteuning.

🧾 Configuratie

• Panelen worden gedefinieerd als YAML-bestanden in de map panels/. Submappen worden ondersteund voor organisatie.
• De plugin genereert voorbeeldpanelen als de map panels/ wordt verwijderd en de plugin opnieuw wordt gestart.

🧠 Technische notities

• Officiële documentatie en releases geven Paper en Folia (Paper-forks) aan als ondersteunde serverplatforms voor de moderne v4-releases.
• De v4-reeks richt zich op recente Minecraft-serverversies; paneeldefinities ondersteunen dynamische placeholders en conditionele logica die tijdens runtime worden geparsed.
• De plugin biedt permissienodes en een op opdrachten gebaseerde API voor het openen van panelen; hij kan ook als bibliotheek in andere plugins worden ingebed door YAML-panelen te laden en open-acties aan te roepen.

🤝 Wanneer deze plugin nuttig is

Als je een gestructureerd, scriptbaar GUI-systeem nodig hebt dat dynamische data, conditionele logica, Bedrock-compatibiliteit en een online editor ondersteunt, biedt CommandPanels een bewezen, YAML-first aanpak die goed past bij Paper-gebaseerde servers en netwerken.