Plugin Minecraft CommandPanels

🔌 Informazioni su CommandPanels

CommandPanels è un plugin Minecraft che fornisce un sistema GUI/menu per server basato su YAML. Si concentra su pannelli basati sull'inventario, pannelli di dialogo (form) e pannelli compatibili con Floodgate per i giocatori Bedrock. Il progetto include un editor online e un formato strutturato per creare menu interattivi e basati sui dati che eseguono comandi, mostrano placeholder dinamici e reagiscono a logica e permessi.

🎯 Scopo

Il plugin è pensato per amministratori di server e sviluppatori che hanno bisogno di GUI flessibili e programmabili per shop, kit, lobby, strumenti di moderazione o flussi di lavoro personalizzati. È progettato per consentire ai pannelli di eseguire comandi, controllare condizioni, animare oggetti ed esporre dati di sessione o persistenti da usare in altri sistemi.

⚙️ Funzionalità

• Pannelli inventario con interazioni sugli oggetti, disposizione degli slot e catene di animazione.
• Pannelli di dialogo per form strutturati e input dei giocatori.
• Supporto ai pannelli Floodgate per mostrare pannelli compatibili ai giocatori Bedrock (tramite configurazioni Geyser/Floodgate).
• Logica inline e condizioni (operatori in stile AND/OR/NOT) per controllare visibilità e comportamento.
• Sistema di comandi/azioni: hook di apertura/chiusura, azioni al clic, azioni al clic fuori e esecuzione condizionale dei comandi.
• Supporto a PlaceholderAPI e aggiornamenti dinamici dei placeholder all'interno dei pannelli.
• Dati di sessione e persistenti dei pannelli accessibili tra pannelli e comandi.
• Aggiornamenti periodici e un osservatore dei permessi che può attivare il rianalisi completa della logica quando i permessi cambiano.
• Editor online con anteprima live del YAML e controlli della struttura.

🧩 A chi è rivolto

Amministratori e sviluppatori di plugin che gestiscono server moderni compatibili con Paper e hanno bisogno di menu GUI flessibili: server survival/SMP, reti di minigiochi, hub PvP e server che richiedono interfacce personalizzate per amministrazione/moderazione.

🏗️ Esempi d'uso

• Creare una GUI per kit o shop che esegue comandi del server e richiede permessi specifici o saldo economico.
• Costruire un menu di navigazione dell'hub con oggetti animati e visibilità condizionale in base al rango del giocatore.
• Fornire un menu compatibile con Bedrock usando varianti di pannelli specifiche di Floodgate.

⌨️ Comandi

(I comandi e i relativi permessi sono tratti dalla documentazione ufficiale di CommandPanels.)

🔐 Permessi

⚙️ Installazione

📥 Setup

• Scarica il file ufficiale .jar di CommandPanels e mettilo nella cartella plugins/ del tuo server.
• Avvia il server per generare i dati del plugin.
• Dopo il primo avvio, controlla plugins/CommandPanels per config.yml e la cartella panels/ contenente i file di definizione dei pannelli.

📦 Dipendenze

• PlaceholderAPI — opzionale ma consigliato per i placeholder dinamici.
• Floodgate — opzionale per il supporto ai pannelli Bedrock (Floodgate).

🧾 Configurazione

• I pannelli sono definiti come file YAML collocati nella directory panels/. Sono supportate sottocartelle per l'organizzazione.
• Il plugin genera pannelli di esempio se la directory panels/ viene eliminata e il plugin viene riavviato.

🧠 Note tecniche

• La documentazione ufficiale e le release indicano Paper e Folia (fork di Paper) come piattaforme server supportate per le moderne release v4.
• La linea di release v4 si concentra sulle versioni recenti del server Minecraft; le definizioni dei pannelli supportano placeholder dinamici e logica condizionale analizzata a runtime.
• Il plugin espone nodi permessi e un'API basata sui comandi per aprire i pannelli; può anche essere integrato come libreria in altri plugin caricando YAML dei pannelli e invocando azioni di apertura.

🤝 Quando questo plugin è utile

Se hai bisogno di un sistema GUI strutturato e scriptabile che supporti dati dinamici, logica condizionale, compatibilità Bedrock e un editor online, CommandPanels offre un approccio confermato, YAML-first, adatto a server e reti basati su Paper.