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

# Fake Permissions

> Grant bot-level permissions to roles without changing their Discord permissions.

## How grants work

Fake permissions are interpreted by Semetary's access checks. They do not modify a role's real Discord permissions. Only the server owner can configure these grants, and @everyone cannot receive them.

## Configure a role

Multiple permission names can be separated by commas or spaces. List shows the current grants; remove revokes selected permissions.

```text theme={null}
,fakepermissions add @Moderator ban_members,kick_members
,fakepermissions list @Moderator
,fakepermissions remove @Moderator ban_members
```

## Permission limits

Owner-only checks, antinuke protection, and role hierarchy still apply. The bot also needs its own Discord permissions.

<Warning>
  A fake permission cannot give Semetary a Discord permission it lacks.
</Warning>

## Command reference

Examples use the default comma prefix. Required inputs use angle brackets; optional inputs use square brackets. Each command notes whether it is also registered in Discord's slash menu.

<AccordionGroup>
  <Accordion title=",fakepermissions" icon="terminal">
    Set up fake permissions for roles through the bot.

    ### fakepermissions add

    Grant fake permissions to a role.

    ```text Prefix syntax theme={null}
    ,fakepermissions add <role> <permission>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | Yes | Role to configure |
    | `permission` | Yes | Comma-separated fake permissions |

    ### fakepermissions remove

    Remove fake permissions from a role.

    ```text Prefix syntax theme={null}
    ,fakepermissions remove <role> <permission>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | Yes | Role to configure |
    | `permission` | Yes | Comma-separated fake permissions |

    ### fakepermissions reset

    Reset every fake permission.

    ```text Prefix syntax theme={null}
    ,fakepermissions reset
    ```

    ### fakepermissions list

    List all fake permissions or permissions for one role.

    ```text Prefix syntax theme={null}
    ,fakepermissions list [role]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `role` | No | Optional role to view |
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.