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

> Configura menús persistentes de selección de roles con grupos exclusivos o multiselección, límites, permisos y controles reales de Headless.

Auto Role puede publicar un menú persistente para que cada miembro gestione los roles que el servidor haya autorizado. Se configura desde **Dashboard → Roles → Auto Role** y también puede administrarse con comandos prefix. Los paneles usan un menú de selección: no son botones individuales vinculados a roles ni roles por reacción.

> [!NOTE]
>
> El menú solo ofrece roles que Headless puede administrar y que son aptos para autoservicio. Headless oculta y rechaza `@everyone`, roles administrados por integraciones y roles con permisos administrativos o de moderación, incluso si alguien intenta usar un panel antiguo.

## Grupos y selección

Un servidor puede guardar hasta **8 grupos** y hasta **20 roles por grupo**. Un menú de Discord puede mostrar como máximo **25 opciones**; si la configuración supera ese límite, Headless muestra solo las primeras opciones que sí puede administrar.

* **Modo exclusivo** — **Al seleccionar una opción:** Asigna el rol elegido y retira otros roles administrables del mismo grupo. Si el miembro ya tiene el rol elegido, permanece asignado.
* **Selección múltiple** — **Al seleccionar una opción:** Alterna el rol elegido: lo añade si no lo tiene y lo retira si ya lo tiene.

`.autorole group` crea grupos exclusivos. Desde el Dashboard puedes cambiar el grupo a selección múltiple y personalizar su panel. Si un menú combina grupos y alguno admite selección múltiple, Discord permite escoger varias opciones; Headless sigue aplicando la regla de cada grupo al procesar la selección.

## Publicar y mantener los paneles

El comando `.autorole panel` publica el selector principal en el canal actual o en el canal de texto que indiques. El Dashboard también permite publicar un panel independiente por grupo, con su propio canal y estilo. Si el panel publicado ya está guardado y disponible, Headless lo actualiza en vez de crear una copia.

Los datos se guardan en la configuración de Auto Role del servidor y los paneles persistentes se vuelven a registrar tras reiniciar Headless cuando su canal y mensaje siguen accesibles. La interacción funciona únicamente en un servidor y requiere que Auto Role esté habilitado tanto en el módulo como en su configuración del servidor.

## Permisos y seguridad

La persona que ejecuta los comandos necesita **Manage Roles** (nativo o compatible con Fake Permissions) y autorización de **owner del servidor, owner de Headless o Anti-Nuke Admin configurado**. Ser Administrador del servidor, por sí solo, no sustituye esta autorización específica.

Headless necesita **Manage Roles** y su rol más alto debe estar por encima de cada rol ofrecido. Los roles administrados por una integración y los que superen la jerarquía del bot se omiten del menú. El canal de publicación también debe permitir que el bot lo vea y envíe mensajes.

> [!WARNING]
>
> Al cambiar un grupo exclusivo, Headless asigna primero el rol seleccionado y después intenta retirar los anteriores para no dejar al miembro sin su rol previo si falla la asignación. Si Discord rechaza una parte del cambio, el resultado puede ser parcial: el miembro recibe un aviso efímero y debe revisar sus roles o pedir ayuda al staff; Headless registra el error.

## Configuración paso a paso

**1. Prepara roles seguros**

Crea roles de autoservicio y coloca el rol de Headless por encima de ellos. No uses roles con permisos de staff o administración.

**2. Crea el grupo**

En Dashboard, abre Roles → Auto Role y añade un grupo con los roles permitidos. También puedes usar el comando `group` para crear un grupo exclusivo rápidamente.

**3. Elige exclusividad y panel**

Deja el grupo exclusivo si el miembro debe elegir una sola opción, o activa selección múltiple si debe poder combinar opciones. Personaliza el título, mensaje y canal si corresponde.

**4. Publica y prueba**

Publica el panel principal con `.autorole panel` o publica el grupo desde Dashboard. Prueba la selección con una cuenta de miembro y confirma que los cambios respetan el modo y la jerarquía.

## Comandos por flujo

El grupo `autorole` es de **prefijo**; no hay un comando slash equivalente para administrarlo. Sustituye `.` si el servidor usa otro prefijo.

### Crear un grupo de roles

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

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

### Publicar y personalizar el panel

#### `.autorole panel`

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

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

También funciona: `.autorole panel #roles`

#### `.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 del menú
```

`group` acepta un nombre de una palabra seguido de menciones de roles. Si vuelves a crear un grupo con el mismo identificador normalizado, se reemplazan sus roles; el comando guarda hasta 20 roles y el servidor hasta 8 grupos. Para crear una selección múltiple o un panel individual por grupo, usa el Dashboard.

> **El miembro no ve uno de los roles**
>
> Comprueba que el rol exista, no sea administrado por una integración y esté por debajo del rol más alto de Headless. El menú omite los roles que el bot no puede administrar; una opción guardada no garantiza que sea asignable.

> **El menú dejó de responder**
>
> Confirma que Auto Role no esté apagado en Dashboard o con `.autorole off`, y que Headless aún tenga acceso al canal y mensaje del panel. Si se eliminó el mensaje o el canal, publica un panel nuevo desde el destino correcto.

> **Quiero botones ligados a mensajes o roles por reacción**
>
> Este selector no vincula cada botón o reacción con un rol. Revisa [Reaction Roles](/docs/server/roles/reaction-roles.md) para reglas por emoji y [Auto Role](/docs/server/roles/auto.md) para la asignación durante el ingreso al servidor.

## Páginas relacionadas

* [Configuración de Auto Role](/docs/server/roles/auto.md)
* [Reaction Roles](/docs/server/roles/reaction-roles.md)
* [Headless Permissions](/docs/permissions.md)


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