Plugin Minecraft CommandButtons

🔌 Sobre o CommandButtons

CommandButtons é um plugin do Minecraft para vincular comandos a interações com blocos. Ele permite que administradores do servidor anexem conjuntos de comandos a blocos (botões, placas, placas de pressão ou blocos clicáveis) para que esses comandos sejam executados quando um jogador interagir com o bloco configurado. O plugin suporta executar comandos como console e/ou como o jogador que acionou o bloco e oferece um editor GUI dentro do jogo para gerenciar botões e suas propriedades.

🎯 Objetivo

O plugin resolve o problema de criar elementos interativos no mundo que executam ações administrativas ou de jogabilidade sem exigir que os jogadores digitem comandos. Usos comuns incluem painéis de teleporte, seletores de kits, ações compráveis e mecânicas personalizadas acionadas por interações com blocos.

⚙️ Recursos

• Vincule um número ilimitado de comandos a um único botão de comando (comandos do console e do jogador).
• Editor GUI no jogo para criar e editar botões de comando e locais.
• Cooldowns por jogador e globais; os cooldowns persistem entre reinicializações do servidor.
• Integração opcional com economia via Vault para cobrar dos jogadores pelo uso dos botões.
• Nós de permissão personalizados para restringir o uso de botões específicos.
• Mensagens personalizáveis por meio de um arquivo de mensagens.
• Vários locais por botão de comando, para que uma única configuração possa ser aplicada a muitos blocos.
• Comandos básicos fornecidos para criar, editar e recarregar os dados do plugin.

🧩 Para quem é

• Administradores e construtores de servidores que querem elementos clicáveis no mundo que executem comandos.
• Servidores de minigames e lobbies que precisam de menus interativos ou painéis de teleporte/seleção de kits.
• Servidores que usam plugins de economia e querem mecânicas de cobrança por uso.

🏗️ Exemplos de uso

• Um painel de teleporte no spawn em que cada botão teleporta o jogador que clicou para uma arena diferente.
• Uma parede de seleção de kits: ao pressionar um botão, um conjunto de comandos é executado para entregar kits e mensagens.
• Uma ação comprável: um botão cobra a moeda do jogo e executa um comando de recompensa.

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o arquivo jar oficial do plugin e coloque-o no diretório plugins/ do servidor.
• Reinicie o servidor e verifique os logs do console para confirmar que o plugin foi carregado corretamente.
• Use os comandos /commandbuttons fornecidos para criar e editar as configurações dos botões no jogo.

📦 Dependências

• Opcional: Vault para habilitar recursos de cobrança da economia. É necessário um plugin de economia que se integre ao Vault (por exemplo, EssentialsX economy) para usar o recurso de cobrança por uso.

🧠 Observações técnicas

• O plugin oferece um editor GUI e cria arquivos de configuração/mensagens para personalização.
• Os cooldowns são preservados entre reinicializações do servidor.
• São suportados os modos de execução de comandos pelo console e pelo jogador; comandos executados como jogador usarão as permissões desse jogador (comandos que exigirem permissões mais altas do que as do jogador não serão executados quando rodados como jogador).
• Os recursos de economia exigem Vault e um plugin de economia compatível.

🤝 Quando este plugin é útil

Use o CommandButtons quando precisar de ações configuráveis e vinculadas a locais, acionadas por interações de jogadores (botões, placas, placas de pressão) com cooldowns integrados, verificações de permissão e custos opcionais de economia, tudo gerenciado por meio de um editor no jogo.