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

# Moderate Your Discord Server Effectively with XRYPTON

> A complete reference for every XRYPTON moderation command — from banning members and locking channels to managing roles and cleaning up messages.

XRYPTON's moderation suite gives your staff team a full toolkit to keep your server safe and organised. Commands marked as **hybrid** work both as a prefix command (e.g. `,lockdown`) and as a slash command (e.g. `/lockdown`). All other commands are prefix-only. Commands respect your Discord role hierarchy, so you can only act on members whose highest role sits below yours.

***

## Member Actions

<CardGroup cols={2}>
  <Card title="ban" icon="gavel">
    **Aliases:** `evict`, `deport`\
    **Permission:** Ban Members\
    Bans a user and deletes their last 7 days of messages. Works on users who have already left the server. If the target is a server booster, you'll be asked to confirm before the ban is applied.
  </Card>

  <Card title="kick" icon="user-minus">
    **Permission:** Kick Members\
    Removes a member from the server. They can rejoin with a new invite. Boosters require a confirmation step.
  </Card>

  <Card title="mute" icon="microphone-slash">
    **Permission:** Moderate Members\
    Times a member out using Discord's native timeout system. The default duration is 60 seconds.
  </Card>

  <Card title="unmute" icon="microphone">
    **Permission:** Moderate Members\
    Removes a Discord timeout from a member immediately.
  </Card>

  <Card title="unban" icon="user-check">
    **Permission:** Moderate Members\
    Unbans a previously banned user by their user ID or tag.
  </Card>

  <Card title="forcenickname" icon="pen">
    **Alias:** `fn`\
    **Permission:** Moderate Members\
    Locks a member's nickname to a value you set. They cannot change it while the force-nickname is active. Run the command again with no name to remove it.
  </Card>
</CardGroup>

```bash theme={null}
,ban @User spamming          # bans with a reason
,kick @User rule 3           # kicks with a reason
,mute @User 10m              # times out for 10 minutes
,unmute @User
,unban 123456789012345678    # unban by user ID
,forcenickname @User "Moderated"   # lock nickname
,forcenickname @User               # remove forced nickname
```

<Note>
  You cannot act on members whose highest role is equal to or above your own, and you can never moderate the server owner.
</Note>

***

## Channel Management

### Nuke

```bash theme={null}
,nuke           # nukes the current channel
,nuke #channel  # nukes a specific channel
```

**Permission:** Manage Server\
Clones the channel (preserving topic, position, and permission overwrites), then deletes the original. A confirmation prompt appears before the action is carried out.

### Lockdown

**Hybrid command** — usable as `,lockdown` or `/lockdown`\
**Permission:** Manage Channels\
Prevents the configured lockdown role (default: `@everyone`) from sending messages in a channel.

```bash theme={null}
,lockdown                     # lock the current channel
,lockdown #channel            # lock a specific channel
,lockdown all                 # lock every channel (ignores the ignored list)
,lockdown ignore #channel     # toggle a channel off the lockdown list
,lockdown ignored             # view all ignored channels
,lockdown role @Role          # set which role is affected by lockdown commands
```

### Unlock

**Hybrid command** — usable as `,unlock` or `/unlock`\
**Permission:** Manage Channels\
Re-enables message sending for the lockdown role.

```bash theme={null}
,unlock                       # unlock the current channel
,unlock #channel              # unlock a specific channel
,unlock all                   # unlock every channel
```

### Hide & Reveal

**Permission:** Manage Channels\
Toggles whether `@everyone` can see the channel at all.

```bash theme={null}
,hide                # hide the current channel from @everyone
,hide #channel
,reveal              # make the channel visible again
,reveal #channel
```

### Channel Create / Delete / Rename / NSFW

**Hybrid command** — usable as `,channel` or `/channel`\
**Permission:** Manage Channels

```bash theme={null}
,channel create name-here       # create a new text channel
,channel delete #channel        # delete a channel
,channel rename #channel new-name
,channel nsfw #channel          # toggle NSFW on or off
```

***

## Message Cleanup — Purge

**Hybrid command** — usable as `,purge` or `/purge`\
**Alias:** `c`\
**Permission:** Manage Messages\
All `purge` subcommands default to removing 15 messages. Pass an `amount` argument to override.

<Accordion title="All purge subcommands">
  | Command                       | What it removes                        |
  | ----------------------------- | -------------------------------------- |
  | `,purge <amount>`             | Any non-pinned messages                |
  | `,purge user @User [amount]`  | Messages sent by a specific member     |
  | `,purge bots [amount]`        | Messages sent by bots                  |
  | `,purge humans [amount]`      | Messages sent by non-bots              |
  | `,purge links [amount]`       | Messages containing URLs or embeds     |
  | `,purge attachments [amount]` | Messages with file attachments         |
  | `,purge stickers [amount]`    | Messages containing stickers           |
  | `,purge mentions [amount]`    | Messages containing user/role mentions |
</Accordion>

```bash theme={null}
,purge 50                 # delete 50 messages
,purge user @User 30      # delete 30 messages from a user
,purge bots               # delete 15 bot messages
,purge links 25
```

<Note>
  Pinned messages are never deleted by `purge`. The invoking message is automatically removed before the purge begins.
</Note>

***

## Role Management

**Hybrid command** — usable as `,role` or `/role`\
**Alias:** `r`\
**Permission:** Manage Roles\
The `role` command group lets you create, delete, and assign roles in bulk.

```bash theme={null}
,role @User @Role             # toggle a role on/off for a member
,role create Name             # create a new role
,role delete @Role            # delete a role
,role all @Role               # give a role to every member
,role humans @Role            # give a role to all non-bot members
,role color #FF5733 @Role     # set a role's hex colour
,role hoist @Role             # toggle whether the role is shown separately in the member list
,role mentionable @Role       # toggle whether anyone can @mention the role
```

<Warning>
  `role all` and `role humans` are slow operations on large servers. XRYPTON will display an estimated completion time before it begins.
</Warning>

***

## Special Mutes

These commands restrict specific permissions for a single member in the current channel without issuing a full timeout.

**Permission:** Moderate Members

```bash theme={null}
,imute @User       # remove attach files & embed links
,iunmute @User     # restore attach files & embed links

,reactionmute @User    # remove reaction & external emoji perms (alias: rmute)
,reactionunmute @User  # restore reaction & external emoji perms (alias: runmute)
```

***

## Strip Staff

**Permission:** Administrator\
Scans a member's roles and removes every role that holds a "dangerous" permission (such as Administrator, Ban Members, Manage Guild, etc.). Useful for emergency de-staffing.

```bash theme={null}
,stripstaff @User   # alias: strip
```

<Tip>
  If the member has no dangerous roles, XRYPTON will let you know instead of silently succeeding.
</Tip>
