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

# Overview

> Core moderation tools for managing members, messages, and server order.

ZEON provides a full suite of server moderation commands designed for speed and safety. Every destructive action (ban, kick, mute, etc.) requires a **confirmation prompt** before executing, and the target user is automatically **DM'd** with the action reason whenever possible.

***

## <Icon icon="gavel" /> Member Actions

Standard moderation commands for managing individual members. All actions are recorded in the Discord audit log with a formatted reason.

| Command                          | Description                                                                                              |
| :------------------------------- | :------------------------------------------------------------------------------------------------------- |
| `.ban <user> [reason]`           | Bans a user from the server (supports mentions and user IDs for hackbanning).                            |
| `.unban <user> [reason]`         | Revokes a user's ban.                                                                                    |
| `.softban <member> [reason]`     | Bans and immediately unbans a member, effectively purging their recent messages without a permanent ban. |
| `.kick <member> [reason]`        | Kicks a member from the server.                                                                          |
| `.mute <member> [time] [reason]` | Times out a member for the specified duration (default: `28d`, max: `28 days`).                          |
| `.unmute <member> [reason]`      | Removes a member's timeout.                                                                              |
| `.nick <member> [nickname]`      | Changes a member's nickname, or resets it if no nickname is provided.                                    |
| `.fakeban <user> [reason]`       | Simulates a ban (sends DM, shows success) without actually banning. Useful for pranks or testing.        |

<Note>
  **Strict Hierarchy Check (`Role > Bot`):** ZEON enforces an extreme security policy. If you are using standard Discord permissions (and not Fake Permissions or Extra Owner status), your top role **must be strictly higher than the bot's highest role** to use these commands.
  Furthermore, you cannot moderate someone with a role equal to or higher than your own.
</Note>

***

## <Icon icon="broom" /> Message Purging

Bulk-delete messages from a channel using the `.clear` (or `.purge`) command group. All purge subcommands are capped at **100 messages** and cannot delete messages older than **14 days** (a Discord limitation).

| Command                 | Description                                                                 |
| :---------------------- | :-------------------------------------------------------------------------- |
| `.clear <amount>`       | Deletes the specified number of messages from the channel.                  |
| `.clear all [amount]`   | Deletes all messages (up to 100).                                           |
| `.clear user <member>`  | Deletes messages from a specific member.                                    |
| `.clear bots`           | Deletes messages sent by bots only.                                         |
| `.clear mentions`       | Deletes messages that contain user, role, or channel mentions.              |
| `.clear images`         | Deletes messages that are image-only (no text).                             |
| `.clear embeds`         | Deletes messages that are embed-only (no text).                             |
| `.clear files`          | Deletes messages with non-image file attachments.                           |
| `.clear contain <text>` | Deletes messages containing a specific text string.                         |
| `.clear emoji`          | Deletes messages that contain only emojis.                                  |
| `.clear reactions`      | Strips all reactions from the last 100 messages (does not delete messages). |

<Tip>
  You can also use the shorthand commands `.purgebots` and `.purgeuser <member>` for quick access.
</Tip>

***

## <Icon icon="arrows-up-down" /> Channel Management

Commands for creating, deleting, and modifying server channels.

### Channel Creation & Deletion

| Command                                    | Description                                                                  |
| :----------------------------------------- | :--------------------------------------------------------------------------- |
| `.channel create <type> <name> [category]` | Creates a new channel. Types: `Text`, `Voice`, `Stage`, `Forum`, `Category`. |
| `.channel delete <channel>`                | Deletes a channel (with a 3-second delay).                                   |
| `.channel deleteafter <time> [channel]`    | Schedules a channel for deletion after the specified time.                   |
| `.clone [channel]`                         | Creates an exact copy of a channel (permissions, topic, etc.).               |
| `.nuke [channel]`                          | Destroys and recreates a channel, wiping all messages.                       |

### Channel Modification

| Command                                  | Description                                                                                               |
| :--------------------------------------- | :-------------------------------------------------------------------------------------------------------- |
| `.channel rename <name> [channel]`       | Renames a channel.                                                                                        |
| `.channel transfer <category> [channel]` | Moves a channel into a different category.                                                                |
| `.lock [channel] [duration]`             | Locks a channel to prevent `@everyone` from sending messages. Optionally auto-unlocks after the duration. |
| `.unlock [channel] [duration]`           | Unlocks a locked channel. Optionally auto-locks after the duration.                                       |
| `.hide [channel] [duration]`             | Hides a channel from `@everyone`. Optionally auto-unhides.                                                |
| `.unhide [channel] [duration]`           | Makes a hidden channel visible again.                                                                     |
| `.slowmode [channel] <delay>`            | Sets a slowmode delay on a channel (max `6h`). Use `0` to remove.                                         |
| `.unslowmode [channel]`                  | Removes slowmode from a channel.                                                                          |

***

## <Icon icon="bolt" /> Mass Server Actions

Dangerous bulk operations that affect the **entire server**. These are restricted to administrators and require confirmation before executing.

| Command      | Description                                                            |
| :----------- | :--------------------------------------------------------------------- |
| `.hideall`   | Hides all channels in the server from `@everyone`.                     |
| `.unhideall` | Unhides all channels in the server.                                    |
| `.lockall`   | Locks all channels (text, voice, forum, stage, threads) in the server. |
| `.unlockall` | Unlocks all channels in the server.                                    |
| `.unbanall`  | Unbans every banned user in the server.                                |

<Warning>
  These commands have a **2-minute cooldown** per server and will process every channel sequentially. They cannot be cancelled once confirmed.
</Warning>

***

## <Icon icon="message" /> Snipe

Recover recently deleted or edited messages in a channel.

| Command          | Description                                                                                                                                                      |
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.snipe [index]` | Shows the most recently deleted/edited messages. Provides a paginated view of up to 25 sniped messages. If an index is provided, it shows that specific message. |

<Note>
  Sniped messages are stored **in memory only** and are lost when the bot restarts. Bot messages are excluded.
</Note>