Saltar al contenido principal

Resumen

Cada comando empieza con un prefijo del servidor: ! y la palabra petto por defecto (!help y petto help funcionan). La palabra petto siempre funciona, elijas los prefijos que elijas (aunque el servidor use solo !n), y no se puede quitar. Los argumentos van en orden y separados por espacios; pon entre “comillas” cualquier cosa que tenga espacios. Un servidor puede tener varios prefijos, hasta 10. El primero es el prefijo principal: la ayuda, las tarjetas y los ejemplos lo muestran. Un servidor que eligió un prefijo propio conserva exactamente ese. Si olvidas un prefijo personalizado, menciona a Petto: @Petto prefix siempre funciona y muestra el prefijo actual.
kira escribe !prefix y no pasa nada, luego @Petto prefix muestra que el prefijo del servidor es ?

En Discord: con un prefijo olvidado, !prefix no recibe respuesta, pero una mención a Petto sí.

Varios prefijos

  • Un símbolo (!, ,, ?, p!) se escribe pegado al comando: ,help. Un espacio después (, hola) no es un comando.
  • Una palabra (termina en letra o número, como petto) no distingue mayúsculas y necesita un espacio: petto help o Petto help. Solo inicia un comando cuando la palabra siguiente es un comando real, un alias o un comando personalizado, así que petto es genial es solo charla.
  • El prefijo más largo va primero, así que con ! y !! en la lista, !!help se lee con !!.
  • Solo el prefijo principal responde “No conozco el comando”, y solo a una palabra escrita como comando (!hola). Los otros prefijos, los de palabra y tu prefijo propio se quedan en silencio cuando la palabra no es un comando.
  • La coma no viene por defecto. Otros bots usan ,, así que Petto no responde a ella salvo que la añadas: !prefix add ,.
  • Tu prefijo propio (!myprefix) y los comandos personalizados que empiezan con el prefijo funcionan con todos los prefijos de la lista.
  • Cada prefijo tiene de 1 a 12 caracteres, sin espacios, sin @ ni comillas invertidas, y no se puede repetir.

Saltar un argumento opcional

Los comandos con varios campos opcionales seguidos (como !ticket category edit o !welcome setup) te dejan ir directo al que quieres con --nombredelcampo valor, en lugar de escribir todos los campos que van antes.
liam usa !welcome setup con el canal de bienvenidas y --message, y Petto guarda el canal y el mensaje

En Discord: --message llena el mensaje de !welcome setup sin escribir los campos de antes.

Combínalos como quieras: los valores normales en orden y las --flags pueden ir en el mismo comando. Esto solo importa para los campos opcionales; los obligatorios siempre necesitan un valor normal, en orden. Un nombre con guion bajo también se puede escribir con guion: --window-seconds 10 es --window_seconds 10.
name:value (como limit:3) es como Discord escribe las opciones de un comando de barra. Con el prefijo no se lee como un nombre, así que escribe --limit 3.

Comandos

Usa !prefix sin argumentos para ver la lista. !prefix add <prefix> añade uno (hasta 10), !prefix remove <prefix> quita uno (el último no se puede quitar) y !prefix reset vuelve a ! y petto. !prefix <prefix> (o !prefix set <prefix>) deja ese prefijo como el único, como siempre (petto y la mención de Petto siguen funcionando). Necesita Gestionar servidor. !help abre el explorador de todos los comandos, con botones a la dashboard, la documentación, la página de Comandos de la web y el servidor de soporte, y !help ticket category add busca uno directamente, incluso un subcomando concreto. !prefix también funciona como !pfx, y !help como !h.
liam mira el prefijo, que es !, y @Petto que siempre funciona, y luego lo cambia a ?

En Discord: !prefix muestra el prefijo actual, y !prefix ? lo cambia.

liam prueba el prefijo petto! y Petto dice que debe tener de 1 a 5 caracteres sin espacios

En Discord: un prefijo de más de 5 caracteres se rechaza.

El menú de ayuda de Petto: cuántos comandos hay, cuántos funcionan también con /, el idioma del servidor y un menú de categorías

En Discord: !help, con las categorías en un menú y enlaces a la dashboard, la documentación y el servidor de soporte.

La categoría Configuración de !help: para qué sirve, cuántos comandos tiene, un botón para volver al menú y un menú con sus comandos

En Discord: al elegir Configuración en el menú, el mismo mensaje muestra sus comandos.

La tarjeta de ayuda de ticket category add con sus alias, sus parámetros, quién puede usarlo, la sintaxis con prefijo y con barra y un ejemplo

En Discord: un subcomando buscado directamente, con sus alias, opciones y las dos formas.

shi busca tiket y Petto sugiere !help ticket, !help time y !help timer

En Discord: un comando mal escrito recibe los nombres más parecidos.

En la dashboard, la tarjeta Prefijos de comandos de la página General muestra la lista y tiene un botón Gestionar prefijos. Abre una ventana: escribe un prefijo, pulsa +, quita los que no quieras con su x y pulsa Guardar. Te dice qué está mal (muy largo, espacios, repetido, @, más de 10) antes de guardar, y funciona en el móvil.
La página Ajustes del servidor con el prefijo de comandos, el idioma del servidor, el rol de silencio y el ranking público

Dashboard → Dashboard → Ajustes: los Prefijos de comandos, junto al idioma del servidor y el rol de silencio.

Comandos de barra

Todos los comandos funcionan con el prefijo. Los de uso diario están también en el menú / de Discord, con las mismas respuestas y las mismas comprobaciones, así que los miembros que nunca aprendieron un prefijo también pueden usarlos. La forma con prefijo sigue funcionando para todos. En total son 67 comandos: 64 comandos de barra y 3 menús contextuales. Las tarjetas !<module>config y algunas herramientas del equipo siguen siendo solo con prefijo.
/help responde en el canal y muestra las dos formas de un comando: la de barra junto a la sintaxis con prefijo. Sus menús describen cada opción y sus botones abren la dashboard, esta documentación y el servidor de soporte.
sam.k usa /help ban user y recibe una tarjeta con la sintaxis con prefijo, la sintaxis con barra y un ejemplo

En Discord: /help muestra la forma con barra junto a la sintaxis con prefijo.

Quién ve cada comando de barra

Discord oculta un comando de barra a los miembros que no tienen el permiso que necesita, así que el menú / solo muestra lo que cada quien puede usar: Un servidor puede cambiar quién ve un comando de barra en Ajustes del servidor → Integraciones → Petto. Así un rol elegido para un comando en !moderation también puede usarlo desde el menú /: permite el comando para ese rol ahí, y las comprobaciones propias de Petto se siguen aplicando. Los comandos de barra de uso diario no se ofrecen en MD. Mira Permisos de comandos para saber cómo Petto revisa un comando.
Los comandos de barra nuevos o cambiados pueden tardar un momento en aparecer. Recargar Discord (Ctrl+R) suele ayudar.