> For the complete documentation index, see [llms.txt](https://docs.sourcefactory.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sourcefactory.eu/discord-utilities/modules/manage-roles-and-permissions.md).

# Manage Roles and Permissions

{% hint style="warning" %} <mark style="color:red;">**configs/plugins/DU\_ManageRolesAndPermissions/DU\_ManageRolesAndPermissions.json**</mark>
{% endhint %}

{% hint style="info" %}
You have a choice of two methods. In both methods, the player must have a [linked account](/discord-utilities/main-configuration/linking-system.md)!

> 1. <mark style="color:green;">**Role To Permission:**</mark>\
>    When a player connects and has a certain role on the discord server, he gets a certain flags, immunity and command overrides on the C2 server.

> 2. <mark style="color:green;">**Permission To Role:**</mark>\
>    When a player connects to the server and has a certain permission (flag/group), he gets a certain role on your Discord server. (The role will remain even if he disconnects from the CS2 server)&#x20;

•<mark style="color:yellow;">**`Remove Roles On Permission Loss`**</mark>\
This means that if a player no longer has the specified permission (flag/group), the role will be automatically removed.
{% endhint %}

{% hint style="success" %}
You can use this for example for VIP or Admin players, when they join they get a permission or role according to your settings.\
\
It's not limited to just 2x Roles To Permission or Permission To Roles, you can add any other values you need. The default config contains only two sample configurations.
{% endhint %}

### Examples:

```json
{
  "Remove Roles On Permission Loss": false, // If a player joins and doesn't have a certain Permission from Permission To Role, and if they don't have that role, it will be automatically removed
  "Remove Permissions On Role Loss" : false, // This means that if a player is removed from a role and is connected on the server, a permissions from that role will be removed immediately
  "Role To Permission": {
    "123456789": {
      "flags": [
        "@css/kick",
        "@css/ban"
      ],
      "immunity": 100,
      "command_overrides": {
        "css_respawn": true
      }
    },
    "987654321": {
      "flags": [
        "@css/ban",
        "@css/kick"
      ],
      "immunity": 90,
      "command_overrides": {
        "css_slay": true
      }
    }
  },
  "Permission To Role": {
    "Flag or Group": "ROLE ID",
    "@css/vip_flag": "321654987", // PLAYERS WILL GET ROLE ON THE DISCORD SERVER: 321654987 IF THEY HAVE FLAG @css/vip_flag
    "#css/admin": "789456123" // PLAYERS WILL GET ROLE ON THE DISCORD SERVER: 789456123IF IF THEY HAVE GROUP #css/admin
    //and more...
  },
  "ConfigVersion": 1
}
```

> Some information about flags: <https://docs.cssharp.dev/docs/admin-framework/defining-admin-groups.html>

***

{% hint style="danger" %} <mark style="color:red;">**CAUTION**</mark>\
• Your Discord BOT role must always be above your Managed Role! Otherwise roles will not be added.\
• Only CSS permissions work, you can't use flags or groups from metamod plugins
{% endhint %}

<div align="left"><figure><img src="/files/XlxPsBJimMi19v5GzUN7" alt="" width="341"><figcaption></figcaption></figure></div>
