serenity
2 min read

Level Rewards

Hand out roles automatically when members reach a level.

Replace [prefix] with your server's prefix.

Text Rewards

// Syntax
[prefix]level rewards add [level] [role]

// Example
;level rewards add 5 @Regular
;level rewards add 20 @Veteran

The role is handed out the moment a member reaches that level, and members who are already past it get it the next time they level up.

CommandWhat it does
[prefix]level rewards listEvery reward and its level
[prefix]level rewards remove [level] [role]Drop one
[prefix]level rewards resetDrop all of them

Stacking or Replacing

// Syntax
[prefix]level rewards roleupdate

// Example
;level rewards roleupdate

Toggles what happens to the previous reward role when the next one is earned:

ModeResult
OffRoles stack - a level 20 member holds every reward up to 20
OnOnly the newest reward is kept, the old one comes off

Turn it on if your reward roles are a ladder (Regular → Veteran → Elite) and leave it off if they're collectibles. Stacked ladder roles turn the member list into a mess of near-identical colours.

Voice Rewards

The voice track has its own set, with the same commands:

;level voicerewards add 5 @Talker
;level vrewards list
;level vrewards remove 5 @Talker
;level vrewards reset

If the server combines voice into the text level, voice XP earns the normal text rewards and these aren't handed out.

serenity can only hand out roles below its own highest role. A reward role above the bot in the role list silently never gets applied - check the order before wondering why nothing happens.

Roles can also speed up how fast members earn XP in the first place:

XP MultipliersSpeed up XP for boosters, or for any role you choose.

Last edited