Plugin Minecraft EssentialsDiscordLink

🔌 Sobre o EssentialsX Discord Link

O EssentialsX Discord Link é um módulo complementar para o EssentialsX Discord que oferece vinculação de contas e sincronização entre contas do Minecraft e cargos do Discord. Ele foi projetado para расширять a integração do Discord do EssentialsX com recursos focados em vincular identidades de usuários e mapear grupos do Vault para cargos do Discord (e vice-versa).

🎯 Objetivo

Oferecer uma forma simples e fácil de manter para permitir que os jogadores vinculem suas contas do Minecraft e do Discord e para manter a afiliação a grupos do servidor e os cargos do Discord sincronizados. Ele também permite restringir jogadores não vinculados de entrar ou interagir até concluírem a vinculação.

⚙️ Recursos

• Sincronização de grupo do Vault -> cargo do Discord (mapeie nomes de grupos do Vault para IDs de cargos do Discord).
• Sincronização de cargo do Discord -> grupo do Vault (atribua grupos do Vault com base em IDs de cargos do Discord).
• Impede que jogadores não vinculados entrem no servidor.
• Impede que jogadores não vinculados se movam ou enviem mensagens no chat até vincularem a conta.
• Fluxo de vinculação de conta no jogo que gera um código curto para usar no Discord.
• Uma pequena API para desenvolvedores verificar o status da vinculação, vincular/desvincular jogadores e obter dados vinculados.

🧩 Para quem é

• Servidores que usam EssentialsX e o módulo EssentialsX Discord e precisam de vinculação de contas do Discord.
• Servidores que usam grupos do Vault e querem que esses grupos apareçam como cargos do Discord (ou vice-versa).
• Servidores Survival, SMP e comunitários que exigem associação verificada ao Discord ou sincronização de cargos.

🏗️ Casos de uso de exemplo

• Conceder automaticamente um grupo de doador baseado no Vault quando um jogador tiver um cargo correspondente no Discord.
• Bloquear jogadores não vinculados de conversar ou se mover até confirmarem sua conta do Discord por meio do código de vinculação no jogo.
• Usar um plugin ou script de back-end para consultar se um jogador está vinculado por meio da API fornecida.

⌨️ Comandos

⚙️ Instalação

📥 Configuração

• Baixe o jar oficial do EssentialsX Discord Link e coloque-o no diretório plugins/ do seu servidor.
• Inicie o servidor para gerar a pasta do plugin e a configuração padrão.
• Edite a configuração do plugin em plugins/EssentialsDiscordLink/config.yml para definir groups (grupo do Vault -> ID do cargo do Discord) e roles (ID do cargo do Discord -> grupo do Vault).
• Depois de salvar a configuração, execute o comando de reload do console do EssentialsX (por exemplo ess reload) ou reinicie o servidor para aplicar as configurações de sincronização de cargos.

📦 Dependências

• EssentialsX (core) — obrigatório (o módulo é um complemento do EssentialsX Discord).
• EssentialsX Discord — obrigatório (este complemento estende esse módulo).
• Vault — usado para mapeamentos entre grupo do Vault ↔ cargo do Discord (mencionado nos recursos de sincronização de cargos).

🧠 Observações técnicas

• O plugin expõe uma pequena API para desenvolvedores (service) que permite a outros plugins verificar se um jogador está vinculado, vincular/desvincular jogadores programaticamente e obter dados vinculados.
• A configuração usa plugins/EssentialsDiscordLink/config.yml para os mapeamentos entre grupos do Vault e IDs de cargos do Discord.

🤝 Quando este plugin é útil

Se o seu servidor já usa EssentialsX e você precisa que os jogadores verifiquem ou vinculem suas contas do Discord (e/ou mantenham grupos do Vault e cargos do Discord sincronizados), o EssentialsX Discord Link oferece uma integração direta e documentada que funciona dentro do ecossistema de módulos do EssentialsX.