Idioma
Anvil · Discordleitura de 7 min

Anvil no Discord

Um bot, um convite, e nenhum aplicativo para registrar. Isto é o que ele posta, onde posta, o que pode mudar no seu servidor — e o que olhar no dia em que ele parar.

Um bot compartilhado, nada para criar~5 min do convite ao primeiro postOpcional cada feed fica desligado até você apontá-lo
Esta tradução para Português (BR) ainda não foi revisada por um falante nativo. Se alguma frase soar errada, a página em inglês é o original —— e nos avisar é o que faz a correção acontecer.
Passo 1

Um bot, já pronto

#

Não há aplicativo do Discord para criar, token para gerar nem segredo para colar. O Anvil roda um bot que todos os clãs compartilham, então conectar é um convite e nada além disso.

Você ainda pode trazer o seu — cole um token em Use your own bot instead (advanced) e ele será usado no lugar. Só vale a pena se você quiser que o bot apareça com o nome e o avatar do seu clã na lista de membros; tudo neste guia funciona igual dos dois jeitos.

Ver canais, Enviar mensagens, Inserir links, Anexar arquivosO básico. Sem isso ele fica no seu servidor e mudo.
Gerenciar webhooksPara que Set it up for me e Post here possam criar webhooks para você, em vez de você copiar URLs do Discord na mão, e para que o Anvil possa encontrar webhooks antigos para você remover.
Gerenciar cargosSó se você ligar a sincronização de cargos. Aí ele distribui os cargos que você mapear — e nunca consegue mexer num cargo acima do dele, o que é regra do Discord, não nossa.
Gerenciar apelidosSó se você ligar a sincronização de apelidos, para que o apelido de servidor de um membro possa virar o RSN dele.
Gerenciar canaisPara canais privados dos times durante um draft e para guias publicados como uma nova categoria ou fórum. Sem ela, todo o resto continua funcionando.
Gerenciar tópicos, Enviar mensagens em tópicosPara guias publicados em um fórum: escrever dentro da postagem e removê-la depois — sem isso o Discord não deixa um bot apagar nem a própria postagem.
Alterar apelidoSó se você der ao bot o nome do seu clã em Connection → Bot appearance in your server. Isso muda o nome do bot apenas no seu servidor.
Ele pede tudo de uma vez
O Discord não tem como pedir uma permissão depois, então o link de convite solicita o conjunto inteiro, e os recursos que você nunca ligar nunca usam a deles. Reabrir o link de convite também é como se conserta uma permissão que alguém tirou.
Passo 2

Conectando

#

Duas coisas, nesta ordem. O bot precisa estar no seu servidor, e o Anvil precisa saber qual servidor é o seu.

Convide o botAdmin → Discord → Connect your Discord server (ou Add Anvil to Discord). O Discord pergunta em qual servidor adicionar o Anvil e te manda de volta para cá, então não dá para adicionar no errado sem querer. Depois, Invite / re-invite the bot fica em More settings → Connection.
Defina o ID do servidorSó se o botão não der conta: abra Can’t use the button? Enter the server ID, clique com o botão direito no ícone do seu servidor no Discord → Copiar ID do servidor (precisa do Modo desenvolvedor ativado, em Avançado, nas configurações do próprio Discord), cole em Your Discord server’s ID e aperte Save. É esse campo que torna a conexão especificamente sua.

O painel então te diz a verdade em vez da sua intenção: se o bot é mesmo membro daquele servidor, e quais permissões faltam. Uma linha verde ali vale mais que um formulário salvo.

O ID do servidor é todo o vínculo
Um servidor pertence a exatamente um clã no Anvil, e comandos de barra vindos de um servidor que ninguém reivindicou são recusados em vez de adivinhados. Até você definir, o bot está convidado e ocioso.
Passo 3

Configurar webhooks

#

O Anvil posta por webhooks, um por canal, e cada um deles é opcional. Nada é postado em lugar nenhum até você apontar um feed para um canal — um clã recém-criado fica em silêncio de propósito, não por acidente.

