Docs
Entrar
Capítulos

Operação · 13 min de leitura

Discord: anúncios, status e logs

A integração com Discord cobre três coisas diferentes, e vale separá-las: anúncios (wipe e votação), embed de status (o servidor ao vivo) e logs (o que deu errado).

Fica em Servidor → Extensões.

Conectar

A organização precisa de uma conexão com o seu servidor de Discord. Ao conectar, você autoriza o bot e escolhe o servidor — a autorização é feita por você, na tela do próprio Discord.

Depois disso, cada servidor de Rust escolhe seus canais.

Anúncios de wipe

Três canais podem ser configurados, e eles podem ser o mesmo:

CanalRecebe
Wipe de mapaWipes do tipo map e restart_only
Wipe completoWipes do tipo full
VotaçãoAbertura e encerramento das votações

As mensagens enviadas:

  • Wipe iniciado — quando a execução começa.
  • Wipe concluído — com a imagem do mapa, o tipo, a origem e os botões de download e visualização.
  • Wipe falhou — quando as tentativas se esgotam. Pode mencionar cargos críticos.

Cargos mencionados

Dois grupos separados:

  • Cargos de ping — mencionados nos anúncios normais de wipe. É o @everyone da comunidade, ou um cargo de notificações.
  • Cargos críticos — mencionados quando algo falha. Devem ser da equipe, não da comunidade.

Importante: manter os dois separados é o que faz o aviso de falha funcionar. Se os cargos críticos forem os mesmos dos anúncios normais, a equipe se acostuma a ignorar as menções e a falha passa despercebida.

Botões nos embeds

Configuráveis por servidor:

  • Baixar mapa — link direto para o arquivo .map.
  • Ver no RustMaps — a página do mapa no RustMaps.
  • Até três botões seus — loja, site, regras. Rótulo e endereço definidos por você.

O botão de visualização só aparece quando o mapa tem id no RustMaps. Mapas enviados manualmente não têm página, e o botão some em vez de apontar para um erro.

Atenção: o Discord aceita no máximo cinco botões por linha. Se a soma passar disso, os seus cedem lugar aos de mapa — a mensagem inteira seria recusada se ultrapassasse o limite.

Identidade da comunidade

Em Extensões → Identidade da comunidade os anúncios ganham a cara do seu servidor:

CampoOnde aparece
Nome e ícone do autorLinha pequena acima do título, com ícone redondo
Logo no cantoMiniatura no canto superior direito
Rodapé e íconeRodapé, junto do horário — o lugar do "Comunidade \2019 - 2026"

Tudo é opcional. Em branco, o embed sai exatamente como antes.

Importante: endereços de imagem precisam começar com http:// ou https://. Um endereço em outro formato é descartado em vez de repassado — o Discord recusa a mensagem inteira quando uma URL de ícone é inválida, e um logo que não aparece é bem melhor do que um wipe que ninguém fica sabendo.

Endereço de conexão no anúncio

Ligado por padrão. O anúncio de wipe concluído passa a trazer o endereço em bloco de código, pronto para copiar:

client.connect 2x.seudominio.com

Ele usa o domínio de conexão configurado no servidor. Sem domínio configurado, a linha é omitida — publicar um endereço que não conecta seria pior do que não publicar nenhum.

Personalizar os textos

Título e descrição de cada embed são editáveis, e aceitam variáveis que a plataforma substitui no envio. Os botões abaixo do campo inserem cada uma com um clique.

VariávelVira
{server}Nome do servidor
{type}Tipo do wipe
{status}Concluído ou falhou
{date}Data e hora, no fuso de quem lê
{ago}Tempo relativo — "há 19 horas"
{mapName}Nome do mapa aplicado
{mapSize}Tamanho do mapa
{seed}Seed do mapa
{mapUrl}Link do mapa no RustMaps
{nextWipe}Quanto falta para o próximo wipe
{nextWipeDate}Data do próximo wipe
{voteWeights}Cargos com voto de peso maior (só na votação)

As duas formas de tempo são marcações do próprio Discord: ele as renderiza no fuso e no idioma de cada pessoa que lê. Um único texto atende uma comunidade espalhada, e {nextWipe} conta o tempo sozinho, sem precisarmos reenviar a mensagem.

Um exemplo aproveitando isso:

🚀 Wipe concluído {ago}

**Mapa:** {mapName} · seed `{seed}` · tamanho `{mapSize}`
**Próximo wipe:** {nextWipe}

Variáveis sem valor saem em branco — um wipe do tipo restart_only não tem mapa, então {mapName} fica vazio em vez de escrever algo quebrado.

Embed de status ao vivo

Uma mensagem fixa num canal, atualizada sozinha, que funciona como painel público da comunidade. Por servidor, ela mostra:

  • Estado e contagem de jogadores online
  • Endereço de conexão, em bloco de código
  • Próximo wipe de mapa e próximo wipe de blueprints
  • Mapa atual e tamanho, e há quanto tempo o servidor wipou
  • Agenda recorrente em palavras — "Toda quinta às 18:00 UTC"

O horário da agenda sai sempre em UTC e rotulado como tal. Converter exigiria escolher um fuso para uma comunidade que não tem um; rotular é honesto.

São mostradas no máximo duas regras por servidor: a linha existe para dar o ritmo, não o calendário inteiro.

Você escolhe o canal, e a plataforma cria e atualiza a mensagem. Vários servidores podem dividir o mesmo embed, em blocos.

Logs

Um canal separado, para a equipe, onde ficam os eventos técnicos: execuções, falhas e alterações de configuração. Não é para a comunidade.

Se o aviso não chegar

O envio ao Discord nunca derruba um wipe — se o Discord estiver fora, o wipe continua. Mas o resultado do envio fica registrado: o histórico da execução termina com um destes passos:

PassoSignifica
Aviso enviado ao Discord.Saiu
Aviso não enviado: anúncios desativados ou canal não configurado.Não havia para onde enviar
Não foi possível enviar o aviso ao Discord...Tentou e falhou — veja bot, webhook e permissões do canal

Isso existe porque "não chegou aviso" e "não havia aviso a dar" eram indistinguíveis antes. Se o passo disser que falhou, confira nesta ordem:

  1. O bot ainda está no servidor de Discord?
  2. Ele tem permissão de Ver canal e Enviar mensagens no canal escolhido?
  3. O canal ainda existe? Canais apagados deixam o id órfão.

Próximo: Equipe e permissões