Leveling 5 min read

Level-Based Role Rewards

Automatically assign roles when members reach specific levels to reward active members.

How Level Rewards Work

Mitsuki's leveling system tracks XP earned through messages and voice activity. When members reach certain levels, they can automatically receive roles as rewards — perfect for unlocking new channels or perks.

Setting Up Role Rewards

1

Enable Leveling

First, make sure the leveling system is enabled:

leveling enable
2

Create Your Reward Roles

Create the roles you want to use as rewards in Server Settings → Roles. Common examples:

  • Level 5 - "Newcomer"
  • Level 10 - "Regular"
  • Level 25 - "Veteran"
  • Level 50 - "Legend"
Role Hierarchy Make sure these roles are positioned below Mitsuki's role, or the bot won't be able to assign them.
3

Add Role Rewards

Link each role to a specific level:

levelrole add 10 @Regular

This assigns the @Regular role when someone reaches level 10.

4

View Your Rewards

Check all configured role rewards:

levelrole list

Stacking vs. Replacing

You can configure whether level roles stack or replace:

  • Stack - Members keep all earned roles (default)
  • Replace - Only the highest level role is kept

Configure with:

levelrole mode stack
Pro Tip Use level roles to unlock access to exclusive channels! Set channel permissions to only allow certain level roles.

Managing Rewards

To remove a role reward:

levelrole remove 10

This removes the reward at level 10.