01A anatomia de um comando
Um comando personalizado é uma pergunta que seus espectadores podem fazer
(!abraco) e a resposta que o seu bot dá. O editor tem oito campos;
só o nome e a resposta são obrigatórios.
- 01 Nome: o que os espectadores digitam depois do “!”. Minúsculas, uma palavra só.
- 02 Nomes alternativos: gatilhos extras para o mesmo comando (!abraco e !abracos podem ser um só comando).
- 03 Resposta: o que o bot diz. Até 5 linhas; cada linha é uma mensagem de chat própria.
- 04 O ensaio de chat encena sua resposta com valores de exemplo antes de você salvar. O criador de comandos tem o mesmo recurso.
- 05 Acesso e intervalos: quem pode usar, quanto tempo todos esperam após cada uso e quanto tempo cada espectador espera entre os próprios usos.
- 06 Somente ao vivo deixa o comando parado quando a live está offline; Ativo é o interruptor geral.
- 07 Fonte de dados: insere um valor buscado em uma das suas fontes de dados, em vez de uma variável.
{urlfetch:name}, um valor
tirado de uma fonte de dados que você mesmo salvou. O
guia de fontes de dados mostra como salvar a primeira.02Duas formas de criar um
Pelo painel
Acesse Comandos, clique em Novo comando, preencha o nome e a resposta e depois Criar. Ele costuma responder no chat em poucos segundos. A edição funciona do mesmo jeito: clique em qualquer comando, altere e salve.
Pelo chat, com !cmd
Você e seus moderadores também podem gerenciar comandos sem sair do chat, durante a live.
Qualquer moderador pode usar: !cmd não exige a promoção a moderador principal
que alguns outros comandos integrados pedem.
⚔ Ayshacinder !cmd add hype BORA, NÃO PARA 🎉
ItsBagelBot @Ayshacinder o comando hype foi adicionado
SnackPackPanda !hype
ItsBagelBot BORA, NÃO PARA 🎉
!cmd add <nome> <resposta>cria um comando.!cmd edit <nome> <resposta>substitui a resposta dele.!cmd remove <nome>apaga o comando.
03Variáveis: a parte inteligente
Escreva {user} em uma resposta, e o bot troca pelo nome de
quem executou o comando. Isso é uma variável: um marcador que o bot preenche no momento em que
responde. Cada variável que ele entende, com a sintaxe exata e um
exemplo prático, está na referência de variáveis.
Adicione uma barra vertical seguida de um texto dentro das chaves para dar algo a dizer à variável
quando ela voltar vazia: hug {touser|todo mundo}
dá um abraço na pessoa citada, ou em todo mundo quando ninguém é citado.
SnackPackPanda !hug
ItsBagelBot SnackPackPanda dá um abraço de bagel quentinho em todo mundo 🥯
SnackPackPanda !hug MikanMeerkat
ItsBagelBot SnackPackPanda dá um abraço de bagel quentinho em MikanMeerkat 🥯
04Várias linhas e ações de chat
Uma resposta pode ter até 5 linhas, e cada linha é enviada como uma mensagem própria, de cima para baixo. E uma linha que começa com um destes comandos vira uma ação nativa da Twitch em vez de uma mensagem comum:
| A linha começa com | O que acontece |
|---|---|
/me | Mensagem de “ação” em itálico, estilo IRC clássico. |
/announce | Um anúncio destacado da Twitch. Variantes de cor: /announceblue, /announcegreen, /announceorange, /announcepurple. |
/shoutout | Um shoutout nativo da Twitch para o primeiro nome da linha. |
/pin | Envia a mensagem e a fixa até o fim da live. |
SnackPackPanda !sorteio
anúncio · O sorteio está AO VIVO! Digite !enter para participar.
ItsBagelBot O vencedor será sorteado na hora cheia. Boa sorte! 🍀
{args},
{touser}) é higienizado antes de entrar na mensagem: ninguém
consegue enfiar um /ban ou um /timeout na saída do seu
comando.05As regras do jogo
O editor verifica tudo isso para você e diz o que está errado em palavras simples. Para referência:
| Campo | A regra |
|---|---|
| Nome | De 1 a 64 caracteres, sem espaços, e sem o “!” (o chat adiciona). Salvo em minúsculas: !Abraco e !abraco são o mesmo comando. |
| Nomes alternativos | Até 25, cada um seguindo as mesmas regras do nome. |
| Resposta | Até 5 linhas de 500 caracteres cada (uma mensagem de chat por linha). |
| Intervalo compartilhado | De 0 a 86400 segundos. É compartilhado por todo o chat: depois que alguém usa o comando, todos esperam. 0 desativa. |
| Intervalo por espectador | De 0 a 86400 segundos. Cada espectador espera esse tempo entre os próprios usos; os outros ainda podem executar o comando quando o intervalo compartilhado acabar. Os nomes alternativos contam como o mesmo comando. 0 desativa. |
| Acesso | Cargo mínimo, em ordem: todos, inscritos, VIPs, moderadores, moderadores principais, streamer. Cada nível inclui os de cima. |
| Restringir ao ID de usuário | Opcionalmente, vincula o comando a uma única conta da Twitch; isso substitui totalmente o nível de acesso. Perfeito para o comando pessoal de um amigo. O campo aceita apenas números: o ID de usuário da Twitch, e não o nome de usuário. Para descobrir um ID, use uma consulta de ID de usuário da Twitch em que você confie, ou uma ferramenta de moderação que mostre os IDs de usuário. |
06Evite digitar: o criador
Tudo neste guia está incorporado ao criador de comandos: escolha variáveis em uma lista explicada em vez de decorá-las, veja um ensaio de chat ao vivo enquanto digita e, quando estiver tudo certo, envie o comando para o seu painel, onde um clique confirma e cria. É o caminho mais curto entre a ideia e um comando que funciona.