¶ Overview
The Leveling & XP System in Cakey Bot provides a comprehensive user progression framework that rewards user activity in Discord servers. Cakey Bot provides all servers with free role rewards and leaderboards. Configure custom XP rates, ignored/no XP roles/channels, and other configuration features! This technical documentation covers the mechanics of XP earning, level calculation, role rewards, and system configuration
Migrating from MEE6 or another leveling bot? You can automatically import your leveling/xp data with the
/setup import-levelscommand!
¶ Importing/Exporting Leveling Data
¶ Importing
Cakey Bot makes it extremely easy to import your data from external/third-party bots! Currently we have support to automatically import data from these bots:
In order to automatically import the leveling data make sure you have Manage Server or Administrator permissions and then run the /setup import-levels command. Keep in mind it may take a few mintues to run if your server has a lot of users/data to export!
Note that importing data will WIPE all existing leveling data for your server. This process can not be reversed so be sure before you run the command.
Don't see your prevous leveling/xp bot in the list above? No problem! You can still use the /manage-levels and /manage-xp commands to manually migrate your user data to Cakey Bot! Unlike some other bots, both of these commands are completely free to use!
¶ Exporting
We believe in vastly different philosophy than our competitors and as end-users of these kinds of systems ourselves in the past, we understand the pain and frustrations some of the other options give you.
All of which is why we allow you to export/download your leveling data at any time, instantly and completely for free!
In order to export your data, simple run the /setup export-cakey-levels command and you'll receive a CSV file with all of your data. Keep in mind it may take a few mintues to run if your server has a lot of users/data to export!
¶ XP Earning Mechanics
The system provides two primary methods for users to earn XP:
- Message XP: Users earn between 15-25 XP (default) for each message sent in the server
- Voice XP: Users earn between 5-8 XP (default) per minute spent in voice channels
Key technical constraints:
- A 60-second cooldown between message XP awards prevents spam
- Muted/deafened users can be excluded from voice XP (configurable)
- XP rates can be modified server-wide or through multipliers
- Channels and roles can be excluded from XP earning
When a user earns enough XP to exceed their current level's threshold, a level-up event is triggered, which can:
- Award role rewards if configured
- Send level-up announcements via configured channels
- Remove previous role rewards if configured
- Update the user's rank on the leaderboard
¶ Leveling Configuration
While Leveling Enabled is not requied to be enabled for Voice Leveling to work, the
/manage-xpand/manage-levelcommands will not function while it is disabled.
| Name | Description | Default Value | Min Value | Max Value | Premium Feature |
|---|---|---|---|---|---|
| Leveling Enabled | Enables or disables message leveling in the server. Note: /manage-xp and /manage-level commands won't function if this is disabled. |
Enabled | No | ||
| Voice Leveling Enabled | Enables or disables voice leveling. You can keep this off to only grant XP for messages. | Enabled | No | ||
| Remove Roles on Demotion | Automatically removes Role Rewards when a user is demoted using /manage-xp or /manage-level. |
Disabled | No | ||
| Remove Roles on Level Up | Automatically removes Role Rewards when a user levels up, including via commands. | Disabled | No | ||
| Wipe User XP on Leave | Wipes a user’s XP when they leave, are kicked, or banned. | Disabled | No | ||
| Ignore Muted Users | Toggles whether muted users earn XP in voice channels. | Enabled | No | ||
| Ignore Deafened Users | Toggles whether deafened users earn XP in voice channels. | Enabled | No | ||
| Ignore Solo Users | Toggles whether users alone in a voice channel earn XP. | Enabled | No | ||
| Disable Level Up Mentions | Toggles whether level up messages will mention users/roles. | Disabled | No | ||
| Send Messages as Embed | Sends level up messages as Discord embeds instead of plaintext. | Disabled | Premium Only | ||
| Max Level | Sets the maximum level a user can reach. | 999 | 1 | 1,000 | No |
| Min XP per Message | Sets the minimum XP a user can gain per message. | 15 | 1 | 1,000 | No |
| Max XP per Message | Sets the maximum XP a user can gain per message. Must be greater than Min XP. | 25 | 1 | 1,000 | No |
| Text Cooldown | Sets the cooldown in minutes between text messages that can earn XP. | 1 | 1 | 60 | No |
| Min XP per Image | Sets the minimum BONUS XP a user can gain per message containing an image. | 0 | 1 | 1,000 | No |
| Max XP per Image | Sets the maximum BONUS XP a user can gain per message containing an image. Must be greater than Min Image XP. | 0 | 1 | 1,000 | No |
| Image Cooldown | Sets the cooldown in minutes between image attachments that can earn bonus XP. | 1 | 1 | 60 | No |
| Min XP per Video | Sets the minimum BONUS XP a user can gain per message containing a video. | 0 | 1 | 1,000 | No |
| Max XP per Video | Sets the maximum BONUS XP a user can gain per message containing a video. Must be greater than Min Video XP. | 0 | 1 | 1,000 | No |
| Video Cooldown | Sets the cooldown in minutes between video attachments that can earn bonus XP. | 1 | 1 | 60 | No |
| Min Voice XP per Minute | Sets the minimum XP a user can gain per minute in a voice channel. | 5 | 1 | 1,000 | No |
| Max Voice XP per Minute | Sets the maximum XP a user can gain per minute in a voice channel. Must be greater than Min Voice XP. | 8 | 1 | 1,000 | No |
| Voice Cooldown | Sets the interval in minutes at which voice XP is awarded. | 2 | 1 | 60 | No |
| XP Rate | The multiplier that is set for ever user in the server. It can adjust how quickly (or slowly) users level up. | 1x | 0.25x | 3x | No |
| Prevent Consecutive Claims | Prevents the same user from claiming multiple consecutive random XP drops. Users must wait for another user to claim before claiming again. | Disabled | No | ||
| Randomize Button Placement | Randomizes the claim button position in random XP drop messages to prevent automated claiming bots. | Disabled | No |
¶ Announcement Location
Disabled- This disables ALL level up messages. (/rankand/leaderboardcommands will still work.)Current Channel- This will send the level up message in whatever channel the message that triggered the level up was sent in.Custom Channel- This will send ALL level up messages to the custom channel you have set.Private Message/DM- This will send the level up message to the user's DM. Note: Some users may have DMs blocked/disabled and may not receive the alert.
¶ Announcement Message
This is the message that is sent when a user levels up. The default message is: Congratulations {user}! You have advanced to level {level}!.
You can also use a few placeholders in this message:
{user}- The username mention of the user who leveled up.{level}- The new level that the user has advanced to.{reward}- The role that was awared to the user.- NOTE: You should only use the reward placeholder on the "Announcement Message When Role Is Awarded" section.
¶ Leaderboard Vanity URL Premium Only
This allows you to set a custom word or pharse to be used to easily access your server's leaderboard instead of the default URL that uses the server's ID.
For example, the default leaderboard URL will look something like this: https://cakey.bot/leaderboard/id/408424043482447872. This default URL can be difficult to remember.
If you set a vanity URL to something like caketropolis, you can then access your server's leaderboard via https://cakey.bot/leaderboard/caketropolis which is alot easier for users to remember.
NOTE: If you set a vanity URL, the default URL will also continue to work. (You can use both URLs to access to leaderboards). Also this setting is linked/syncronized across multiple features.
¶ Ignored Roles & Channels (NoXP Roles/Channels)
This is a list of channels or roles where XP will NOT be rewarded to users.
¶ Double XP Days
You can also specify days for Cakey Bot to award double XP on. The double XP will be calculated AFTER the XP rate has been calculated. You can select multiple days to apply double XP on.
.png)
¶ Role Rewards
You can set up to 10 different role rewards (Or up to 20 with a premium susbcription). As users level up they will receive these roles once they meet the level requirement. You can also use the "Remove Roles on Level Up" setting to have old role rewards removed when users are assigned a new role. By default, users will keep ALL of their role rewards.
Note: In order to prevent abuse, Cakey Bot will prevent selecting roles that contain
Administrator,Manage ServerorManage Rolespermissions. In addition, if these roles gain this permission after being set, the bot will no longer assign them.
¶ Role & Channel XP Multipliers
You can set up to 5 different multipliers of each type (Or up to 10 with a premium susbcription). Role and Channel multipliers are counted separately. If a user qualifies one (or more) of these multipliers, all of their received XP will be multiplied by the largest multiplier they have. Role and Channel XP multipliers will NOT stack with other multipliers of the same type if a user qualifies for multiple (Role multipliers WILL stack with a Channel multiplier though). They WILL also stack with other multipliers such as double XP days.
Note: Role/Channel XP multipliers will get added AFTER other XP multipliers (such as double XP days and global rate).
¶ XP Decaying
XP Decay reduces a user's XP over time when they are inactive, ensuring leaderboards reflect active participation. Decay begins after a set period of inactivity and is applied daily at a configurable rate. It stops once users reach a minimum XP level. Multipliers do not affect XP decay, ensuring fairness across all users.
Note: XP decay is NOT affected by multipliers.
¶ Configuration Settings
| Name | Description | Default Value |
|---|---|---|
| Decay Rate (per day) | Determines the percentage of XP lost per day once the decay process begins. This is based on the user's current XP and is applied daily. | 0.10 (10%) |
| Days Since Activity | Specifies the minimum number of days of inactivity before XP decay starts. | 7 days |
| Minimum Level | Sets the minimum XP level for decay to occur and defines the lowest level a user can decay to. XP will not drop below this threshold. | 1 |
| Decay Ignore Roles | Users with these roles will not have XP decay applied even if inactive | None |
¶ Random XP Drops
Random XP Drops introduce timed XP bonuses that occur during active event periods or seasons. These drops encourage engagement and reward users for participating during special occasions. When enabled, random XP drop events can occur across configured channels, providing users with additional XP rewards upon claiming. You can also manually spawn XP drops with /leveling spawn-xp-drop, even if the random timer system is disabled.
Note: Random XP Drops can only occur when the feature is enabled and a valid output channel is configured.
¶ Configuration Settings
| Name | Description | Default Value |
|---|---|---|
| Drops Enabled | Determines whether Season XP Drops are active. When disabled, no XP drops will occur regardless of other settings. | Off (0) |
| Output Channel | The channel where XP drop events are announced. If multiple are selected, the bot will randomly choose one for each drop. | None (0) |
| Min. XP | The minimum XP amount that can be awarded during a drop event. | 500 |
| Max. XP | The maximum XP amount that can be awarded during a drop event. | 2000 |
| Min. Time (Hours) | The minimum interval between XP drop events, measured in hours. | 2 hours |
| Max. Time (Hours) | The maximum interval between XP drop events, measured in hours. | 6 hours |
Note: If no valid channel is set, drops will not trigger. You need to have drops enabled AND atleast one output channel selected.
Behavior Overview
- XP drop events are randomly scheduled between the configured minimum and maximum hours.
- Each drop awards a random XP amount within the defined XP range.
- Drops will only occur when both the feature and output channel are set.
- Claiming a drop resets the drop timer and triggers the next event window.
- The previous drop must be claimed for a new one to spawn.
- The random images used for the drops may change throughout the year to reflect the current season or nearby holiday to help keep things refreshing/new.
Tip: Use shorter time intervals during events to increase engagement and activity.
¶ Rank Card Customization
¶ Banner Images
You can set different image banners for the /rank card. Premium servers also have access to a wider selection of image banners for their rank cards.
Our fancy image banner editor:
The recommended image size is
Width: 930xHeight: 280for custom image banners.
¶ Rank Card Badges
Users who support Cakey Bot will get badges on their profile, so you'll know they're cool.
| Badge | Name | Description |
|---|---|---|
 |
