How to set up a level system on Discord
A level system gives members XP for writing and for time in voice channels, and a new level once enough has added up. With role rewards and a leaderboard, regulars have something to show for the evenings they spend on your server. On SCNX this is the level module of your bot, and nearly every number in it can be changed.
Updated 18 Νοεμβρίου 20269 min read
On this page
The short version
- Members earn XP for messages, with a cooldown, and for time in voice.
- You decide which level unlocks which role and how steep the climb is.
/profile,/leaderboardand a live leaderboard channel show where everyone stands.
What you need
- Your own bot on SCNX. Creating one takes about two minutes
- The bot can view the channels where XP should count and read their message history
- For role rewards: the Manage Roles permission, and the bot's role above the reward roles
How XP works
Every message earns a random amount of XP between a minimum and a maximum. With the default settings that is 25 to 65 XP. A cooldown follows in which further messages earn nothing.
Time in voice channels earns XP too, by default half an XP per minute. It only counts while other members are in the channel, and not while someone is muted or deafened. The bot adds voice XP every 15 minutes and when the member leaves the channel.
A level curve defines how much XP each level needs. When a member crosses the line, the bot posts a level-up message and hands out the role you tied to that level, if there is one.
Illustration. The real interface may look different.
Set up the level module
Switch on the module
Open Modules in the Discord-Bot section of your dashboard, find Level-System and switch it on. Save your changes. Members earn XP with the default values right away.
Check the bot's permissions
The bot only counts messages it can see. It needs View Channel and Read Message History in every channel where XP should count, and Send Messages and Embed Links where level-up messages appear.
Open the configuration
Click Open configuration on the module, or open the level configuration directly. The settings are grouped into XP Settings, Level Roles, Level-up Messages, Leaderboard, General Settings and Inactivity decay.
Exclude channels that say nothing about activity
Add bot command channels, counting games and spam channels to Blacklisted Channels. Do the same for staff channels, so your team does not climb the leaderboard by doing its job.
Save and reload
Save and confirm Reload configuration now. Write a message and run
/profileto see your XP.
If you are unsure about the numbers, leave the defaults for a week and look at the leaderboard before you change anything. Tell your members when you change them later. People notice when leveling suddenly gets slower.
The XP settings
| Setting | What it does and what to pick |
|---|---|
| XP given at least for messages, XP given at most for messages | The range for one message. Default 25 and 65. A wider range makes leveling feel less mechanical. |
| Cooldown | The pause between two XP grants for the same member, in milliseconds. The default is 1500, so one and a half seconds. For a calmer system set 60000: then one message per minute counts. |
| XP given per Voice Minute | Default 0.5. Set it to 0 if voice should not count. |
| Type of the leveling curve | How much XP each level needs. See below. |
| Blacklisted Channels | Channels where nobody earns XP. |
| Blacklisted roles | Members with one of these roles earn no XP for messages. |
| XP Multiplication Roles | A factor for members with a role, for example 1.5 for your boosters. |
| XP Multiplication Channels | A factor for a channel. Above 1 rewards writing there, below 1 damps it. |
There are three built-in curves. Default Linear needs 750 XP times the level. Level 15 then stands at 11,250 XP, which is 250 messages at an average of 45 XP. Easy Linear adds 500 XP for every level after the first, so it starts the same way and gets harder as members climb. Exponentiation starts very gently and becomes steep after level 14. You can also enter your own formula with x as the level.
Our docs recommend Easy Linear for most servers. The level simulator in the docs shows how many messages each level takes with your numbers.
Multipliers stack. A message worth 50 XP from a member with a 1.5 role in a channel with factor 1.9 earns 143 XP. If someone holds two multiplier roles, their factors are multiplied with each other, so keep the values between 1 and 2.
Role rewards
Role rewards are set in Level Reward roles. Add an element, enter the level in the first field and choose the role in the second. Create the roles in Discord first.
By default members keep every reward role they have earned. With Only keep highest Level-Role the bot removes the earlier ones when a member reaches the next reward.
Keep the list short. A new role every few levels stops feeling special, and five or six milestones are easier to remember, for example Regular at level 10 and Veteran at level 25. Roles that only change the name color work well. Be careful with roles that unlock permissions: XP can be farmed, and a level should not be the only thing between a new account and posting links.
The bot can only assign roles that sit below its own role in your server's role list, and it needs Manage Roles.
Level-up messages
By default the bot congratulates in the channel where the member just wrote. On an active server that gets noisy quickly. Three settings in the Level-up Messages group control it.
| Setting | What it does and what to pick |
|---|---|
| Which Level-Up-Messages should get sent? | all sends one for every level. only-role-rewards only speaks up when a level comes with a role, which suits busy servers. none switches them off. |
| Level-Up-Channel | A fixed channel for all level-up messages. Leave it empty to post where the member leveled up. |
| Random messages | Picks a text from the Random-Level-Up-Messages file instead of the same sentence every time. |
The texts themselves are in the module's Messages file. There is one for a normal level-up and one for a level with a role reward, where %role% inserts the role. In the Selected messages file you can write a special message for single levels, such as level 50.
Profile and leaderboard
/profile shows a member their level, XP, message count and today's activity. With a member selected it shows that member's profile. /leaderboard shows the ranking of the whole server, sorted by level or by XP. Both replies are only visible to the person who ran the command, so nobody floods the chat with rank checks.
For a ranking everyone can see, set a Live Leaderboard-Channel. The bot posts one message there and updates it every five minutes. A button below it, 👤 Show my level, tells each member their own level in a reply only they see. By default the message lists the top 15, which you can change. Take away the permission to send messages in that channel so the leaderboard stays at the top.
On large servers, set User Display Mode to Tag. The leaderboard then shows usernames as text.
Illustration. The real interface may look different.
Reset, correct and move levels
- Reset one member
/manage-levels reset-xpwith auserandconfirmset to True deletes that member's XP and level.- Reset the whole server
- The same command without a user, again with
confirmset to True, wipes everyone's XP. It cannot be undone. By default the command is available to everyone who may time out members, so restrict it in your Discord server settings under Integrations if moderators should not have it. - Reset when someone leaves
- With Rest Level on leave the bot deletes a member's levels and XP when they leave your server. It is off by default, so returning members keep their progress.
- Correct a level or XP by hand
- Switch on Cheats in the configuration.
/manage-levels edit-xpand/manage-levels edit-levelthen add, remove or set a member's XP or level. Leave the option off when you do not need it. A leaderboard that admins edit loses trust quickly. - Move from another level bot
- There is no automatic import from other bots. With Cheats on, you set each member's level with
/manage-levels edit-level set. That is doable for your top twenty and less so for two thousand members. A common compromise is to carry over the top ranks by hand and announce a fresh season for everyone else. - Let inactive members drop
- Enable inactivity decay? takes XP from members who have earned none for a while. By default they lose 5 percent every 7 days after a grace period of 30 days. Reward roles follow the level down.
- Cap the system
- Enable maximum level? stops leveling at a level you choose. Start with Level 0? shows new members as level 0 instead of 1.
When something does not work
- Nobody earns XP in a channel
- Check that the bot can view the channel and read its message history, and that neither the channel nor one of the member's roles is on a blacklist.
- Reward roles are not assigned
- The bot needs Manage Roles, and its role must be above the reward roles. A role that sits higher than the bot cannot be assigned.
- No level-up messages appear
- Look at Which Level-Up-Messages should get sent? and at the Level-Up-Channel. The bot needs Send Messages and Embed Links in the channel where the message should appear.
/manage-levels edit-xpis missing- The edit commands only exist while Cheats is on. Switch it on, save and reload the configuration.
- The live leaderboard looks outdated
- It updates every five minutes. If nothing shows at all, check the bot's permissions in that channel and reload the configuration.
- Voice time earns nothing
- Voice XP needs at least one other member in the channel, and muted or deafened members get none. It is added every 15 minutes or when the member leaves the channel.
Other ways to do it
Levels are among the most common bot features, and there are bots built for nothing else. They are quick to add. Check first which features their free version includes, role rewards and the leaderboard in particular.
Your own code needs a database for the XP, and that is where most hobby projects get complicated. If you want custom logic without running a database, a level system built with Custom Commands V3 stores its data on your SCNX bot.
Common questions
- Is the level bot free?
- Yes. The level module is part of your bot and free on our Starter plan, with role rewards, multipliers and the live leaderboard.
- Does time in voice channels count?
- Yes. Voice XP is given for time in a voice channel while others are present. Members who are muted or deafened get none. Set the value per minute to 0 to switch it off.
- How do I reset all levels?
- Run
/manage-levels reset-xpwithout a user and withconfirmset to True. This deletes the XP of every member and cannot be undone. - Can I import levels from MEE6 or another bot?
- Not automatically. You can set levels by hand with
/manage-levels edit-level setafter switching on Cheats in the configuration. - Can some members earn XP faster?
- Yes. Multiplication roles and channels raise the XP, for example for server boosters or for a channel you want to bring to life.
- How do I stop members from farming XP with spam?
- Raise the cooldown so only one message per minute counts, blacklist bot and spam channels, and give busy off-topic channels a multiplier below 1.
- Do members lose their level when they leave?
- Not by default. They keep it and continue where they left off when they come back. Switch on Rest Level on leave if you want a clean slate.
- Is there a maximum level?
- Only if you want one. You can set a maximum level, and you can let members start at level 0.
Start with a free bot
Log in with Discord, add your server and create your bot. The dashboard walks you through each step.
Get started for freeFree on our Starter plan. A short ad video every 14 days keeps the bot online.