Role management

This is not just a separate module, but a central hub for all functions related to automation and role management on your server.

How to access?

To enter the Role Management Center use the command /settings roles.

1. Auto roles and Restoration

These two sections allow you to configure what happens to members' roles when they join the server.

Auto roles

Configure roles that are assigned to users automatically on their first join to the server. This is perfect for giving a basic "Member" role or for segmenting streams of new users.

• How to find: /settings roles -> button Auto-roles

Role and nickname restoration

Here you configure behavior for returning members.

• Role restoration: If a member left the server and then returned, the bot can automatically restore all the roles they had. You can set up "exception roles" that will not be restored (for example, booster roles or temporary roles).

• Nickname restoration: The bot can also restore the user's previous nickname.

• How to find: /settings roles -> button Role restoration

---

2. Temporary roles

Module for assigning roles for a specified period. Ideal for rewards, access to temporary events, or as a soft punishment.

• How to find the settings: /settings roles -> button Temporary roles

Commands

Command	Description	Usage example
/temprole add	Assign a temporary role to a user.	/temprole add user:@user role:@role time:7d reason:Reward
/temprole remove	Remove a temporary role early.	/temprole remove user:@user role:@role reason:Violation
/temprole extend	Extend the duration of a temporary role.	/temprole extend user:@user role:@role time:3d
/temprole list	Show a list of all active temporary roles on the server.	/temprole list user:@user

---

3. Linked roles (Hierarchy)

This powerful system allows you to build a logical role hierarchy by creating "category-roles". You can configure automatic assignment of a parent "category-role" when a user receives any of several "child" roles.

Most importantly: the parent role will be automatically removed, only when the user loses the last child role from the linked group.

Usage example: Category-roles

Let's break it down using your screenshot example — the category "Level rewards".

Task: You want any user who has received at least one level reward role (from 0 to 45) to have a common category role ✨ | Level Rewards. This allows you to nicely group members in the list and, for example, grant access to special channels only to holders of that common role.

How to set it up:

1. Go to /settings roles -> Linked roles.

2. Create a new hierarchy.

3. As the parent role choose ✨ | Level Rewards.

4. As the child roles select all roles related to levels: [0 lvl] Pixel Ghost, [5 lvl] Cosmic Wanderer, [15 lvl] Glitch Master and so on up to [45 lvl] Keeper of Legends.

What will happen now:

• Assignment: As soon as a user receives their first level role (for example, [0 lvl] Pixel Ghost), the bot will automatically grant them the parent role ✨ | Level Rewards as well. When they receive the next level role, nothing will change because they already have the parent role.

• Removal: If a user's [5 lvl] role is taken away but they still have the [0 lvl] role, the parent role ✨ | Level Rewards will remain. It will only be removed when the user doesn't have any role from the list of child roles.

Similarly, you can set up other categories: 🛡️ | Community Moderation will be automatically granted to anyone who receives the Junior Moderator, Moderator, or Senior Moderator role.

This saves you from having to configure category role assignment in multiple places (for levels, when promoting a moderator, etc.) and automatically keeps users' roles organized.

• How to find: /settings roles -> button Linked roles

4. Cross-server roles

This unique feature allows you to set up synchronization of roles and nicknames between multiple servers where you are an administrator and VLesnix Guard is installed.

How does it work? You can create a "link" between two servers in one of two modes:

1. One-way: Changes from the Main server are copied to the Subordinate. Ideal if you have a main server and its "branches."

2. Two-way: Servers become equal Partners. Changing roles or a nickname on one server is instantly reflected on the other, and vice versa.

• How to find: /settings roles -> button Cross-server roles