Saltar al contenido principal

​
Permisos, jerarquía y alcance

Los comandos de prefijo .warn, .warns, .delwarn y .clearwarns solo están disponibles dentro de un servidor y exigen Moderate Members. Los ejemplos usan el prefijo predeterminado .; reemplázalo si el servidor configuró otro. Las versiones slash registradas declaran ese permiso como predeterminado; .warn, /warn y /clearwarns también validan el objetivo. Al crear o retirar una advertencia, Headless rechaza al owner del servidor, al propio bot y a miembros cuyo rol superior no esté por debajo del del bot o del moderador (salvo bypass de owner). Las consultas .warns y /warns son de solo lectura y no aplican la comprobación de jerarquía del objetivo. Los registros se separan por servidor y miembro.

​
Crear una advertencia

.warn <miembro> [motivo] y /warn crean una advertencia activa con un ID corto, guardan el moderador, motivo y fecha, crean un caso de moderación y generan una entrada para el flujo de Logs. Si omites el motivo se usa No reason provided. Headless intenta enviar un DM al miembro; un DM cerrado o fallido no revierte el registro. El alias de prefijo es .w.

​
.warn

También funciona: .w @miembro Motivo opcional

​
/warn

​
Consultar el historial

.warns <miembro> y /warns muestran el estado, ID, fecha, motivo y moderador de hasta las 20 entradas más recientes; también indican cuántas siguen activas. .warnings y .wl son aliases de prefijo. Si no hay registros, el bot responde que no existen advertencias. La lista no modifica el historial.

​
.warns

También funciona: .warnings @miembro

​
/warns

​
Retirar una o todas

.delwarn <miembro> <id> [motivo] (aliases .removewarn y .dw) marca el ID coincidente como removed; la búsqueda del ID no distingue mayúsculas. Guarda quién, cuándo y por qué lo retiró, crea un caso y registra la acción. No existe slash /delwarn. /clearwarns y .clearwarns <miembro> [motivo] (alias .cw) retiran todas las advertencias activas de ese miembro, guardan los mismos metadatos y crean un caso incluso si no había ninguna activa. El motivo opcional predeterminado es No reason provided.

​
.delwarn

Si no se puede resolver al miembro o el ID no aparece en sus advertencias de este servidor, el comando responde con un error sin guardar cambios, crear un caso ni enviar una entrada a Logs.

​
.clearwarns

​
/clearwarns

.clearwarns retira de inmediato todas las advertencias activas del miembro sin pedir confirmación. Verifica el miembro antes de ejecutarlo; usa .warns para revisar el estado y el ID.
Nota: El conteo de advertencias se muestra para revisión del equipo, pero no activa por sí mismo timeout, expulsión ni ban.

​
Comportamiento que conviene conocer

Estas acciones cambian el estado, no borran filas del historial. delwarn acepta un ID coincidente aunque ya esté retirado y vuelve a guardar sus metadatos de retiro; revisa la etiqueta activa/retirada en .warns antes de repetirlo. clearwarns se ejecuta inmediatamente, sin confirmación. No hay sanciones automáticas ni un umbral de advertencias que aplique timeout, kick o ban.

​
Pasos

1

Comprueba el servidor y el permiso

Ejecuta el comando dentro del servidor correcto y confirma Moderate Members; para cambiar registros, confirma además que la jerarquía del objetivo permita la acción.
2

Registra el contexto

Usa .warn @miembro <motivo> con una razón útil para el equipo. El motivo es opcional, pero se recomienda incluirlo.
3

Revisa antes de retirar

Consulta .warns @miembro, identifica el ID y confirma que la advertencia siga activa. Para clearwarns, verifica cuidadosamente el miembro porque no hay confirmación.
4

Comprueba el resultado

Vuelve a consultar .warns y revisa el caso o Logs si están configurados; la entrega del DM puede fallar sin cancelar la advertencia.

​
Ayuda y diagnóstico

Comprueba que el miembro pertenezca al servidor y usa una mención, nombre o ID que Headless pueda resolver. Los comandos de advertencias no operan sobre usuarios que no están en ese servidor.
Copia el ID completo mostrado por .warns para ese miembro. La búsqueda no distingue mayúsculas, pero sí debe coincidir con el ID almacenado.
La entrega se intenta después de guardar y registrar el caso. El miembro puede tener DMs de servidor cerrados o Discord puede rechazar el envío; revisa el historial, el caso y Logs en vez de repetir .warn.
No. El runtime actual solo registra y permite retirar advertencias; no implementa escalamiento automático por conteo.

​
Páginas relacionadas