Setting Up Server XP/Leveling

Reward your users activity with levels, role rewards and more!

Why Would You Need This?

Server Leveling is a super easy and effective way to ensure activity and growth in your Discord server. By setting out goals of activity with rewards, users will be enticed to keep the chat going to reach this goal you've put out for them. This goal can be anything from something as simple and inexpensive as a role reward that grants the user a special permission like the ability to send and embed images, to rewarding the topmost active users on your Discord with Nitro! Pepe Manager offers a free and easy-to-use XP and Leveling system so you can keep user retention high, and costs low!

Video Tutorial

We currently do not have an updated video tutorial for this guide just yet, check back later!


Toggling Levels

By default, Pepe Manager will not have leveling enabled. Any user activity that may have occurred before you enabled leveling has not been counted. You need to enable it to get started by typing the following command:


What Messages Count for Leveling?

Any of the following messages can count towards leveling progression, provided the member is not blocked from leveling in some way or another.
  • Default text messages
  • Reply text messages
  • Slash command usages (Any bot, non-ephemeral)
  • Context menu command usages (Any bot, non-ephemeral)


Adding Leveling Channels

You can now add specific channels that users can gain XP in. The channels you setup will be by default blacklisted channels, meaning that they are the only ones that are excluded from being able to gain XP. However, as we will explain shortly you can very easily change that within moments. For now, use the /config set command to add as many channels as you want!
You can add up to 30 channels for free, or 50 channels with Premium!
Now the bot will send a confirmation message of the information you just entered, however included with that is also a grey button that let's you toggle between the blacklist and the whitelist option whilst still retaining all of the channels you just set! If you therefore want only the channels you just entered to be used as leveling channels, press the button that says 'Switch to whitelist'
If you don't do anything, the channels will be set as they are!
To simply things and help you understand the different leveling channel modes here is an overview:
Whitelist enabled & no leveling channels set = Members can't gain levels anywhere
Blacklist enabled & no leveling channels set = Members can gain levels everywhere

And That's It!

If you only want the very basic leveling setup, you are done now! If you want to go more in-depth and learn about many more features that you can use, carry on! ALL STEPS BEYOND THIS POINT ARE OPTIONAL


Adding No Leveling Roles

You can now set specific roles to not gain XP, regardless of whether or not the user is in the appropriate leveling channel or not. It is also not important if the user has another role on top or below the role you set to not gain XP. This feature is quite useful if you do not want your staff to gain XP, or to make sure that muted users do not gain XP, etc. To add a role you can type the following command:


Adding the Daily Top Leveling Role

You can also reward a user for having the most XP by letting the bot assign a Top Leveling role. This role is given out at 00:00 UTC, and is only ever given to one person on the server. If a user had the Top Leveling role previously, it will be taken off of them.
The Top Leveling Role will only be assigned if the qualified person is level 10+. This is done to prevent unfair XP gain by other members in the lower levels where gaining XP is easier.
This feature is a quick and easy way to give users a long-term goal to work towards. It also helps if the Top Leveling role is hoisted quite high on the server list, and is given a prominent colour. To set the Top Leveling role, you can type the following command:
It is highly suggested that you also set the Top Leveling role as a No Leveling role aswell. Not doing so might lead to the situation that only one person ever receives the Top Leveling role since during their day on the Top they keep gaining XP. By letting them not gain XP for a day gives other users time to catch up.

Customizing the Level Up Message

