Petto Code

​

Visão geral

{{ sendMessage nil (cembed
  "author" (or .Member.DisplayName .User.Username)
  "authorIcon" .User.Avatar
  "description" (printf "Welcome to **%s**!" .Guild.Name)
  "color" "#ff91c2") }}

​

O que dá para fazer

• Embeds e mensagens com campos, cores, imagens e o avatar ao lado do autor.
• Botões e menus que executam código (votações, botões de cargo, lojas).
• Formulários que aparecem na tela (modais) com campos de texto.
• Reações que executam código: uma mensagem com reações que mudam a mensagem, dão ou tiram um cargo ou respondem no canal.
• Dados salvos: contadores, pontos, rankings, intervalos e listas, para o servidor ou para cada membro.
• Seu próprio prefixo ou palavras: comece um comando com ?hello, hey bot ou good morning.
• Membros, cargos e canais: leia um membro, um cargo ou um canal do servidor, para cartões como !whois e !roleinfo.
• Comandos que trabalham juntos: um comando pode executar outro com execCC, com um atraso e alguns dados.

​

Trabalhando com outros comandos

​

Executar outro comando

{{ execCC "give" }}
{{ execCC "remind" 300 }}
{{ execCC "give" 0 (sdict "item" "rose" "price" 50) }}

• O nome do outro comando. Um prefixo na frente (!give) é ignorado, e maiúsculas ou minúsculas não fazem diferença.
• Um atraso em segundos, de 0 a 300 (5 minutos). Com 0, o outro comando é executado logo depois que este termina e o Petto faz as ações dele. Os comandos em espera ficam na memória, então se o Petto reiniciar ele esquece os que ainda não tinham sido executados.
• Dados: qualquer valor (um texto, um número, uma lista ou um mapa). Em JSON, pode ter no máximo 2.000 caracteres.

Exemplo: um comando !buy que chama um comando give

buy cobra as moedas e pede a give que entregue o item:

buy

{{ $prices := sdict "rose" 50 "cake" 120 }}
{{ if not .Args }}Use: {{ .Prefix }}{{ .Cmd }} rose (50 coins) or cake (120 coins){{ return }}{{ end }}
{{ $item := lower (index .Args 0) }}
{{ $price := index $prices $item }}
{{ if not $price }}There is no {{ $item }} in the shop.{{ return }}{{ end }}
{{ $coins := or (dbGet "coins" .User.ID) 0 }}
{{ if lt $coins $price }}You have {{ $coins }} coins, a {{ $item }} costs {{ $price }}.{{ return }}{{ end }}
{{ $left := dbIncr "coins" (sub 0 $price) .User.ID }}
You paid {{ $price }} coins for a **{{ $item }}**. You have {{ $left }} left.
{{ execCC "give" 0 (sdict "item" $item "price" $price) }}

give só funciona quando outro comando o executa, e conta os itens de cada membro:

give

{{ if ne .Trigger "exec" }}This command is used by other commands, like {{ .ServerPrefix }}buy.{{ return }}{{ end }}
{{ $item := .ExecData.item }}
{{ $count := dbIncr (print "item:" $item) 1 .User.ID }}
{{ sendMessage nil (cembed
  "title" "🎁 Delivered"
  "description" (printf "%s now has %d × %s (from %s)." .User.Mention $count $item .ExecBy)
  "color" "#57f287") }}

!buy rose responde You paid 50 coins for a rose. You have 70 left., e depois give envia @Liam now has 1 × rose (from buy).

​

Problemas dos comandos

​

Quem usou o comando

{{ if eq .Trigger "command" }}
  {{ sendMessage nil (complexMessage
       "embed" (cembed "description" (print .User.Mention " asks for: " .RawArgs))
       "reactions" (cslice "🎀")) }}
{{ return }}{{ end }}
{{ if ne .Message.CommandUserID .User.ID }}{{ removeReaction }}{{ return }}{{ end }}
{{ updateMessage (cembed "description" "Delivered!" "color" "#57f287") }}

​

Você quis dizer, e dicas

