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

# General & Member Moderation

> Ban, kick, timeout, warn, mass-role, purge messages, list server audits, and manage moderator hierarchies.

# General Moderation Suite

<Badge variant="pro">Tier 2: Pro</Badge>

> Complete toolkit for server administrators and moderators to maintain order, discipline violators, batch-assign roles, purge messages, and inspect server statistics.

***

## Commands Overview

| Command      | Aliases           | Syntax                                      | Description                                                 | Permissions          |
| :----------- | :---------------- | :------------------------------------------ | :---------------------------------------------------------- | :------------------- |
| `.mod`       | —                 | `.mod <subcommand> [argument]`              | Manages server moderators, immunity, and audit logs.        | Administrator        |
| `.ban`       | `hackban`         | `.ban <@user\|userid> [reason]`             | Bans a member from the server.                              | BanMembers           |
| `.unban`     | —                 | `.unban <userid> [reason]`                  | Unbans a user by their user ID.                             | BanMembers           |
| `.unbanall`  | —                 | `.unbanall`                                 | Unbans all banned users from the guild.                     | BanMembers           |
| `.kick`      | —                 | `.kick <@user\|userid> [reason]`            | Kicks a member from the server.                             | KickMembers          |
| `.mute`      | `timeout`         | `.mute <@user\|userid> [duration] [reason]` | Times out a member.                                         | ModerateMembers      |
| `.unmute`    | `untimeout`       | `.unmute <@user\|userid> [reason]`          | Removes timeout from a member.                              | ModerateMembers      |
| `.unmuteall` | `untimeoutall`    | `.unmuteall`                                | Removes timeouts from all server members.                   | ModerateMembers      |
| `.warn`      | —                 | `.warn <subcommand> <args> [reason]`        | Issues, views, and manages member warnings.                 | ModerateMembers      |
| `.nick`      | `nickname`        | `.nick <@member/id> [new nickname]`         | Changes or resets a member's nickname.                      | ManageNicknames      |
| `.slowmode`  | —                 | `.slowmode <seconds>`                       | Sets chat slowmode rate limit (0 to disable).               | ManageChannels       |
| `.snipe`     | —                 | `.snipe`                                    | Retrieves the most recently deleted message in the channel. | ManageMessages       |
| `.purge`     | `clear`, `c`, `p` | `.purge <subcommand> <amount> [content]`    | Mass-deletes filtered messages in the channel.              | ManageMessages       |
| `.purgebots` | `pb`, `purgebot`  | `.purgebots [amount]`                       | Quickly clears bot messages in the channel.                 | ManageMessages       |
| `.role`      | `r`               | `.role <subcommand> <role>`                 | Manages user roles or triggers mass role assignments.       | ManageRoles          |
| `.mention`   | `announce`        | `.mention <#channel> <@role> [message]`     | Sends announcement while pinging a role.                    | MentionEveryone      |
| `.rename`    | —                 | `.rename <subcommand> <target> <new name>`  | Renames channels, roles, or emojis.                         | ManageChannels/Roles |
| `.list`      | `l`               | `.list <subcommand>`                        | Displays categorized lists of members/roles.                | None                 |

***

## Punishment Commands

### ban & unban

Permanently remove users from the server or lift active bans.

<Tabs>
  <Tab title="Ban">
    ```bash theme={null} theme={null}
    .ban @User Spamming in chat
    .ban 1191399940014997584 Raiding
    ```

    * **Aliases**: `hackban`
  </Tab>

  <Tab title="Unban">
    ```bash theme={null} theme={null}
    .unban 1191399940014997584 Appeal accepted
    .unbanall
    ```
  </Tab>
</Tabs>

***

### kick

Remove a member from the server, allowing them to re-join if they have a valid invite.

```bash theme={null} theme={null}
.kick @User Breaking rules
```

***

### mute & unmute

Apply Discord timeouts to temporarily restrict a member from sending messages or joining voice channels.

<Tabs>
  <Tab title="Mute">
    ```bash theme={null} theme={null}
    .mute @User 10m Spamming
    .mute @User 1h Toxicity
    .mute @User 7d Severe rule violation
    ```

    * **Aliases**: `timeout`
  </Tab>

  <Tab title="Unmute">
    ```bash theme={null} theme={null}
    .unmute @User Appeal accepted
    .unmuteall
    ```

    * **Aliases**: `untimeout`, `untimeoutall`
  </Tab>
</Tabs>

***

### warn

Issue formal warnings, inspect warning histories, or clear warnings by ID.

| Subcommand | Syntax                                  | Description                           | Example                   |
| :--------- | :-------------------------------------- | :------------------------------------ | :------------------------ |
| `@user`    | `.warn <@user\|userId> [reason]`        | Issues a warning to a member          | `.warn @User Spamming`    |
| `list`     | `.warn list <@user\|userId>`            | Displays warning history for a member | `.warn list @User`        |
| `remove`   | `.warn remove <@user\|userId> <warnID>` | Deletes a specific warning by its ID  | `.warn remove @User 1232` |
| `reset`    | `.warn reset <@user\|userId>`           | Clears all warnings for a member      | `.warn reset @User`       |

