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

# Fake Permissions

> Grant ZEON-only moderation powers to roles without giving real Discord permissions.

The **Fake Permissions** system allows the Server Owner to grant specific ZEON moderation abilities to roles **without** giving those roles any actual Discord permissions. This means a role can use ZEON's `.ban` command without having Discord's native "Ban Members" permission.

<Warning>
  **Server Owner Only:** Only the Server Owner can configure fake permissions. This is a security measure to prevent privilege escalation.
</Warning>

***

## <Icon icon="list-check" /> Available Permissions

The following permissions can be individually toggled for each role:

| Permission                 | What It Unlocks                                                                                    |
| :------------------------- | :------------------------------------------------------------------------------------------------- |
| `Quarantine Users`         | Allows using `.quarantine` / `.jail` commands.                                                     |
| `Ban / Unban Users`        | Allows using `.ban`, `.unban`, `.softban`, `.fakeban`.                                             |
| `Kick Users`               | Allows using `.kick`.                                                                              |
| `Timeout / Mute Users`     | Allows using `.mute` and `.unmute`.                                                                |
| `Purge / Manage Messages`  | Allows using `.clear` / `.purge` and `.snipe`.                                                     |
| `Manage Channels`          | Allows using `.channel create/delete/rename`, `.lock`, `.unlock`, `.hide`, `.unhide`, `.slowmode`. |
| `Manage Roles`             | Allows using `.role add/remove/create/delete/rename/colour/icon`.                                  |
| `Manage Nicknames`         | Allows using `.nick`.                                                                              |
| `Manage Emojis / Stickers` | Allows using `.steal`, `.deleteemoji`, `.deletesticker`.                                           |
| `Voice Moderation`         | Allows using `.voice kick/mute/unmute/deafen` and related VC commands.                             |

***

## <Icon icon="wand-magic-sparkles" /> Setup Guide

<Steps>
  <Step title="Run the Grant Command">
    Use `.permissions grant @Role` to open the interactive setup panel for that role.

    ```bash theme={null}
    .permissions grant @Moderator
    ```
  </Step>

  <Step title="Toggle Permissions">
    An interactive panel will appear showing all 10 permissions with toggle switches. Use the **dropdown menu** to select which permissions you want to enable or disable.

    You can also use the quick-action buttons:

    * **All Perms** — Instantly enables every permission.
    * **Reset** — Disables all permissions and removes the role's config.
  </Step>

  <Step title="Permissions Save Automatically">
    Every toggle click is saved in real-time. There is no "save" button — your changes are applied instantly.
  </Step>
</Steps>

<Note>
  You can configure fake permissions for up to **5 roles** per server.
</Note>

***

## <Icon icon="gear" /> Managing Existing Roles

| Command                      | Description                                                                                      |
| :--------------------------- | :----------------------------------------------------------------------------------------------- |
| `.permissions grant <role>`  | Opens the interactive setup panel for a role (creates a new config if one doesn't exist).        |
| `.permissions manage <role>` | Opens the setup panel for a role that already has fake permissions configured.                   |
| `.permissions revoke <role>` | Removes all fake permissions from a specific role.                                               |
| `.permissions list`          | Shows a paginated overview of all roles with fake permissions and their enabled/disabled states. |
| `.permissions resetall`      | Revokes all fake permissions from every role in the server.                                      |

<Tip>
  Fake permissions **stack with Discord's native permissions** and **bypass the strict `Role > Bot` hierarchy check**.

  Normally, ZEON requires standard moderators to have a role strictly higher than the bot's highest role. However, by granting a role Fake Permissions, you allow those users to moderate without needing to place their role above the bot's role!
</Tip>