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

# Sintaxis

> Esta página resume la sintaxis real de Headless. Los ejemplos usan el prefijo predeterminado `.`; los comandos slash aparecen en el selector de Discord cuando están registrados.

## Prefijo y comandos slash

Consulta el prefijo actual con `.prefix`; Administrator puede cambiarlo con `.prefix set <nuevo>` o resetearlo. También puedes usar `/prefix` con `new_prefix` si el comando slash está disponible. Los comandos slash separan cada argumento en campos de Discord.

## Argumentos y menciones

En la documentación, `<obligatorio>` y `[opcional]` son notación: no escribas los corchetes. Una lista como `<on|off>` indica que debes elegir una alternativa. Usa la mención o selector de Discord para miembros, roles y canales cuando el comando espera ese tipo de argumento.

## Duraciones y opciones

Headless no aplica una gramática universal de duración. Por ejemplo, Honeyspot acepta valores compactos como `60m` o `1w2d`, mientras que Vanity interpreta `.vanity timeout 10` como diez minutos. Las opciones con `--` pertenecen solo a comandos que las anuncian; escribe dos guiones ASCII `--`, no un guion largo `—`.

## Comportamiento que no se hereda

El formato `select:ID`, los conjuntos de castigos `--do` y las unidades de otro bot no son una sintaxis general de Headless. Sigue la página del comando concreto y no copies opciones de una función distinta.

## Pasos

**1. Abre la guía del comando**

Confirma prefijo, argumentos requeridos, opciones y permisos antes de copiar un ejemplo.

**2. Sustituye solo los valores**

Cambia menciones, canal, duración o texto de ejemplo por datos de tu servidor; no incluyas los corchetes de notación.

**3. Prueba sin sancionar**

Para una regla de moderación, usa primero un modo de registro o preview si el comando lo ofrece.

## Ejemplos por familia de sintaxis

### Configurar un módulo Anti-Nuke

```headless-command Syntax theme={null}
.antinuke ban [on|off|status] [--threshold <1-50>] [--do <none|warn|jail|kick|ban|stripstaff>] [--command <on|off>]
```

```headless-command Example theme={null}
.antinuke ban on --threshold 3 --do ban --command on
```

### Cambiar el prefijo

#### `.prefix`

```headless-command Syntax theme={null}
.prefix
```

```headless-command Example theme={null}
.prefix
```

```headless-command Syntax theme={null}
/prefix [new_prefix:<new_prefix>]
```

```headless-command Example theme={null}
/prefix new_prefix:!
```

#### `.prefix set`

```headless-command Syntax theme={null}
.prefix set <new_prefix>
```

```headless-command Example theme={null}
.prefix set !
```

#### `.prefix reset`

```headless-command Syntax theme={null}
.prefix reset
```

```headless-command Example theme={null}
.prefix reset
```

#### `.antinuke status`

```headless-command Syntax theme={null}
/antinuke status
```

```headless-command Example theme={null}
/antinuke status
```

## Protección de canales Anti-Nuke

El módulo de canales usa el mismo parser de acciones que las demás reglas. `stripstaff` es una opción real y `.an` es el alias corto de `.antinuke`.

```headless-command Syntax theme={null}
.antinuke channel [on|off|status] [--threshold <1-50>] [--do <none|warn|jail|kick|ban|stripstaff>]
```

```headless-command Example theme={null}
.an channel on --threshold 1 --do stripstaff
```

### Configurar oleadas de ingreso

```headless-command Syntax theme={null}
.antiraid massjoin [on|off|status] [--threshold <1-50>] [--do <kick|ban>] [--lock <true|false>] [--punish <true|false>]
```

```headless-command Example theme={null}
.antiraid massjoin on --threshold 5 --do kick
```

### Duraciones de otras funciones

```headless-command Syntax theme={null}
.honeyspot timeout <duration>
```

```headless-command Example theme={null}
.honeyspot timeout 1w2d
```

```headless-command Syntax theme={null}
.vanity timeout <minutes>
```

```headless-command Example theme={null}
.vanity timeout 10
```

> [!WARNING]
>
> Las flags de castigo pueden ejecutar acciones reales. Verifica el comando y el modo exacto antes de habilitar kick, ban o cualquier otra sanción.

## Páginas relacionadas

* [Join Gate](/docs/security/anti-raid.md)
* [Moderación](/docs/security/moderation.md)
* [Permisos](/docs/permissions.md)


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