> ## 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 de booster > Configura un rol cosmético por booster, su jerarquía, cambios, uso compartido con aceptación y anuncios reales de boost. Booster Roles permite que cada miembro que **está impulsando actualmente** el servidor cree y mantenga un rol cosmético personal. El módulo comienza desactivado; el primer comando `create` también lo habilita. Los comandos se usan en servidores y tienen prefijo, no hay un grupo slash equivalente. > [!NOTE] > > El módulo administra roles y anuncios; no crea recompensas de nivel ni concede beneficios de suscripción. Cada rol personal se guarda dentro de la configuración `custom_roles` de su servidor. ## Requisitos y jerarquía El runtime exige un boost activo (`premium_since`) para crear o editar el rol personal. El miembro administra su propio rol sin un permiso de staff. Headless necesita **Manage Roles** y su rol más alto debe estar por encima del rol ancla, el separador y los roles personales. Cuando el separador está habilitado, Headless lo crea o mantiene debajo del ancla y coloca los roles personales debajo de ese separador. Si se desactiva, los roles se colocan debajo del ancla. Al crear un rol, Headless lo asigna al booster y lo marca como mencionable; la opción de separarlo en la lista de miembros está activa inicialmente. * **Rol más alto de Headless** — **Uso:** Debe quedar por encima de los roles que el bot crea, mueve o asigna. * **Ancla configurada** — **Uso:** Referencia para colocar el separador o, si no se usa separador, los roles personales. * **Separador (opcional)** — **Uso:** Headless lo crea/actualiza y mantiene los roles personales debajo. * **Roles personales** — **Uso:** Uno por propietario registrado; el bot los crea, actualiza y asigna. > [!WARNING] > > Discord bloquea cambios de roles por encima del rol de Headless. Un permiso `Manage Roles` sin la jerarquía correcta no basta. Si el rol ya se creó pero falló un paso posterior —por ejemplo, aplicar el icono o moverlo— revisa el panel de Booster Roles y el último error antes de volver a intentar. ## Crear y personalizar tu rol Usa `create` para crear el rol o actualizar el que ya tienes. Puedes elegir nombre, color e icono en una misma llamada; después puedes cambiar cada propiedad por separado. El nombre admite varias palabras. Los colores se introducen en hexadecimal y Headless limpia caracteres incompatibles del nombre. * **`.boosterrole create [nombre...] [#RRGGBB] [icono]`** — **Resultado:** Crea o actualiza tu rol personal. El nombre, color e icono finales son opcionales. * **`.boosterrole name `** — **Resultado:** Cambia solo el nombre de tu rol. * **`.boosterrole color <#RRGGBB>`** — **Resultado:** Cambia el color. * **`.boosterrole icon `** — **Resultado:** Aplica un emoji, emoji personalizado, URL HTTPS de imagen compatible, sticker o imagen adjunta al mensaje del comando. * **`.boosterrole icon clear`** — **Resultado:** Quita el icono del rol. * **`.boosterrole members [@miembro o @rol]`** — **Resultado:** Muestra los miembros de tu rol; el staff autorizado puede consultar otros roles. `.boosterrole` y `.brole` abren el panel con el estado del módulo, la plantilla, la posición y el último error registrado. También se aceptan aliases como `.boosterrole crear`, `.boosterrole nombre`, `.boosterrole color` y `.boosterrole icono`. ## Compartir el rol Si compartir está habilitado, `.boosterrole share @miembro` envía al invitado una solicitud con **Aceptar** y **Rechazar**. Solo la persona invitada puede aceptar; la solicitud vence después de 10 minutos. Aceptar asigna el rol y guarda el acceso compartido. El límite predeterminado es **10 personas por rol** y la Dashboard permite configurarlo entre 0 y 100. `.boosterrole unshare @miembro` retira el rol de esa persona directamente y elimina su registro de acceso compartido; no requiere que el invitado acepte otra solicitud. > [!WARNING] > > Un rol compartido tiene los permisos que Discord le haya concedido. Revisa el rol y el miembro antes de enviarlo; desactiva `Compartir` en Dashboard si el servidor no permite que sus propietarios compartan roles personales. ## Anuncios cuando alguien impulsa el servidor Dashboard → Roles → Booster Roles permite habilitar un anuncio independiente, elegir canal y editar la mención, el título, el mensaje, los medios y hasta tres botones con enlaces HTTPS. Headless publica cuando detecta que Discord registró un boost nuevo; no anuncia la retirada de un boost. Si no se elige canal de anuncio, el runtime puede usar el canal de presentación configurado. > [!NOTE] > > Los textos y botones integrados predeterminados están en inglés. Headless migra solo los valores antiguos que coinciden exactamente con sus defaults anteriores; conserva el texto personalizado del servidor. La vista **Probar anuncio** de Dashboard genera una vista previa sin registrar un boost real. Los anuncios están desactivados inicialmente y requieren que Headless pueda enviar mensajes en el canal elegido. ## Configuración paso a paso **1. Habilita el módulo** En Dashboard, abre Roles → Booster Roles y activa el módulo. El comando `create` también lo activa al crear el primer rol. **2. Ordena la jerarquía** Elige un ancla y, si lo necesitas, un separador. Coloca el rol más alto de Headless por encima del ancla, separador y futuros roles personales. **3. Revisa acceso y apariencia** Define plantilla de nombre y color, icono, visibilidad del separador, opción de compartir y límite. Crea roles de prueba solo con permisos cosméticos. **4. Valida con un booster** Comprueba `create`, los cambios de nombre/color/icono y el flujo de invitación con un miembro que impulse actualmente el servidor. **5. Configura el anuncio si lo usarás** Selecciona un canal, habilita anuncios y revisa la vista previa. La prueba no simula ni registra un evento real de boost. ## Controles de acceso que requieren atención La Dashboard actualmente muestra los campos `Solo boosters`, `Rol requerido` y `Creación automática`, pero el código activo no permite usarlos para saltarse el requisito de boost ni para crear roles al llegar un boost: el runtime normaliza `booster_only` a activo, valida `premium_since` y no consume `required_role_id` ni `auto_create` para esta decisión. La elegibilidad efectiva sigue siendo: **boost activo para crear o editar**. ```headless-command Syntax theme={null} .boosterrole create [nombre...] [#RRGGBB] [icono] ``` ```headless-command Example theme={null} .boosterrole create VIP Rain #45E7F1 🔥 ``` #### `.boosterrole name` ```headless-command Syntax theme={null} .boosterrole name [name] ``` ```headless-command Example theme={null} .brole name VIP Rain ``` #### `.boosterrole color` ```headless-command Syntax theme={null} .boosterrole color [color] ``` ```headless-command Example theme={null} .brole color #45E7F1 ``` #### `.boosterrole icon` ```headless-command Syntax theme={null} .boosterrole icon [icon_url] ``` ```headless-command Example theme={null} .brole icon 🔥 ``` También funciona: `.brole icon clear` #### `.boosterrole share` ```headless-command Syntax theme={null} .boosterrole share ``` ```headless-command Example theme={null} .brole share @miembro ``` #### `.boosterrole unshare` ```headless-command Syntax theme={null} .boosterrole unshare ``` ```headless-command Example theme={null} .brole unshare @miembro ``` #### `.boosterrole members` ```headless-command Syntax theme={null} .boosterrole members [target] ``` ```headless-command Example theme={null} .brole members ``` > **¿Qué ocurre cuando alguien deja de impulsar?** > > El código actual no borra automáticamente su rol personal ni revoca a quienes ya lo recibieron. La persona deja de cumplir la validación de booster para crear/editar, pero la limpieza posterior no está implementada. Retira manualmente roles que deban dejar de existir y revisa primero a todos los miembros que los comparten. > **El comando responde, pero el rol no cambia** > > Confirma que el módulo esté activo, que el miembro siga impulsando y que Headless tenga `Manage Roles` y jerarquía suficiente. Los errores de Discord se guardan en `last_error` y aparecen en el panel de Booster Roles. > **¿Puede crear roles cualquier miembro con un rol requerido?** > > No. El campo visible `Rol requerido` no se consume en la validación actual. Para crear o editar hace falta un boost activo; no uses ese campo como sustituto de la regla real. ## Páginas relacionadas * [Auto Role](/docs/server/roles/auto.md) * [Roles autoasignables](/docs/server/roles/self-assignable.md) * [Embed Scripting](/docs/resources/scripting/embeds.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.