Level Rewards
Reward your members for being active in your server.
Getting started
Before you run any commands, it’s important to use the levels unlock
command otherwise
XP will not be tracked for users. You can also use the levels lock
command to temporarily stop tracking XP.
Ignoring channels and roles
You should immediately ignore channels and roles that you don’t want gaining XP. You can do this by using the levels ignore
command.
If you no longer want to ignore a channel or role, you can re-run the command.
You can also use levels list
to view all ignored channels and roles.
Setting up roles to reward
You can reward your members with roles when they reach a certain level. You can use the levels add
command to add a level reward.
If you no longer want to reward a role for a level, you can use the level remove
command.
levels sync
command to ensure that all users have the correct roles based on their XP.Stacking reward roles
Stacking roles means that users will keep all the roles they’ve earned when they reach a new level, instead of only having the role for their current level. By default, this feature is enabled.
Customizing level-up messages
You can customize the level-up message that will be sent when a user achieves a new level.
{guild.name}
variable in your message otherwise it will not work.Setting where the message is sent
You can set the channel where the level-up message will be sent. By default, the message is sent in the same channel where the user achieved the level.
The option
parameter can be one of the following:
pm
- Sends the message in the user’s direct messages.context
- Sends the message in the same channel where the user gained XP.#channel
- Sends the message in the specified channel.none
- Entirely disables the level-up message.
Changing a member’s level
You can change a member’s level to a specific level or set their XP to a specific amount.
Changing the XP multiplier
You can change the XP multiplier to increase or decrease the amount of XP members receive.