Com o bot do Anvil no seu servidor, Set it up for me no topo de Admin → Discord cria os canais e aponta cada feed para eles. Para fazer na mão, abra More settings → What goes where e comece pelo Catch-all channel em Clan & events, depois pelo In-game catch-all em In-game (plugin): escolha um canal na lista suspensa e ele salva. Sem o bot, abra no Discord Editar canal → Integrações → Webhooks daquele canal, crie um, copie a URL, escolha Paste a webhook… na lista suspensa, cole e aperte Save. Uma URL de webhook pode postar no canal, então trate-a como senha; se vazar, apague-a no Discord e crie outra. Test, e Add another para alternar as postagens de maior volume entre dois webhooks, ficam em Post without a bot.

Canal geralO principal, na aba Clan & events. Início e fim de eventos, abertura de inscrições, classificações, resultados semanais: tudo que o site publica sem um canal próprio. Configure só este e você já tem um clã funcionando.
Geral do jogoNa aba In-game (plugin): para onde vai tudo que vem do jogo quando não tem canal próprio. Configure este em segundo lugar.
Marcos e maisNa aba In-game (plugin). Slayer, clues, speedruns, contagens de abates, apostas do BA e mensagens de chat personalizadas são publicados aqui, quando os jogadores ativarem. O botão Filters define o que seu clã dá aos membros por padrão. Os modelos próprios dos jogadores e os tipos privados estão em Settings, page by page.
Feeds divididosPosts de eventos, boards que você coapresenta, Skill & boss of the week e eventos do calendário do clã podem sair do canal geral; drops raros, pets, collection log, níveis, combat achievements, quests, diaries, mortes e abates de PvP podem sair do canal geral do jogo. Mudanças no roster, aprovações de inscrição e o livro-caixa do cofre ficam em Staff only. Feeds divididos em branco usam o canal geral correspondente. O cofre é a exceção: em branco significa que nenhum dinheiro é publicado. Leagues e outros modos têm sua própria aba Game modes.
Separe as mortes primeiro
Mortes são o feed de maior volume na maioria dos quadros e o que soterra todo o resto. Se você separar só uma coisa, separe essa.
Passo 4

Leagues, Deadman e outros modos

#

Leagues, Deadman, hardcore e outros modos rodam em mundos próprios, com personagens próprios. As publicações deles são sempre identificadas e nunca contam para tabelas ou competições. Eles têm aba própria: Admin → Discord → What goes where → Game modes. Um modo aparece ali na primeira vez que um membro o joga.

Cada modo tem um interruptor e um canal To. Ative Send game-mode posts to their own channels para usar esses canais; se deixar desligado, todos os modos publicam nos canais normais, sempre identificados. O botão Posts na linha de um modo lista todos os tipos que ele envia (os habituais e os eventos do próprio modo), cada um com seu interruptor.

Abaixo dessa lista, Custom thresholds fazem um modo publicar menos que o jogo principal. Post drops rarer than 1 in… (mínimo 2) e Post drops worth at least (gp) (mínimo 1,000) definem seus próprios limites (em branco = igual ao jogo principal). Depois pressione Save drop thresholds: itens de publicação obrigatória continuam sendo publicados, mas drops que só contam pelo valor não. Use its own level milestones publica um level-up somente se atender aos dois conjuntos de regras.

Mais rígido, nunca mais solto
Os filtros de um modo só podem tirar posts. O plugin já aplicou suas configurações do jogo principal, então nada que um filtro de modo faça consegue trazer um post de volta.
Passo 5

Webhooks antigos de outros plugins ou bots

#

Com o bot no seu servidor, a página do Discord lista todos os webhooks do servidor que não são do Anvil. Coming from other plugins? oferece Use the same channels, para que Set it up for me poste onde seus feeds antigos postavam e nada mude para seus membros.

Quando seus membros já estiverem no Anvil, vá em Remove old webhooks from other plugins, marque os que devem sair e aperte Remove … webhooks, depois Yes, remove them. Isso os apaga no Discord de vez — não dá para desfazer.

