> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt
> Use this file to discover all available pages before exploring further.

# Prefijo

> El texto antes de cada comando (! y petto por defecto): un servidor puede tener varios prefijos, cómo verlos y cambiarlos, saltar argumentos opcionales con --flags, y qué comandos también funcionan con /.

## 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 ?](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-mention.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=6ed0a9bc5f8b3057763d8dcbbbfd833f)

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`](https://wiki.petto.sbs/es/setup/user-prefix)) 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.

```javascript Sintaxis theme={null}
!command subcommand <required> --optionname value
```

```javascript Ejemplo theme={null}
!ticket category edit support --naming ticket-{number}
!welcome setup #welcome --message "¡Bienvenido {user}!"
```

![liam usa !welcome setup con el canal de bienvenidas y --message, y Petto guarda el canal y el mensaje](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-flags.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=771adf0f28f2f80f4be6043518e1c66d)

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`.

> [!WARNING]
>
> `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

```javascript Sintaxis theme={null}
!prefix
!prefix add <prefix>
!prefix remove <prefix>
!prefix reset
!prefix <prefix>
!help [full | query]
```

```javascript Ejemplo theme={null}
!prefix
!prefix add ,
!prefix remove petto
!prefix reset
!prefix ?
!help "ticket category add"
```

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 ?](https://mintcdn.com/wikipetto/4ijFW041sxK9Gi0r/images/discord/setup/es/prefix.webp?fit=max\&auto=format\&n=4ijFW041sxK9Gi0r\&q=85\&s=08d581df014e79a4aaa68fb3f4faedc8)

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

> [accordion] !prefix petto!
>
> ![liam prueba el prefijo petto! y Petto dice que debe tener de 1 a 5 caracteres sin espacios](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-invalid.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=f6e1286b0b61b66a7283486575efbdf0)
>
> En Discord: un prefijo de más de 5 caracteres se rechaza.

> [accordion] !help
>
> ![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](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-help.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=4b8af6ea2666d5bb1bd1629f9a36cc10)
>
> En Discord: !help, con las categorías en un menú y enlaces a la dashboard, la documentación y el servidor de soporte.

> [accordion] !help: una categoría
>
> ![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](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-help-category.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=9f3b523da41503fb450bc735f28621ae)
>
> En Discord: al elegir Configuración en el menú, el mismo mensaje muestra sus comandos.

> [accordion] !help "ticket category add"
>
> ![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](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-help-lookup.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=a778f31fc8cc4a0401a97d92d4c8e262)
>
> En Discord: un subcomando buscado directamente, con sus alias, opciones y las dos formas.

> [accordion] !help tiket
>
> ![shi busca tiket y Petto sugiere !help ticket, !help time y !help timer](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-help-not-found.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=b04a64d685b08973369a4b0512d4a6e4)
>
> 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](https://mintcdn.com/wikipetto/Z-XTVemdYTr1KRaH/images/dashboard/setup/es/general-settings.webp?fit=max\&auto=format\&n=Z-XTVemdYTr1KRaH\&q=85\&s=d2227023f1730b87795e6a31b7e71350)

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.

| Tipo | Comandos |
| - | - |
| De uso diario, de las dos formas | `/help`, `/ping`, `/botinfo`, `/server`, `/user`, `/rank`, `/top`, `/remind`, `/afk`, `/suggest`, `/poll`, `/warn`, `/kick`, `/ban`, `/channel`, `/giveaway`, `/ticket`, `/embed`, `/report` |
| Grupos de comandos | `/mod`, `/staff`, `/game`, `/me`, `/search`, `/config`, `/protect`, `/greet`, `/auto`, `/message`, `/community`, `/contrib`, `/special`, `/bot`, `/ai` (**BETA**, mira [Ask](https://wiki.petto.sbs/es/miscellaneous/ask.md)): cada uno reúne comandos relacionados como subcomandos (`/mod ban`, `/game 8ball`, `/search weather`, `/ai ask`). `/avatar`, `/userinfo`, `/serverinfo`, `/unban`, `/purge` y `/timeout` ahora están dentro de ellos como `/user avatar`, `/user info`, `/server info`, `/mod unban`, `/mod purge` y `/mod tempmute`; sus formas con prefijo no cambiaron |
| Comandos con subcomandos propios | `/level`, `/automod`, `/form`, `/forum`, `/role`, `/logs`, `/permission`, `/antinuke`, `/antiscam`, `/invites`, `/autoresponder`, `/image`, `/feed`, `/identity`, `/starboard`, `/clownboard`, `/monkeyboard`, `/stats`, `/customcommand`, `/rollouts`, `/quickreply`, `/voicemaster`, `/giveawaypreset`, `/giveawaytemplate`, `/boosterrole` (23 subcomandos, aparte de `/me`: mira [Roles de boosters](https://wiki.petto.sbs/es/community/boosterrole.md)) |
| Enlaces de mensajes | `/messagelinks` (activa y desactiva los embeds de enlaces de mensajes) |
| Roles de identidad | `/vanity`, `/guildtag` (mira [Vanity y Server Tags](https://wiki.petto.sbs/es/guides/vanity-tag-bot.md)) |
| Solo de barra | `/setup`, cuya configuración rápida abre un formulario de Discord, y los menús **Report Message** y **Report User** (clic derecho en un mensaje o un miembro, luego **Aplicaciones**) |
| [Roleplay](https://wiki.petto.sbs/es/roleplay/roleplay.md) | Los 79 comandos de interacción, todos como subcomandos de un solo comando: `/act love hug`, `/act fight slap`. Cada uno conserva también su propia palabra con el prefijo (`!hug`, `!slap`) |

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.

> [!TIP]
>
> `/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](https://mintcdn.com/wikipetto/XJGgnnMwMsp95tLP/images/discord/setup/es/prefix-help-slash.webp?fit=max\&auto=format\&n=XJGgnnMwMsp95tLP\&q=85\&s=d297a8b0da0fc11878295a828a8508b1)

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:

| Comando | Necesita |
| - | - |
| `/ban`, `/unban` | Banear miembros |
| `/kick` | Expulsar miembros |
| `/warn`, `/timeout` | Moderar miembros |
| `/purge` | Gestionar mensajes |
| `/channel` (lock, unlock, slowmode...) | Gestionar canales |
| `/embed`, `/giveaway`, `/setup`, `/vanity`, `/guildtag` | Gestionar servidor |
| Todo lo demás | No se le oculta a nadie |

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`](https://wiki.petto.sbs/es/moderation/moderation#acceso-a-la-moderación-por-rol) 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](https://wiki.petto.sbs/es/setup/permissions.md#comandos-de-barra) para saber cómo Petto revisa un comando.

> [!NOTE]
>
> Los comandos de barra nuevos o cambiados pueden tardar un momento en aparecer. Recargar Discord (Ctrl+R) suele ayudar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.