Scoreboards Documentation
Everything you need to create and manage Discord leaderboards
- Adicione o bot — Convide o Scoreboards para o seu server do Discord pelo link de convite na página inicial.
- Rode o assistente — Use
/get startedpara escolher um tipo de ranking, dar um nome e publicar em um canal. Rankings Classic, Highscore e Time começam com algumas entradas de exemplo, só para você ver a coisa funcionando; elas somem no instante em que o primeiro score de verdade entra. - Defina os cargos — Abra o painel para escolher o cargo <arg>bot permission</arg> (quem pode gerenciar rankings) e o cargo <arg>validator</arg> (quem pode aprovar envios).
- Crie seu primeiro ranking — Use
/scoreboard createe defina nome, tipo e ordem de classificação. - Publique — Use
/scoreboard showem um canal para postar o ranking interativo, com botão de envio e navegação entre páginas.
Ao criar um ranking com /scoreboard create, você escolhe entre seis tipos:
Classic
Soma ou desconta pontos de um total acumulado. Ideal para jogos em que a pontuação vai se somando.
Highscore
Guarda só o recorde pessoal de cada jogador. Scores menores são substituídos automaticamente.
Time (Speedrun)
Envie tempos como 00:00:00 (centésimos) ou 00:00:000 (milésimos) — o formato de exibição é uma configuração do painel, e rankings novos já vêm em milésimos. Ordem crescente para vencer quem faz o menor tempo, decrescente para vencer quem aguenta mais.
ELO - Ranked
Sistema de rating ELO competitivo, em 1v1 ou times de 2v2 a 8v8. Registre o resultado do match e o rating de todo mundo se atualiza sozinho.
Rating
A comunidade envia imagens e avalia com estrelas (de 1 a 10). Os votos viram uma média. Perfeito para concursos de arte e desafios criativos.
League
Ranking por pontos em partidas, para esportes como futebol, basquete e FIFA. Pontos por vitória/empate/derrota configuráveis (padrão 3/1/0) e placar do match (ex.: 3-1).
Gerenciamento de rankings
| Comando | Descrição | Permissão |
|---|---|---|
/scoreboard create | Cria um ranking novo com nome, tipo, ordem de classificação e configurações opcionais | Admin / Bot Permission |
/scoreboard show | Publica o ranking no canal atual, com botões interativos | Admin / Bot Permission |
/scoreboard settings | Abre o painel para gerenciar as configurações deste ranking (ordem, visibilidade, cabeçalhos, modo de exibição, ELO e mais) | Admin / Bot Permission |
/scoreboard delete | Apaga o ranking e todos os dados dele de vez (pede confirmação) | Admin / Bot Permission |
/scoreboard season end | Arquiva a classificação final, publica o pódio e zera o ranking para a próxima season (pede confirmação) | Admin / Bot Permission |
/import | Importa scores de um arquivo CSV para um ranking (útil ao migrar de outro bot ou de uma planilha) | Admin / Bot Permission |
Envio de scores e matches
| Comando | Descrição | Permissão |
|---|---|---|
/submit | Envia para qualquer ranking. O bot abre o passo certo conforme o tipo — um modal de score (Classic/Highscore/Time), um seletor de jogadores + vencedor (ELO), um seletor de jogadores + placar (League) ou um modal de nome (Rating, com a imagem anexada ao comando). Em ranking por times, os seletores pedem o elenco completo de cada lado. | Todo mundo |
/set | Define manualmente o score exato ou o rating ELO de um jogador | Admin / Bot Permission |
/adjust | Soma ou subtrai um valor do score de um jogador (use valores negativos para subtrair) | Admin / Bot Permission |
/player remove | Tira um jogador do ranking | Admin / Bot Permission |
Configuração
| Comando | Descrição | Permissão |
|---|---|---|
/get started | Abre o assistente de configuração inicial | Admin |
/help | Abre a ajuda interativa com todos os tópicos disponíveis | Todo mundo |
Existem dois jeitos de enviar:
- Use o comando
/submite escolha um ranking. O bot abre o formulário certo conforme o tipo — campo de score para Classic/Highscore/Time, seletor de jogadores + vencedor para ELO, seletor de jogadores + placar para League, ou campo de nome para Rating (com a imagem anexada ao comando). Em ranking por times, os seletores pedem o elenco completo de cada lado, e não um jogador só. - Clique no botão Submit na mensagem do ranking para abrir esse mesmo fluxo.
Como funciona a revisão
- O envio vai para o canal de verificação configurado (se você definiu um).
- Um validador ou admin clica em Approve ou Reject.
- Se for recusado, quem enviou recebe uma DM com o motivo.
- Se for aprovado, o ranking se atualiza na hora.
Aprovação automática
Cada ranking pode aprovar os envios sozinho depois de um tempo: desligado, na hora, 1 hora, 3 horas, 24 horas, 3 dias ou 7 dias. Em rankings de ELO o padrão é 24 horas.
Cancelando um score
Admins e validadores podem cancelar um score já aprovado: clique com o botão direito na mensagem do envio e escolha "Cancel Score/Match". A pontuação volta ao que era e o bot pede um motivo para o cancelamento.
O tipo ELO - Ranked usa um sistema de rating ELO para classificar os jogadores por nível, em 1v1 ou em times de até oito de cada lado.
Como funciona
- Todo jogador começa com um ELO inicial configurável (padrão: 1200).
- O resultado do match pode ser vitória, derrota ou empate.
- Os ratings são calculados com um fator K de 32.
- Depois da aprovação, o rating de todos os participantes muda ao mesmo tempo.
Matches em time (2v2 a 8v8)
Rankings de ELO e League podem ter tamanho de time fixo — escolha na criação ou mude depois em Match format, no painel. Num ranking 3v3, todo match tem três jogadores de cada lado, e a classificação continua sendo individual.
No ELO, o resultado esperado de cada time sai da média dos ratings, e a variação resultante vale para todos os integrantes daquele time — ou seja, derrubar um time mais forte rende o mesmo ganho para todo mundo do lado vencedor. No League, cada jogador do time vencedor leva os pontos de vitória, e o time perdedor inteiro leva os pontos de derrota.
Queue de matchmaking (Beta)
Se o botão de queue estiver ativo no ranking, é só clicar para entrar. O sistema junta jogadores de ELO parecido usando uma janela que vai se abrindo aos poucos. Quando o match sai, é criada uma thread para ele, com botões de votação para a comunidade. Se não aparecer ninguém em 5 minutos, a sua entrada na queue expira.
Em ranking por times, a queue espera juntar gente suficiente para os dois lados — seis num 3v3 — e então divide o pessoal em dois times com a média de rating mais próxima possível, jogando o mais forte e o mais fraco em lados opostos. Todo mundo precisa clicar em Ready; quem não clicar cai fora, e o resto volta para a queue sem perder o lugar.
Cada time ganha um canal de voz próprio, então dá para combinar a tática sem o adversário ouvir — você só enxerga e entra no canal do seu time. Os dois canais somem quando o match é encerrado. O resultado só é registrado quando a maioria de cada time vota nele (dois de três num 3v3), o que impede um time de decretar a própria vitória; qualquer divergência abre uma disputa para um validador resolver.
Times fixos
Um ranking de ELO ou League com times também pode rodar no modo fixed teams (a chave fica no painel, ao lado de Match format). Aí os times têm nome e são permanentes: cada um se inscreve uma vez pelo botão Team sign-up do ranking — escolha o nome e monte o elenco, que pode ter até dois reservas além do tamanho do time. A classificação passa a ser dos times: num ranking de ELO cada time tem seu próprio rating e derrubar um time mais forte rende mais; num ranking de League a tabela ordena os times por pontos, igualzinho a um campeonato de verdade. Times fixos de League registram os matches com /submit — a queue de matchmaking abaixo é só para ELO.
Quando qualquer integrante clica em Queue, o time inteiro entra na queue e todo mundo recebe uma DM. O sistema junta time contra time pelo rating de cada um, e o ready-check já serve de escalação: jogam os primeiros de cada elenco a clicar em Ready, até completar o tamanho do time, e o resto fica de fora naquele match. Quem jogou é quem vota no resultado, com a mesma regra de maioria de cada lado.
O tipo League classifica os jogadores pelos pontos somados ao longo dos matches. É o formato certo para futebol, basquete, futsal, hóquei e qualquer competição 1v1 ou por times em que a tabela da season é o que vale.
Como funciona
- Registre um match com
/submit— o bot pede os dois lados e o placar de cada um (ex.: 3 e 1). - Quem marca mais vence; placar igual é empate.
- O lado vencedor leva points_win, o perdedor leva points_loss e, no empate, todo mundo leva points_draw. Em liga por times, cada jogador recebe os pontos do lado dele.
- O ranking ordena por total de pontos; vitórias, empates e derrotas são contados à parte.
Pontuação padrão
Ligas novas já vêm com 3 / 1 / 0 (o padrão da FIFA desde 1994). Os três valores são configuráveis em cada ranking pelo painel. Use 2 / 1 / 0 para hóquei, 4 / 2 / 0 para rúgbi ou o que fizer sentido no seu esporte.
Registrando um match
Pelo site, abra o ranking e clique em Submit — informe os dois lados e o placar. O comando /submit abre o mesmo formulário no Discord. Match de um jogador contra ele mesmo e placar negativo são recusados na hora do envio.
Ligas por times
Um ranking de League pode ter tamanho de time fixo, de 2v2 até 8v8, definido na criação ou depois em Match format, no painel. A tabela continua individual: cada jogador do lado vencedor leva os pontos de vitória, o lado perdedor inteiro leva os pontos de derrota, e o placar do match conta como gols a favor e contra para cada um deles.
Quer a tabela clássica de campeonato, com os times nas linhas? Ative Fixed teams ao lado de Match format: os times com nome se inscrevem pelo botão Team sign-up do ranking (o elenco pode levar até dois reservas), os matches são registrados time contra time com placar, e a tabela ordena os times por pontos.
Revisão e cancelamento
Matches de League passam pela mesma revisão dos matches de ELO: um validador aprova ou recusa cada envio, os pontos entram na aprovação, e um match já aprovado pode ser cancelado depois — o que devolve exatamente os pontos que tinham sido dados.
O tipo Rating deixa a galera do server enviar imagens e avaliar as dos outros com estrelas.
Como funciona
- As imagens são enviadas com
/submit— anexe a imagem ao comando e digite um nome no formulário. - Os envios aparecem no canal escolhido, com um menu de avaliação.
- Qualquer pessoa pode dar de 1 a 10 estrelas. As notas viram uma média.
- Dá para mudar o voto quando quiser — mas é um voto por pessoa em cada envio.
- O ranking ordena os envios pela nota média.
Avaliando pelo site
No site, os envios ficam na aba Entries. Clique em qualquer um para ver a imagem inteira e dar a sua nota nos botões de estrela. Seus votos ficam salvos de uma visita para a outra.
Você decide quem vê os seus rankings no site do Scoreboards:
Qualquer pessoa vê no site.
Só quem é membro do seu server do Discord vê (precisa entrar na conta).
Só quem tem um cargo específico do Discord vê.
Não aparece no site de jeito nenhum.
Entregue cargos do Discord automaticamente conforme a posição no ranking. Dá para dar um cargo "Campeão" para o top 3, "Veterano" da 4ª à 10ª posição, e por aí vai.
- Os tiers são configurados no painel web, dentro das configurações de cada ranking.
- Escolha como o tier é definido: por posição (da 1ª à 3ª), por percentil (os 10% melhores) ou por pontuação (todo mundo com 2000 pontos ou mais). Todos os tiers de um ranking usam o mesmo modo.
- Aponte para cada tier qualquer cargo que já exista no server.
- Os cargos entram e saem sozinhos conforme a classificação muda.
- O cargo do Scoreboards precisa estar acima de todos os cargos que ele distribui, em Server Settings → Roles. O Discord não deixa bot mexer em cargo no mesmo nível ou acima do dele, e o bot avisa no canal do ranking se esbarrar nisso.
Já tem uma competição rolando em outro lugar? O /import lê um arquivo CSV e preenche o ranking com ele, sem você redigitar nada.
Dá para fazer de dois jeitos: no Discord, rode /import, escolha o ranking e anexe o arquivo; ou, no site, abra o painel, selecione um ranking e use Import from CSV. Ranking pessoal não tem server do Discord, então nesse caso o caminho é o painel. Nos dois jeitos o arquivo é o mesmo — um <arg>name,score</arg> por linha:
name,score Alex,120 "Cooney, EM",95 Sam,88
- Linha de cabeçalho é detectada e ignorada automaticamente.
- Vírgula, ponto e vírgula e tabulação funcionam como separador — do jeito que a sua planilha exportar.
- Nome com vírgula funciona, desde que venha entre aspas, tipo <arg>"Cooney, EM"</arg>.
- Se o nome for um id de usuário do Discord, a entrada é vinculada ao membro e mostra o nome de exibição dele. O resto vira entrada personalizada.
- Nome repetido fica com o último valor, então dá para reimportar um arquivo corrigido.
- Linhas ilegíveis são puladas e listadas pelo número da linha — o resto entra normalmente, então você conserta uma ou duas e roda de novo.
Tempos aceitam <arg>mm:ss</arg>, <arg>hh:mm:ss</arg> e, se quiser, uma fração: <arg>1:30</arg>, <arg>1:12:44.081</arg>. Um número solto é lido como milissegundos. Atenção: três números separados por dois-pontos significam <arg>hours:minutes:seconds</arg>, então a precisão abaixo de um segundo vem depois de um ponto.
Limites: 500 linhas e 100 KB por arquivo — se a exportação for maior, divida e importe em partes. Rankings de Image Rating não podem ser importados, porque as entradas deles são imagens enviadas, e não pontuações.
As seasons servem para encerrar um ciclo e recomeçar sem apagar o que já aconteceu. Rode /scoreboard season end e, depois de confirmar, a classificação final é arquivada, um pódio é publicado no canal do ranking e o ranking é zerado para a season seguinte.
- Rankings de ELO mantêm os jogadores e devolvem todo mundo ao rating inicial — ranking de ELO sem ninguém dentro não é ranking.
- Rankings Classic, Highscore, Time e League são esvaziados, porque pontuação zerada não é uma entrada de verdade.
- Rankings de Image Rating não têm season — zerar apagaria as imagens enviadas.
- As classificações arquivadas ficam guardadas para sempre, mesmo que o ranking seja zerado de novo mais adiante.
Os resumos semanais publicam um apanhado curto no canal do ranking toda segunda-feira: o top 3, quem mais subiu na semana e o quanto se jogou. Só entram rankings com pelo menos três scores nos últimos sete dias, então ranking parado continua quieto. Dá para desligar os resumos em cada ranking pelo /scoreboard settings ou pelo painel do site.