Contents
Levlix Auto Roles Guide
Auto Roles hands out roles without anyone pressing a button, and can announce it when a member receives a role. It covers three things:
- a server tag role for members who wear your server tag,
- a join role for every new member,
- role announcements: a message with optional link buttons, posted whenever a member gains a role you picked.
Everything is configured in the Levlix Dashboard under Engagement → Auto Roles. There are no commands to run and no manual sync.
Server tag role
Discord lets members adopt your server's tag next to their name. Pick a role under Server tag role in the Automatic roles card and Levlix keeps it in sync:
- A member who adopts the tag receives the role right away.
- A member who removes the tag, hides it, or switches to another server's tag loses the role again, but only if Levlix gave it to them. Members who got the role from a moderator or another bot keep it.
- When you save the setting, members who already wear the tag are picked up by the next sync run, which happens every 15 minutes and on every bot start.
Pick a new role that is only meant for tag wearers. The server tag role and the join role must be two different roles.
Levlix remembers which members it gave the tag role to, so it never takes the role from anyone else. For a tag role that was set up before Levlix kept this record, the next sync run adds the current holders who wear the tag to that record, once. When you pick a different tag role or clear it, Levlix stops managing the old role and members keep it.
A sync run takes the role from at most 50 members. If more members dropped the tag, the rest follow in the next runs.
Join role
Pick a role under Join role and every new member receives it. If membership screening is enabled, the role is applied once the member accepts the rules; without screening it is applied immediately. Members who joined before you picked the role do not receive it. Bots never receive automatic roles.
Role announcements
Add an announcement for any role, up to 25 per server and one per role. Each one has:
| Setting | Description |
|---|---|
| Role | The role that triggers the announcement |
| Channel | The text channel the message is posted in |
| Enabled | Switch an announcement off without deleting it |
| Title | Optional headline, up to 100 characters |
| Message | The message text, up to 2000 characters, supports the placeholders below |
| Accent colour | Colour of the message container; defaults to the role colour |
| Link buttons | Up to five buttons with label, link and optional emoji; links start with https:// or http:// |
The message also shows the member's avatar. Announcements fire no matter who granted the role: a moderator, the shop, level rewards, the server tag rule or the join rule. Bots never trigger an announcement.
Placeholders
| Placeholder | Result |
|---|---|
{user} |
Mentions the member |
{username} |
The member's username |
{displayname} |
The member's display name |
{server} |
The server name |
{member_count} |
The current member count |
{role} |
Mentions the role |
{role_name} |
The role name |
When Ping members in public announcements is off under Server → Settings, {user} names the member without notifying them.
Permissions and role hierarchy
Levlix needs Manage Roles for the server tag role and the join role, and View Channel and Send Messages in every announcement channel.
Levlix can only assign roles that sit below its own highest role. The pickers only offer those roles; to use a role that is missing, move the Levlix role above it in Server Settings → Roles. You can only pick a new role that you could hand out yourself, and a new announcement channel that you can post in yourself.
Without Manage Roles, Levlix pauses the server tag role and the join role. Once the permission is back, the next sync run catches up on the server tag role; members who joined in the meantime do not receive the join role afterwards.
Turning it off
Disable the module under Server → Modules in the dashboard sidebar. Roles that were already handed out stay on the members; Levlix stops adding, removing and announcing. It also forgets which members it gave the tag role to, so after switching the module back on it does not take the tag role from those members when they drop the tag.