DiscordSRV conecta funções de Minecraft e Discord, como chat vinculado, comandos, sincronização de cargos e associação de conta. A integração atravessa duas plataformas e pode expor mensagens ou permitir ações administrativas. Planeje canais, escopo do bot, permissões e desvinculação antes de abrir acesso a toda comunidade.

Use a documentação atual do plugin: opções e comandos mudam por versão. Teste primeiro numa cópia do servidor e num canal privado. Nunca coloque token do bot em site, vídeo, captura ou repositório.

Desenhe os canais e o fluxo

Escolha quais canais espelham chat de Minecraft, anúncios, vínculo, avisos de moderação e console. Evite misturar conversa pública com logs privados ou comandos. Cada canal deve ter finalidade e audiência definidas, com histórico e retenção compatíveis com a política da comunidade.

Mapeie direções: Minecraft para Discord, Discord para Minecraft ou ambas. Um canal que recebe texto em jogo pode ter regras diferentes do que encaminha mensagem externa ao chat. Desative integração que não é necessária para o caso de uso.

Use só as permissões necessárias do bot

Crie ou configure aplicação/bot conforme a documentação oficial e limite permissões aos recursos ativados. Se o plugin envia mensagens, precisa ver canal e enviar mensagens; recursos de roles exigem permissões adicionais. Não conceda Administrador por conveniência se a configuração funciona com escopo menor.

Confira cargo mais alto do bot e hierarquia quando a sincronização altera roles. Um bot sem permissão pode produzir falha, enquanto um cargo amplo pode dar mais acesso que o necessário. Valide num canal de teste e compare ações feitas pelo bot com as da equipe.

Configure vínculo de contas com clareza

Vínculo associa identidade de Minecraft e Discord. Explique como iniciar, verificar código, confirmar sucesso e desvincular. Se o servidor exige link antes de entrar, informe isso antes do jogador conectar e ofereça caminho de suporte para quem não consegue completar o fluxo.

Não use vínculo para coletar dados além do necessário nem trate role do Discord como prova automática de identidade em situações fora do escopo. Teste conta com username alterado, Discord inacessível e jogador que entrou antes da política. Defina que ocorre quando o vínculo é removido.

Planeje mensagens entre plataformas

Espelhar chat facilita comunicação, mas mensagens passam por duas comunidades com formatos e moderação diferentes. Defina filtros, prefixos e comportamento de exclusão. Teste menções, Markdown, links e caracteres especiais para que mensagem de jogo não crie notificações em massa ou aparência de anúncio oficial.

Se usar webhooks ou integração opcional, revise identidade e nome exibido para não impersonar outro jogador ou marca. Mantenha mensagem encaminhada atribuída de forma transparente. Documente se editar ou apagar mensagem de uma plataforma altera cópia na outra.

Restrinja a função de console

Console remoto pode executar comando administrativo. DiscordSRV documenta que permissões de canal podem permitir a certos cargos ver console sem enviar mensagens, mas isso depende de configuração cuidadosa. Crie canal privado e cargos explícitos, negue envio para leitores e teste com uma conta que não seja administrador do servidor.

Se um grupo pode executar comandos, limite os comandos permitidos e revise logs de execução. Nunca compartilhe acesso amplo com moderadores que só precisam ler log. Mantenha token de bot e segredo de integração confidenciais; se vazarem, revogue e rotacione seguindo a plataforma.

Teste mensagens e permissões em uma cópia

Use uma conta comum no Minecraft e conta de teste no Discord. Teste chat nas duas direções, comandos autorizados e negados, link, unlink, sincronização de role e desconexão do bot. Confirme que canal de staff não recebe mensagens públicas e que mensagem externa não dispara comando sem intenção.

Revise logs após teste, procurando mensagens duplicadas, loops, falhas de permissão e dados exibidos em canal incorreto. Reinicie o servidor para garantir que configuração persiste. Se algo falhar, desligue a função específica antes de abrir todo o Discord da comunidade.

Faça operação e moderação responsáveis

Defina quem administra cargo e canais; o staff do jogo não deve automaticamente ter permissão de gerenciar servidor Discord. Remova ex-equipe da plataforma e do Minecraft de forma coordenada. Tenha canal para reportar problemas de vínculo sem publicar códigos ou informações de conta.

Registre versão de DiscordSRV, canais, intents/permissões que realmente foram habilitados e ações de teste. Não salve tokens no documento. Atualize a integração numa janela e acompanhe logs, especialmente se mudanças da API Discord afetarem permissões.

Consulte a documentação de DiscordSRV, o guia de vinculação de contas, o mapa de configuração de canais e a lista de comandos e permissões. Os requisitos exatos variam por recurso habilitado.

Defina o que acontece com contas duplicadas

Uma pessoa pode mudar o nome de jogo, perder acesso ao Discord ou ter duas contas na plataforma externa. Defina como solicitar novo vínculo e qual processo remove o anterior sem transferir permissões de modo automático. Teste esse ciclo em usuário de homologação e confira se cargos sincronizados também são retirados.

Prepare uma pausa segura da integração

Se bot expuser conteúdo ou começar a espelhar mensagens incorretas, desative o módulo ou o canal afetado enquanto investiga. Guarde configuração e logs necessários com acesso restrito, revogue token se houver suspeita de comprometimento e informe a comunidade se o recurso ficar indisponível. Não altere permissões de todo Discord se o problema está num único canal.

Revise respostas de falha do bot

Se comando administrativo foi enviado sem sucesso, confira se bot tem permissão no canal e se o membro tem node do DiscordSRV, sem ampliar acesso global para contornar erro. Registre o texto retornado e teste novamente com usuário autorizado. Resposta silenciosa pode ser configuração de canal ou comando desativado, não prova de que integração inteira caiu.

Planeje reparo sem apagar vínculos válidos

Se associação de uma conta ficar inconsistente, preserve identificação interna do caso e siga comandos oficiais de unlink e novo link. Não remova todas as ligações ou sincronizações para resolver um usuário, pois isso desconecta membros e pode alterar cargos em massa. Teste reparo numa conta controlada e verifique cada lado antes de fechar o chamado.

Comunique alterações aos membros

Avise se vínculo é obrigatório e como a pessoa pode revisar qual conta está associada. Explique o mínimo de dados que integração usa e como pedir desvinculação conforme política publicada. Uma mensagem simples reduz exposição de códigos de link e evita que usuários peçam ajuda em canais públicos com dados de conta.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.