> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lucie.elxy.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Moderación
> Sanciones, limpieza de canales y expedientes: cada acción de moderación queda registrada como un caso consultable.
Cada sanción que aplicas con Lucie crea un **caso numerado** en el expediente del servidor. Luego puedes ver su detalle con `!case`, corregir su razón con `!reason` y repasar el historial de cualquier usuario con `!modlogs`.
Los permisos indicados en cada comando también se cubren con un **rol de moderación autorizado** del servidor. Además, Lucie respeta la jerarquía de roles: no puedes sancionar a alguien con un rol igual o superior al tuyo.
`warn`, `unwarn`, `mute`, `unmute`, `kick`, `ban`, `softban`, `unban`
`purge`, `lock`, `unlock`, `slowmode`
`case`, `reason`, `modlogs`, `modstats`
## !warn
Advierte a un usuario y registra el caso en su expediente. La respuesta muestra cuántas advertencias activas acumula.
**Uso:** `!warn <@usuario> [razón]`
**Alias:** `advertir`, `aviso`
**Permisos:** Moderar Miembros
Si el servidor tiene configurado el escalado automático, al acumular advertencias Lucie aplica la sanción correspondiente por su cuenta y la registra como un caso aparte.
**Ejemplos**
```text theme={"dark"}
!warn @usuario spam en el chat
!warn 123456789012345678 flood
```
## !unwarn
Retira una advertencia por su número de caso (lo ves en `!modlogs @usuario`). Solo funciona sobre casos de tipo advertencia que sigan activos.
**Uso:** `!unwarn [razón]`
**Alias:** `delwarn`, `quitarwarn`
**Permisos:** Moderar Miembros
`!unwarn` **elimina** la advertencia del expediente (no queda como anulada) y no crea un caso propio. Si prefieres conservarla como anulada para auditoría, anula el caso desde el [panel web](https://lucie.elxy.dev).
**Ejemplos**
```text theme={"dark"}
!unwarn 12
!unwarn 12 se disculpó
```
## !mute
Aísla temporalmente a un usuario (timeout de Discord): no podrá escribir ni hablar mientras dure.
**Uso:** `!mute <@usuario> [duración] [razón]`
**Alias:** `timeout`, `aislar`, `silenciar`
**Permisos:** Moderar Miembros (Lucie también necesita **Moderar Miembros**)
La duración se escribe como `45s`, `10m`, `1h`, `7d`… con un máximo de **28d** (límite de Discord). Si no indicas duración, aplica **1h**.
**Ejemplos**
```text theme={"dark"}
!mute @usuario 1h spam
!mute @usuario 7d tóxico en voz
```
## !unmute
Retira el timeout de un usuario. Si no tiene un timeout activo, Lucie te lo dirá.
**Uso:** `!unmute <@usuario> [razón]`
**Alias:** `untimeout`, `desaislar`
**Permisos:** Moderar Miembros
**Ejemplos**
```text theme={"dark"}
!unmute @usuario
!unmute @usuario apeló correctamente
```
## !kick
Expulsa a un usuario del servidor. Puede volver si tiene una invitación.
**Uso:** `!kick <@usuario> [razón]`
**Alias:** `expulsar`
**Permisos:** Expulsar Miembros (Lucie también necesita **Expulsar Miembros**)
**Ejemplos**
```text theme={"dark"}
!kick @usuario spam de invitaciones
```
## !ban
Banea a un usuario, opcionalmente de forma temporal. Acepta la ID aunque el usuario ya no esté en el servidor.
**Uso:** `!ban <@usuario|ID> [duración] [razón]`
**Alias:** `banear`
**Permisos:** Banear Miembros (Lucie también necesita **Banear Miembros**)
Si añades una duración (`45s`, `10m`, `1h`, `7d`, `2w`…) el baneo es temporal: Lucie desbanea sola cuando vence.
Con el slash command `/ban` temporal, al vencer el baneo el usuario recibe una invitación de regreso. Con el prefijo (`!ban 7d`), el baneo simplemente expira sin invitación.
**Ejemplos**
```text theme={"dark"}
!ban @usuario raid
!ban @usuario 7d spam reincidente
!ban 123456789012345678 alt de baneado
```
## !softban
Banea y desbanea al instante: sirve para expulsar a un usuario borrando sus mensajes del último día.
**Uso:** `!softban <@usuario> [razón]`
**Permisos:** Banear Miembros (Lucie también necesita **Banear Miembros**)
**Ejemplos**
```text theme={"dark"}
!softban @usuario spam masivo
```
## !unban
Desbanea a un usuario por su ID.
**Uso:** `!unban [razón]`
**Alias:** `desbanear`
**Permisos:** Banear Miembros (Lucie también necesita **Banear Miembros**)
**Ejemplos**
```text theme={"dark"}
!unban 123456789012345678 apeló y fue aceptado
```
## !purge
Borra mensajes recientes del canal, opcionalmente solo los de un usuario. Estas herramientas de canal no crean casos.
**Uso:** `!purge [cantidad] [@usuario]` · `!purge -p [cantidad]`
**Alias:** `prune`
**Permisos:** Gestionar Mensajes (Lucie también necesita **Gestionar Mensajes**) — **salvo con `-p`, que no pide permisos**
La cantidad va de 1 a 100; si no la indicas, borra 100. La confirmación se borra sola a los pocos segundos.
### Purga personal (`-p`)
Con `-p` borras **tus propios mensajes** sin necesitar permisos de moderación: tus mensajes son tuyos. De 1 a 25 (sin cantidad borra 25), y **solo del canal donde ejecutas el comando** — nunca toca tus mensajes de otros canales ni los de nadie más, aunque menciones a alguien: con `-p` el objetivo siempre eres tú.
Lo purgado nunca vuelve con `!snipe`, ni en la purga de moderación ni en la personal.
Los mensajes con más de 14 días no se pueden borrar en masa (límite de Discord).
**Ejemplos**
```text theme={"dark"}
!purge
!purge 20
!purge 50 @usuario
!purge -p
!purge -p 10
```
## !lock
Bloquea el canal actual: solo el staff puede escribir.
**Uso:** `!lock [razón]`
**Alias:** `bloquear`
**Permisos:** Gestionar Canales (Lucie necesita **Gestionar Canales** y **Gestionar Roles** en el canal)
**Ejemplos**
```text theme={"dark"}
!lock
!lock raid en curso
```
## !unlock
Desbloquea el canal: todos pueden volver a escribir.
**Uso:** `!unlock [razón]`
**Alias:** `desbloquear`
**Permisos:** Gestionar Canales (Lucie necesita **Gestionar Canales** y **Gestionar Roles** en el canal)
**Ejemplos**
```text theme={"dark"}
!unlock
!unlock fin del raid
```
## !slowmode
Configura el modo lento del canal: el tiempo mínimo entre mensajes de cada usuario.
**Uso:** `!slowmode `
**Alias:** `slow`
**Permisos:** Gestionar Canales (Lucie también necesita **Gestionar Canales**)
Acepta segundos (`10`), duraciones (`5m`, `1h`) o `off`/`0` para desactivarlo. Máximo: **6h**.
**Ejemplos**
```text theme={"dark"}
!slowmode 10
!slowmode 5m
!slowmode off
```
## !case
Muestra el detalle de un caso de moderación: tipo de sanción, usuario, moderador, razón, duración, fecha y estado.
**Uso:** `!case `
**Alias:** `caso`
**Permisos:** Moderar Miembros
**Ejemplos**
```text theme={"dark"}
!case 12
```
## !reason
Edita la razón de un caso ya registrado. Útil cuando sancionaste rápido y quieres dejar el expediente bien documentado.
**Uso:** `!reason `
**Alias:** `razon`
**Permisos:** Moderar Miembros
**Ejemplos**
```text theme={"dark"}
!reason 12 spam reincidente en varios canales
```
## !modlogs
Muestra el expediente de moderación de un usuario: sus 10 casos más recientes, con contadores de casos activos, anulados y advertencias activas. Por defecto ves los casos **activos**, con botones para cambiar a **Anuladas** o **Todas**.
**Uso:** `!modlogs [@usuario]`
**Alias:** `expediente`, `warns`, `sanciones`
**Permisos:** Moderar Miembros
Sin argumento, `!modlogs` muestra **tu propio expediente**: cualquiera puede consultarlo si el servidor activa el expediente público en el [panel web](https://lucie.elxy.dev). Ver el expediente de otros sigue requiriendo permisos de moderación.
**Ejemplos**
```text theme={"dark"}
!modlogs @usuario
!modlogs 123456789012345678
```
## !modstats
Ranking de sanciones aplicadas por cada moderador del servidor, con el total de casos registrados.
**Uso:** `!modstats`
**Alias:** `modranking`
**Permisos:** Moderar Miembros
**Ejemplos**
```text theme={"dark"}
!modstats
```