> For the complete documentation index, see [llms.txt](https://docs.evelina.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.evelina.bot/security/fake-permissions.md).

# Fake Permissions

## Why use fake permissions?

Fake permissions negate the possibility of a rogue moderator using a script which floods the **Discord API** and mass bans all members, or any other harmful action. It’s a security measure which ensures that your server can’t be nuked whatsoever.

## How do fake permissions work?

When a moderator is given fake permissions, such as `ban_members`, they will be able to use the `ban` command with **evelina**, but they won’t be able to use the native **Discord** ban feature.

## Getting command permissions

You can locate the required permissions for a command with `;help (command)`

<figure><img src="https://github.com/EvelinaServices/docs/blob/main/.gitbook/assets/Discord_mGCYYCNrMc.png" alt=""><figcaption></figcaption></figure>

## Setting up fake permissions

{% hint style="warning" %}
The following commands can only be used by the **server owner**.
{% endhint %}

<details>

<summary>Granting fake permissions to a role</summary>

Use the `fakepermissions add` command to grant a fake permission to a role.

```
Syntax: ;fakepermissions add [role] [permission]
Example: ;fakepermissions add mod manage_messages
```

</details>

<details>

<summary>Revoking fake permissions from a role</summary>

Use the `fakepermissions remove` command to revoke a fake permission from a role.

```
Syntax: ;fakepermissions remove [role] [permission]
Example: ;fakepermissions remove mod manage_messages
```

</details>

<details>

<summary>Clear all fake permissions from a role</summary>

Use the `fakepermissions clear` command to revoke all fake permission from a role.

```
Syntax: ;fakepermissions clear [role]
Example: ;fakepermissions clear mod
```

</details>

<details>

<summary>Viewing fake permissions</summary>

Use the `fakepermissions list` command to view all fake permissions.

```
Syntax: ;fakepermissions list [role]
Example: ;fakepermissions list mod
```

</details>

<details>

<summary>Revoking all fake permissions</summary>

Use the `fakepermissions reset` command to reset all fake permissions.

</details>

## Recommended Configuration

{% tabs %}
{% tab title="Moderator" %}

* `manage_messages` - Allows the moderator to delete messages.
* `moderate_members` - Allows the moderator to timeout members.
* `manage_nicknames` - Allows the moderator to change nicknames.
* `kick_members` - Allows the moderator to kick members from the server.

```
;fakepermissions add (moderator role) manage_messages
;fakepermissions add (moderator role) moderate_members
;fakepermissions add (moderator role) manage_nicknames
;fakepermissions add (moderator role) kick_members
```

{% endtab %}

{% tab title="Administrator" %}

* `manage_messages` - Allows the administrator to delete messages.
* `moderate_members` - Allows the administrator to timeout members.
* `manage_nicknames` - Allows the administrator to change nicknames.
* `manage_roles` - Allows the administrator to manage roles.
* `ban_members` - Allows the administrator to ban members.
* `kick_members` - Allows the administrator to kick members.

```
;fakepermissions add (admin role) manage_messages
;fakepermissions add (admin role) moderate_members
;fakepermissions add (admin role) manage_nicknames
;fakepermissions add (admin role) manage_roles
;fakepermissions add (admin role) ban_members
;fakepermissions add (admin role) kick_members
```

{% endtab %}

{% tab title="Co-Owner" %}

* `administrator` - Allows the co-owner to use all moderation commands.

```
;fakepermissions add (co-owner role) administrator
```

{% endtab %}
{% endtabs %}