> ## 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.
# Moderação
> Sanções, limpeza de canais e fichas: cada ação de moderação fica registrada como um caso consultável.
Cada sanção que você aplica com a Lucie cria um **caso numerado** na ficha do servidor. Depois você pode ver os detalhes com `!case`, corrigir o motivo com `!reason` e revisar o histórico de qualquer usuário com `!modlogs`.
As permissões indicadas em cada comando também são cobertas por um **cargo de moderação autorizado** do servidor. Além disso, a Lucie respeita a hierarquia de cargos: você não pode sancionar alguém com um cargo igual ou superior ao seu.
`warn`, `unwarn`, `mute`, `unmute`, `kick`, `ban`, `softban`, `unban`
`purge`, `lock`, `unlock`, `slowmode`
`case`, `reason`, `modlogs`, `modstats`
## !warn
Adverte um usuário e registra o caso na ficha dele. A resposta mostra quantas advertências ativas ele acumula.
**Uso:** `!warn <@usuário> [motivo]`
**Atalhos:** `advertir`, `aviso`
**Permissões:** Moderar Membros
Se o servidor tiver o escalonamento automático configurado, ao acumular advertências a Lucie aplica a sanção correspondente por conta própria e a registra como um caso à parte.
**Exemplos**
```text theme={"dark"}
!warn @usuario spam en el chat
!warn 123456789012345678 flood
```
## !unwarn
Remove uma advertência pelo número do caso (você o vê em `!modlogs @usuario`). Só funciona em casos do tipo advertência que ainda estejam ativos.
**Uso:** `!unwarn [motivo]`
**Atalhos:** `delwarn`, `quitarwarn`
**Permissões:** Moderar Membros
`!unwarn` **exclui** a advertência da ficha (ela não fica como anulada) e não cria um caso próprio. Se preferir mantê-la como anulada para auditoria, anule o caso pelo [painel web](https://lucie.elxy.dev).
**Exemplos**
```text theme={"dark"}
!unwarn 12
!unwarn 12 se disculpó
```
## !mute
Isola temporariamente um usuário (timeout do Discord): ele não poderá escrever nem falar enquanto durar.
**Uso:** `!mute <@usuário> [duração] [motivo]`
**Atalhos:** `timeout`, `aislar`, `silenciar`
**Permissões:** Moderar Membros (a Lucie também precisa de **Moderar Membros**)
A duração é escrita como `45s`, `10m`, `1h`, `7d`… com um máximo de **28d** (limite do Discord). Se você não indicar a duração, ela aplica **1h**.
**Exemplos**
```text theme={"dark"}
!mute @usuario 1h spam
!mute @usuario 7d tóxico en voz
```
## !unmute
Remove o timeout de um usuário. Se ele não tiver um timeout ativo, a Lucie avisa você.
**Uso:** `!unmute <@usuário> [motivo]`
**Atalhos:** `untimeout`, `desaislar`
**Permissões:** Moderar Membros
**Exemplos**
```text theme={"dark"}
!unmute @usuario
!unmute @usuario apeló correctamente
```
## !kick
Expulsa um usuário do servidor. Ele pode voltar se tiver um convite.
**Uso:** `!kick <@usuário> [motivo]`
**Atalhos:** `expulsar`
**Permissões:** Expulsar Membros (a Lucie também precisa de **Expulsar Membros**)
**Exemplos**
```text theme={"dark"}
!kick @usuario spam de invitaciones
```
## !ban
Bane um usuário, opcionalmente de forma temporária. Aceita o ID mesmo que o usuário já não esteja no servidor.
**Uso:** `!ban <@usuário|ID> [duração] [motivo]`
**Atalhos:** `banear`
**Permissões:** Banir Membros (a Lucie também precisa de **Banir Membros**)
Se você adicionar uma duração (`45s`, `10m`, `1h`, `7d`, `2w`…), o banimento é temporário: a Lucie desbane sozinha quando ele vence.
Com o slash command `/ban` temporário, ao vencer o banimento o usuário recebe um convite de volta. Com o prefixo (`!ban 7d`), o banimento simplesmente expira sem convite.
**Exemplos**
```text theme={"dark"}
!ban @usuario raid
!ban @usuario 7d spam reincidente
!ban 123456789012345678 alt de baneado
```
## !softban
Bane e desbane na hora: serve para expulsar um usuário apagando as mensagens dele do último dia.
**Uso:** `!softban <@usuário> [motivo]`
**Permissões:** Banir Membros (a Lucie também precisa de **Banir Membros**)
**Exemplos**
```text theme={"dark"}
!softban @usuario spam masivo
```
## !unban
Desbane um usuário pelo ID.
**Uso:** `!unban [motivo]`
**Atalhos:** `desbanear`
**Permissões:** Banir Membros (a Lucie também precisa de **Banir Membros**)
**Exemplos**
```text theme={"dark"}
!unban 123456789012345678 apeló y fue aceptado
```
## !purge
Apaga mensagens recentes do canal, opcionalmente só as de um usuário. Essas ferramentas de canal não criam casos.
**Uso:** `!purge [quantidade] [@usuário]` · `!purge -p [quantidade]`
**Atalhos:** `prune`
**Permissões:** Gerenciar Mensagens (a Lucie também precisa de **Gerenciar Mensagens**) — **exceto com `-p`, que não exige permissões**
A quantidade vai de 1 a 100; se você não indicar, ela apaga 100. A confirmação se apaga sozinha depois de alguns segundos.
### Purga pessoal (`-p`)
Com `-p` você apaga **as suas próprias mensagens** sem precisar de permissões de moderação: as suas mensagens são suas. De 1 a 25 (sem quantidade apaga 25), e **só no canal onde você executa o comando** — nunca mexe nas suas mensagens de outros canais nem nas de mais ninguém, mesmo que você mencione alguém: com `-p` o alvo é sempre você.
O que foi purgado nunca volta com `!snipe`, nem na purga de moderação nem na pessoal.
Mensagens com mais de 14 dias não podem ser apagadas em massa (limite do Discord).
**Exemplos**
```text theme={"dark"}
!purge
!purge 20
!purge 50 @usuario
!purge -p
!purge -p 10
```
## !lock
Bloqueia o canal atual: só a staff pode escrever.
**Uso:** `!lock [motivo]`
**Atalhos:** `bloquear`
**Permissões:** Gerenciar Canais (a Lucie precisa de **Gerenciar Canais** e **Gerenciar Cargos** no canal)
**Exemplos**
```text theme={"dark"}
!lock
!lock raid en curso
```
## !unlock
Desbloqueia o canal: todos podem voltar a escrever.
**Uso:** `!unlock [motivo]`
**Atalhos:** `desbloquear`
**Permissões:** Gerenciar Canais (a Lucie precisa de **Gerenciar Canais** e **Gerenciar Cargos** no canal)
**Exemplos**
```text theme={"dark"}
!unlock
!unlock fin del raid
```
## !slowmode
Configura o modo lento do canal: o tempo mínimo entre as mensagens de cada usuário.
**Uso:** `!slowmode `
**Atalhos:** `slow`
**Permissões:** Gerenciar Canais (a Lucie também precisa de **Gerenciar Canais**)
Aceita segundos (`10`), durações (`5m`, `1h`) ou `off`/`0` para desativá-lo. Máximo: **6h**.
**Exemplos**
```text theme={"dark"}
!slowmode 10
!slowmode 5m
!slowmode off
```
## !case
Mostra os detalhes de um caso de moderação: tipo de sanção, usuário, moderador, motivo, duração, data e status.
**Uso:** `!case `
**Atalhos:** `caso`
**Permissões:** Moderar Membros
**Exemplos**
```text theme={"dark"}
!case 12
```
## !reason
Edita o motivo de um caso já registrado. Útil quando você sancionou às pressas e quer deixar a ficha bem documentada.
**Uso:** `!reason `
**Atalhos:** `razon`
**Permissões:** Moderar Membros
**Exemplos**
```text theme={"dark"}
!reason 12 spam reincidente en varios canales
```
## !modlogs
Mostra a ficha de moderação de um usuário: os 10 casos mais recentes dele, com contadores de casos ativos, anulados e advertências ativas. Por padrão você vê os casos **ativos**, com botões para alternar para **Anuladas** ou **Todas**.
**Uso:** `!modlogs [@usuário]`
**Atalhos:** `expediente`, `warns`, `sanciones`
**Permissões:** Moderar Membros
Sem argumento, `!modlogs` mostra **a sua própria ficha**: qualquer um pode consultá-la se o servidor ativar a ficha pública no [painel web](https://lucie.elxy.dev). Ver a ficha de outras pessoas continua exigindo permissões de moderação.
**Exemplos**
```text theme={"dark"}
!modlogs @usuario
!modlogs 123456789012345678
```
## !modstats
Ranking de sanções aplicadas por cada moderador do servidor, com o total de casos registrados.
**Uso:** `!modstats`
**Atalhos:** `modranking`
**Permissões:** Moderar Membros
**Exemplos**
```text theme={"dark"}
!modstats
```