Comandos Personalizados

O que é esta página

Chat Bot → Comandos de Chat é onde ficam os comandos de texto personalizados; a própria página tem o cabeçalho Comandos Personalizados, "Gerir comandos de texto personalizados para o chat". Um comando é um gatilho que o chat digita e uma resposta que o bot escreve de volta, com variáveis substituídas nela.

Como configurar

A página tem dois separadores, Comandos e Variáveis, cada um com a sua contagem entre parênteses. O botão no canto superior direito segue o separador em que está — Adicionar Comando ou Adicionar Variável.

Um comando

1. Abra Chat Bot → Comandos de Chat, mantenha-se no separador Comandos e pressione Adicionar Comando. O formulário tem o título Criar Comando.
2. Nome do comando (para você) — um título que reconhecerá na lista, e espaços são permitidos: "O meu servidor do Discord". As maiúsculas são mantidas como digitadas. Um nome de uma palavra serve também como gatilho no chat; um nome com espaços não pode ser digitado, por isso tal comando precisa de pelo menos um gatilho e guardar sem um é recusado.
3. Gatilhos que os espectadores digitam (separados por vírgula) — as palavras que disparam o comando, o marcador de posição mostra o formato: discord, ds. O primeiro é o principal — é o que a lista {commands} mostra — enquanto o comando responde a todos eles. As maiúsculas também são mantidas aqui, e um gatilho idêntico ao nome não é mostrado duas vezes no cartão.
4. Modo de Ativação — A mensagem começa com !comando, ou Palavra em qualquer lugar da mensagem. O segundo é marcado no cartão com um distintivo palavra-chave.
5. Resposta do Comando — o que o bot escreve, por exemplo "Junta-te ao nosso servidor, {user}!". Por baixo do campo está "Clique numa variável para a inserir na resposta:" e uma linha de chips — {user}, {target}, {args}, {count}, {random:1-100}, {choose:a|b|c}, {randuser}, {time}, {date}, {math:}, {repeat:3:}. Um clique coloca um no cursor. Três separadores ficam acima da linha — Integrados, Seus e Base de Conhecimento — para que as suas próprias variáveis e os seus links de referência também estejam a um clique.
6. Tempo de Espera (seg) começa em 10, Tempo de Espera por Utilizador (seg) em 0. Por baixo deles está a marca Moderadores e streamer ignoram o tempo de espera.
7. Funções Permitidas — Todos, Subscritor, VIP, Moderador, Transmissor. Todos estão marcados num novo comando, e não marcar nenhuma também guarda como Todos.
8. Responder apenas quando — uma condição, Sempre por predefinição. A secção abaixo explica-a.
9. Pressione Guardar, ou Cancelar. Sem um nome e uma resposta o formulário responde "Preencha o nome do comando e a resposta!" e permanece aberto.
10. Um cartão tem como cabeçalho apenas o nome do comando, com o distintivo das funções ao lado e um distintivo de condição quando há uma. A linha por baixo contém os aliases, a cores e com o seu !, seguidos da resposta; depois vêm o tempo de espera, o tempo de espera por utilizador e quantas vezes foi disparado. Um alias idêntico ao nome não é mostrado duas vezes. O interruptor desliga o comando sem o eliminar; ao lado estão Editar e Eliminar, e eliminar pergunta "Eliminar este comando?".

Uma variável sua

1. Mude para o separador Variáveis e pressione Adicionar Variável — o formulário é Criar Variável.
2. Nome da Variável — apenas letras, dígitos e _; o campo converte para minúsculas o que digita e remove o resto. A dica por baixo mostra o resultado: "Usado nas respostas como {nome}".
3. Valores (um por linha) — o marcador de posição mostra três linhas, pizza, sushi, hambúrguer. "Um valor aleatório da lista é inserido quando o comando é disparado".
4. Pressione Guardar. Um nome repetido é recusado com "Já existe uma variável com este nome!", um formulário incompleto com "Forneça um nome e pelo menos um valor!".
5. O cartão mostra {nome}, quantos valores contém e os próprios valores. Eliminar avisa primeiro: "Eliminar esta variável? Os comandos que a usam deixarão de a substituir."

Responder apenas por vezes

Responder apenas quando contém uma condição, e Sempre — sem condição — é o que um novo comando obtém.

