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

# Roles automáticos

> Auto Role reúne la asignación automática al entrar, los roles previos a la verificación y los selectores voluntarios de roles. La configuración se guarda por servidor. Los comandos editan esa configuración; no se aplican a miembros que ya estaban en el servidor.

La interfaz de Auto Role que publica Headless usa inglés por defecto. Al cargar la configuración, solo se actualizan textos que coinciden exactamente con valores predeterminados anteriores; los mensajes personalizados del servidor se conservan.

## Asignación al entrar

El módulo está apagado de forma predeterminada. Cuando está habilitado, asigna el rol configurado para bots a las cuentas bot; a las personas les asigna el rol humano y, si existe, el rol temporal Pending Verify. El retraso predeterminado es de 2 segundos. `delay` acepta enteros de 0 a 86 400 segundos; los valores fuera del rango se ajustan al límite más cercano. El handler omite miembros con un rol exento configurado, roles que ya tienen o roles que Headless no puede gestionar.

### `.autorole`

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

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

### `.autorole human`

```headless-command Syntax theme={null}
.autorole human [role]
```

```headless-command Example theme={null}
.autorole human @Member
```

### `.autorole bot`

```headless-command Syntax theme={null}
.autorole bot [role]
```

```headless-command Example theme={null}
.autorole bot @Bot
```

### `.autorole delay`

```headless-command Syntax theme={null}
.autorole delay <seconds>
```

```headless-command Example theme={null}
.autorole delay 30
```

## Verify y roles pendientes

El panel integrado de Verify usa títulos, mensajes y botones predeterminados en inglés. Al leer configuraciones anteriores, Headless cambia solo los valores que coinciden exactamente con esos textos predeterminados antiguos; los mensajes personalizados, incluso si están en español, se conservan.

El flujo de Verify de Headless asigna los roles definidos en su propia configuración y retira el rol Pending Verify de Auto Role cuando corresponde. Aunque `.autorole verified @Rol` guarda un `verified_role_id`, el handler actual de Verify no invoca la función que aplicaría ese campo; no dependas de ese ajuste para conceder el rol verificado. Configura el rol de acceso final dentro de Verify hasta que esa integración cambie.

> [!NOTE]
>
> El botón público de Verify también rechaza `@everyone`, roles administrados por Discord y roles con permisos administrativos o de moderación. Si la configuración contiene uno de ellos, Headless lo omite y avisa al miembro; el administrador debe elegir un rol seguro en Verify.

### `.autorole pending`

```headless-command Syntax theme={null}
.autorole pending [role]
```

```headless-command Example theme={null}
.autorole pending @Pending
```

### `.autorole verified`

```headless-command Syntax theme={null}
.autorole verified [role]
```

```headless-command Example theme={null}
.autorole verified @Verified
```

## Paneles y funciones que comparten el interruptor

Auto Role también controla los paneles de selección y Reaction Roles. `off` detiene la asignación al entrar y las interacciones de esos flujos, pero conserva sus reglas y paneles guardados. Crear un grupo con `group`, publicar con `panel` o añadir una regla Reaction Role puede volver a poner `enabled` en `true`; revisa el estado después de esos cambios. Los grupos admiten hasta 8 por servidor y 20 roles por grupo; consulta la guía de paneles para su comportamiento.

> [!NOTE]
>
> Además del ajuste `enabled` guardado en Auto Role, existe un interruptor global e independiente en Dashboard → Modules. Si ese interruptor está apagado, las asignaciones al entrar, los paneles y Reaction Roles permanecen pausados aunque `.autorole on` active la configuración.

### `.autorole on`

```headless-command Syntax theme={null}
.autorole on
```

```headless-command Example theme={null}
.autorole on
```

### `.autorole off`

```headless-command Syntax theme={null}
.autorole off
```

```headless-command Example theme={null}
.autorole off
```

### `.autorole panel`

```headless-command Syntax theme={null}
.autorole panel [channel]
```

```headless-command Example theme={null}
.autorole panel #roles
```

### `.autorole group`

```headless-command Syntax theme={null}
.autorole group <name> [roles]...
```

```headless-command Example theme={null}
.autorole group colores @Rojo @Azul
```

