Escrever comandos

Os comandos personalizados em código são gerenciados com !customcommand (ou !cc). Você precisa da permissão Gerenciar servidor. Também pode escrevê-los no editor do painel, que verifica o seu código enquanto você escreve.

Qualquer pessoa que possa gerenciar comandos pode escrevê-los. Um servidor Free pode ter até 50 comandos personalizados, um Premium até 100.

Escrever um comando

!customcommand code hello Olá {{ .User.Username }}!

Para código de várias linhas, coloque-o dentro de um bloco de código. As linhas são mantidas exatamente como você as escreveu:

!customcommand code roll ```
{{ $sides := 6 }}
{{ if .Args }}{{ $sides = toInt (index .Args 0) }}{{ end }}
🎲 Você tirou {{ add 1 (randInt $sides) }}!
```

• O nome tem de 1 a 32 letras, números, - ou _, e não pode ser o nome de um comando real.
• O código é verificado antes de ser salvo. Se tiver um erro, nada é salvo e você é informado da linha e da coluna.
• Escrever um comando com um nome que já existe o altera.
• Um servidor pode ter até 100 comandos personalizados, de qualquer tipo.

Agora qualquer pessoa no servidor pode usar !roll ou !roll 20.

Testar código sem salvá-lo

!customcommand codetest {{ sendMessage nil "oi" }}{{ addRole "223456789012345678" }}

codetest executa o código como se você tivesse usado o comando, e mostra o que ele imprimiria e o que faria. Nada é enviado, nenhum cargo é dado, nada é salvo. Use quantas vezes quiser enquanto escreve.

Ver o código de um comando

!customcommand codeshow roll

Se o código for longo, ele vem em um arquivo.

Templates

!customcommand template            lista os comandos prontos
!customcommand template roll       instala "roll" com o nome sugerido
!customcommand template roll dice  instala com o nome "dice"

Veja Templates. Depois de instalar um, altere-o com !customcommand code <nome>.

Compartilhar um comando

!customcommand export roll

dá um código de compartilhamento que começa com pc1.. Qualquer pessoa pode usá-lo em outro servidor:

!customcommand import pc1.eyJ2IjoxLC... dice

O nome no final é opcional: sem ele, usa-se o nome do código de compartilhamento. O código importado é verificado como qualquer outro. Veja o que você importa com codetest ou codeshow antes de usar, como com qualquer coisa que você copia de outras pessoas.

Gatilhos

!customcommand trigger hello prefix ?

faz com que hello também comece com ?hello. Veja Gatilhos e prefixos.

A lista

!customcommand list mostra cada comando personalizado, marca com (code) os escritos em código, e mostra o gatilho dos que têm um próprio.

Remover

!customcommand remove <nome> remove qualquer comando personalizado, em código ou não.

Quem vê um erro

Se o código de um comando falhar quando alguém o usar, o Petto responde no canal com o erro e a linha, e diz que um administrador do servidor pode corrigi-lo. Veja Erros.