> ## 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.

# Member moderation commands

> Bans, kicks, mutes, timeouts, warnings, points and role management — 24 commands for acting on members.

Twenty-three commands that act on a member. Every one requires a Discord permission.

<Warning>
  **The Vetox role must sit above the target's highest role**, or Discord refuses the action regardless of permissions. This is the most common cause of "the command did nothing".
</Warning>

## Bans and kicks

| Command      | You need          | Vetox needs  | 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="/ban options" icon="hammer">
    | Option            | Required | Notes                                                 |
    | ----------------- | -------- | ----------------------------------------------------- |
    | `user`            | **Yes**  |                                                       |
    | `duration`        | No       | `7d`, `2h30m`, `permanent`. **Defaults to permanent** |
    | `reason`          | No       |                                                       |
    | `delete_messages` | No       | 0, 1, 3 or 7 days of message history                  |

    A duration makes it a temporary ban, lifted automatically.
  </Accordion>

  <Accordion title="/unban" icon="unlock">
    `user` is required and accepts a mention, the picker, or a raw ID — useful since a banned member cannot be mentioned normally. `reason` is optional.
  </Accordion>

  <Accordion title="/unban-all" icon="triangle-exclamation">
    No options. **Unbans every banned user in the server.** Administrator only, 20s cooldown, and there is no confirmation prompt or undo.
  </Accordion>
</AccordionGroup>

## Timeouts and mutes

Three different mechanisms — do not confuse them.

| Command                        | Mechanism                | You need         | Vetox needs      |
| ------------------------------ | ------------------------ | ---------------- | ---------------- |
| `/timeout`, `/untimeout`       | Discord's native timeout | Moderate Members | Moderate Members |
| `/mute-text`, `/unmute-text`   | A mute **role**          | Moderate Members | **Manage Roles** |
| `/mute-voice`, `/unmute-voice` | Server voice mute        | Mute Members     | Mute Members     |

All take `user` (required), plus optional `duration` and `reason`. Cooldowns 5–10s.

<Note>
  **`/mute-text` applies a role**, so it needs Manage Roles and depends on that role's channel overwrites being correct. `/timeout` uses Discord's built-in timeout and needs no role at all.
</Note>

<AccordionGroup>
  <Accordion title="/mute-check — who is muted" icon="magnifying-glass">
    Requires **Manage Messages**. `user` optional — omit it to list every text-muted member. Cooldown 5s.
  </Accordion>
</AccordionGroup>

## Voice

| Command  | You need     | Vetox needs  | Notes                        |
| -------- | ------------ | ------------ | ---------------------------- |
| `/vkick` | Move Members | Move Members | Disconnects from voice       |
| `/move`  | Move Members | Move Members | Moves between voice channels |

<Warning>
  **`/move` with no `user` moves you.** Every option is optional, and omitting the target defaults it to the person running the command. Always specify `user`.
</Warning>

`/move` takes `user`, `to-user` (move to whichever channel that person is in) and `to-channel`.

## Warnings and points

| Command         | You need        | 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` required, `reason` optional.

    <Warning>
      **The reason is capped at 250 characters, but Discord will let you type more.** A longer reason is accepted by the input box and then rejected on submit. Keep it under 250.
    </Warning>
  </Accordion>

  <Accordion title="/warn-remove" icon="eraser">
    `user` required. `warning-code` optional — **omitting it removes every warning** that member has.
  </Accordion>

  <Accordion title="/warnings" icon="list">
    `user` optional — omit to list every warned member. Paginated, with delete controls.
  </Accordion>

  <Accordion title="/points and /points-reset" icon="hashtag">
    `/points` takes `user` and `amount`, where amount accepts `+5`, `-5` or `5`. `/points-reset` takes an optional `user` — **omit it to reset everyone**.
  </Accordion>
</AccordionGroup>

## Roles

| Command          | You need          | Vetox needs      | 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 — toggle a role" icon="user-tag">
    `member` and `role` both required. Adds the role if absent, removes it if present.
  </Accordion>

  <Accordion title="/temprole — time-limited role" icon="clock">
    `member`, `role` and `duration` all required. The role is removed automatically when it expires.
  </Accordion>

  <Accordion title="/rar — remove all roles" icon="user-minus">
    `user` required. Strips every role Vetox is able to remove.
  </Accordion>

  <Accordion title="/role-multiple — mass role change" icon="users">
    Administrator only, 30s cooldown.

    | Option          | Required | Notes                                                                 |
    | --------------- | -------- | --------------------------------------------------------------------- |
    | `type`          | **Yes**  | `give` or `remove`                                                    |
    | `role`          | **Yes**  |                                                                       |
    | `pick_type`     | **Yes**  | `all`, `bots`, `humans` or `role`                                     |
    | `required_role` | No       | **Only used when `pick_type` is `role`** — silently ignored otherwise |

    <Warning>
      This affects every matching member at once and cannot be undone in bulk.
    </Warning>
  </Accordion>

  <Accordion title="/setnick" icon="pen">
    `user` required, `nickname` optional — omit it to reset. **Vetox can never rename the server owner**; that is a Discord restriction.
  </Accordion>

  <Accordion title="/inrole" icon="list">
    `role` required. Lists everyone holding it.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Vetox says it cannot act on that member">
    Role hierarchy — move the Vetox role above theirs. Server owners can never be actioned.
  </Accordion>

  <Accordion title="/mute-text does nothing visible">
    It applies a role. If that role has no channel overwrites denying Send Messages, the member is not actually muted.
  </Accordion>

  <Accordion title="I ran /move and moved myself">
    `user` was omitted, which defaults to you.
  </Accordion>

  <Accordion title="My warning reason was rejected">
    Over 250 characters. The input box does not stop you typing more.
  </Accordion>

  <Accordion title="/warn-remove removed every warning">
    `warning-code` was omitted, which clears them all.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Server moderation" icon="shield-halved" href="/en/commands/server-moderation">
    Channels, cleanup, giveaways and tickets.
  </Card>

  <Card title="Moderation Tools" icon="wrench" href="/en/moderation/moderation-tools">
    The dashboard equivalents.
  </Card>
</CardGroup>