### `.autorole title`

```headless-command Syntax theme={null}
.autorole title <title>
```

```headless-command Example theme={null}
.autorole title Elige tus roles
```

### `.autorole message`

```headless-command Syntax theme={null}
.autorole message <message>
```

```headless-command Example theme={null}
.autorole message Selecciona una opción
```

### `.autorole thumbnail`

```headless-command Syntax theme={null}
.autorole thumbnail [url]
```

```headless-command Example theme={null}
.autorole thumbnail https://example.com/roles.png
```

### `.autorole image`

```headless-command Syntax theme={null}
.autorole image [url]
```

```headless-command Example theme={null}
.autorole image https://example.com/banner.png
```

### `.autorole gif`

```headless-command Syntax theme={null}
.autorole gif [url]
```

```headless-command Example theme={null}
.autorole gif https://example.com/roles.gif
```

> [!WARNING]
>
> `verified` actualmente guarda la selección, pero el flujo de Verify no aplica ese campo. Evita tratarlo como una concesión activa; asigna el rol final desde la configuración real de Verify. Los selectores de autoasignación son voluntarios: nunca incluyas permisos sensibles en esos roles.

**Nota:**

El retraso inicial es 2 segundos y la asignación depende de la configuración `enabled` del servidor. El bot guarda el último error de asignación para diagnóstico; permisos y jerarquía de Discord siguen siendo obligatorios.

## Dashboard, permisos y datos

En Dashboard → Roles → Auto Role puedes editar roles, retraso, roles exentos, el título y texto del panel, medios y grupos. El comando usa el prefijo configurado del servidor (punto por defecto) y `.arole` es alias de `.autorole`. Debes estar en un servidor, tener `Manage Roles` y ser owner del servidor, owner de Headless o Anti-Nuke Admin configurado. Headless también necesita `Manage Roles`; Discord solo permite asignar roles por debajo del rol más alto del bot. La configuración persistente se mantiene aislada por servidor en el almacén existente de Auto Role.

## Pasos

**1. Comprueba quién administrará el módulo**

Confirma que tu cuenta cumple la autorización del grupo y tiene `Manage Roles`. Da `Manage Roles` a Headless y coloca su rol por encima de cada rol que deba conceder o retirar.

**2. Configura roles y excepciones**

En Dashboard → Roles → Auto Role, elige roles separados para personas, bots y Pending Verify; ajusta el retraso y los roles exentos. Configura los roles finales de verificación desde Verify.

**3. Activa y prueba el evento de entrada**

Ejecuta `.autorole on` y prueba con una cuenta de prueba que entre después del cambio. Revisa el estado con `.autorole`; no hay asignación retroactiva a miembros existentes.

> **Comandos de prefijo registrados**
>
> Grupo y alias: `.autorole` / `.arole`. Sin subcomando muestra el estado. Subcomandos: `on` (`enable`, `activar`), `off` (`disable`, `desactivar`), `human` (`humans`, `humano`, `h`), `bot` (`bots`, `b`), `pending` (`pendiente`, `pend`, `p`), `verified` (`verify`, `verificado`, `v`), `delay` (`wait`, `espera`, `d`), `panel` (`sendpanel`, `selfroles`, `roles`), `group` (`grupo`, `colors`, `colores`), `title` (`titulo`), `message` (`mensaje`, `msg`), `thumbnail` (`thumb`), `image` (`banner`, `imagen`) y `gif`. Todos son comandos de prefijo, no comandos slash.

> **Qué significa apagar o quitar un rol**
>
> `.autorole off` no borra la configuración ni los mensajes de panel, pero el runtime deja de procesar asignaciones de entrada, selectores y reacciones mientras Auto Role está apagado. En `human`, `bot`, `pending` o `verified`, omitir la mención de rol guarda un valor vacío y limpia ese ajuste. No uses la lista de canales exentos como sustituto de un rol exento: el handler de entrada consulta roles del miembro, no el canal del evento.

## Páginas relacionadas

* [Paneles autoasignables](/docs/server/roles/self-assignable.md)
* [Roles por reacción](/docs/server/roles/reaction-roles.md)
* [Permisos de Headless](/docs/permissions.md)


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