Minecraft-plugin CommandPanels

🔌 Om CommandPanels

CommandPanels är ett Minecraft-plugin som يوفر ett YAML-baserat GUI-/menysystem för servrar. Det fokuserar på paneler baserade på inventarium, dialogpaneler (form) och Floodgate-kompatibla paneler för Bedrock-spelare. Projektet innehåller en onlineeditor och ett strukturerat format för att bygga interaktiva, datadrivna menyer som kör kommandon, visar dynamiska placeholders och reagerar på logik och behörigheter.

🎯 Syfte

Pluginet är avsett för serveradministratörer och utvecklare som behöver flexibla, programmerbara GUI:n för butiker, kit, lobbyer, modereringsverktyg eller anpassade arbetsflöden. Det är utformat så att paneler kan köra kommandon, kontrollera villkor, animera föremål och exponera session- eller permanent data för användning i andra system.

⚙️ Funktioner

• Inventariepaneler med item-interaktioner, slot-layouter och animationskedjor.
• Dialogpaneler för strukturerade formulär och inmatning från spelare.
• Stöd för Floodgate-paneler för att visa kompatibla paneler för Bedrock-spelare (via Geyser/Floodgate-installationer).
• Inline-logik och villkor (operatorer i stil med AND/OR/NOT) för att styra synlighet och beteende.
• Kommando-/aktionssystem: open/close-hooks, klickåtgärder, åtgärder vid klick utanför panelen och villkorad kommandokörning.
• Stöd för PlaceholderAPI och dynamiska placeholder-uppdateringar i panelerna.
• Sessionsdata och permanent paneldata som kan nås över paneler och kommandon.
• Periodiska uppdateringar och en behörighets-observatör som kan trigga en fullständig omtolkning av logiken när behörigheter ändras.
• Onlineeditor med live-YAML-förhandsvisning och strukturkontroller.

🧩 Vem det är för

Administratörer och pluginutvecklare som kör moderna Paper-kompatibla servrar och behöver flexibla GUI-menyer: Survival/SMP-servrar, minispelsnätverk, PvP-hubbar och servrar som kräver anpassade admin-/modereringsgränssnitt.

🏗️ Exempel på användning

• Skapa ett kit- eller shop-GUI som kör serverkommandon och kräver specifika behörigheter eller ekonomisk balans.
• Bygg en navigationsmeny för en hub med animerade föremål och villkorad synlighet baserad på spelarens rank.
• Erbjuda en Bedrock-kompatibel meny med Floodgate-specifika panelvarianter.

⌨️ Commands

(Kommandon och deras behörigheter är hämtade från den officiella CommandPanels-dokumentationen.)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | Ger åtkomst till grundkommandot /pa. | true | | commandpanels.command.reload | Tillåter omladdning av pluginet. | op | | commandpanels.command.generate | Åtkomst till panelgenerator-kommandot. | op | | commandpanels.command.version | Tillåter kontroll av pluginversionen. | true | | commandpanels.command.data | Ger åtkomst att konfigurera paneldata. | op | | commandpanels.command.open | Tillåter att öppna paneler med /pa open. | op | | commandpanels.command.open.other | Tillåter att öppna paneler för andra spelare. | op | | commandpanels.command.help | Ger åtkomst till /pa help. | true |

⚙️ Installation

📥 Setup

• Ladda ner den officiella CommandPanels .jar-filen och placera den i serverns plugins/-mapp.
• Starta servern för att generera pluginets data.
• Efter första körningen, kontrollera plugins/CommandPanels efter config.yml och mappen panels/ som innehåller paneldefinitionsfiler.

📦 Dependencies

• PlaceholderAPI — valfritt men rekommenderas för dynamiska placeholders.
• Floodgate — valfritt för stöd för Bedrock-paneler (Floodgate).

🧾 Konfiguration

• Paneler definieras som YAML-filer i katalogen panels/. Undermappar stöds för organisation.
• Pluginet genererar exempelpaneler om katalogen panels/ tas bort och pluginet startas om.

🧠 Tekniska noter

• Officiell dokumentation och utgåvor anger Paper och Folia (Paper-forks) som stödda serverplattformar för de moderna v4-utgåvorna.
• V4-utgivningsspåret fokuserar på nyare Minecraft-serverversioner; paneldefinitioner stöder dynamiska placeholders och villkorad logik som parsas vid runtime.
• Pluginet exponerar behörighetsnoder och ett kommandobaserat API för att öppna paneler; det kan också bäddas in som ett bibliotek i andra plugins genom att läsa in panel-YAML och anropa open-åtgärder.

🤝 När detta plugin är användbart

Om du behöver ett strukturerat, skriptbart GUI-system som stöder dynamisk data, villkorad logik, Bedrock-kompatibilitet och en onlineeditor, erbjuder CommandPanels ett bekräftat YAML-first-sätt som passar Paper-baserade servrar och nätverk.