Plugin Minecraft CommandPanels

🔌 Sobre o CommandPanels

O CommandPanels é um plugin de Minecraft que fornece um sistema de GUI/menu para servidores baseado em YAML. O foco está em painéis baseados no inventário, painéis de diálogo (formulários) e painéis compatíveis com Floodgate para jogadores de Bedrock. O projeto inclui um editor online e um formato estruturado para criar menus interativos e baseados em dados que executam comandos, mostram placeholders dinâmicos e reagem a lógica e permissões.

🎯 Objetivo

O plugin foi pensado para administradores de servidores e desenvolvedores que precisam de GUIs flexíveis e programáveis para lojas, kits, lobbies, ferramentas de moderação ou fluxos de trabalho personalizados. Ele foi desenhado para permitir que os painéis executem comandos, verifiquem condições, animem itens e exponham dados de sessão ou persistentes para uso noutros sistemas.

⚙️ Funcionalidades

• Painéis de inventário com interações com itens, disposição de slots e cadeias de animação.
• Painéis de diálogo para formulários estruturados e entrada dos jogadores.
• Suporte a painéis Floodgate para apresentar painéis compatíveis a jogadores Bedrock (via configurações Geyser/Floodgate).
• Lógica e condições inline (operadores do tipo AND/OR/NOT) para controlar visibilidade e comportamento.
• Sistema de comandos/ações: hooks de abrir/fechar, ações de clique, ações ao clicar fora e execução condicional de comandos.
• Suporte a PlaceholderAPI e atualizações dinâmicas de placeholders dentro dos painéis.
• Dados de sessão e persistentes dos painéis acessíveis entre painéis e comandos.
• Atualizações periódicas e um observador de permissões que pode voltar a fazer o reparse completo da lógica quando as permissões mudam.
• Editor online com pré-visualização em tempo real do YAML e verificações de estrutura.

🧩 Para quem é

Administradores e desenvolvedores de plugins que executam servidores modernos compatíveis com Paper e precisam de menus GUI flexíveis: servidores survival/SMP, redes de minijogos, hubs PvP e servidores que exigem interfaces personalizadas para administração/moderação.

🏗️ Exemplos de uso

• Criar uma GUI de kits ou loja que executa comandos do servidor e exige permissões específicas ou saldo de economia.
• Construir um menu de navegação do hub com itens animados e visibilidade condicional com base no rank do jogador.
• Disponibilizar um menu compatível com Bedrock usando variantes de painéis específicas do Floodgate.

⌨️ Comandos

(Os comandos e as respetivas permissões são retirados da documentação oficial do CommandPanels.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Descarrega o ficheiro oficial .jar do CommandPanels e coloca-o na pasta plugins/ do teu servidor.
• Inicia o servidor para gerar os dados do plugin.
• Após a primeira execução, verifica plugins/CommandPanels para ver o config.yml e a pasta panels/ com os ficheiros de definição dos painéis.

📦 Dependências

• PlaceholderAPI — opcional, mas recomendado para placeholders dinâmicos.
• Floodgate — opcional para suporte a painéis de Bedrock (Floodgate).

🧾 Configuração

• Os painéis são definidos como ficheiros YAML colocados no diretório panels/. São suportadas subpastas para organização.
• O plugin gera painéis de exemplo se o diretório panels/ for apagado e o plugin for reiniciado.

🧠 Notas técnicas

• A documentação oficial e os lançamentos indicam Paper e Folia (forks do Paper) como plataformas de servidor suportadas para as versões modernas v4.
• A série de lançamentos v4 foca-se em versões recentes do servidor Minecraft; as definições dos painéis suportam placeholders dinâmicos e lógica condicional analisada em tempo de execução.
• O plugin expõe nós de permissão e uma API baseada em comandos para abrir painéis; também pode ser incorporado como biblioteca noutros plugins ao carregar YAML de painéis e invocar ações de abertura.

🤝 Quando este plugin é útil

Se precisas de um sistema de GUI estruturado e programável que suporte dados dinâmicos, lógica condicional, compatibilidade com Bedrock e um editor online, o CommandPanels oferece uma abordagem baseada em YAML que se adapta a servidores e redes baseados em Paper.