serenity

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

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.