Pular para o conteúdo

Gatilhos e prefixos

Um comando personalizado começa com o prefixo do servidor, ! por padrão: !hello. Um comando também pode ter o seu próprio gatilho, para que as pessoas o iniciem de outra forma:

!customcommand trigger <nome> <tipo> [texto]
Tipo Começa quando… Exemplo Mensagem que o inicia
command A mensagem começa com o prefixo do Petto e o nome. É o padrão !hello
prefix A mensagem começa com o seu próprio prefixo e o nome !customcommand trigger hello prefix ? ?hello
startswith A mensagem começa com algumas palavras !customcommand trigger hi startswith hey bot hey bot, tudo bem?
exact A mensagem é exatamente algumas palavras !customcommand trigger gm exact bom dia bom dia
contains A mensagem tem algumas palavras dentro !customcommand trigger pizza contains pizza Quero pizza!

Sem um tipo, !customcommand trigger <nome> mostra como o comando começa agora.

  • Maiúsculas e minúsculas não importam: Bom Dia combina com bom dia.
  • Uma palavra nunca é cortada no meio: pizza combina com Eu amo pizza! mas não com pizzas nem unpizza.
  • Os argumentos são o que vem depois do gatilho. Para ?hello big world, .Args é ["big", "world"]. Para contains, .RawArgs é a mensagem inteira.
  • Um comando com gatilho próprio não é iniciado também pelo prefixo do Petto. Definir command volta a isso.
  • Um prefixo tem até 5 caracteres sem espaços, como ?, >> ou .. Os outros textos têm até 50 caracteres. Um gatilho não pode conter uma menção.
  • Se dois comandos puderem combinar com a mesma mensagem, roda o primeiro por nome (ordem alfabética). Só um comando roda por mensagem.
  • Um prefixo mais um nome não pode ser o nome de um comando real do Petto.

Um servidor pode ter até 25 comandos com um gatilho próprio. Cada pessoa pode usar cada comando uma vez a cada 2 segundos, então um gatilho contains não serve para inundar um canal.

  • Use prefix para fazer comandos que pareçam o seu próprio bot: ?roll, >>shop.
  • Use exact para cumprimentos e frases curtas, e contains com moderação: ele lê todas as mensagens do servidor.
  • O código pode saber como começou: .Cmd é o nome do comando e .Prefix é o prefixo que o iniciou (vazio para startswith, exact e contains).