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

# Fake Permissions

> Restrict moderators to only use raze for moderation.

# Fake Permissions

> Restrict moderators to only use raze for moderation.

## Why use fake permissions?

Fake permissions prevent a rogue moderator from using native **Discord** features directly. A staff member granted `ban_members` via fake permissions can use raze's `;ban` command, but cannot use Discord's native ban feature. This means all moderation goes through raze — logged, auditable, and controllable.

## How do fake permissions work?

When a role has a fake permission like `ban_members`, members with that role can use raze commands that require that permission. They still have no native Discord permissions — raze enforces the check internally on every command invocation.

## Getting command permissions

Every raze command lists its required permission in the help output. Run `;help (command)` to see the **Information** field.

```bash theme={null} theme={null}
;help ban
```

The information field shows the required permission, like `Ban Members`. The fake permission equivalent is the snake\_case version: `ban_members`.

## Setting up fake permissions

<Warning>
  Only the **server owner** can grant and revoke fake permissions.
</Warning>

<Expandable title="Granting fake permissions to a role">
  Use the `fakepermissions add` command to grant a fake permission to a role.

  <CodeGroup>
    ```bash Syntax theme={null} theme={null}
    ;fakepermissions add (@role) (permission)
    ```

    ```bash Example theme={null} theme={null}
    ;fakepermissions add @Moderator ban_members
    ```
  </CodeGroup>
</Expandable>

<Expandable title="Revoking fake permissions from a role">
  <CodeGroup>
    ```bash Syntax theme={null} theme={null}
    ;fakepermissions remove (@role) (permission)
    ```

    ```bash Example theme={null} theme={null}
    ;fakepermissions remove @Moderator ban_members
    ```
  </CodeGroup>
</Expandable>

<Expandable title="Viewing fake permissions">
  <CodeGroup>
    ```bash Syntax theme={null} theme={null}
    ;fakepermissions list (@role)
    ```

    ```bash Example theme={null} theme={null}
    ;fakepermissions list @Moderator
    ```
  </CodeGroup>
</Expandable>

<Expandable title="Revoking all fake permissions">
  Use the `fakepermissions reset` command to remove all fake permissions from a role at once.

  <CodeGroup>
    ```bash Syntax theme={null} theme={null}
    ;fakepermissions reset (@role)
    ```

    ```bash Example theme={null} theme={null}
    ;fakepermissions reset @Moderator
    ```
  </CodeGroup>
</Expandable>

## Recommended Configuration

<Tabs>
  <Tab title="Moderator">
    * `manage_messages` — delete and pin messages
    * `moderate_members` — timeout members
    * `manage_nicknames` — change member nicknames
    * `kick_members` — kick members from the server
    * `ban_members` — ban and unban members

    ```bash theme={null} theme={null}
    ;fakepermissions add @Moderator manage_messages moderate_members manage_nicknames kick_members ban_members
    ```
  </Tab>

  <Tab title="Administrator">
    All moderator permissions plus:

    * `manage_guild` — access server configuration commands
    * `manage_roles` — create, edit, and assign roles
    * `manage_channels` — create and edit channels
    * `view_audit_log` — view server audit log

    ```bash theme={null} theme={null}
    ;fakepermissions add @Administrator manage_guild manage_roles manage_channels view_audit_log
    ```
  </Tab>

  <Tab title="Co-Owner">
    * `administrator` — grants access to all raze commands

    ```bash theme={null} theme={null}
    ;fakepermissions add @Co-Owner administrator
    ```

    <Warning>
      Granting `administrator` gives full access to every raze command. Reserve this for highly trusted staff only.
    </Warning>
  </Tab>
</Tabs>

## Available permissions

| Permission           | Allows                              |
| -------------------- | ----------------------------------- |
| `administrator`      | Full access to all raze commands    |
| `ban_members`        | Ban and unban members               |
| `kick_members`       | Kick members                        |
| `manage_guild`       | Server configuration commands       |
| `manage_channels`    | Create and edit channels            |
| `manage_roles`       | Create, edit, and assign roles      |
| `manage_messages`    | Delete and pin messages             |
| `view_audit_log`     | View audit log                      |
| `manage_webhooks`    | Manage webhooks                     |
| `manage_expressions` | Manage emoji and stickers           |
| `mute_members`       | Mute members in voice               |
| `deafen_members`     | Deafen members in voice             |
| `move_members`       | Move members between voice channels |
| `manage_nicknames`   | Change member nicknames             |
| `mention_everyone`   | Mention @everyone and @here         |
| `moderate_members`   | Timeout members                     |
| `external_emojis`    | Use external emojis                 |
| `change_nickname`    | Change own nickname                 |