If you find the current Level-Up message to not suit your server style, or you simply want to spice it up a little, you can completely customize it! We currently only support raw text messages (Not Embeds) To set the Level-Up message you can type the following command:
This will then open a modal dialog box, in which you can then type and send-off your written out level-up message! When you're done, and are sure that the message is within the 1,000 character limit, click on the submit button!
There are several tags you can include in your Level-Up message. These parameters will be replaced with the appropriate information when the Level-Up message is sent. You must include the {} brackets in your message for the tags to show up!
User Mention (@User)
User Tag (User#1234)
Username (User)
User Discriminator (1234)
User ID (99787644430475264)
Server Name (My Cool Server)
Server ID (493351982887862283)
Level Reached (5)


Setting the Level Up Message Destination

By default Pepe Manager will simply send the Level-Up message in the same channel where the user who Leveled-Up last spoke in, but this can sometimes be intrusive and can disrupt normal conversation. Not to worry though, as you can set where Pepe Manager will send the Level-Up message. To set this up, simply type the following command:
The command will reply with a select menu, asking you to select where to send the level up announcement to. Unless you are selecting a custom channel, simply select an option from the drop-down menu.
If you are selecting a custom channel, you must choose the optional slash command option values and in the option field enter the custom channel you want to use.


When to send the Level Up Message

By default, Pepe Manager will send the Level-Up message after every level increase no matter what. However, you can also configure the bot to send the message at different times and for different reasons/levels.
This first command lets you set exactly which levels should be announced and which shouldn't. You can include as many levels as you want, within reason. Only these levels will then be announced, regardless of where the level-up message will be sent.
The next command lets you set from what level on-wards you want the levels to be announced. This means that any and all levels below this threshold won't be announced, but all of them including the minimum level will be announced.
The next command lets you set if you want levels to only be announced if they are a part of a multiple of a specific number. For example if you only want to announce the levels 5, 10, 15 and so on, you would set this command to a multiple of 5.
Lastly, you can also additionally toggle whether or not you want to announce only the levels that also have a Leveling Role attached to them.
The following table shows you the hierarchy of all of these settings and when they go into effect if you've set multiple of them. Please refer to this when you're troubleshooting why a certain level isn't being announced.
Level Announcement Setting
Hierarchy of Announcement
Minimum Level
Manually Set Levels
Only Leveling Roles
Multiple (Factor) Of
By this table, if you have manually set levels 1, 2 & 3 to have an announcement, but also set a multiple of 5, the only level that would be left out with be level 4.


Adding Leveling Role Rewards

The main meat of Leveling: the role rewards. You can set up roles to be given out to users when they reach a specific Level. This can be used to simply indicate the users level with a role, give out special colours to users as they gain higher levels, give out permissions that can be earned through activity, and so much more. With the free version of Pepe Manager you can set up to 2 roles to be given out on the same Level, however overall there is no limit to how many roles you can set up. The premium limit is 10 roles for the same Level.
You will then receive a modal box asking you to enter the exact Level you want these particular roles to be assigned at.


Adding the No Role Reward Roles

This option allows you to set specific roles that will not be awarded other role rewards, even if they reach or surpass the required level. However you cannot set a specific to be both a role reward and a no role reward role.


Automatically Resetting Levels

Automatically resetting levels can be very useful to keep your server nice and organized, and to punish those you ban even more! When the condition you set has been met, Pepe Manager will automatically delete the affected users level data (If they had any) without questions.
Kicking a user has the same effect as leaving though, so please be careful!
You will then receive a drop-down menu from which you can choose what you want the bot to do. You can only choose one at a time.
What Will Trigger the Reset?
Response Type
When the user leaves the server for whatever reason
When the user is banned for whatever reason
When the user leaves or when the user is banned


Blacklisting Bot Prefixes

You are obviously using more than one bot in your server, and many times users can use bot commands in channels where you might also want to have leveling enabled. With Pepe Manager you can choose whether or not the bot ignores commands, even if they should be counted as a normal leveling message. For example if someone uses the command ?hug <User> and you have the prefix ? blacklisted, that message won't be counted as an XP message.
You will then receive a modal box in which you can enter the message command prefixes you want to be blocked, seperated by a comma.


Server-Wide Rank Card Colour

Normally, every user can choose their own rank card colour accent. As a server owner, if they haven't set one themselves, you can set one for them to provide a cohesive appearance for the entire server whenever everyone is checking out their rank cards!
You will then receive a modal box asking you which option for the accent colour to choose. You can only choose one option at a time. Below the example image is a table of all of the different choices and what they will do.
Accent Colour
Hexadecimal Colour (Eg. #ff7077)
Sets the colour to your custom hex colour code
Icon Average
Sets the colour to the average colour of your server icon
Banner Average
Sets the colour to the average colour of your server banner


Toggling Role Stacking

Now that you've set up some role rewards, you can choose whether or not the bot will stack the roles or not. Stacking means that each additional role reward will simply be added to the users already existing roles. Non-Stacking means that any previous role reward roles will be removed when the user gains a new role. This does not affect roles that are not specifically marked as rewards.
By default, stacking is turned on.


Toggling Leveling in Threads

Pepe Manager can see every message in every thread, and enabling this can mean a lot more diversity and a lot less clutter for different topics in your server, and yet still allowing you to reward active chatters with XP.
Toggling this will not enable XP on all threads, it will enable XP gain on threads that are part of already enabled XP channels.
By default, leveling in threads is turned off.


Final Words

It's really easy to set up an activity tracking system, but as you want to add more and more features, and reward your users for the loyalty and activity it becomes more and more complex. If you are new to bots don't be scared of all of the complicated commands and command structures, new words that bots use to describe what they're doing, etc. If you need any more assistance with Pepe Manager, check out the rest of this documentation or join our support server to talk to an actual human!



Leveling Roles aren't being assigned!

If you think you have set up the Leveling roles correctly, but users aren't getting them when they level up or when they press the Sync button, follow these steps in order to fix your issue! These steps are also the same when troubleshooting the Top Leveling role.

1. Make sure the bot has 'Manage roles' permission

The bot needs to have this permission in order to assign roles. If you're new to Discord, a lot of different permissions are bundled under one permission umbrella, and giving the manage roles permission also grants users access to assign roles.

2. Make sure the roles you want to assign are below the bot on the role list

Another common issue is that the bot DOES have the manage roles permission, but the highest bot role (ie. The top-most role that the bot is assigned to) is lower down in the role-ranking than the roles you want it to assign. Hierarchy moves from the top to the bottom, so make sure that the bot always has a role that's above the Leveling roles.

3. Make sure the roles you want to assign aren't integration managed

Integration managed means that the role you want to assign is being used by an external bot or integration. This is what you should see at the top of the role edit page when the role is managed by an integration.

4. It's still not working!

If the bot still isn't assigning the Leveling roles, join our support server and head over to the #bot-support channel, then react with the 🆘 icon to get access to our human support channel!