Partner | This badge is given out to our partners, some of the coolest bots across the Discord ecosystem. This by far the rarest badge with only 2 users! |
 |
Translater | This badge is given to people who make Cakey Bot available in other languages. |
 |
Cakey Bot Staff | This badge is given to developers, moderators, writers, and administrators working on Cakey Bot. |
 |
Active Tester | This badge is given to users who actively help test new Cakey Bot features and provide feedback in our tester Discord server. |
 |
Graphic Designer | This badge is awarded to talented individuals who contribute to Cakey Bot’s visual identity by designing emotes, icons, banners, or other graphical assets. Their creativity helps enhance the bot’s appearance and branding across Discord. |
 |
Custom Bot Owner | This special badge is granted to users who purchase a Custom Bot version of Cakey Bot.  |
 |
Premium User | Users who purchase the premium version of Cakey Bot get a special badge that evolves as they maintain their membership. |
¶ Premium User Badge Progression
¶ Frequently Asked Questions
¶ What XP equation is used for leveling?
Cakey Bot uses the same leveling XP equation as the popular MEE6 bot. You can use the following formula to calculate how much XP you need to level up:
5 * (lvl ^ 2) + (50 * lvl) + 100 - xp, where
lvlis your current levelxpis how much XP you already have towards the next level.
¶ Is there a cooldown or anti-abuse?
Yes, Cakey Bot has a cooldown for messages to help discourage spamming. Only one message per 60 second interval will award XP, even if multiple messages are sent during that time.
¶ How can I combat malicious users spamming for free XP?
There's several tools you can use:
/manage-leveland/manage-xpcommands allow you to manually adjust a user's XP or level to remove ill-gotten xp or levels- You can mute or timeout the user to prevent them sending messages.
- Could you configure a no-xp/ignored role on the dashbaord and assign it to them to prevent them from getting any XP while they are unmuted.
¶ Related Commands
Usage Key: <required> / [optional]
| Command | Description | Usage | Permission |
|---|---|---|---|
| /leaderboard | View the top 10 users on the leaderboard. | [limit] | None |
| /leveling manage-level | Manage a user's level. | <give | remove | set> <user> <level> | ManageServer |
| /leveling manage-xp | Manage a user's XP. | <give | remove | set> <user> <xp> | ManageServer |
| /leveling spawn-xp-drop | Manually spawn an XP drop in a channel. | [min-xp] [max-xp] [channel] | ManageServer |
| /rank | Get your rank or another user's rank. | [user] | None |
| /setup export-cakey-levels | Exports your Cakey Bot leveling and XP data. | N/A | ManageServer or Administrator |
| /setup import-levels | Imports your leveling and XP data from other bots. NOTE: EXISTING LEVEL DATA WILL BE OVERWRITTEN! | N/A | ManageServer or Administrator |
| /setup reset-levels | Reset the leveling for this server. This will RESET ALL user levels & XP! | <confirm> | ManageServer or Administrator |
| /setup reset-levels-missing | Reset the levels/xp for users who have left the server. | <confirm> | ManageServer or Administrator |