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

# Aliases de comandos

> Los aliases crean atajos persistentes por servidor para invocar comandos registrados de Headless. No reemplazan los controles ni permisos del comando original.

## Acceso y alcance

Crear, consultar y eliminar aliases requiere el permiso de Discord `Manage Server`. Cada servidor puede guardar hasta 100 atajos en una configuración separada. El prefijo de los ejemplos es `.`; usa el prefijo que tenga configurado tu servidor.

## Plantillas y argumentos

`.alias add <atajo> <comando y argumentos>` puede guardar texto fijo y marcadores. `{}` inserta todo el texto restante escrito al invocar el atajo; `{0}`, `{1}` y los siguientes índices insertan argumentos en posiciones desde cero. Si no usas marcadores, el texto de entrada se añade al final del destino.

## Validación del destino

El nombre del atajo admite 1–24 caracteres: letras ASCII, números, `_` y `-`. No puede ocupar un comando registrado ni cambiar el significado de una abreviatura integrada; el runtime solo permite una asignación redundante si apunta exactamente al mismo comando. Tampoco puede llamarse igual que la raíz de su destino ni apuntar a otro alias personalizado. El destino sí debe ser un comando Headless registrado; no puede contener caracteres de control y tiene un máximo de 300 caracteres.

## Consultar, paginar y borrar

`.alias view` muestra el destino de un atajo y `.alias list` enumera los aliases del servidor. La lista muestra 20 por página; solo quien la abrió puede usar sus controles de paginación y estos vencen a los 120 segundos. `.alias remove` elimina un alias individual de inmediato. `.alias removeall` elimina los atajos que apuntan a una ruta de comando registrada, mientras que `.alias reset` elimina todos los aliases personalizados; ambos requieren confirmar dentro de 60 segundos con el mismo usuario, quien aún debe tener `Manage Server`. Los aliases integrados no se eliminan.

## Pasos

**1. Elige un comando registrado**

Copia una ruta de comando real del catálogo Commands, como `ban`. El destino puede ser un comando integrado o su alias oficial; no apuntes a otro alias personalizado ni al propio sistema `.alias`.

**2. Decide cómo se pasan argumentos**

Usa `{}` para conservar todo el texto restante o `{0}`, `{1}` para posiciones desde cero; deja texto fijo en el destino solo si lo necesitas.

**3. Crea y prueba el atajo**

Ejecuta `.alias add` y prueba la invocación. Los permisos, las comprobaciones de acceso y la validación del comando original siguen activas.

**4. Revisa antes de borrar en grupo**

Consulta `.alias list` o `.alias view`. Para `removeall` o `reset`, comprueba el resumen y confirma solo si quieres eliminar esos atajos.

> **Reglas completas de validación**
>
> El alias es una sola palabra de 1–24 caracteres (`a-z`, `0-9`, guion bajo o guion). No puede ocupar una raíz de comando registrada o cambiar una abreviatura reservada; una asignación redundante solo se acepta si conserva exactamente su destino integrado. Tampoco puede tener el mismo nombre que la raíz del destino. La ruta destino debe estar registrada y tener como máximo 300 caracteres; se rechazan caracteres de control, llaves sin marcador válido y cadenas de alias. Los marcadores aceptados son `{}`, `{0}`, `{1}` y otras posiciones numéricas.

## Comandos por flujo

### Crear, consultar y listar

```headless-command Syntax theme={null}
.alias add [shortcut] [command]
```

```headless-command Example theme={null}
.alias add deport ban {0} {1}
```

```headless-command Syntax theme={null}
.alias view [shortcut]
```

```headless-command Example theme={null}
.alias view deport
```

```headless-command Syntax theme={null}
.alias list
```

```headless-command Example theme={null}
.alias list
```

### Eliminar aliases

```headless-command Syntax theme={null}
.alias remove [shortcut]
```

```headless-command Example theme={null}
.alias remove deport
```

```headless-command Syntax theme={null}
.alias removeall [command]
```

```headless-command Example theme={null}
.alias removeall ban
```

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

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

> [!WARNING]
>
> `removeall` y `reset` son operaciones de borrado masivo, pero no afectan los alias integrados. Cancelar o dejar vencer la confirmación no cambia la configuración.

**Nota:**

El ejemplo crea `.deport @Member Spam` como llamada al comando real `.ban @Member Spam`. El contenido del alias se almacena con el ID del servidor en la colección persistente `command_aliases`.

## Páginas relacionadas

* [Sintaxis de comandos](/docs/resources/syntax.md)
* [Permisos de Headless](/docs/permissions.md)


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