Minecraft-plugin CommandPanels

🔌 Om CommandPanels

CommandPanels er et Minecraft-plugin, der tilbyder et YAML-baseret GUI/menu-system til servere. Det fokuserer på inventariebaserede paneler, dialogpaneler (form) og Floodgate-kompatible paneler til Bedrock-spillere. Projektet inkluderer en online editor og et struktureret format til at bygge interaktive, datadrevne menuer, der kører kommandoer, viser dynamiske placeholders og reagerer på logik og tilladelser.

🎯 Formål

Pluginet er tiltænkt serveradministratorer og udviklere, som har brug for fleksible, programmerbare GUI'er til shops, kits, lobbyer, moderationsværktøjer eller tilpassede workflows. Det er designet, så paneler kan udføre kommandoer, tjekke betingelser, animere items og eksponere session- eller permanente data til brug i andre systemer.

⚙️ Funktioner

• Inventariepaneler med item-interaktioner, slot-layouts og animationskæder.
• Dialogpaneler til strukturerede formularer og input fra spillere.
• Floodgate-panelunderstøttelse til at vise kompatible paneler til Bedrock-spillere (via Geyser/Floodgate-opsætninger).
• Inline logik og betingelser (AND/OR/NOT-stil operatorer) til at styre synlighed og adfærd.
• Kommando-/aktionssystem: open/close-hooks, klikhandlinger, handlinger ved klik uden for panelet og betinget kommandoafvikling.
• Understøttelse af PlaceholderAPI og dynamiske placeholder-opdateringer inde i paneler.
• Sessiondata og permanent paneldata, som kan tilgås på tværs af paneler og kommandoer.
• Periodiske opdateringer og en tilladelses-observer, der kan udløse fuld gen-parsing af logikken, når tilladelser ændres.
• Online editor med live YAML-forhåndsvisning og strukturkontrol.

🧩 Hvem er det til

Administratorer og pluginudviklere, der kører moderne Paper-kompatible servere og har brug for fleksible GUI-menuer: Survival/SMP-servere, minispilsnetværk, PvP-hubs og servere, der kræver tilpassede admin-/modereringsgrænseflader.

🏗️ Eksempler på brug

• Opret en kit- eller shop-GUI, der kører serverkommandoer og kræver specifikke tilladelser eller økonomisk balance.
• Byg en hub-navigationsmenu med animerede items og betinget synlighed baseret på spillerens rang.
• Giv en Bedrock-kompatibel menu ved hjælp af Floodgate-specifikke panelvarianter.

⌨️ Commands

(Kommandoer og deres tilladelser er hentet fra den officielle CommandPanels-dokumentation.)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | Giver adgang til basis-/pa-kommandoen. | true | | commandpanels.command.reload | Giver tilladelse til at genindlæse pluginet. | op | | commandpanels.command.generate | Adgang til panelgenerator-kommandoen. | op | | commandpanels.command.version | Giver lov til at tjekke pluginversionen. | true | | commandpanels.command.data | Giver adgang til at konfigurere paneldata. | op | | commandpanels.command.open | Giver lov til at åbne paneler med /pa open. | op | | commandpanels.command.open.other | Giver lov til at åbne paneler for andre spillere. | op | | commandpanels.command.help | Giver adgang til /pa help. | true |

⚙️ Installation

📥 Opsætning

• Download den officielle CommandPanels .jar-fil og læg den i din servers plugins/-mappe.
• Start serveren for at generere plugindata.
• Efter første kørsel, tjek plugins/CommandPanels for config.yml og mappen panels/, som indeholder paneldefinitionsfiler.

📦 Dependencies

• PlaceholderAPI — valgfrit, men anbefalet til dynamiske placeholders.
• Floodgate — valgfrit for Bedrock (Floodgate) panelunderstøttelse.

🧾 Konfiguration

• Paneler defineres som YAML-filer placeret i mappen panels/. Under-mapper understøttes til organisering.
• Pluginet genererer eksempelpanele- r, hvis mappen panels/ slettes, og pluginet genstartes.

🧠 Tekniske noter

• Officiel dokumentation og udgivelser angiver Paper og Folia (Paper-forks) som understøttede serverplatforme for de moderne v4-udgivelser.
• v4-udgivelseslinjen fokuserer på nyere Minecraft-serverversioner; paneldefinitioner understøtter dynamiske placeholders og betinget logik, som parses ved runtime.
• Pluginet eksponerer tilladelsesnoder og et kommando-baseret API til at åbne paneler; det kan også indlejres som et bibliotek i andre plugins ved at indlæse panel-YAML og kalde open-handlinger.

🤝 Hvornår er dette plugin nyttigt

Hvis du har brug for et struktureret, scriptbart GUI-system, der understøtter dynamiske data, betinget logik, Bedrock-kompatibilitet og en online editor, tilbyder CommandPanels en bekræftet YAML-first tilgang, der passer til Paper-baserede servere og netværk.