Elige el flujo
Auto Role configura roles de entrada para humanos y bots, además de los paneles donde los miembros pueden seleccionar roles. Consulta Auto roles para configurar la asignación al entrar y Roles autoasignables para publicar y mantener los selectores. Reaction Roles vincula reacciones de un mensaje con roles; Booster Roles administra roles y anuncios relacionados con boosts.Permisos
La jerarquía de roles de Discord sigue aplicándose: el rol del bot debe estar por encima de cada rol que asigna o retira. Las opciones administrativas también comprueban los permisos que exige cada módulo.Restaurar roles elegibles
.restore <usuario> [fuente] [razón] intenta devolver roles que Headless registró como retirados. Los aliases de prefijo son .rr, .rs, .res y .restaurar. /restore y /rs ofrecen las mismas fuentes auto, jail, logs e history; la opción slash se llama source y usa history aunque la etiqueta visible sea «Historial».
En modo auto, Headless prueba los roles guardados por Jail, después los cambios recientes de roles registrados en Logs/Cases y, por último, los nombres de roles de User History. Logs y Cases se revisan hasta 4.000 entradas recientes por fuente; para cada rol se considera el evento más reciente y solo se propone si fue una retirada. User History resuelve nombres sin distinguir mayúsculas, pero omite nombres duplicados o roles eliminados. Las fuentes explícitas limitan la búsqueda a esa fuente. Si no existe una fuente segura, el comando no adivina.
Cuando hay una fuente de Jail, Headless también intenta retirar el rol Jail. El registro de Jail se borra solo después de que las operaciones de Discord terminan sin error; si Discord falla durante los cambios, el registro se conserva para poder investigar o volver a intentar. La restauración puede aplicar hasta 25 roles elegibles. Los roles que ya existen en el miembro, se borraron, son administrados por una integración o no superan la validación actual se omiten.
El comando de prefijo exige Manage Roles al usuario y a Headless. Discord marca /restore y /rs con Manage Roles como permiso predeterminado; Headless además necesita Manage Roles y valida la jerarquía del actor, del miembro objetivo y de cada rol. No puede modificar @everyone, roles administrados, al owner del servidor ni roles iguales o superiores al actor o al bot; un administrador, el owner del servidor o el owner de Headless puede restaurar un rol con Administrator.
.restore @Member logs Reposición revisada
1
Comprueba la fuente disponible
Usa
auto para que Headless consulte sus fuentes en orden, o elige jail, logs o history si quieres limitar la búsqueda. El historial se guarda por servidor; no se buscan roles por similitud.2
Ejecuta la restauración
Menciona al miembro o usa su ID. Añade una razón para que quede registrada en el caso y en el log de la operación.
3
Revisa el resultado antes de repetir
Comprueba los roles aplicados y omitidos, el historial de casos y los logs. Una respuesta de error de Discord puede ocurrir después de que alguna operación previa ya se haya completado.
¿Qué puede recuperar cada fuente?
¿Qué puede recuperar cada fuente?
jail usa los roles guardados en el registro activo de Jail; logs usa retiradas recientes identificadas por ID de rol; history intenta resolver nombres guardados en User History cuando existe una coincidencia única. auto prueba esas tres fuentes en ese orden.¿Por qué se omitió un rol o no se limpió Jail?
¿Por qué se omitió un rol o no se limpió Jail?
Puede que el rol ya no exista, el miembro ya lo tenga, la integración lo administre o la jerarquía/permisos actuales no permitan modificarlo. Si una llamada a Discord falla, Headless informa el error y conserva el registro de Jail; revisa el estado real del miembro antes de repetir el comando.