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

# Moderation

> Bans, softbans, timeouts, jail, warnings and purge — every action becomes a numbered case.

Every punishment writes a numbered case to a persistent case book, DMs the target (and tells you
whether that DM landed), and posts an entry to the log channel.

## Core commands

| Command | What it does | Needs |
| - | - | - |
| `/ban <member> [reason]` | Ban and record a case | Ban Members |
| `/kick <member> [reason]` | Kick and record a case | Kick Members |
| `/mute <member> [duration]` | Apply the Muted role, **5 minutes** by default | Moderate Members + `/setup mute` |
| `/unmute <member>` | Remove the Muted role | Moderate Members |
| `/untimeout <member>` | End a timeout early | Moderate Members |
| `/imagemute <member> [duration]` | Apply Image Muted — no uploads, no link embeds | Moderate Members + `/setup mute` |
| `/jail <member> [duration]` | Move to `#jail`, **1 hour** by default | Manage Roles + `/setup jail` |
| `/unjail <member>` | Release early | Manage Roles |
| `/warn <member> [reason]` | Warn with a case entry | Moderate Members |
| `/clearwarns <member>` | Clear active warnings, keep the history | Moderate Members |
| `/purge <count>` | Bulk delete | Manage Messages |
| `/threadlock [thread] [reason]` | Lock a thread so only moderators can post | Manage Threads |

## The `/mod` group

```text theme={null}
/mod unban <user> [reason]
/mod softban <member> [reason]
/mod banlist
/mod warnings <member>
/mod delwarn <id>
/mod case <id>
/mod modlogs <member>
/mod nickname <member> <name>
```

`softban` bans and immediately unbans to clear recent messages. `modlogs` lists every case touching
a member, and `case` opens one case with its reason, moderator and timestamp.

## Bulk cleanup

The "all" variants scrub the whole server and always ask for confirmation first:

```text theme={null}
/mod unban user:all
/unmute member:all
/untimeout member:all
```

## Purge filters

Slash:

```text theme={null}
/purge 100 user:@member
/purge 50 bots:true
/purge 200 contains:"free nitro"
```

Prefix:

```text theme={null}
,purge 50 --user @member --contains "free nitro" --bots --attachments
,ban @member --delete-days 7
,softban @member --delete-days 1
```

## Channel control

| Command | Effect |
| - | - |
| `/channel lock` | Deny `Send Messages` for `@everyone` |
| `/channel unlock` | Restore it |
| `/channel slowmode <seconds>` | Set slowmode |
| `/channel nuke` | Recreate the channel, wiping its history |

## Prefix twins

Every essential moderation action has a prefix form, because raids don't wait for an interaction:
`,ban`, `,unban`, `,softban`, `,kick`, `,mute`, `,unmute`, `,jail`, `,unjail`, `,warn`,
`,clearwarns`, `,purge`, `,slowmode`, `,nickname`, `,untimeout`, and `,threadlock` (`,tl`).

**The bot's role must sit above the target**

Discord only lets a bot act on members below its own highest role. If a command fails while the
bot has the permission, move Criminal's role up in **Server Settings → Roles**.

## Reactions worth knowing

Any message containing a standalone `y/n` prompt automatically gets 👍 and 👎; `v/s` gets ⬅️ and
➡️. That makes impromptu votes work without a poll command.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.