create también lo habilita. Los comandos se usan en servidores y tienen prefijo, no hay un grupo slash equivalente.
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.
Crear y personalizar tu rol
Usacreate 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 <nombre...>— Resultado: Cambia solo el nombre de tu rol..boosterrole color <#RRGGBB>— Resultado: Cambia el color..boosterrole icon <fuente>— 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.
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.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.
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 camposSolo 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.
.boosterrole name
.boosterrole color
.boosterrole icon
.brole icon clear
.boosterrole share
.boosterrole unshare
.boosterrole members
¿Qué ocurre cuando alguien deja de impulsar?
¿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
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?
¿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.