• Uma função que não existe mostra a que você provavelmente quis usar: Não existe nenhuma função chamada "dbget". Você quis dizer dbGet?
• !customcommand codetest, !customcommand info e a verificação e o teste do dashboard dão dicas: funções que não existem e nomes que não estão nos dados (.User.Usrname, Você quis dizer .User.Username?), mesmo em uma parte do código que não foi executada. Ler um nome que não existe continua dando nada, não é um erro.
• codeshow, export e info mostram o comando mais parecido quando o nome tem um erro de digitação: !customcommand codeshow gret responde Você quis dizer greet?

Uma função que não existe

Um nome que não está nos dados

Um nome de comando com erro

​

Gerenciando seus comandos

• !customcommand codetest aceita argumentos depois do bloco de código: um bloco e depois red "big cat" testa o código como se red "big cat" tivesse sido digitado depois do comando. Ele descreve cada mensagem que enviaria (o texto, o embed, os botões e menus e as reações) e cada ação, as dicas, e os passos e o tempo usados. Código sem bloco é todo código, como antes.
• !customcommand info <name> diz o que é um comando: texto ou código, como ele começa, o tamanho (dos 10.000 caracteres de código), quem o escreveu, as funções que usa e se usa dados salvos, botões, menus, reações, formulários, cargos, mensagens diretas, membros do servidor ou outros comandos.
• !customcommand list mostra uma página por vez, em ordem de nome, com o que cada comando é (código ou texto), como é digitado e o tamanho dele.
• !customcommand codeshow mostra o código em um bloco que colore as ações {{ }}.
• !customcommand rename <name> <new name> muda o nome e mantém o código, o gatilho (o prefixo próprio também, então .req1 vira .req) e os dados salvos. Um nome que é um comando real do Petto ou outro comando personalizado é recusado. As mensagens que o comando enviou antes, com botões ou reações, mantêm o nome antigo e param de responder.
• !customcommand trigger <name> sem um tipo mostra como o comando começa e os comandos para mudar isso. Avisa quando nada muda, e qual era o prefixo antes quando muda.
• Ao salvar um comando, o Petto avisa quando o primeiro comentário diz que ele é usado com um prefixo próprio (como {{/* req: .req <what you ask> */}}) e o comando não o tem, e dá o comando que o define.

!customcommand codetest

!customcommand info

!customcommand list

!customcommand codeshow

!customcommand rename

!customcommand trigger

Ao salvar: um prefixo próprio

​

Novidades no Petto Code

​

Novas funções

• Texto: joinStr, trimPrefix, trimSuffix, trimSpace, inFold, capitalize, repeat, truncate, padLeft, padRight, count, indexOf, reverse, urlescape, urlunescape, escapeMarkdown, formatNumber, toString, toLower e toUpper.
• Números: fdiv, sqrt, cbrt, log, roundCeil, roundFloor, roundEven, clamp e toInt64.
• Tempo: currentTime, toDuration ("1h30m" em segundos), humanizeTimeSince, snowflakeToTime, newDate, formatTime (um formato e um fuso horário) e weekday.
• Listas e mapas: sort, sortBy, uniq, first, last, sum, randItem, concat, hasKey, setKey, delKey, merge, values, kindOf, json e parseJson.
• IDs: userID, roleID e channelID tiram o ID de uma menção.

{{ capitalize "petto" }} has {{ formatNumber 1234567 }} coins.
{{ joinStr ", " (sort (cslice "pear" "apple" "fig")) }}
{{ toDuration "1h30m" }} seconds

​

Membros, cargos e canais

{{ with .Mentions }}
  {{ $m := getMember (index . 0).ID }}
  {{ if $m }}{{ $m.DisplayName }} is here.{{ end }}
{{ end }}

​

Rankings

• dbRank dá a posição de um membro em um ranking, como o de moedas.
• dbBottom dá os números mais baixos, de 1 a 25 membros (como dbTop, mas de baixo para cima).
• dbCount diz quantas chaves estão salvas.

{{ with dbRank "coins" .User.ID }}You are **#{{ . }}**.{{ else }}No coins yet.{{ end }}

​

Ações

