# Moderação

Use /ban, /kick e /mute no Discord com motivo e provas, registre cada caso e desfaça punições pelo painel do FiveDash.

Source: https://fivedash.fivex.gg/docs/pt/discord/moderation

A Moderação dá à equipe da sua cidade os comandos **/ban**, **/kick** e **/mute** no Discord, com motivo obrigatório, até 3 provas no próprio comando e um registro de cada caso no painel. Quem punir, quem pode punir e quem nunca é punido ficam configurados em **Discord → Moderação**. É para donos e staff que querem punições justas, rastreáveis e fáceis de revisar.

## Antes de começar

* O módulo **Discord** precisa estar no plano da organização. A Moderação vem em todos os planos (Plus, Pro e Ultra).
* O bot da cidade precisa estar conectado ao servidor do Discord. Veja [Bot](https://fivedash.fivex.gg/docs/pt/discord/bot).
* O cargo do bot precisa destas permissões: **Banir membros**, **Expulsar membros**, **Castigar membros**, **Enviar mensagens** e **Inserir links**. Se faltar alguma, a página mostra o aviso e quais faltam.
* O cargo do bot precisa estar **acima** do cargo mais alto de quem ele vai punir (Configurações do servidor → Cargos).

Nível de acesso no painel (área **Moderação**):

| Nível          | O que permite                              |
| -------------- | ------------------------------------------ |
| **Ver**        | Registro de punições                       |
| **Gerenciar**  | Desbanir, tirar do castigo e anexar provas |
| **Configurar** | Comandos, cargos e mensagens               |

## Ligar os comandos

### Abra a Moderação

No painel, vá em **Discord → Moderação** e abra a aba **Configurações**.

### Escolha os comandos

Em **Comandos**, ligue os que a equipe vai usar: **Banir**, **Expulsar** e **Castigar**. Cada um tem a chave **Ligar /ban**, **Ligar /kick** ou **Ligar /mute**. O desbanimento (**/unban**) vem junto com o **/ban**, e o fim do castigo (**/unmute**) vem junto com o **/mute**.

### Defina quem pode usar

Em **Quem pode usar**, escolha os cargos que podem usar cada comando. Sem cargos escolhidos, aparece **Só administradores**: só quem tem Administrador no servidor usa.

### Proteja quem não pode ser punido

No grupo **Proteção**, escolha **Cargos protegidos** e **Membros protegidos**. Ninguém pune essas pessoas por nenhum comando.

### Escolha onde registrar

Em **Registro no Discord → Onde registrar**, escolha **Só no painel**, **Um canal** ou **Um por comando** e os canais.

### Salve

Clique em **Salvar** na barra de **Você tem alterações não salvas**. Se o Discord responder, aparece **Comandos atualizados no Discord** com a lista dos comandos disponíveis.

> Os comandos só ficam registrados no servidor enquanto estão ligados. Se aparecer **Salvo, mas os comandos não mudaram no Discord**, abra a visão geral do bot e clique em verificar de novo.

## Os comandos no Discord

As respostas dos comandos são privadas: só quem usou o comando vê. Os nomes dos comandos e das opções ficam sempre como abaixo, em qualquer idioma da cidade.

| Comando   | Opções                                                                                                         | O que faz                                                                   |
| --------- | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `/ban`    | `membro` (obrigatório, aceita o ID), `motivo` (obrigatório), `prova`, `prova_2`, `prova_3`, `apagar_mensagens` | Bane o membro do servidor. Ele não volta até alguém desbanir.               |
| `/unban`  | `usuario` (obrigatório, cole o ID), `motivo` (opcional)                                                        | Tira o banimento. Vira um caso de **Desbanimento**.                         |
| `/kick`   | `membro` (obrigatório), `motivo` (obrigatório), `prova`, `prova_2`, `prova_3`                                  | Expulsa o membro. Ele pode voltar pelo convite.                             |
| `/mute`   | `membro` (obrigatório), `duracao` (obrigatório), `motivo` (obrigatório), `prova`, `prova_2`, `prova_3`         | Usa o castigo do Discord: o membro não fala, não reage e não entra em call. |
| `/unmute` | `membro` (obrigatório), `motivo` (opcional)                                                                    | Tira o membro do castigo. Vira um caso de **Fim do castigo**.               |

O `motivo` aceita até 500 caracteres. Veja todos os comandos do bot em [Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands).

### Durações do /mute

`duracao` aceita: 1 minuto, 5 minutos, 10 minutos, 30 minutos, 1 hora, 3 horas, 6 horas, 12 horas, 1 dia, 3 dias, 1 semana, 2 semanas e 28 dias (o máximo do Discord).

### Apagar mensagens no /ban

`apagar_mensagens` é opcional. Sem escolher, nada é apagado.

| Opção                   | Apaga as mensagens do membro             |
| ----------------------- | ---------------------------------------- |
| **Não apagar**          | Nenhuma (padrão)                         |
| **Da última hora**      | Da última hora                           |
| **Das últimas 6 horas** | Das últimas 6 horas                      |
| **Do último dia**       | Das últimas 24 horas                     |
| **Dos últimos 3 dias**  | Dos últimos 3 dias                       |
| **Dos últimos 7 dias**  | Dos últimos 7 dias (o máximo do Discord) |

### Quem pode ser punido

O bot recusa o comando quando:

* a pessoa tenta punir a si mesma, o bot ou o dono do servidor;
* o alvo tem um cargo protegido ou está nos membros protegidos;
* o cargo mais alto do alvo é igual ou acima do cargo mais alto de quem usou o comando (um Suporte não pune um Moderador);
* o cargo do bot está abaixo do cargo mais alto do alvo;
* o alvo de um **/mute** é administrador (o Discord não deixa castigar administradores).

> Se a [Proteção](https://fivedash.fivex.gg/docs/pt/discord/protection) estiver com os **Limites da staff** ligados, o **/ban** e o **/kick** do FiveDash contam para o limite de banimentos e expulsões. Um moderador que passar do limite é parado.

## Configurações

### Comandos

| Campo                                | O que faz                                                                                                  | Padrão                          |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Ligar /ban**                       | Registra o **/ban** e o **/unban** no servidor.                                                            | Ligado                          |
| **Ligar /kick**                      | Registra o **/kick** no servidor.                                                                          | Ligado                          |
| **Ligar /mute**                      | Registra o **/mute** e o **/unmute** no servidor.                                                          | Ligado                          |
| **Quem pode usar** (em cada comando) | Os cargos que podem usar o comando. Quem tem um desses cargos (ou Administrador) pode usar. Até 25 cargos. | Nenhum (**Só administradores**) |

### Proteção

| Campo                  | O que faz                                                                        | Padrão |
| ---------------------- | -------------------------------------------------------------------------------- | ------ |
| **Cargos protegidos**  | Quem tem um desses cargos não pode ser punido por nenhum comando. Até 25 cargos. | Nenhum |
| **Membros protegidos** | Pessoas específicas que ninguém pune, seja qual for o cargo. Até 50 membros.     | Nenhum |

### Registro no Discord

| Opção de **Onde registrar** | O que faz                                                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Só no painel**            | Nada vai para o Discord. Os casos ficam só na aba **Registro**. Padrão.                                                                         |
| **Um canal**                | Todos os comandos no mesmo canal. Pede o **Canal do registro**.                                                                                 |
| **Um por comando**          | Cada comando no seu canal. Pede o **Canal do registro de /ban**, **/kick** e **/mute** (cada canal recebe também as revogações do seu comando). |

Cada punição e cada revogação viram uma mensagem no canal escolhido.

### Mensagem privada

| Campo                      | O que faz                                                                                                   | Padrão        |
| -------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------- |
| **Avisar o membro por DM** | O membro recebe o motivo no privado. No ban e no kick a DM vai antes, porque depois o bot não alcança mais. | Ligado        |
| **Mostrar quem puniu**     | Coloca o nome do moderador na DM. Desligado, a equipe fica anônima.                                         | Desligado     |
| **Mensagens**              | Abre **Personalizar mensagens**: o texto e a imagem da DM de cada comando.                                  | Textos padrão |
| **Embed**                  | Abre **Personalizar embed**: a cor de cada ação, a foto do membro no registro e o servidor no topo da DM.   | Veja abaixo   |

### Personalizar mensagens

Uma aba por comando (**DM de /ban**, **DM de /kick**, **DM de /mute**). Cada texto aceita até 1.500 caracteres e uma **Imagem** opcional, larga (2:1), no fim da DM: PNG, JPG, WebP ou GIF de até 1 MB.

Variáveis que os textos aceitam:

| Variável     | O que mostra                     |
| ------------ | -------------------------------- |
| `{membro}`   | Marca o membro punido (@Jogador) |
| `{nome}`     | O nome do membro punido          |
| `{servidor}` | O nome do servidor do Discord    |
| `{motivo}`   | O motivo escrito no comando      |
| `{duracao}`  | Quanto tempo dura o castigo      |
| `{caso}`     | O número do caso (#012)          |

Texto padrão da DM de **/ban**:

```text
{{error}} Você foi **banido** de **{servidor}**.
**Motivo:** {motivo}
```

> Com **Avisar o membro por DM** ligado, nenhuma das três mensagens pode ficar vazia. O painel não salva e mostra, por exemplo, **Escreva a DM de /ban.**

### Personalizar embed

| Campo                          | O que faz                                                               | Padrão    |
| ------------------------------ | ----------------------------------------------------------------------- | --------- |
| **Cor** de **Banimento**       | O registro, a DM e a resposta do /ban.                                  | `#ED4245` |
| **Cor** de **Expulsão**        | O registro, a DM e a resposta do /kick.                                 | `#F0B232` |
| **Cor** de **Castigo**         | O registro, a DM e a resposta do /mute.                                 | `#9B84EE` |
| **Cor** de **Revogações**      | O registro do /unban e do /unmute (e de quem foi revogado pelo painel). | `#57F287` |
| **Foto do membro no registro** | A foto de quem foi punido no canto da mensagem.                         | Ligado    |
| **Servidor no topo da DM**     | O nome e o ícone do servidor em cima da mensagem privada.               | Ligado    |

A prévia ao lado mostra o resultado em três vistas: **Registro**, **DM** e **Resposta**.

## O registro de punições

A aba **Registro** lista cada **/ban**, **/kick** e **/mute** usado no Discord, com o motivo e as provas.

* **Blocos no topo**: **Banimentos** (quantos em vigor), **Castigos** (quem está de castigo agora), **Expulsões** e **Revogações**. Clique em um bloco para filtrar.
* **Busca**: por membro, moderador, motivo, ID ou número do caso (`#12` ou `12`).
* **Colunas**: **Caso**, **Moderador**, **Situação** e **Quando**.
* **Por página**: 10, 20 ou 50 linhas.

Situações de um caso:

| Situação     | Quando aparece                                                    |
| ------------ | ----------------------------------------------------------------- |
| **Em vigor** | Banimento ainda valendo, ou castigo que ainda não terminou.       |
| **Terminou** | Castigo que acabou no fim do tempo.                               |
| **Revogado** | Banimento ou castigo desfeito por /unban, /unmute ou pelo painel. |

Expulsões e revogações não ficam "em vigor": o membro expulso pode voltar pelo convite.

### Abrir um caso

Clique em uma linha para abrir o caso. Ele mostra **Moderador**, **Quando**, **Duração**, **Mensagens** (apagadas ou mantidas), **DM** (entregue ou não), **Registro**, o **Motivo**, as **Provas** e a **Linha do tempo**. Use **Copiar ID** para copiar o ID do membro e **Ver no registro** para abrir a mensagem no Discord.

## Desfazer uma punição pelo painel

Precisa do nível **Gerenciar**.

### Abra o caso

Em **Discord → Moderação → Registro**, clique no banimento ou castigo que está **Em vigor**.

### Clique para revogar

Clique em **Desbanir** (banimento) ou **Tirar do castigo** (castigo).

### Escreva o motivo, se quiser

O **Motivo (opcional)** vai no registro do Discord e no log de auditoria do servidor. Sem motivo, fica "Revogado pelo painel".

### Confirme

Confirme. A revogação vira um novo caso: aparece **Registrado como caso #N**.

## Anexar provas

Precisa do nível **Gerenciar**.

* No comando, a equipe envia até 3 provas (`prova`, `prova_2`, `prova_3`). Pelo comando, o bot guarda imagens de até 8 MB e vídeos de até 25 MB; o que passar disso precisa ser anexado pelo painel.
* No painel, abra o caso e use **Anexar provas** (ou **Adicionar**): arraste ou escolha prints e vídeos. Imagens PNG, JPG, WebP ou GIF e vídeos MP4, MOV ou WebM, até 25 MB cada.
* Um caso guarda até 10 provas.
* Para tirar uma prova, use **Remover** ao lado dela.

## Perguntas frequentes

**O comando não aparece no Discord. O que faço?**
Confira se ele está ligado em **Configurações** e salve. Se o painel avisar que os comandos não mudaram no Discord, abra a página do bot e verifique de novo.

**A DM não chegou ao membro.**
O membro pode ter as DMs fechadas. O caso mostra **Não chegou (DMs fechadas ou desligadas)** na linha **DM**. A punição vale do mesmo jeito.

**Por que o bot diz que não pode punir alguém?**
Ou o cargo do bot está abaixo do cargo do membro, ou o membro tem um cargo igual ou acima do seu, ou ele está protegido. Arraste o cargo do bot para cima em Configurações do servidor → Cargos.

**Dá para usar a moderação sem mandar nada para o Discord?**
Sim. Em **Onde registrar**, escolha **Só no painel** e desligue **Avisar o membro por DM**.

## Próximos passos

[Proteção](https://fivedash.fivex.gg/docs/pt/discord/protection)Anti-link, anti-spam, limites da staff e anti-raid.
[Alinhamento](https://fivedash.fivex.gg/docs/pt/discord/alignment)Chame alguém para conversar com prazo.
[Comandos](https://fivedash.fivex.gg/docs/pt/discord/commands)Todos os comandos do bot e quem usa.
[Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions)Dê o nível certo para cada pessoa.