Plugin Minecraft CommandPanels

🔌 Sobre o CommandPanels

CommandPanels é um plugin de Minecraft que oferece um sistema de GUI/menu para servidores baseado em YAML. O foco é 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 orientados por dados que executam comandos, exibem placeholders dinâmicos e reagem a lógica e permissões.

🎯 Objetivo

O plugin foi feito 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 projetado para permitir que os painéis executem comandos, verifiquem condições, animem itens e exponham dados de sessão ou persistentes para uso em outros sistemas.

⚙️ Recursos

• Painéis de inventário com interações com itens, organizaçã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 setups Geyser/Floodgate).
• Lógica inline e condições (operadores no estilo 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 ao 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 disparar um reparse completo da lógica quando as permissões mudam.
• Editor online com prévia em tempo real do YAML e verificações de estrutura.

🧩 Para quem é

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

🏗️ Exemplos de uso

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

⌨️ Comandos

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

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o arquivo oficial .jar do CommandPanels e coloque-o na pasta plugins/ do seu servidor.
• Inicie o servidor para gerar os dados do plugin.
• Após a primeira execução, verifique plugins/CommandPanels para encontrar o config.yml e a pasta panels/ contendo os arquivos 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 arquivos YAML colocados no diretório panels/. Subpastas são suportadas 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 releases indicam Paper e Folia (forks do Paper) como plataformas de servidor suportadas para as versões modernas v4.
• A linha de releases v4 foca 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; ele também pode ser incorporado como biblioteca em outros plugins ao carregar YAML de painel e invocar ações de abertura.

🤝 Quando este plugin é útil

Se você precisa 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 confirmada, centrada em YAML, que se encaixa em servidores e redes baseados em Paper.