***

## Message Purge & Cleaning

### purge

Mass delete messages with fine-grained filter subcommands.

| Subcommand    | Aliases                   | Syntax                               | Example                   |
| :------------ | :------------------------ | :----------------------------------- | :------------------------ |
| `bots`        | `bot`, `b`                | `.purge bots <amount>`               | `.purge bots 20`          |
| `humans`      | `human`, `h`              | `.purge humans <amount>`             | `.purge humans 50`        |
| `mentions`    | `mention`, `m`            | `.purge mentions <amount>`           | `.purge mentions 15`      |
| `links`       | `link`, `l`               | `.purge links <amount>`              | `.purge links 25`         |
| `attachments` | `attachment`, `a`         | `.purge attachments <amount>`        | `.purge attachments 10`   |
| `emojis`      | `emoji`, `e`              | `.purge emojis <amount>`             | `.purge emojis 30`        |
| `stickers`    | `sticker`, `s`            | `.purge stickers <amount>`           | `.purge stickers 10`      |
| `contains`    | `content`, `contain`, `c` | `.purge contains <amount> <content>` | `.purge contains 10 scam` |
| `users`       | `user`, `u`               | `.purge user <amount> <@user>`       | `.purge user 50 @User`    |

* **Aliases**: `clear`, `c`, `p`
* **User Permissions**: ManageMessages

***

## Role Assignment & Mass Roles

### role

Assign roles individually or launch asynchronous mass-role tasks across the entire server.

| Subcommand   | Syntax                                         | Description                                           | Example                          |
| :----------- | :--------------------------------------------- | :---------------------------------------------------- | :------------------------------- |
| `<@user>`    | `.role <@user> <role>`                         | Toggles role for a specific user                      | `.role @User developer`          |
| `all`        | `.role all <role>`                             | Assigns role to every member in the server            | `.role all @Member`              |
| `humans`     | `.role humans <role>`                          | Assigns role to all human members                     | `.role humans @Verified`         |
| `has`        | `.role has <has_role> <role_to_assign>`        | Assigns role to members who already have another role | `.role has @Members @VIP`        |
| `has remove` | `.role has remove <has_role> <role_to_remove>` | Removes role from members who have a specific role    | `.role has remove @Booster @VIP` |
| `status`     | `.role status`                                 | Checks progress of ongoing mass role operation        | `.role status`                   |
| `cancel`     | `.role cancel`                                 | Cancels ongoing mass role operation                   | `.role cancel`                   |

***

## Server & Member Audits

### list

Quickly inspect member lists, staff lists, role counts, or booster details.

| Subcommand | Aliases                           | Description                            | Example                |
| :--------- | :-------------------------------- | :------------------------------------- | :--------------------- |
| `admin`    | `admins`, `administration`        | Lists all server administrators        | `.list admin`          |
| `mod`      | `mods`, `moderator`, `moderators` | Lists all active moderators            | `.list mod`            |
| `bot`      | `bots`                            | Lists all bots in the server           | `.list bot`            |
| `ban`      | `bans`                            | Lists all banned accounts              | `.list ban`            |
| `muted`    | `mute`, `timeout`                 | Lists all currently timed-out members  | `.list muted`          |
| `inrole`   | —                                 | Lists members holding a specific role  | `.list inrole @Family` |
| `roles`    | `role`                            | Lists all server roles with IDs        | `.list roles`          |
| `noroles`  | `norole`                          | Lists members with zero roles assigned | `.list noroles`        |
| `boost`    | `boosts`, `booster`, `boosters`   | Lists all active server boosters       | `.list boost`          |
| `joinpos`  | `joinposition`                    | Displays join order of members         | `.list joinpos`        |

***

### mod

Configure moderator permissions, toggle immunity, and inspect moderator action logs.

| Subcommand | Syntax                        | Description                            | Example               |
| :--------- | :---------------------------- | :------------------------------------- | :-------------------- |
| `add`      | `.mod add <@user\|userID>`    | Adds a moderator with bot permissions  | `.mod add @User`      |
| `remove`   | `.mod remove <@user\|userID>` | Removes a moderator                    | `.mod remove @User`   |
| `permit`   | `.mod permit <@user\|userID>` | Permits member to manage moderators    | `.mod permit @User`   |
| `immune`   | `.mod immune <@role\|roleID>` | Toggles moderation immunity for a role | `.mod immune @Admins` |
| `list`     | `.mod list`                   | Lists all configured moderators        | `.mod list`           |
| `reset`    | `.mod reset`                  | Resets all moderator configurations    | `.mod reset`          |
| `audit`    | `.mod audit [user]`           | Views recent moderator audit history   | `.mod audit @User`    |