> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos de moderação de membros

> Bans, kicks, mutes, timeouts, warnings, pontos e gerenciamento de cargos — 24 comandos para agir sobre membros.

Vinte e três comandos que agem sobre um membro. Cada um exige uma permissão do Discord.

<Warning>
  **O cargo do Vetox precisa estar acima do cargo mais alto do alvo**, ou o Discord recusa a ação, independentemente das permissões. Essa é a causa mais comum de "o comando não fez nada".
</Warning>

## Bans e kicks

| Comando      | Você precisa      | O Vetox precisa | Cooldown |
| ------------ | ----------------- | --------------- | -------- |
| `/ban`       | Ban Members       | Ban Members     | 10s      |
| `/unban`     | Ban Members       | Ban Members     | 5s       |
| `/unban-all` | **Administrator** | Ban Members     | 20s      |
| `/kick`      | Kick Members      | Kick Members    | 10s      |

<AccordionGroup>
  <Accordion title="opções de /ban" icon="hammer">
    | Opção             | Obrigatória | Observações                                        |
    | ----------------- | ----------- | -------------------------------------------------- |
    | `user`            | **Sim**     |                                                    |
    | `duration`        | Não         | `7d`, `2h30m`, `permanent`. **Padrão: permanente** |
    | `reason`          | Não         |                                                    |
    | `delete_messages` | Não         | 0, 1, 3 ou 7 dias de histórico de mensagens        |

    Uma duração torna o ban temporário, sendo removido automaticamente.
  </Accordion>

  <Accordion title="/unban" icon="unlock">
    `user` é obrigatório e aceita uma menção, o seletor ou um ID puro — útil porque um membro banido não pode ser mencionado normalmente. `reason` é opcional.
  </Accordion>

  <Accordion title="/unban-all" icon="triangle-exclamation">
    Sem opções. **Desbane todos os usuários banidos no servidor.** Apenas Administrator, cooldown 20s, e não há confirmação ou desfazer.
  </Accordion>
</AccordionGroup>

## Timeouts e mutes

Três mecanismos diferentes — não os confunda.

| Comando                        | Mecanismo                 | Você precisa     | O Vetox precisa  |
| ------------------------------ | ------------------------- | ---------------- | ---------------- |
| `/timeout`, `/untimeout`       | Timeout nativo do Discord | Moderate Members | Moderate Members |
| `/mute-text`, `/unmute-text`   | Um **cargo** de mute      | Moderate Members | **Manage Roles** |
| `/mute-voice`, `/unmute-voice` | Mute de voz do servidor   | Mute Members     | Mute Members     |

Todos recebem `user` (obrigatório), além de `duration` e `reason` opcionais. Cooldowns 5–10s.

<Note>
  **`/mute-text` aplica um cargo**, então precisa de Manage Roles e depende das overwrites de canal desse cargo estarem corretas. `/timeout` usa o timeout nativo do Discord e não precisa de cargo algum.
</Note>

<AccordionGroup>
  <Accordion title="/mute-check — quem está mutado" icon="magnifying-glass">
    Requer **Manage Messages**. `user` opcional — omita para listar todos os membros com mute de texto. Cooldown 5s.
  </Accordion>
</AccordionGroup>

## Voz

| Comando  | Você precisa | O Vetox precisa | Observações              |
| -------- | ------------ | --------------- | ------------------------ |
| `/vkick` | Move Members | Move Members    | Desconecta da voz        |
| `/move`  | Move Members | Move Members    | Move entre canais de voz |

<Warning>
  **`/move` sem `user` move você.** Todas as opções são opcionais, e omitir o alvo faz padrão para quem executa o comando. Sempre especifique `user`.
</Warning>

`/move` aceita `user`, `to-user` (move para o canal em que essa pessoa está) e `to-channel`.

## Warnings e pontos

| Comando         | Você precisa    | Cooldown |
| --------------- | --------------- | -------- |
| `/warn-add`     | Manage Messages | 5s       |
| `/warn-remove`  | Manage Messages | 5s       |
| `/warnings`     | Manage Messages | 5s       |
| `/points`       | Manage Server   | 5s       |
| `/points-reset` | Manage Server   | 5s       |

