Leveling
Here you will find information on how to configure John-Bot's progressive leveling system.
Video tutorial related to this page: Configure John-Bot's Level System - Tutorial #6
🚀 Introduction
To maintain consistent activity on a Discord server, the most recommended method is to reward members with levels and ranks. Based on this concept, John-Bot offers an enhanced version with levels earned through experience points and the assignment of virtual rewards via roles when specific milestones are reached.
🛠️ Configuring the System
Access the Dashboard
First, go to the John-Bot dashboard through the method of your choice. Learn how to do it here: How to Access the Dashboard
Access the Settings
Next, look for Levels on the right-hand column, under your server's logo and banner. You will now be on a page where you can access all the settings related to the level system.
Import from Another Application
If you're currently using another application to manage your server's leveling system, you can import all your data in just a few moments using a simple command¹.
At the moment, only the MEE6 application is supported, but this feature may evolve to include other applications.
🌍 Global System
The leveling system works with experience points that can be earned by sending a message or spending time in a voice channel. You can set the amount of experience points gained per message or per minute, as well as a rate. A level corresponds to a milestone, achievable by accumulating a specific number of experience units.
Details on how to gain experience, as well as the experience required to unlock a level, are available in the subpage linked to this page.
Level-Up Announcement
When a new level is unlocked, John-Bot can instantly send a customized announcement in a designated channel.
Enable announcement: To activate level-up announcements, check this option.
Enable image: With each announcement, an image representing the member is generated, also indicating the level reached at that moment.
Channel choice: You can choose to send the level-up announcement in the last channel where the member sent a message² by selecting
In the current channelfrom the dropdown menu, or send the announcement in a specific channel, always the same for each announcement, by selectingIn a custom channelfrom the dropdown menu, then specifying the channel using the second dropdown menu that appears below or to the right, depending on your device.Level-up message: In addition to the level-up image, you can add a personalized message, compatible with level variables.
Additional Options
Experience ratio
This option allows you to set the amount of experience points awarded to a member per message or per minute spent in a voice channel. You can choose a range using the dropdown menu; the exact amount will be randomly determined.
Maximum level 💎
You can set a maximum level that will prevent members who have reached this level from gaining more experience. To disable this option, set it to 0.
Voice experience 💎
By enabling this option, you allow your members to earn experience points in voice channels, as long as there are at least two human members in the voice channel.
Level loss upon departure
With this option enabled, if a member leaves the server, their experience will be reset.
No experience gain in ticket
When this option is enabled, no experience points will be awarded to members sending messages in ticket channels.³
Experience rate 💎
If you want to increase the experience gained to make it easier to access higher levels, you can choose to award experience points up to 3 times faster.
Special Roles and Channels
Bonus roles and channels: You can set roles and channels where sent messages or minutes spent in voice chat earn more experience points. You can adjust the bonus multiplier⁴ by clicking on the number located before the role or channel name.
No-gain roles and channels: You can set roles and channels where sent messages or minutes spent in voice chat earn no experience.
🎯 Rewards
To encourage members to reach higher levels, you can set unlockable rewards in the form of roles when a member reaches a specific level.
Reward Unlock Announcement
When a new level is reached and a reward is unlocked, John-Bot can instantly send a customized announcement in a designated channel.
Enable announcement: To activate reward unlock announcements, check this option.
Enable image: With each announcement, an image representing the member is generated, also indicating the unlocked reward.
Channel choice: You can choose to send the reward unlock announcement in the last channel where the member sent a message² by selecting
In the current channelfrom the dropdown menu, or send the announcement in a specific channel, always the same for each announcement, by selectingIn a custom channelfrom the dropdown menu, then specifying the channel using the second dropdown menu that appears below or to the right, depending on your device.Reward unlock message: In addition to the reward unlock image, you can add a personalized message, compatible with level variables.
Reward Role Types 💎
Reward roles are assigned when a member reaches the required level. You can choose whether a member can only have one reward role at a time on their profile by selecting Progressive reward roles. When a new reward is unlocked, the current role will be removed from the member's profile and replaced with the newly unlocked role. If you want the member to accumulate roles, select Cumulative reward roles.
Reward Configuration
To create a reward, click the button at the bottom of the page and define the following two parameters:
Required level: Set the required level to unlock this reward by entering it in the designated field.
Reward roles: Define the role that will be assigned as a reward when the member reaches the required level by selecting it using the corresponding dropdown menu.
📊 Leaderboard
Your server's leaderboard lists members in descending order based on their experience points, showing their level and accumulated experience points.
It can be accessed via the leaderboard command, which displays the top ten members. A complete version is available online.
Accessing the Server Leaderboard
You can access the complete online leaderboard in two ways:
Full URL: The web address (URL) of a server's leaderboard is composed as follows:
https://www.johnbot.app/leaderboard/serverid. Simply replace theserveridvariable with your server's ID⁵.Link via a command: You can easily obtain this link using the
/leaderboardcommand.
🔧 Command List
| Command | Description | Example |
|---|---|---|
/leaderboard | Displays the server members' level leaderboard. | |
/rank or /level | Displays your level or a member's level. | |
/xp add | Adds experience to a member. | |
/xp remove | Removes experience from a member. | |
/xp import | Imports leveling data from other bots. | |
/xp reset | Resets the leveling data of a member or all server members. | |
/xp user | Displays a member's total experience and level. | |
/rewards | Displays the list of rewards that can be unlocked with the leveling system. |
1: Subject to the availability of the corresponding application
2: The message will be sent to the voice channel chat if the member levels up in a voice channel
3: Tickets must be managed with John-Bot's ticket system
4: Only among the following numbers: 1.5; 2; 2.5; 3
5: Find your server ID: Where can I find my user/server/message ID?
Last updated
