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

# Set Up Fake Permissions for XRYPTON Commands

> Grant roles the ability to run permission-gated XRYPTON commands without giving them the real Discord permission, using the fakeperms module.

Fake Permissions let you grant a role the ability to run XRYPTON commands that normally require a specific Discord permission, without actually giving that role the permission in Discord's settings. This is ideal for delegating moderation power to trusted roles while keeping their real Discord permissions minimal.

<Note>
  Fake permissions only affect XRYPTON's internal command checks. They do **not** grant any real Discord permissions — a role with fake `ban_members` still cannot ban through the Discord client, only through XRYPTON.
</Note>

<Warning>
  All `fakeperms` commands require the **Administrator** permission. Only give fake permissions to roles you fully trust.
</Warning>

***

## How It Works

When a member runs a XRYPTON command, the bot checks whether they have the required Discord permission. With fake permissions enabled, XRYPTON also checks whether any of the member's roles has been granted that permission through `fakeperms add`. If so, the command runs as if the user had the real permission.

<CardGroup cols={2}>
  <Card title="Delegate Safely" icon="user-shield">
    Give moderators access to `,ban`, `,kick`, or `,purge` without granting the real Discord permissions that could be abused elsewhere.
  </Card>

  <Card title="Role-Scoped" icon="users-gear">
    Fake permissions are attached to roles, not individual users. Anyone with the role inherits the granted permissions.
  </Card>
</CardGroup>

***

## Setup

### 1. View Valid Permissions

Before assigning anything, list every permission string XRYPTON accepts. Permission names use `snake_case`.

```discord theme={null}
,fakeperms perms
```

Common examples: `ban_members`, `kick_members`, `manage_messages`, `manage_roles`, `manage_channels`, `moderate_members`, `mention_everyone`.

### 2. Grant a Fake Permission

Assign a permission to a role using its name or mention.

```discord theme={null}
,fakeperms add <role> <permission>
```

**Example** — let the `@Moderator` role use ban commands:

```discord theme={null}
,fakeperms add @Moderator ban_members
```

Members with `@Moderator` can now run `,ban` even though the role does not have the real Ban Members permission in Discord.

### 3. Review a Role's Fake Permissions

```discord theme={null}
,fakeperms list <role>
```

Shows every fake permission currently attached to the role.

### 4. Remove a Fake Permission

```discord theme={null}
,fakeperms remove <role> <permission>
```

**Example**:

```discord theme={null}
,fakeperms remove @Moderator ban_members
```

***

## Command Reference

| Command            | Usage                                   | Description                                                   |
| ------------------ | --------------------------------------- | ------------------------------------------------------------- |
| `fakeperms`        | `,fakeperms`                            | Show the fake permissions help menu. Alias: `fp`.             |
| `fakeperms add`    | `,fakeperms add <role> <permission>`    | Grant a fake permission to a role. Alias: `set`.              |
| `fakeperms remove` | `,fakeperms remove <role> <permission>` | Revoke a fake permission from a role.                         |
| `fakeperms list`   | `,fakeperms list <role>`                | List all fake permissions assigned to a role.                 |
| `fakeperms perms`  | `,fakeperms perms`                      | Show every valid permission name accepted by `fakeperms add`. |

All commands require **Administrator**.

***

## Examples

**Give trial moderators purge access without Manage Messages:**

```discord theme={null}
,fakeperms add @TrialMod manage_messages
```

**Let a support role time out members:**

```discord theme={null}
,fakeperms add @Support moderate_members
```

**Audit a role before an event:**

```discord theme={null}
,fakeperms list @EventStaff
```

***

## Tips

<Tip>
  Run `,fakeperms perms` first to copy the exact permission string. Typos are silently rejected.
</Tip>

<Tip>
  Fake permissions stack with real Discord permissions — a user only needs one of them to pass the command check.
</Tip>

<Warning>
  Fake `administrator` bypasses every XRYPTON permission check. Treat it exactly like giving out the real Administrator permission.
</Warning>