Role management

This is not just a separate module, but a central hub for all features related to automating and managing roles on your server.

How to get access?

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

1. Automatic roles and Restoration

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

Automatic roles

Configure roles that are assigned to users automatically on first join to the server. This is ideal 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

This configures 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 "excluded 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 specific period. Ideal for rewards, access to temporary events, or as a mild punishment.

• How to find 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 the 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 with the example from your screenshot — the category "Level rewards".

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

How to set it up:

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

2. Create a new hierarchy.

3. As the parent role select ✨ | 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. When they get the next level role, nothing will change since 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 no longer has any role from the list of child roles.

In the same way 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 needing to configure assignment of category-roles in multiple places (for levels, on moderator promotion, etc.) and automatically keeps order in users' roles.

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

4. Cross-server roles

This unique feature allows you to configure 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 Secondary. Ideal if you have a primary server and its "branches".

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

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