Home
Server Setup Leveling

Leveling

Enable XP & levels, send level-up messages, and award role rewards at specific levels.

Replace [prefix] with your server’s prefix. For Calamity the prefix is ,,.

Enable or Disable

Turn the leveling system on or off for this server.

,,level enable
,,level disable

Level-up Channel

Set a dedicated channel for level-up messages, or remove it so messages appear in the current channel.

,,level channel #level-up
,,level channel remove
Set level-up channel

Level-up Message

Customize the level-up message using embed parameters. See Embeds › Parameters.

,,level message {embed}$v{title: GG!}$v{description: {user.name} reached level {level}}
Set custom level-up message

Reset Levels

Reset a single user back to level 0, or reset everyone on the server.

,,level reset @User
,,level reset all
Reset user level

Role Rewards

Automatically grant roles when users reach a specific level.

Add

,,level role add <level> <role>
Add level role reward

Remove

,,level role remove <role>

List

,,level role list
List level role rewards

Manually Set a User’s Level

Directly set a user to any level (useful for migrations or fixes).

,,level set @User <level>
Set a user's level

Stacking Roles

Choose whether users keep all earned level roles or only the highest one.

,,level stack
,,level unstack
  • Stack: Users keep every reward role they’ve unlocked.
  • Unstack: Only the latest/highest reward role remains.

Tips

  • Place the bot’s role above your reward roles so it can assign them.
  • The variable {level} is available in embed text for level-up messages.
  • You can change channel/message settings anytime without losing XP data.