Skip to main content
Scrump is a Discord leveling bot, also spelled a Discord levelling bot, that rewards members with XP for participating in chat. Members can view rank cards and leaderboards, while server managers can configure level roles, XP cooldowns, multipliers, excluded channels, and rank-up notifications.
Configuring the Discord leveling system requires Manage Server permission.

​
How to set up a Discord leveling bot

1

Enable Discord leveling

Run /leveling-config module enable. Members begin earning XP from eligible messages while the leveling module is enabled.
2

Choose rank-up notifications

Run /leveling-config rank-up-notifications mode:. Rank-up alerts can be disabled, sent by DM, posted in the channel where the member earned XP, or sent to one specific channel.
3

Create level roles

Run /leveling-config level-role add role: level: for every Discord role you want Scrump to award at a level milestone.
4

Review the leveling configuration

Run /leveling-config view to check whether leveling is enabled and review the server’s XP, notification, multiplier, and level-role settings.

​
Import MEE6 leveling data

If your Discord server is switching from MEE6, run /leveling-config mee6-import to import the server’s existing MEE6 leveling data into Scrump. Importing member XP helps preserve established ranks instead of making the community start at level zero. The free import is normally available once per server.
Review /leveling-config view after the import, then test /rank and /leaderboard before announcing the new leveling bot.

​
How Discord XP works

By default, an eligible human message awards a random 5 to 15 XP. A member can receive one XP award every 60 seconds, which reduces the benefit of rapid message spam, and messages from bots do not earn XP. Free servers use those default XP values. Paid plans can change the XP cooldown and apply server-wide, channel, or role multipliers.

​
Configure Discord XP

Use these leveling commands to control where and how quickly members earn XP:
  • /leveling-config no-xp-channel add channel: prevents XP farming in a selected channel.
  • Paid plans can use /leveling-config set xp-earn-cooldown time: to change the cooldown between XP awards.
  • Paid plans can use /leveling-config set global-xp-multiplier multiplier: to change XP earning across the server.
  • Paid plans can use /leveling-config channel-xp-multiplier add channel: multiplier: to boost or reduce XP in one channel.
  • Paid plans can use /leveling-config role-xp-multiplier add role: multiplier: to change XP for members with one role.
Free servers use the default XP cooldown and a 1.0x global multiplier without channel or role multiplier rules. Channel and role multipliers can be removed with the corresponding remove subcommand. Server managers can also use the /leveling-config give-xp, remove-xp, give-levels, and remove-levels commands when a manual adjustment is needed.

​
Discord level roles

Level roles automatically reward active members when they reach configured milestones. Use /leveling-config level-role add role: level: to create a reward and /leveling-config level-role remove role: level: to remove it. Paid plans can run /leveling-config level-role set-mode mode: to choose between:
  • Assigning every level role a member has earned
  • Assigning only the highest level role the member has earned
Make sure the Scrump bot role is above every reward role in the Discord role list and has Manage Roles permission.

​
Rank cards and Discord leaderboards

Members can use /rank to view their Discord rank card, current level, and progress toward the next level. Add the optional member parameter to view another member’s rank. Use /leaderboard to display the server XP leaderboard. Servers with a public leaderboard enabled can also share it with /leaderboard-link, and individual members can control their public visibility with /leaderboard-privacy visible:.

​
Discord leveling plan limits

​
Discord leveling troubleshooting

If members are not earning XP or receiving level roles, check that:
  • /leveling-config view shows the module as enabled.
  • The channel is not configured as a no-XP channel.
  • The member is outside the configured XP cooldown.
  • Global, channel, and role multipliers allow XP to be awarded.
  • Scrump has Manage Roles and its bot role is above the reward role.
  • Rank-up notifications are not set to No alerts.

​
Discord leveling FAQ

​
How do I add leveling to a Discord server?

Invite Scrump, run /leveling-config module enable, configure rank-up notifications, and add level rewards with /leveling-config level-role add. Members will then earn XP from eligible chat activity.

​
Is it called Discord leveling or Discord levelling?

Both searches refer to the same feature. “Leveling” is the common US spelling and is used in Scrump’s slash commands, while “levelling” is common in British English.

​
How do members check their Discord level?

Use /rank for a visual rank card and /leaderboard for the server XP rankings.

​
Can I stop XP farming in bot commands or spam channels?

Yes. Add those channels with /leveling-config no-xp-channel add channel:. You can also increase the XP earn cooldown or use channel XP multipliers.

​
Can I transfer MEE6 levels to another Discord bot?

Scrump supports a MEE6 leveling import. Run /leveling-config mee6-import, then review the imported results with the rank and leaderboard commands.