A lista mostra qualquer webhook que não seja do Anvil, não só os de outro plugin. Tem um que você quer manter, como o feed de outro bot? Aperte Keep e ele sai da lista; Show kept e Put back o trazem de volta. Manter só o esconde aqui — nada muda no Discord.

Precisa da permissão Gerenciar webhooks
O bot lê os webhooks do seu servidor para encontrá-los. Sem a permissão Gerenciar webhooks no cargo dele, a página avisa que não consegue vê-los.
Passo 6

Cargos e apelidos

#

As duas sincronizações ficam desligadas até você ativá-las em Admin → Discord → Roles & nicknames, e as duas são guiadas pela lista do clã. Ligue Enable Discord role sync, deixe ligado Auto-match in-game rank → Discord role by name, escolha os Member roles e Guest roles gerais que quiser, salve e aperte Sync roles & nicknames now. Cada pessoa também precisa ter uma identidade do Discord vinculada; o relatório da sincronização nomeia quem não pôde ser identificado.

Sincronização de cargosPara a correspondência automática de rank, o nome do cargo do Discord precisa ser igual ao rank do clã no jogo: Owner, Deputy Owner, Coordinator, Overseer, General, Captain, Lieutenant, Sergeant, Corporal ou Recruit. Ranks personalizados também funcionam quando o cargo do Discord usa esse mesmo nome. A correspondência ignora maiúsculas e minúsculas e trata sublinhados como espaços, mas palavras extras não combinam: General funciona; OSRS General não. Os cargos de membros e convidados são escolhidos à parte, então podem ter qualquer nome.
Sincronização de apelidosDefine o apelido de servidor de um membro como o RSN dele. Por padrão preenche um apelido vazio e pode ser instruída a sobrescrever um que a pessoa escolheu — essa é a configuração para pensar antes, não depois.
O cargo do bot precisa ficar acima dos que ele gerencia
O Discord não deixa nenhum bot mexer num cargo igual ou acima do próprio, e recusa em silêncio do seu lado — a sincronização simplesmente não faz nada. Arraste o cargo do Anvil para cima em Configurações do servidor → Cargos e ele passa a funcionar; não precisa reconvidar nada.
Passo 7

Comandos de barra

#

O bot responde a /bingo no seu servidor (o tabuleiro, a classificação, as regras, a sua própria ficha) e também a comandos do clã como /sotw, /stats e /coffer. Eles leem o site ao vivo, então ninguém precisa sair do Discord para ver como está. Todos os comandos e suas opções têm uma página própria.

Eles aparecem cerca de um minuto depois de o bot entrar. Se não aparecerem nunca, o convite concedeu o bot mas não os comandos dele — são duas permissões separadas, e um link de convite mais antigo pedia só uma. Use de novo Invite / re-invite the bot em Connection, na página do Discord; isso não expulsa o bot nem zera nada.

Ele responde no idioma de cada pessoa
Por padrão o bot responde no idioma que aquele membro configurou no Discord, com inglês como reserva. Escolha um único idioma em Idioma do bot para valer para todo mundo — é também a única forma de ter árabe, já que o Discord não tem idioma de cliente árabe para detectar.
Passo 8

O que ele posta, e quando

#

Duas fontes, e vale saber qual é qual quando algo parece errado.

O site posta eventos: um quadro abrindo, inscrições, uma largada, classificações, o resultado. Saem do próprio Anvil e funcionam tendo alguém o plugin ou não.

O plugin posta o que acontece no jogo: drops, pets, mortes, níveis, casas do collection log, combat achievements. Só existem para os membros que o usam, então um canal de drops silencioso costuma significar um plugin silencioso, não um webhook quebrado.

Nada é postado duas vezes
Um drop que completa uma casa é um post, não um do plugin e outro do quadro.
Passo 9

Limites de drop

#

Anvil começa em 1m gp ou 1 in 1,000. Um drop é publicado quando atende a qualquer um dos dois. Ninguém pode definir números abaixo desses, e 0 desativa um deles.

