Plugin Minecraft DiscordSRV

🔌 Sobre o DiscordSRV

O DiscordSRV é um plugin de Minecraft que conecta um servidor de Minecraft a um servidor do Discord. Ele encaminha o chat do jogo para o Discord (e as mensagens do Discord para o jogo), oferece vinculação de contas entre contas de Minecraft e Discord e fornece ganchos de sincronização para cargos/grupos e vários eventos do servidor.

🎯 Objetivo

O objetivo principal do DiscordSRV é oferecer uma ponte confiável e configurável entre um servidor de Minecraft e o Discord, para que as comunidades possam se comunicar nas duas plataformas, manter a equipe informada e sincronizar informações de membros/cargos quando configurado.

⚙️ Recursos

• Sincronização de chat em duas vias entre canais do Minecraft e do Discord (configurável por canal).
• Vinculação de contas Minecraft <-> Discord para jogadores.
• Ganchos de sincronização de cargos/grupos (pontos de integração para plugins de permissões como o LuckPerms).
• Mensagens de broadcast e da equipe do Minecraft para o Discord.
• Comandos para vinculação, verificação do status de vínculo e ações administrativas (reload, resync, debug).
• Vários arquivos de configuração para mapeamento de canais, idioma/mensagens, sincronização e recursos de voz.
• Código open-source com um rastreador público de issues e lançamentos.

🧩 Para quem é

• Donos e administradores de servidor que querem unificar o chat da comunidade entre Minecraft e Discord.
• Equipes de moderação que precisam de visibilidade dos eventos do servidor no Discord.
• Redes que usam plugins de permissões e querem sincronização de cargos ou grupos com o Discord.

🏗️ Exemplos de uso

• Encaminhar o chat global ou por canal do Minecraft para canais específicos do Discord, para que usuários fora do servidor acompanhem as conversas.
• Vincular contas de jogadores a IDs do Discord para conceder cargos do Discord ou verificar usuários entre plataformas.
• Enviar registros de entrada/saída/console do servidor para um canal de moderação do Discord.

⌨️ Comandos

Subcomandos do jogador:

Comandos da equipe:

(Os comandos obsoletos relacionados ao antigo sistema de assinatura estão documentados no histórico, mas foram removidos da operação atual.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o .jar oficial do DiscordSRV em uma distribuição oficial (página do projeto / catálogo / lançamentos).
• Coloque o jar na pasta plugins/ do seu servidor, em um servidor compatível com Bukkit/Spigot.
• Reinicie o servidor e verifique os logs do console para confirmar que o DiscordSRV carregou.
• Conclua a configuração inicial (token do bot, mapeamento de canais, opções de vínculo) usando os arquivos de configuração gerados.

📦 Arquivos de configuração

O DiscordSRV usa vários arquivos de configuração; os nomes confirmados incluem:

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Edite os arquivos apropriados para definir o token do bot do Discord, o mapeamento de canais e as configurações de sincronização. Alguns recursos (sincronização de cargos/grupos, integração de voz) exigem configuração adicional.

🧠 Notas técnicas

• O código-fonte e os lançamentos são mantidos em um repositório público.
• O projeto é publicado sob GPL-3.0.
• As integrações opcionais confirmadas incluem LuckPerms (contexts/sincronização de grupos) e PlaceholderAPI (placeholders).
• Os comandos e permissões estão documentados na documentação oficial; operações administrativas como resync e reload existem e podem exigir privilégios de operador.

🤝 Quando este plugin é útil

Se você precisa de chat bidirecional consistente e configurável, além de vinculação de contas entre um servidor de Minecraft e uma comunidade do Discord, o DiscordSRV fornece a ponte, os ganchos de integração e os arquivos de configuração para operar esses recursos, integrando-se também a plugins comuns do servidor.