Petto Code

​

Resumen

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

​

Qué puede hacer

• Embeds y mensajes con campos, colores, imágenes y el avatar junto al autor.
• Botones y menús que ejecutan código (votaciones, botones de roles, tiendas).
• Formularios que aparecen (modales) con campos de texto.
• Reacciones que ejecutan código: un mensaje con reacciones que cambian el mensaje, dan o quitan un rol, o responden en el canal.
• Datos guardados: contadores, puntos, rankings, tiempos de espera y listas, para el servidor o para cada miembro.
• Tu propio prefijo o palabras: empieza un comando con ?hola, oye bot o buenos días.
• Miembros, roles y canales: lee un miembro, un rol o un canal del servidor, para tarjetas como !whois y !roleinfo.
• Comandos que trabajan juntos: un comando puede ejecutar otro con execCC, con un retraso y algunos datos.

​

Trabajar con otros comandos

​

Ejecutar otro comando

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

• El nombre del otro comando. Un prefijo delante (!give) se ignora, y no importan mayúsculas ni minúsculas.
• Un retraso en segundos, de 0 a 300 (5 minutos). Con 0, el otro comando se ejecuta justo después de que este haya terminado y Petto haya hecho sus acciones. Los comandos en espera se guardan en memoria, así que si Petto se reinicia olvida los que todavía no se habían ejecutado.
• Datos: cualquier valor (un texto, un número, una lista o un mapa). Como JSON puede tener como máximo 2000 caracteres.

Ejemplo: un comando !buy que llama a un comando give

buy cobra las monedas y le pide a give que entregue el artículo:

buy

{{ $prices := sdict "rose" 50 "cake" 120 }}
{{ if not .Args }}Uso: {{ .Prefix }}{{ .Cmd }} rose (50 monedas) o cake (120 monedas){{ return }}{{ end }}
{{ $item := lower (index .Args 0) }}
{{ $price := index $prices $item }}
{{ if not $price }}No hay {{ $item }} en la tienda.{{ return }}{{ end }}
{{ $coins := or (dbGet "coins" .User.ID) 0 }}
{{ if lt $coins $price }}Tienes {{ $coins }} monedas, un {{ $item }} cuesta {{ $price }}.{{ return }}{{ end }}
{{ $left := dbIncr "coins" (sub 0 $price) .User.ID }}
Pagaste {{ $price }} monedas por un **{{ $item }}**. Te quedan {{ $left }}.
{{ execCC "give" 0 (sdict "item" $item "price" $price) }}

give solo funciona cuando otro comando lo ejecuta, y cuenta los artículos de cada miembro:

give

{{ if ne .Trigger "exec" }}Este comando lo usan otros comandos, como {{ .ServerPrefix }}buy.{{ return }}{{ end }}
{{ $item := .ExecData.item }}
{{ $count := dbIncr (print "item:" $item) 1 .User.ID }}
{{ sendMessage nil (cembed
  "title" "🎁 Entregado"
  "description" (printf "%s ahora tiene %d × %s (de %s)." .User.Mention $count $item .ExecBy)
  "color" "#57f287") }}

!buy rose responde Pagaste 50 monedas por un rose. Te quedan 70., y luego give envía @Liam ahora tiene 1 × rose (de buy).

​

Problemas de los comandos

​

Quién usó el comando

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

​

¿Quisiste decir?, y pistas

• Una función que no existe dice la que probablemente quisiste usar: No hay ninguna función llamada "dbget". ¿Quisiste decir dbGet?
• !customcommand codetest, !customcommand info y la revisión y la prueba de la dashboard dan pistas: funciones que no existen y nombres que no están en los datos (.User.Usrname, ¿Quisiste decir .User.Username?), incluso en una parte del código que no se ejecutó. Leer un nombre que no está sigue sin dar nada; no es un error.
• codeshow, export e info dicen el comando más parecido cuando el nombre tiene un error de escritura: !customcommand codeshow gret responde ¿Quisiste decir greet?

Una función que no existe

Un nombre que no está en los datos

Un nombre de comando mal escrito

​

Gestionar tus comandos

• !customcommand codetest acepta argumentos después del bloque de código: un bloque y luego red "big cat" prueba el código como si se hubiera escrito red "big cat" después del comando. Describe cada mensaje que enviaría (su texto, su embed, sus botones y menús, y sus reacciones) y cada acción, las pistas, y los pasos y el tiempo que usó. El código sin bloque es todo código, como antes.
• !customcommand info <name> dice qué es un comando: texto o código, cómo empieza, su tamaño (de los 10 000 caracteres de código), quién lo escribió, las funciones que usa, y si usa datos guardados, botones, menús, reacciones, formularios, roles, mensajes directos, miembros del servidor u otros comandos.
• !customcommand list muestra una página a la vez, ordenada por nombre, con lo que es cada comando (código o texto), cómo se escribe y qué tan grande es.
• !customcommand codeshow muestra el código en un bloque que colorea las acciones {{ }}.
• !customcommand rename <name> <new name> cambia el nombre y mantiene el código, el activador (también su propio prefijo, así que .req1 pasa a ser .req) y los datos guardados. Un nombre que es un comando real de Petto u otro comando personalizado se rechaza. Los mensajes que el comando envió antes, con botones o reacciones, mantienen el nombre anterior y dejan de responder.
• !customcommand trigger <name> sin un tipo muestra cómo empieza el comando y los comandos para cambiarlo. Avisa cuando nada cambia, y cuál era el prefijo antes cuando cambia.
• Al guardar un comando, Petto avisa cuando su primer comentario dice que se usa con un prefijo propio (como {{/* req: .req <lo que pides> */}}) y el comando no lo tiene, y da el comando que lo configura.

