> ## 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. # Advertencias > Advertencias conserva un historial auditable por servidor y miembro. Las advertencias retiradas siguen visibles y no activan sanciones automáticas por cantidad. ## 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 [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` ```headless-command Syntax theme={null} .warn [reason=No reason provided] ``` ```headless-command Example theme={null} .warn @miembro spam repetido ``` También funciona: `.w @miembro Motivo opcional` ### `/warn` ```headless-command Syntax theme={null} /warn member: [reason:] ``` ```headless-command Example theme={null} /warn member:@miembro reason:Spam repetido ``` ## Consultar el historial `.warns ` 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` ```headless-command Syntax theme={null} .warns ``` ```headless-command Example theme={null} .warns @miembro ``` También funciona: `.warnings @miembro` ### `/warns` ```headless-command Syntax theme={null} /warns member: ``` ```headless-command Example theme={null} /warns member:@miembro ``` ## Retirar una o todas `.delwarn [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 [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` ```headless-command Syntax theme={null} .delwarn [reason=No reason provided] ``` ```headless-command Example theme={null} .delwarn @miembro ABC12345 apelación aceptada ``` 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` ```headless-command Syntax theme={null} .clearwarns [reason=No reason provided] ``` ```headless-command Example theme={null} .clearwarns @miembro revisión completada ``` ### `/clearwarns` ```headless-command Syntax theme={null} /clearwarns member: [reason:] ``` ```headless-command Example theme={null} /clearwarns member:@miembro reason:Revisión ``` > [!WARNING] > > `.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 ` 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 > **El comando dice que no encontró al miembro** > > 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. > **El ID de advertencia no aparece** > > 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 advertencia se guardó pero no llegó el DM** > > 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`. > **¿Puedo configurar una sanción al llegar a tres advertencias?** > > No. El runtime actual solo registra y permite retirar advertencias; no implementa escalamiento automático por conteo. ## Páginas relacionadas * [Casos de moderación](/docs/moderation/cases.md) * [Configuración de moderación](/docs/security/moderation.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.