Plugin Minecraft DiscordSRV

🔌 Sobre o DiscordSRV

O DiscordSRV é um plugin de Minecraft que liga 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), suporta a ligação de contas entre contas de Minecraft e do Discord e fornece ganchos de sincronização para funções/grupos e vários eventos do servidor.

🎯 Objetivo

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

⚙️ Funcionalidades

• Sincronização de chat bidirecional entre canais do Minecraft e do Discord (configurável por canal).
• Ligação de contas Minecraft <-> Discord para jogadores.
• Ganchos de sincronização de funções/grupos (pontos de integração para plugins de permissões como o LuckPerms).
• Mensagens de broadcast e da equipa do Minecraft para o Discord.
• Comandos para ligação, verificação do estado da ligação e ações administrativas (reload, resync, debug).
• Vários ficheiros de configuração para mapeamento de canais, idioma/mensagens, sincronização e funcionalidades de voz.
• Código open-source com um rastreador público de issues e lançamentos.

🧩 Para quem é

• Donos e administradores de servidores que querem unificar o chat da comunidade entre Minecraft e Discord.
• Equipas 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 funções ou grupos com o Discord.

🏗️ Exemplos de utilização

• Encaminhar o chat global ou por canal do Minecraft para canais específicos do Discord, para que utilizadores fora do servidor acompanhem as conversas.
• Ligar contas de jogadores a IDs do Discord para atribuir funções do Discord ou verificar utilizadores entre plataformas.
• Enviar registos de entrada/saída/console do servidor para um canal de moderação do Discord.

⌨️ Comandos

Subcomandos do jogador:

Comandos da equipa:

(Os comandos obsoletos relacionados com o antigo sistema de subscrição estão documentados no histórico, mas foram removidos do funcionamento atual.)

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Descarrega o .jar oficial do DiscordSRV de uma distribuição oficial (página do projeto / catálogo / lançamentos).
• Coloca o jar na pasta plugins/ do teu servidor, para um servidor compatível com Bukkit/Spigot.
• Reinicia o servidor e verifica os registos da consola para confirmar que o DiscordSRV carregou.
• Conclui a configuração inicial (token do bot, mapeamento de canais, opções de ligação) usando os ficheiros de configuração gerados.

📦 Ficheiros de configuração

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

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

Edita os ficheiros adequados para definir o token do bot do Discord, o mapeamento de canais e as definições de sincronização. Algumas funcionalidades (sincronização de funções/grupos, integração de voz) requerem configuração adicional.

🧠 Notas técnicas

• O código-fonte e os lançamentos são mantidos num repositório público.
• O projeto é publicado sob GPL-3.0.
• As integrações opcionais confirmadas incluem LuckPerms (contextos/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 precisas de chat bidirecional consistente e configurável, além de ligaçã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 ficheiros de configuração para operar essas funcionalidades, integrando-se também com plugins comuns do servidor.