!customcommand codetest

!customcommand info

!customcommand list

!customcommand codeshow

!customcommand rename

!customcommand trigger

Al guardar: un prefijo propio

​

Novedades en Petto Code

​

Funciones nuevas

• Texto: joinStr, trimPrefix, trimSuffix, trimSpace, inFold, capitalize, repeat, truncate, padLeft, padRight, count, indexOf, reverse, urlescape, urlunescape, escapeMarkdown, formatNumber, toString, toLower y toUpper.
• Números: fdiv, sqrt, cbrt, log, roundCeil, roundFloor, roundEven, clamp y toInt64.
• Tiempo: currentTime, toDuration ("1h30m" en segundos), humanizeTimeSince, snowflakeToTime, newDate, formatTime (un formato y una zona horaria) y weekday.
• Listas y mapas: sort, sortBy, uniq, first, last, sum, randItem, concat, hasKey, setKey, delKey, merge, values, kindOf, json y parseJson.
• IDs: userID, roleID y channelID sacan el ID de una mención.

{{ capitalize "petto" }} tiene {{ formatNumber 1234567 }} monedas.
{{ joinStr ", " (sort (cslice "pear" "apple" "fig")) }}
{{ toDuration "1h30m" }} segundos

​

Miembros, roles y canales

{{ with .Mentions }}
  {{ $m := getMember (index . 0).ID }}
  {{ if $m }}{{ $m.DisplayName }} está aquí.{{ end }}
{{ end }}

​

Rankings

• dbRank da el puesto de un miembro en un ranking, como el de monedas.
• dbBottom da los números más bajos, de 1 a 25 miembros (como dbTop, desde abajo).
• dbCount dice cuántas claves hay guardadas.

{{ with dbRank "coins" .User.ID }}Estás en el puesto **#{{ . }}**.{{ else }}Todavía no tienes monedas.{{ end }}

​

Acciones

• deleteTrigger y el nuevo deleteResponse aceptan un retraso de hasta 5 minutos (en segundos). deleteResponse borra la respuesta del comando, 10 segundos después si no das un retraso. Solo funciona cuando el comando se escribe, no en un botón, un menú, un formulario o una reacción.
• addReactions agrega varias reacciones a la vez (hasta 5).
• complexMessage acepta "reply" true (el mensaje responde al mensaje del comando) y "silent" true (sin notificación).

¡Guardado!{{ deleteTrigger 5 }}{{ deleteResponse 10 }}
{{ sendMessage nil (complexMessage "content" "Entendido." "reply" true "silent" true) }}

​

Formularios con todas las partes

{{ showModal (cmodal "id" "about" "title" "Sobre ti" "fields" (cslice
  (cdisplay "Solo tarda un minuto.")
  (ctext "id" "name" "label" "Nombre" "description" "Cómo te llamamos")
  (cmenu "id" "color" "label" "Color favorito" "options" (cslice (cslice "Rosa" "pink") (cslice "Azul" "blue")))
  (cusers "id" "friends" "label" "Amigos" "max" 3 "required" false)
  (cfile "id" "photo" "label" "Una foto" "required" false)
  )) }}

• .Fields.<id>: un texto (ctext, cradio), una lista de valores (cmenu, cchecks), una lista de IDs (cusers, croles, cmentions, cchannels), true o false (ccheck) o una lista de archivos (cfile, cada uno con ID, Name, URL, Size, Type y Description).
• .FieldText.<id>: lo mismo, listo para imprimir: IDs como menciones, listas unidas, ✅ o ❌, los enlaces de los archivos.
• .Files: todos los archivos del formulario en una lista.

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

​

Datos nuevos

• .Mentions (los usuarios mencionados, con su nombre y avatar), .MentionedRoles y .MentionedChannels.
• .ServerPrefix, .Now y .User.CreatedAt.
• Más de .Member: Avatar, Color, HighestRoleID, BoostingSince e IsOwner.
• Más de .Guild: OwnerID, CreatedAt, BoostCount, BoostTier, Banner, Description, RoleCount, ChannelCount y EmojiCount.
• Más de .Channel: Topic, NSFW, ParentID, Type e IsThread.
• Más de .Message: CreatedAt, Attachments y ReplyToID.

​

Plantillas nuevas

• whois: una tarjeta del miembro que mencionas, o tuya. !whois @Liam
• roleinfo: el color, los miembros y la fecha de creación de un rol. !roleinfo @Role
• rank: tu puesto en el ranking de monedas, o el del miembro que mencionas.

!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 ¡Hola {{ .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

• El código se revisa antes de guardarse. Un error dice la línea y la columna, y no se guarda nada.
• codetest ejecuta el código como si hubieras usado el comando y muestra lo que imprimiría y haría. No se envía ni se guarda nada.
• template lista comandos ya hechos (votación, solicitud, reclamo, sugerencia, reporte, perfil, botón de rol, rol por reacción, whois, roleinfo, rank y más) e instala uno.
• export da un código para compartir que funciona en cualquier servidor, e import usa uno.
• Activadores: prefix, startswith, exact, contains o command (el prefijo de Petto). Un servidor puede tener hasta 25 comandos con un activador propio.

​

Editor de la dashboard

​

Generador de Petto Code

​

Límites y seguridad