• deleteTrigger e o novo deleteResponse aceitam um atraso de até 5 minutos (em segundos). deleteResponse apaga a resposta do comando, 10 segundos depois se você não der um atraso. Só funciona quando o comando é digitado, não em um botão, menu, formulário ou reação.
• addReactions adiciona várias reações de uma vez (até 5).
• complexMessage aceita "reply" true (a mensagem responde à mensagem do comando) e "silent" true (sem notificação).

Saved!{{ deleteTrigger 5 }}{{ deleteResponse 10 }}
{{ sendMessage nil (complexMessage "content" "Got it." "reply" true "silent" true) }}

​

Formulários com todas as partes

{{ showModal (cmodal "id" "about" "title" "Sobre você" "fields" (cslice
  (cdisplay "Leva só um minuto.")
  (ctext "id" "name" "label" "Nome" "description" "Como chamamos você")
  (cmenu "id" "color" "label" "Cor favorita" "options" (cslice (cslice "Rosa" "pink") (cslice "Azul" "blue")))
  (cusers "id" "friends" "label" "Amigos" "max" 3 "required" false)
  (cfile "id" "photo" "label" "Uma foto" "required" false)
  )) }}

• .Fields.<id>: um texto (ctext, cradio), uma lista de valores (cmenu, cchecks), uma lista de IDs (cusers, croles, cmentions, cchannels), true ou false (ccheck) ou uma lista de arquivos (cfile, cada um com ID, Name, URL, Size, Type e Description).
• .FieldText.<id>: o mesmo, pronto para imprimir: IDs como menções, listas unidas, ✅ ou ❌, os links dos arquivos.
• .Files: todos os arquivos do formulário em uma lista.

{{ sendMessage nil (cembed "title" (index .FieldText "name") "description" (print "Cor: " (index .FieldText "color") "\nAmigos: " (or (index .FieldText "friends") "-"))) }}

​

Novos dados

• .Mentions (os usuários mencionados, com nome e avatar), .MentionedRoles e .MentionedChannels.
• .ServerPrefix, .Now e .User.CreatedAt.
• Mais de .Member: Avatar, Color, HighestRoleID, BoostingSince e IsOwner.
• Mais de .Guild: OwnerID, CreatedAt, BoostCount, BoostTier, Banner, Description, RoleCount, ChannelCount e EmojiCount.
• Mais de .Channel: Topic, NSFW, ParentID, Type e IsThread.
• Mais de .Message: CreatedAt, Attachments e ReplyToID.

​

Novos modelos

• whois: um cartão do membro que você mencionar, ou seu. !whois @Liam
• roleinfo: a cor, os membros e a data de criação de um cargo. !roleinfo @Cargo
• rank: sua posição no ranking de moedas, ou a posição do membro que você mencionar.

!customcommand template whois
!customcommand template rank

!customcommand template whois

!whois

!roleinfo

!rank

​

Comandos

!customcommand code <name> <code>
!customcommand codeshow <name>
!customcommand codetest <code> [arguments]
!customcommand info <name>
!customcommand list
!customcommand rename <name> <new name>
!customcommand logs [name]
!customcommand template [id] [name]
!customcommand export <name>
!customcommand import <share code> [name]
!customcommand trigger <name> [type] [text]

!customcommand code hello Hello {{ .User.Username }}!
!customcommand template vote
!customcommand trigger hello prefix ?
!customcommand rename req1 req
!customcommand logs give

!customcommand code

!customcommand template

!customcommand template vote

!customcommand export

!customcommand import

!customcommand trigger

• O código é verificado antes de ser salvo. Um erro mostra a linha e a coluna, e nada é salvo.
• codetest executa o código como se você tivesse usado o comando e mostra o que ele imprimiria e faria. Nada é enviado nem salvo.
• template lista comandos prontos (votação, pedido, reivindicar, sugestão, denúncia, perfil, botão de cargo, cargo por reação, whois, roleinfo, rank e mais) e instala um deles.
• export dá um código de compartilhamento que funciona em qualquer servidor, e import usa um.
• Gatilhos: prefix, startswith, exact, contains ou command (o prefixo do Petto). Um servidor pode ter até 25 comandos com gatilho próprio.

​

Editor do dashboard

​

Gerador de Petto Code

​

Limites e segurança