• A jogar um destes jogos — aparece um campo Jogos (separados por vírgulas). Parte de um nome é suficiente e as maiúsculas/minúsculas não importam, por isso gta corresponde a "GTA V" e "GTA Online". As plataformas escrevem o mesmo jogo de forma diferente, por isso liste todas as grafias — GTA, Grand Theft Auto — e qualquer uma delas corresponder é suficiente. A categoria é lida de todas as plataformas que estão atualmente ao vivo.
• Há um leilão a decorrer — enquanto o módulo de leilão tem um leilão ativo, pausado ou bloqueado.
• A stream está ao vivo / A stream está offline — o estado da stream conforme o módulo Estado da Stream reporta.

Responder quando a condição não se verificar é a segunda resposta. Usa as mesmas variáveis e links de referência — e a sua própria linha de chips, por isso um clique aí cai nesse campo e não no de cima. "Não há leilão de momento — o próximo é na sexta-feira!" é uma resposta completa. Deixe-a vazia e o comando não diz nada; um comando silencioso não gasta o seu tempo de espera, por isso o próximo espectador que perguntar no momento certo ainda obtém uma resposta.

Guardar uma condição de jogo com o campo de jogos vazio é recusado: a condição nunca corresponderia e o comando ficaria silencioso para sempre.

Links de referência e regras de leilão

Mais duas coisas podem ser colocadas numa resposta e são mantidas num só lugar em vez de serem reescritas.

• {discord}, {boosty} e qualquer outro nome da Base de Conhecimento na barra lateral. Mude o link lá e todos os comandos seguem. Nomes que não conhece são deixados como estão, {discord}, por isso um erro de digitação é visível em vez de silencioso. O separador de chip Base de Conhecimento por baixo do campo de resposta lista-os todos — não há nada para memorizar.
• {auction_rules} — a descrição escrita nas definições do leilão, o mesmo texto que os espectadores veem.

As chavetas são simples, como qualquer outra variável. Chavetas duplas {{...}} ainda funcionam — essa era a grafia mais antiga, e os textos antigos continuam a funcionar. As variáveis integradas são lidas primeiro, por isso uma referência chamada time não irá sobrepor a variável {time}; apenas evite nomear links com nomes de variáveis.

A referência

Referência de Variáveis no topo abre Variáveis Disponíveis — todas as variáveis integradas com o seu significado e um exemplo prático: {display_name}, {user.id}, {touser}, {args:0|default}, {count+10}, {channel} e o resto, com as suas próprias no final da lista.

O que não pode fazer

• {channel} é o canal onde a mensagem foi escrita, por isso numa stream multi-plataforma difere por chat: o seu nome da Twitch na resposta da Twitch, o seu nome do Kick na do Kick. Cada plataforma escreve-o à sua maneira — o Kick não tem nome de exibição, apenas o identificador com que iniciou sessão — por isso não espere que os três correspondam exatamente.
• {randuser} escolhe entre espectadores que escreveram nesse chat na última meia hora, não entre todos os que estão a assistir: apenas a Twitch oferece uma lista de pessoas presentes, e mesmo essa é reduzida, enquanto o YouTube e o Kick não oferecem nenhuma. Cada plataforma mantém a sua própria lista, por isso uma resposta na Twitch nunca marca um espectador do YouTube. Logo após a aplicação iniciar a lista está vazia e a variável recua para a pessoa que executou o comando; uma mensagem no chat preenche-a. As próprias mensagens do seu bot são excluídas.
• Um comando responde com texto no chat. Som, sobreposições e qualquer outra ação não fazem parte desta página.
• Os comandos não são direcionados a uma plataforma ou a um canal específico: uma lista serve o chat.
• A lista não tem pesquisa, ordenação nem arrastar para reordenar — os cartões mantêm-se na ordem em que foram criados.
• Uma variável personalizada é uma lista para escolher uma linha aleatoriamente. Não mantém um valor por espectador, nenhum contador e nenhuma aritmética.
• Os tempos de espera são contados em segundos, por comando e por espectador. Não há limite diário, e a única exceção por função é a marca Moderadores e streamer ignoram o tempo de espera.
• Um comando tem uma condição, não várias combinadas. Não há condição por hora do dia e nenhuma por contagem de espectadores.