Defina os padrões do seu clã em Admin → Discord → What goes where → Drops: Default minimum drop value (gp), Default: post drops rarer than 1 in… e Require both. Ative Require both e um drop precisa atingir o valor and a raridade.

Cada personagem segue o padrão do clã do qual é membro, e o padrão da Anvil se não tiver nenhum. Os jogadores podem escolher os próprios números em Settings. Aparece Using clan default ou Custom, e Reset volta ao padrão.

Hard floor: never post drops more common than 1 in… é a regra estrita. Os membros não podem ir além dela nos canais do seu clã. Os webhooks próprios deles podem.

Mais sobre o lado do jogador
Os números, modelos e webhooks dos jogadores estão em Settings, page by page.
Passo 10

Mais webhooks para canais movimentados

#

Um webhook só consegue enviar até certa velocidade. Para um evento movimentado, adicione mais webhooks ao mesmo canal. Pressione Busy channel? Let the bot add … more webhooks (precisa de Manage Webhooks), ou cole vários links de webhook na caixa do canal. A Anvil sugere mais quando há 50 ou mais jogadores, muitas publicações por minuto, ou quando o Discord disse recentemente “slow down”. Até 10 é o suficiente.

A Anvil alterna entre eles. Se o Discord disser “slow down” para um, esse webhook descansa por um momento e o próximo envia a publicação. Se um for apagado ou parar de funcionar, ele é ignorado por 10 minutos. As publicações continuam fluindo, desde que um webhook funcione.

Todos devem apontar para o mesmo canal. A Anvil avisa se não apontarem. Use Test para verificar um, ou Stop posting here para removê-lo.

Mesmo canal, mesmas publicações
Mais webhooks nunca publicam duas vezes. Eles apenas dividem o trabalho. A mesma ideia está em Limites de drop acima, e o lado do admin em Running the event.
Passo 11

Publicar no Discord

#

Admins podem postar como o bot em Post to Discord, sob Clan no menu do admin. Escolha um Channel, escreva a Message e aperte Send message. Um texto longo, como um livro de regras, é dividido em várias mensagens sozinho.

Send as an embed vem ligado por padrão e adiciona um Title opcional e uma Accent colour; desligue para texto simples. Ping escolhe um cargo, ou @everyone, para mencionar, e o Anvil pergunta antes de enviar.

Cada post que você envia fica listado em Sent from here. Edit muda o post no Discord sem marcar ninguém de novo, e Delete o remove.

Só admins, com o bot
Ele posta como o bot do Anvil, então conecte seu servidor primeiro. Moderadores não o veem. É o interruptor Post to Discord em Clan settings → Features; desligado, ele some do menu.
Passo 12

Quando fica em silêncio

#

Em ordem, porque cada item descarta o seguinte:

O bot está mesmo no servidor?Connection, na página do Discord, diz isso diretamente. «Token válido» e «no seu servidor» são fatos diferentes e o primeiro não implica o segundo — com um bot compartilhado o token é sempre válido.
O ID do servidor está certo?Um ID errado mas real fica exatamente igual a um certo, até você reparar que os posts estão indo para outro lugar.
O webhook ainda existe?Apagar um canal do Discord apaga o webhook dele, e o Anvil fica com a URL morta. Escolha de novo um canal para ele em What goes where.
O cargo do bot está alto o bastante?Só para a sincronização de cargos e apelidos — veja acima. Esse é o que falha em silêncio.
Ele não consegue dar boas-vindas a quem entra
O Discord só informa entradas por uma conexão gateway, que um bot compartilhado não mantém aberta para cada servidor. Por isso não existe post de boas-vindas — coloque o link de inscrição num canal #cargos ou #comece-aqui, que é onde as pessoas olham de qualquer jeito.

Tudo isto fica em Admin → Discord: a configuração rápida no topo, depois More settings — Connection, What goes where, Event posts, Roles & nicknames, Team channels, Commands e Post without a bot.

Travou ou algo parece errado? Pergunte no Discord de suporte do Anvil