Role Rewards

How role rewards work

When a member reaches a configured level, the bot automatically assigns the linked Discord role. This happens immediately on level-up - no delay, no manual action needed.

Adding a reward

/add-role-reward level:5 role:@Active Member

Requires Administrator permission. The role must already exist in your server.

Role hierarchy

The bot’s role must be above the reward role in Server Settings → Roles. This is the single most common issue with role rewards. If the bot’s role is lower, assignment fails without any error message.

Removing a reward

/remove-role-reward level:5

Removing a reward doesn’t strip the role from members who already have it.

Viewing current rewards

Anyone can run /list-role-rewards to see all configured rewards and their levels.

Members who already passed that level

If you add a reward for level 10 and some members are already level 15, they won’t automatically get the role retroactively. Two options:

• Use /setlevel @user 10 then /setlevel @user 15 to trigger the level-up path (one user at a time).
• Use /harvest then /replay to reprocess all history and trigger role assignments for everyone at once. See the Harvest & Replay guide for details.

Multiple rewards per level

You can assign multiple roles at the same level by running /add-role-reward multiple times with the same level but different roles.

Levelers

If you use multiple levelers, role rewards are per-leveler. Pass the leveler parameter:

/add-role-reward level:10 role:@Art Star leveler:art