Plugin Minecraft MyCommand

🔌 Sobre o MyCommand

MyCommand é um plugin de Minecraft para criar comandos personalizados, aliases e interfaces interativas baseadas em comandos sem escrever Java. Ele oferece um sistema guiado por YAML para definir comandos que executam outros comandos, enviam texto formatado, abrem GUIs, acionam scripts e interagem com eventos.

🎯 Objetivo

MyCommand é voltado para administradores de servidores que precisam de comandos personalizados flexíveis, atalhos e interfaces de administração/usuário. Ele resolve o problema de adicionar comportamentos sob medida aos comandos (atrasos, warmups, cooldowns, tab-complete, placeholders) e interações leves com GUI sem desenvolver um plugin completo.

⚙️ Recursos

• Criar novos comandos e aliases, com registro opcional para tab-complete.
• Executar vários comandos a partir de um único comando personalizado (execução pela console ou pelo jogador).
• Atrasos, warmups e cooldowns para comandos.
• Substituir outros comandos ou fornecer atalhos/aliases.
• Acionamento de comandos por itens, blocos, placas, livros, NPCs e item frames.
• Elementos de GUI: IconMenu baseado em baú, ActionBar, BossBar, Title, Scoreboard, Anvil GUI e Sign GUI.
• Suporte a placeholders e condicionais no estilo de scripts para comportamento dinâmico.
• Integração com economia (opcional via Vault) e alguns recursos de economia independentes.
• Suporte a eventos de jogador (entrar/sair/morrer) e tarefas agendadas.
• Banco de dados de jogadores personalizado opcional com suporte a SQL e suporte a múltiplos arquivos para comandos ilimitados.
• Recursos relacionados ao BungeeCord e uma variante separada para o lado do Bungee, para comandos no proxy.
• Requisições HTTP (GET/POST) e suporte à formatação MiniMessage onde disponível.
• Usa bStats para coleta de métricas.

🧩 Para quem é

• Servidores Survival e SMP que querem comandos e menus personalizados sem programar.
• Servidores com muita administração ou economia que precisam de fluxos personalizados de loja/comandos.
• Redes de proxy que exigem comportamento de comandos centralizado ou do lado do proxy.
• Operadores de servidor que precisam de condicionais em script e placeholders para saídas dinâmicas.

🏗️ Casos de uso de exemplo

• Definir um único comando que executa uma sequência de comandos da console para abrir uma loja, dar itens e registrar a compra.
• Criar menus de punição/teleporte com GUI usando entradas de chest GUI e prompts de anvil/sign.
• Fornecer aliases curtos que apontam para comandos mais longos de troca de servidor via BungeeCord com tab-complete.

⌨️ Comandos

A documentação oficial lista comandos administrativos para gerenciar o plugin. Exemplos documentados pelo projeto incluem:

(Consulte a documentação oficial de comandos do plugin para a lista completa e a sintaxe exata.)

🔐 Permissões

O projeto documenta nodes de permissão para ações administrativas. Exemplos da lista oficial de permissões incluem:

(Veja a documentação de permissões do plugin para o mapa completo de permissões.)

⚙️ Instalação

📥 Configuração

• Baixe o plugin oficial .jar e coloque-o na pasta plugins/ do seu servidor.
• Inicie ou reinicie o servidor e verifique os logs do console para confirmar que o plugin foi carregado.
• Se o plugin não carregar, verifique se os plugins de suporte obrigatórios/opcionais (veja Dependências) estão presentes ou atualizados.

📦 Dependências

• ProtocolLib — indicado como importante se o plugin não carregar ou para alguns recursos.
• Vault — opcional, necessário para integrações com economia.
• PlaceholderAPI — opcional, para suporte ampliado a placeholders.

Instale apenas as dependências confirmadas para os recursos desejados; muitas integrações são opcionais.

🧠 Notas técnicas

• O plugin é configurado por arquivos YAML e suporta vários arquivos de comandos para evitar limites de comandos.
• O armazenamento SQL está disponível para o banco de dados personalizado de jogadores (opcional) e são suportadas configurações com múltiplos arquivos.
• Há um componente separado do BungeeCord para o processamento de comandos no lado do proxy.
• O projeto reporta métricas via bStats.
• A formatação MiniMessage e o suporte à tab-complete estão disponíveis em ambientes compatíveis.

🤝 Quando este plugin é útil

Se você precisa de comandos personalizados flexíveis baseados em arquivos, scripts condicionais e fluxos de comandos com GUI sem escrever Java, o MyCommand oferece uma plataforma configurável para isso e adiciona integrações com proxy e economia quando necessário.