# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.evelina.bot/security/fake-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.