Plugin Minecraft EssentialsDiscord

🔌 Sobre o EssentialsX Discord

O EssentialsX Discord (distribuído como o módulo EssentialsDiscord) é um módulo oficial do EssentialsX que integra um servidor Minecraft a um servidor Discord. Ele roda como um plugin JAR junto do módulo principal do EssentialsX e se conecta ao Discord por meio de um token de bot configurado para repassar chat, eventos e oferecer interações do lado do Discord com base em uma pequena API.

🎯 Objetivo

O objetivo principal do módulo é duplo: repassar chats/eventos selecionados do Minecraft para canais do Discord e repassar mensagens/comandos selecionados do Discord para o servidor Minecraft. Ele foi pensado para administradores de servidores que querem comunicação direta e configurável, além de controle remoto limitado entre o Discord e um servidor Minecraft baseado no EssentialsX.

⚙️ Recursos

• Mapeamento de canais configurável para diferentes tipos de mensagem (chat, entrada/saída, equipe etc.).
• Repasse do chat do Minecraft para o Discord e, opcionalmente, de mensagens do Discord para o chat do Minecraft.
• Comandos slash no lado do Discord que podem executar comandos do console, enviar mensagens para jogadores e mostrar listas de jogadores (configuráveis e restritos por cargos).
• Sistema granular de tipos de mensagem e formatação por tipo definidos na configuração do plugin.
• API para desenvolvedores registrarem tipos de mensagem personalizados e comandos de interação do Discord via a API DiscordService fornecida.

🧩 Para quem é

• Donos de servidores que usam EssentialsX e querem sincronização de chat entre Discord ↔ Minecraft.
• Equipes de staff que querem canais privados ligados aos membros da staff no jogo.
• Desenvolvedores de plugins que querem expor interações simples com o Discord ou hooks de mensagens personalizados para o Discord.

🏗️ Casos de uso de exemplo

• Encaminhar o chat global para um canal dedicado no Discord enquanto envia mensagens de staff apenas para a equipe no jogo.
• Permitir que cargos verificados do Discord executem consultas ou comandos configurados do servidor via comandos slash sem expô-los publicamente.
• Fazer outro plugin enviar notificações estruturadas para o Discord registrando um tipo de mensagem personalizado com a API do EssentialsX Discord.

⌨️ Comandos

O EssentialsX Discord expõe comandos slash configuráveis do lado do Discord (registrados no Discord) em vez dos comandos de chat típicos do Minecraft. Esses comandos (com exemplos mostrados na documentação oficial) são executados a partir do Discord e podem executar comandos do console, enviar mensagens para jogadores ou mostrar listas de jogadores. A disponibilidade dos comandos e recursos avançados é controlada por configuração de cargos/IDs no arquivo de configuração do plugin.

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o arquivo JAR do módulo EssentialsX Discord e coloque-o no diretório plugins/ do seu servidor junto do JAR principal do EssentialsX.
• Inicie o servidor para gerar a configuração do módulo e depois pare o servidor.
• Configure o token do bot, os IDs dos canais, os tipos de mensagem e as definições de cargos dos comandos em plugins/EssentialsDiscord/config.yml conforme a documentação e então reinicie.

📦 Dependências

• EssentialsX (core) — o módulo funciona como um complemento da suíte de plugins EssentialsX.

🧠 Notas técnicas

• O módulo fornece uma API de serviço (DiscordService) para que outros plugins registrem tipos de mensagem personalizados e enviem mensagens para canais do Discord configurados.
• Os comandos do lado do Discord são controlados por cargos/IDs configurados no arquivo do plugin, e não por nodes de permissão padrão do Minecraft.
• A configuração no estilo de administração (token do bot, IDs dos canais, formatação das mensagens, IDs dos cargos dos comandos) é feita no arquivo de configuração do módulo criado na primeira execução.

🤝 Quando este plugin é útil

Quando você precisa de comunicação bidirecional gerenciada e configurável entre uma comunidade no Discord e um servidor Minecraft baseado no EssentialsX — incluindo comandos do Discord restritos por cargo e hooks para desenvolvedores — o EssentialsX Discord oferece um módulo focado que cuida do mapeamento de mensagens e de uma pequena API para integrações.