Skip to main content

​
Overview

Give a role automatically when a member reaches a specific level, and give certain roles or channels a faster (or slower) XP rate.
Petto announces in the level-ups channel that nico hit level 10 and unlocked the Regular role

In Discord: a member reaches level 10, a level with its own message, and gets its reward role.

​
Role rewards

liam types !level reward add text 10 @Regular and Petto answers that members will now get @Regular at level 10

In Discord: @Regular at message level 10.

liam types !level reward add voice 5 @Talker and Petto answers that members will now get @Talker at voice level 5

In Discord: @Talker at voice level 5.

liam types !level reward remove text 25 and Petto answers Removed the level 25 reward

In Discord: the reward of level 25 is removed.

liam types !level reward list and Petto lists Messages: level 10 Regular, 25 Veteran, 50 Legend, and Voice: level 5 Talker

In Discord: the rewards of message levels and of voice levels.

type is text (message levels) or voice. Write it before the level, or add --type text at the end: in !level reward add 10 @Regular the 10 would be read as the type.

​
Voice level rewards

Message levels and voice levels have their own reward roles. type is messages (the default) or voice, written as --type voice. A member who reaches voice level 5 gets the voice reward for level 5, not the one of message level 5, and each kind follows its own stacking mode. reward list shows both. In the dashboard, adding or removing a reward only changes the page, and one Save rewards button at the end saves the whole list at once. Level Rewards has the two lists and a choice of message or voice level when you add one.
Petto posts in #level-ups that zoe_plays reached voice level 5 and got @Talker

In Discord: a member reaches voice level 5 and gets the voice reward @Talker.

The Level rewards page with Regular at message level 10, Veteran at 25, Legend at 50 and Talker at voice level 5

Dashboard → Leveling → Level Rewards: the rewards for message and voice levels, and the row to add one.

​
Stacking vs highest-only

liam types !level role-mode highest and Petto confirms the reward role mode: highest earned only

In Discord: members keep only their highest reward role.

mode is highest (only the highest earned reward role is kept, others are stripped) or all (every earned reward role stacks). Set with !level role-mode, and for voice levels with !level voice-role-mode.

​
XP multipliers

Give a role, a channel or a whole category a faster (or slower) XP rate.
liam types !level multiplier set 2 @Server Booster and Petto answers that @Server Booster now gives x2 XP

In Discord: boosters earn double XP.

liam types !level multiplier set 0.5 #off-topic and Petto answers that #off-topic now gives x0.5 XP

In Discord: #off-topic gives half the XP.

liam types !level multiplier set 1.5 --category GAMES and Petto answers that GAMES now gives x1.5 XP

In Discord: every channel of a category gives x1.5.

liam types !level multiplier remove #off-topic and Petto answers Removed the multiplier for #off-topic

In Discord: the multiplier of a channel is removed.

liam types !level multiplier list and Petto lists @Server Booster x2, #off-topic x0.5 and GAMES (category) x1.5

In Discord: every multiplier of the server.

value is a raw multiplier: 2 for double XP, 0.5 for half, 0 for none. Provide one of role, channel or category (the category goes with --category). How a multiplier is worked out for a message or a minute in voice:
  1. The base multiplier of the server (!level rules xp_multiplier, 1 by default).
  2. Times the one of the member’s roles. With several roles, multiplier_mode decides: highest takes the biggest, stack multiplies them, sum adds each extra to 1.
  3. Times the one of the channel, or of its category when the channel has none of its own. A channel wins over its category.
  4. Never above the cap (multiplier_cap, 20 by default).
It works for messages and for voice. The dashboard has a Multipliers page with the three kinds (edited on the page and saved together with Save multipliers), and the base multiplier, the mode and the cap are in Rules and events.
The Multipliers page with x1.5 for the GAMES category, x0.5 for #off-topic and x2 for @Server Booster, and the fields applies to, role and multiplier

Dashboard → Leveling → Multipliers: the multiplier of each role, channel and category, and the row to add one.

The Multipliers card of Rules and events with a base of 1, several roles set to only the highest, and a cap of 20

Dashboard → Leveling → Rules and events: the base multiplier, the mode for several roles and the cap.

​
Giveaways

Levels also work in giveaways: a preset can ask for a level to enter and give extra entries from some levels.

​
Rank cards

Members check their own progress with !rank, or the server ranking with !top, no configuration needed for either.

​
Limits

Level rewards have no Premium limit: every server can give a role at as many levels as it wants, for message and voice levels. See Premium.