<AccordionGroup>
  <Accordion title="/warn-add" icon="triangle-exclamation">
    `user` obrigatório, `reason` opcional.

    <Warning>
      **A razão tem limite de 250 caracteres, mas o Discord deixará você digitar mais.** Uma razão mais longa é aceita pela caixa de entrada e depois rejeitada no envio. Mantenha abaixo de 250.
    </Warning>
  </Accordion>

  <Accordion title="/warn-remove" icon="eraser">
    `user` obrigatório. `warning-code` opcional — **omiti-lo remove todos os warnings** que o membro tem.
  </Accordion>

  <Accordion title="/warnings" icon="list">
    `user` opcional — omita para listar todos os membros com warnings. Paginado, com controles de exclusão.
  </Accordion>

  <Accordion title="/points e /points-reset" icon="hashtag">
    `/points` aceita `user` e `amount`, onde amount aceita `+5`, `-5` ou `5`. `/points-reset` aceita um `user` opcional — **omita para resetar todos**.
  </Accordion>
</AccordionGroup>

## Cargos

| Comando          | Você precisa      | O Vetox precisa  | Cooldown |
| ---------------- | ----------------- | ---------------- | -------- |
| `/role`          | Manage Roles      | Manage Roles     | 3s       |
| `/temprole`      | Manage Roles      | Manage Roles     | 5s       |
| `/rar`           | Manage Roles      | Manage Roles     | 10s      |
| `/role-multiple` | **Administrator** | Manage Roles     | 30s      |
| `/setnick`       | Manage Nicknames  | Manage Nicknames | 5s       |
| `/inrole`        | Manage Server     | —                | 10s      |

<AccordionGroup>
  <Accordion title="/role — alternar um cargo" icon="user-tag">
    `member` e `role` ambos obrigatórios. Adiciona o cargo se ausente, remove se presente.
  </Accordion>

  <Accordion title="/temprole — cargo temporário" icon="clock">
    `member`, `role` e `duration` todos obrigatórios. O cargo é removido automaticamente quando expira.
  </Accordion>

  <Accordion title="/rar — remover todos os cargos" icon="user-minus">
    `user` obrigatório. Remove todos os cargos que o Vetox conseguir remover.
  </Accordion>

  <Accordion title="/role-multiple — alteração massiva de cargos" icon="users">
    Apenas Administrator, cooldown 30s.

    | Opção           | Obrigatória | Observações                                                                            |
    | --------------- | ----------- | -------------------------------------------------------------------------------------- |
    | `type`          | **Sim**     | `give` ou `remove`                                                                     |
    | `role`          | **Sim**     |                                                                                        |
    | `pick_type`     | **Sim**     | `all`, `bots`, `humans` ou `role`                                                      |
    | `required_role` | Não         | **Usado apenas quando `pick_type` é `role`** — ignorado silenciosamente caso contrário |

    <Warning>
      Isso afeta todos os membros correspondentes de uma vez e não pode ser desfeito em massa.
    </Warning>
  </Accordion>

  <Accordion title="/setnick" icon="pen">
    `user` obrigatório, `nickname` opcional — omita para redefinir. **O Vetox nunca pode renomear o dono do servidor**; é uma restrição do Discord.
  </Accordion>

  <Accordion title="/inrole" icon="list">
    `role` obrigatório. Lista todos que o possuem.
  </Accordion>
</AccordionGroup>

## Solução de problemas

<AccordionGroup>
  <Accordion title="O Vetox diz que não pode agir sobre esse membro">
    Hierarquia de cargos — mova o cargo do Vetox acima do dele. Donos de servidor nunca podem ser afetados.
  </Accordion>

  <Accordion title="/mute-text não faz nada visível">
    Ele aplica um cargo. Se esse cargo não tiver overwrites de canal negando Send Messages, o membro não fica realmente mutado.
  </Accordion>

  <Accordion title="Rodei /move e movi a mim mesmo">
    `user` foi omitido, e o padrão é você.
  </Accordion>

  <Accordion title="Minha razão de warning foi rejeitada">
    Mais de 250 caracteres. A caixa de entrada não impede você de digitar mais.
  </Accordion>

  <Accordion title="/warn-remove removeu todos os warnings">
    `warning-code` foi omitido, o que limpa todos.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Moderação de servidor" icon="shield-halved" href="/pt/commands/server-moderation">
    Canais, limpeza, giveaways e tickets.
  </Card>

  <Card title="Ferramentas de Moderação" icon="wrench" href="/pt/moderation/moderation-tools">
    Os equivalentes no dashboard.
  </Card>
</CardGroup>