Plugin Minecraft CommandPanels

🔌 Despre CommandPanels

CommandPanels este un plugin Minecraft care oferă un sistem GUI/menu bazat pe YAML pentru servere. Se concentrează pe panouri bazate pe inventar, panouri de dialog (form) și panouri compatibile cu Floodgate pentru jucătorii Bedrock. Proiectul include un editor online și un format structurat pentru construirea de meniuri interactive, bazate pe date, care rulează comenzi, afișează placeholders dinamice și reacționează la logică și permisiuni.

🎯 Scop

Pluginul este destinat administratorilor de server și dezvoltatorilor care au nevoie de GUI-uri flexibile, programabile, pentru shop-uri, kit-uri, lobby-uri, unelte de moderare sau fluxuri de lucru personalizate. Este conceput astfel încât panourile să poată executa comenzi, verifica condiții, anima iteme și expune date de sesiune sau persistente pentru utilizare în alte sisteme.

⚙️ Funcții

• Panouri de inventar cu interacțiuni cu iteme, layout de sloturi și lanțuri de animații.
• Panouri de dialog pentru formulare structurate și input de la jucători.
• Suport pentru panouri Floodgate pentru a prezenta panouri compatibile jucătorilor Bedrock (prin setări Geyser/Floodgate).
• Logică inline și condiții (operatori de tip AND/OR/NOT) pentru controlul vizibilității și comportamentului.
• Sistem de comenzi/acțiuni: hook-uri la deschidere/închidere, acțiuni la click, acțiuni la click în afara panoului și execuție condiționată a comenzilor.
• Suport pentru PlaceholderAPI și actualizări dinamice ale placeholderelor în interiorul panourilor.
• Date de sesiune și date persistente ale panourilor, accesibile între panouri și comenzi.
• Actualizări periodice și un observer de permisiuni care poate declanșa reanalizarea completă a logicii atunci când permisiunile se schimbă.
• Editor online cu previzualizare YAML live și verificări de structură.

🧩 Pentru cine este

Pentru administratori și dezvoltatori de pluginuri care rulează servere moderne compatibile cu Paper și au nevoie de meniuri GUI flexibile: servere Survival/SMP, rețele de minigame, hub-uri PvP și servere care necesită interfețe personalizate de administrare/moderare.

🏗️ Exemple de utilizare

• Creează un GUI de kit sau shop care rulează comenzi de server și necesită permisiuni specifice sau un sold economic.
• Construiește un meniu de navigare pentru hub cu iteme animate și vizibilitate condiționată în funcție de rangul jucătorului.
• Oferă un meniu compatibil cu Bedrock folosind variante de panouri specifice Floodgate.

⌨️ Commands

(Comenzile și permisiunile lor sunt preluate din documentația oficială CommandPanels.)

🔐 Permissions

| Permission | Description | Default | |---|---|---|---| | commandpanels.command | Permite accesul la comanda de bază /pa. | true | | commandpanels.command.reload | Permite reîncărcarea pluginului. | op | | commandpanels.command.generate | Acces la comanda generatorului de panouri. | op | | commandpanels.command.version | Permite verificarea versiunii pluginului. | true | | commandpanels.command.data | Oferă acces pentru configurarea datelor panoului. | op | | commandpanels.command.open | Permite deschiderea panourilor cu /pa open. | op | | commandpanels.command.open.other | Permite deschiderea panourilor pentru alți jucători. | op | | commandpanels.command.help | Permite accesul la /pa help. | true |

⚙️ Instalare

📥 Configurare

• Descarcă fișierul oficial CommandPanels .jar și pune-l în folderul plugins/ al serverului tău.
• Pornește serverul pentru a genera datele pluginului.
• După prima rulare, verifică plugins/CommandPanels pentru config.yml și folderul panels/ care conține fișierele de definire ale panourilor.

📦 Dependencies

• PlaceholderAPI — opțional, dar recomandat pentru placeholders dinamice.
• Floodgate — opțional pentru suportul panourilor Bedrock (Floodgate).

🧾 Configurare

• Panourile sunt definite ca fișiere YAML plasate în directorul panels/. Sunt acceptate și subfoldere pentru organizare.
• Pluginul va genera panouri exemplu dacă directorul panels/ este șters și pluginul este repornit.

🧠 Note tehnice

• Documentația oficială și versiunile indică Paper și Folia (fork-uri Paper) ca platforme de server suportate pentru versiunile moderne v4.
• Seria de versiuni v4 se concentrează pe versiuni recente de server Minecraft; definițiile panourilor acceptă placeholders dinamice și logică condițională analizate la runtime.
• Pluginul expune noduri de permisiuni și un API bazat pe comenzi pentru deschiderea panourilor; poate fi integrat și ca bibliotecă în alte pluginuri prin încărcarea YAML-ului panoului și apelarea acțiunilor de deschidere.

🤝 Când este util acest plugin

Dacă ai nevoie de un sistem GUI structurat, scriptabil, care suportă date dinamice, logică condițională, compatibilitate Bedrock și un editor online, CommandPanels oferă o abordare confirmată, bazată pe YAML, potrivită pentru servere și rețele bazate pe Paper.