Pular para o conteúdo
Guia 05

Contadores

Acompanhe tudo que acontece mais de uma vez: mortes, abraços, resgates de recompensas. Escolha uma vez como cada coisa é contada, e o bot se lembra para sempre.

Neste guia
8 min de leitura

01Os contadores: números que lembram

em um relanceUm único marcador, {counter:name}, soma 1 e mostra o total. A contagem sobrevive a cada transmissão.

Um contador é um número com nome que o bot guarda de uma transmissão para a outra. Escreva {counter:mortes} na resposta de um comando e, a cada uso, o bot soma 1 a um contador chamado «mortes» e mostra o novo total direto na resposta. Sem planilha, sem contagem manual, só um marcador.

Dois usos do mesmo comando !mort, um único contador que guarda os dois.
Os contadores precisam dos Pontos de fidelidade Os contadores são guardados pelo módulo Pontos de fidelidade. Ative-o primeiro, senão {counter:…} continua sendo texto literal no chat.

02Quatro formas de contar

em um relanceCanal inteiro, por espectador, por comando, ou os dois. Escolha uma na criação; ela fica definida.

Cada contador tem exatamente um escopo, escolhido no momento da criação, e ele continua o mesmo pela vida inteira do contador. O escopo responde a uma só pergunta: a quem pertence este número?

EscopoPalavra-chaveO que é contado
Canal inteiro(padrão)Um único total compartilhado, todos somam no mesmo número.
Por espectadoruserCada espectador tem o próprio número.
Por comando ou recompensacommandUm total compartilhado para um único comando ou recompensa, com todos os espectadores somados.
Por espectador + comando ou recompensauser+commandCada espectador tem um número separado para cada comando ou recompensa.

Canal inteiro

Todo mundo avança o mesmo número compartilhado. Perfeito para uma contagem que pertence à própria transmissão, e não a um espectador específico, como um contador de mortes.

Não importa quem digite !mort, o total do canal continua subindo.

Por espectador

Cada espectador tem um número privado, em que ninguém mais mexe. Ideal para séries pessoais: quantos abraços alguém já deu, quantas vezes ele venceu você em um jogo.

Mesmo comando, dois espectadores, duas contagens totalmente separadas.

Por comando ou recompensa

O escopo mais recente: um único total compartilhado para um comando ou uma recompensa de pontos do canal, em que cada espectador soma no mesmo número. Ideal para «quantas vezes essa recompensa específica foi resgatada, no total?»

Dois espectadores diferentes, o total da recompensa continua subindo mesmo assim.

Por espectador + comando ou recompensa

Combina os dois: cada espectador tem um número separado para cada comando ou recompensa que compartilha este contador. Vincule um mesmo contador a dois comandos e cada espectador terá uma contagem por comando, não uma única contagem compartilhada entre os dois.

A contagem de MikanMeerkat para !calin e a dele para !highfive não se misturam, mesmo com o mesmo contador.
Definido na criação O escopo de um contador não pode mudar depois. Escolheu errado? Exclua-o (!counter delete nome, ou pelo painel) e crie de novo; os valores antigos não são mantidos.

03Gerenciar contadores pelo chat

em um relanceCriar, adicionar, definir, zerar, excluir ou simplesmente consultar, sem sair do chat.

Você e seus moderadores podem criar e gerenciar contadores sem sair do chat, tudo com !counter:

ComandoO que faz
!counter create <nome> [escopo]Cria um contador. A palavra de escopo é user, command ou user+command; omita-a para o canal inteiro.
!counter add <nome> [valor]Soma 1, ou o valor informado. Números negativos subtraem.
!counter set <nome> <valor>Define o total diretamente.
!counter reset <nome>Zera o contador. Para um contador por espectador ou por comando, isso apaga todas as contagens guardadas.
!counter delete <nome>Exclui o contador por completo.
!counter listLista todos os contadores do canal e o escopo de cada um.
!counter <nome>Mostra o valor atual, como ele aparece no chat.
Criar e avançar um contador do início ao fim, sem tocar no painel.
Escopo «por comando», pelo chat !counter create hidratações command cria um contador agrupado por comando em uma linha, pronto para encaixar na resposta de um comando, ou para vincular a uma recompensa de pontos do canal, como {counter:hidratações}.
Experimente: avance o contador

04O painel e as recompensas de pontos do canal

em um relanceA página Contadores para controle direto, e como uma recompensa se vincula a ela.

A página Contadores lista todos os contadores do seu canal e permite criá-los, ajustá-los e excluí-los clicando, em vez de digitando.

  • Nome: o mesmo texto que você digitaria em {counter:…}.
  • Contagem: o escopo. Definido na criação.
  • Um lembrete em linguagem simples de onde os contadores podem ser avançados.
Painel «novo contador»: dê um nome, escolha um escopo, pronto. As linhas existentes têm botões +/- para os contadores do canal inteiro, ou uma tabela de valores para os outros.

Vincular um contador a uma recompensa de pontos do canal

Cada recompensa de Pontos do canal pode manter o próprio contador, direto no editor da recompensa: digite um nome de contador (novo ou existente), escolha o escopo, e cada resgate o avança. Use {counter} na resposta de chat da recompensa para mostrar o novo total.

  • Desativado por padrão, a maioria das recompensas não precisa dele.
  • Por espectador + recompensa costuma ser a escolha certa: cada espectador monta a própria contagem de resgates dessa recompensa.
O bloco de contador do editor de recompensa: um interruptor, um nome e os mesmos quatro escopos.
Experimente no construtor O construtor de comandos pode guiar você para dar nome a um contador e escolher o escopo, e depois devolve o marcador {counter:…} pronto. Abrir o construtor de comandos