Your friendly neighborhood leveling system
Earn experience by chatting in text and voice channels, compare levels with your friends, customize your profile and view various leaderboards!
View Weekly Leaderboard
.weekly [stat=exp] [displayname=True]weekserver_onlyView Last Week's Leaderboard
.lastweeklyserver_onlyConfigure Weekly LevelUp Settings
.weeklysetADMINwsetserver_onlySet bonus exp for top weekly winners
.weeklyset bonus <bonus>Set day for weekly stats reset
0 = Monday
1 = Tuesday
2 = Wednesday
3 = Thursday
4 = Friday
5 = Saturday
6 = Sunday
.weeklyset day <day>Toggle weekly stat tracking
.weeklyset toggleRemove role from previous winner when new one is announced
.weeklyset autoremoveToggle auto reset of weekly stats
.weeklyset autoresetToggle whether all winners get the role
.weeklyset roleallSet number of winners to display
Due to Discord limitations with max embed field count, the maximum number of winners is 25
.weeklyset winners <count>Set role to award top weekly winners
.weeklyset role <role>Toggle whether to ping winners in announcement
.weeklyset pingSet hour for weekly stats reset
.weeklyset hour <hour>Reset the weekly leaderboard manually and announce winners
.weeklyset reset <yes_or_no>Set channel to announce weekly winners
.weeklyset channel <channel>View the current weekly settings
.weeklyset viewView the LevelUp leaderboard
Arguments
stat - The stat to view the leaderboard for, defaults to exp but can be any of the following:
xp - Experiencelevel - Levelvoice - Voicetimemessages - Messagesstars - Starsglobalstats - View the global leaderboard instead of the server leaderboarddisplayname - Use display names instead of usernames.leveltop [stat=xp] [globalstats=False] [displayname=True]/leveltop [stat=xp] [globalstats=False] [displayname=True]lvltop, topstats, membertop, and topranksserver_onlyView the leaderboard for roles
.roletopserver_onlyView a user's profile by ID
Useful if user has left the server
.profiledata <user_id>MODserver_onlyView User Profile
.profile [user]/profile [user]pf3 per 10.0 secondsserver_onlyToggles level up notifications for a user
.lvlupnotify/lvlupnotifynotifyserver_onlyPrestige your rank!
Once you have reached this servers prestige level requirement, you can
reset your level and experience to gain a prestige level and any perks associated with it
If you are over level and xp when you prestige, your xp and levels will carry over
.prestige/prestigeserver_onlyCustomize your profile
.setprofile/setprofilemyprofile, mypf, and pfsetserver_onlyView the all available backgrounds
.setprofile backgrounds/setprofile backgrounds1 per 5.0 secondsSet a color for your username
For a specific color, try Google's hex color picker
Set to default to randomize the color each time your profile is generated
.setprofile namecolor <color>/setprofile namecolor <color>nameSet a color for your level bar
For a specific color, try Google's hex color picker
Set to default to randomize the color each time your profile is generated
.setprofile barcolor <color>/setprofile barcolor <color>levelbar, lvlbar, and barSet a font for your profile
To view available fonts, type .myprofile fonts
To revert to the default font, use default for the font_name argument
.setprofile font <font_name>/setprofile font <font_name>View your profile settings
.setprofile view/setprofile viewRemove a default background from the cog's backgrounds folder
.setprofile rembackground <filename>/setprofile rembackground <filename>BOT_OWNERView the available fonts you can use
.setprofile fonts/setprofile fonts1 per 5.0 secondsAdd a custom background to the cog from discord
Arguments
preferred_filename - If a name is given, it will be saved as this name instead of the filename
DISCLAIMER
.setprofile addbackground [preferred_filename=None]/setprofile addbackground [preferred_filename=None]BOT_OWNERAdd a custom font to the cog from discord
Arguments
preferred_filename - If a name is given, it will be saved as this name instead of the filename
Note: do not include the file extension in the preferred name, it will be added automatically
.setprofile addfont [preferred_filename=None]/setprofile addfont [preferred_filename=None]BOT_OWNERSet a color for your server stats
For a specific color, try Google's hex color picker
Set to default to randomize the color each time your profile is generated
.setprofile statcolor <color>/setprofile statcolor <color>statToggle whether your nickname or username is shown in your profile
.setprofile shownick/setprofile shownickSet a background for your profile
This will override your profile banner as the background
WARNING
The default profile style is wide (1050 by 450 pixels) with an aspect ratio of 21:9.
Portrait images will be cropped.
Tip: Googling "dual monitor backgrounds" gives good results for the right images
Here are some good places to look.
dualmonitorbackgrounds
setaswall
pexels
teahub
Additional Options
url blank or specify default to reset back to using your profile banner (or random if you don't have one)random will randomly select from a pool of default backgrounds each timefilename run .mypf backgrounds to view default options you can use by including their filename.setprofile background [url=None]/setprofile background [url=None]bgToggle a slight blur effect on the background image where the text is displayed.
.setprofile blur/setprofile blurGet folder paths for this cog's fonts
.setprofile fontpath/setprofile fontpathBOT_OWNERRemove a default font from the cog's fonts folder
.setprofile remfont <filename>/setprofile remfont <filename>BOT_OWNERSet your profile image style
default is the default profile style, very customizablerunescape is a runescape style profile, less customizable but more nostalgic.setprofile style <style>/setprofile style <style>Get the folder paths for this cog's backgrounds
.setprofile bgpath/setprofile bgpathBOT_OWNERReward a good noodle
.stars [user]/stars [user]givestar, addstar, and thanksserver_onlyView the Star Leaderboard
.startop [globalstats=False] [displayname=True]topstars, starleaderboard, and starlbserver_onlyConfigure LevelUp Star Settings
.starsetADMINserver_onlyToggle star reaction mentions
.starset mentionSet the star cooldown
.starset cooldown <cooldown>View Star Settings
.starset viewToggle whether the bot auto-deletes the star mentions
Set to 0 to disable auto-delete
.starset mentiondelete <delete_after>Owner Only LevelUp Settings
.levelownerBOT_OWNERlvlownerserver_onlySet the external API URL for image generation
Set to an none to disable the external API
Notes
.levelowner externalapi <url>Toggle ignoring bots for XP and profiles
USE AT YOUR OWN RISK
Allowing your bot to listen to other bots is a BAD IDEA and should NEVER be enabled on public bots.
.levelowner ignorebotsToggle rendering of GIFs for animated profiles
.levelowner rendergifsrendergif and gifAdd/Remove a server from the ignore list
.levelowner ignore <server_id>Toggle purging of config data for servers the bot is no longer in
.levelowner autocleanSet the cache time for user profiles
.levelowner cache <seconds>Toggle enforcing profile embeds
If enabled, profiles will only use embeds on all servers.
This disables image generation globally.
.levelowner forceembedsforceembedView Global LevelUp Settings
.levelowner viewEnable internal API for parallel image generation
Setting a port will spin up a detatched but cog-managed FastAPI server to handle image generation.
The process ID will be attached to the bot object and persist through reloads.
USE AT YOUR OWN RISK!!!
Using the internal API will spin up multiple subprocesses to handle bulk image generation.
If your bot crashes, the API subprocess will not be killed and will need to be manually terminated!
It is HIGHLY reccommended to host the api separately!
Set to 0 to disable the internal API
Notes
.levelowner internalapi <port>Admin Only Data Commands
.leveldataADMINlvldata and ldataserver_onlyReset user data for all servers
.leveldata resetglobalBOT_OWNERBackup this server's data
.leveldata backupRestore this server's data
.leveldata restoreRestore the cog's data
.leveldata restorecogBOT_OWNERImport levels and exp from MEE6
Arguments
➣ import_by - Import by level or exp
• If level, it will import their level and calculate exp from that.
• If exp, it will import their exp directly and calculate level from that.
➣ replace - Replace existing data (True/False)
➣ include_settings - Include MEE6 settings (True/False)
➣ all_users - Import all users regardless of if they're in the server (True/False)
.leveldata importmee6 <import_by> <replace> <include_settings> <all_users>GUILD_OWNERImport levels and exp from Polaris
Make sure your server's leaderboard is public!
Arguments
➣ replace - Replace existing data (True/False)
➣ include_settings - Include Polaris settings (True/False)
➣ all_users - Import all users regardless of if they're in the server (True/False)
.leveldata importpolaris <replace> <include_settings> <all_users>GUILD_OWNERCleanup the database
Performs the following actions:
.leveldata cleanupImport levels and exp from AmariBot
Arguments
➣ import_by - Import by level or exp
• If level, it will import their level and calculate exp from that.
• If exp, it will import their exp directly and calculate level from that.
➣ replace - Replace existing data (True/False)
• If True, it will replace existing data.
➣ api_key - Your AmariBot API key
➣ all_users - Import all users regardless of if they're in the server (True/False)
.leveldata importamari <import_by> <replace> <api_key> <all_users>GUILD_OWNERImport levels and exp from Malarne's Leveler cog
Arguments
➣ import_by - Import by level or exp
• If level, it will import their level and calculate exp from that.
• If exp, it will import their exp directly and calculate level from that.
➣ replace - Replace existing data (True/False)
• If True, it will replace existing data.
➣ all_users - Import all users regardless of if they're in the server (True/False)
.leveldata importmalarne <import_by> <replace> <all_users>BOT_OWNERReset the ENTIRE cog's data
.leveldata resetcogBOT_OWNERReset all user data in this server
.leveldata resetBackup the cog's data
.leveldata backupcogBOT_OWNERImport data from Fixator's Leveler cog
This will overwrite existing LevelUp level data and stars
It will also import XP range level roles, and ignored channels
Obviously you will need MongoDB running while you run this command
.leveldata importfixatorBOT_OWNERConfigure LevelUp Settings
.levelsetADMINlvlset and lsetserver_onlyToggle the LevelUp system
.levelset toggleVoice settings
.levelset voiceAdd a range of bonus XP to users who are Discord streaming
This bonus applies to voice time xp
Set both min and max to 0 to remove the bonus
.levelset voice streambonus <min_xp> <max_xp>Set voice XP gain
Sets the amount of XP gained per minute in a voice channel (default is 2)
.levelset voice xp <voice_xp>Ignore deafened voice users
Toggle whether deafened users in a voice channel can gain voice XP
.levelset voice deafenedAdd a range of bonus XP to apply to certain channels
This bonus applies to voice time xp per minute.
Example: 2 minutes in a channel with a 1-2 bonus will give 2-4 XP
Set both min and max to 0 to remove the channel bonus.
.levelset voice channelbonus <channel> <min_xp> <max_xp>Ignore muted voice users
Toggle whether self-muted users in a voice channel can gain voice XP
.levelset voice mutedAdd a range of bonus XP to users running a specific application/game in voice channels
This bonus applies to voice time xp
Set both min and max to 0 to remove the application bonus
Examples:
• .levelset voice appbonus VALORANT 5 10 - Users playing VALORANT get 5-10 bonus XP per minute
• .levelset voice appbonus "Visual Studio Code" 2 4 - Use quotes for names with spaces
• .levelset voice appbonus VALORANT 0 0 - Remove the bonus for VALORANT
.levelset voice appbonus <application_name> <min_xp> <max_xp>Ignore invisible voice users
Toggle whether invisible users in a voice channel can gain voice XP
.levelset voice invisibleAdd a range of bonus XP to apply to certain roles
This bonus applies to voice time xp
Set both min and max to 0 to remove the role bonus
.levelset voice rolebonus <role> <min_xp> <max_xp>Ignore solo voice users
Toggle whether solo users in a voice channel can gain voice XP
.levelset voice soloSend levelup message in the channel the user is typing in
Send a message in the channel a user is typing in when they level up
.levelset levelnotifyToggle whether the bot auto-deletes the star mentions
Set to 0 to disable auto-delete
.levelset starmentiondelete <deleted_after>Set the default background for all users in the server
This background will be used when a user hasn't set their own background.
You can specify:
If no background is specified, shows the current default background.
.levelset defaultbackground [background]Remove XP from a user or role
.levelset removexp <user_or_role> <xp>Toggle DM notifications
Determines whether LevelUp messages are DM'd to the user
.levelset dmToggle using embeds or generated pics
.levelset embedsPrestige settings
.levelset prestigeKeep level roles after prestiging
.levelset prestige keeprolesRemove a prestige level
.levelset prestige remove <prestige>rem and delAdd a role to a prestige level
.levelset prestige add <prestige> <role> <emoji>bot_has_server_permissionsToggle stacking roles on prestige
If using dmrole or msgrole
• {role}: The role the user just recieved
.levelset levelupmessageslvlalerts, levelalerts, lvlmessages, and lvlmsgSet the message sent when a user levels up and recieves a role.
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
• {role}: The role the user just recieved
.levelset levelupmessages msgrole [message]Set the message sent when a user levels up.
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
.levelset levelupmessages msg [message]Set the DM a user gets when they level up and recieve a role.
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
• {role}: The role the user just recieved
.levelset levelupmessages dmrole [message]Set the DM a user gets when they level up (Without recieving a role).
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
.levelset levelupmessages dm [message]View the current level up alert messages
.levelset levelupmessages viewManage level requirement for commands
Add a level requirement to the command
.levelset lvlreq add <level> <command>Remove a level requirement for a command
.levelset lvlreq del <command>List all commands and their level requirements
.levelset lvlreq listManage per level command cooldowns
Add a cooldown for a command based on level
Multiple cooldown levels can be set, the cooldown will be applied to members at the specified level and under
Warning: This will override any default cooldowns for the command
Example:
.lset cooldowns add 5 15 mycommand
.lset cooldowns add 10 5 mycommand
Members who are level [0, 5] will have a cooldown of 15 seconds for mycommand (including members at level 5)
Members who are level (5, 10] will have a cooldown of 5 seconds (level 6 to level 10)
Members above level 10 will have no cooldown
.levelset cooldowns add <level> <cooldown> <command>Remove a level cooldown for a command
.levelset cooldowns del <level> <command>List all commands and their cooldowns per level
.levelset cooldowns listView all LevelUP settings
.levelset viewAdd XP to a user or role
.levelset addxp <user_or_role> <xp>Set a user's level
Use the command with a role already in the ignore list to remove it
.levelset ignore role <role>Add/Remove a channel in the ignore list
Channels in the ignore list don't gain XP
Use the command with a channel already in the ignore list to remove it
.levelset ignore channel <channel>Add/Remove a user in the ignore list
Members in the ignore list don't gain XP
Use the command with a user already in the ignore list to remove them
.levelset ignore user <user>Test the level algorithm
View the first 20 levels using the current algorithm to test experience curve
.levelset seelevelsSet the star cooldown
Users can give another user a star every X seconds
.levelset starcooldown <seconds>Reset the emojis to default
.levelset resetemojisSet a user to a specific prestige level
Prestige roles will need to be manually added/removed when using this command
.levelset setprestige <user> <prestige>Message settings
.levelset messagesmessage and msgSet minimum message length for XP
Minimum length a message must be to count towards XP gained
Set to 0 to disable
.levelset messages length <length>Set message XP range
Set the Min and Max amount of XP that a message can gain
Default is 3 min and 6 max
.levelset messages xp <min_xp> <max_xp>Add a range of bonus XP to apply to certain channels
This bonus applies to message xp
Set both min and max to 0 to remove the channel bonus
.levelset messages channelbonus <channel> <min_xp> <max_xp>Add a range of bonus XP to apply to certain roles
This bonus applies to message xp
Set both min and max to 0 to remove the role bonus
.levelset messages rolebonus <role> <min_xp> <max_xp>Add a range of bonus XP to users running a specific application/game
This bonus applies to message xp
Set both min and max to 0 to remove the application bonus
Examples:
• .levelset messages appbonus VALORANT 5 10 - Users playing VALORANT get 5-10 bonus XP per message
• .levelset messages appbonus "Visual Studio Code" 2 4 - Use quotes for names with spaces
• .levelset messages appbonus VALORANT 0 0 - Remove the bonus for VALORANT
.levelset messages appbonus <application_name> <min_xp> <max_xp>Cooldown threshold for message XP
When a user sends a message they will have to wait X seconds before their message
counts as XP gained
.levelset messages cooldown <cooldown>Add or remove a role to the role group
These roles gain their own experience points as a group
When a member gains xp while having this role, the xp they earn is also added to the role group
.levelset rolegroup <role>Send levelup message in the channel the user is typing in
Send a message in the channel a user is typing in when they level up
.levelset levelnotifyToggle whether users can gain Exp from running commands
.levelset commandxpBase command for all allowed lists
.levelset allowedAdd/Remove a role in the allowed list
If the allow list is not empty, only roles in the list will gain XP
Use the command with a role already in the allowed list to remove it
.levelset allowed role <role>Add/Remove a channel in the allowed list
If the allow list is not empty, only channels in the list will gain XP
Use the command with a channel already in the allowed list to remove it
.levelset allowed channel <channel>Toggle DM notifications
Determines whether LevelUp messages are DM'd to the user
.levelset dmToggle star reaction mentions
Toggle whether the bot mentions that a user reacted to a message with a star
.levelset starmentionTest the level algorithm
View the first 20 levels using the current algorithm to test experience curve
.levelset seelevelsBase command for all ignore lists
.levelset ignoreAdd/Remove a channel in the ignore list
Channels in the ignore list don't gain XP
Use the command with a channel already in the ignore list to remove it
.levelset ignore channel <channel>Add/Remove a channel in the notify ignore list
Channels in the notify ignore list will have level up notifications suppressed
Use the command with a channel already in the notify ignore list to remove it
.levelset ignore notify <channel>Add/Remove a role in the ignore list
Members with roles in the ignore list don't gain XP
Use the command with a role already in the ignore list to remove it
.levelset ignore role <role>Add/Remove a user in the ignore list
Members in the ignore list don't gain XP
This command is for if you added level roles after users have achieved that level,
it will apply all necessary roles to a user according to their level and prestige
.levelset roles initializeinit1 per 240.0 secondsAutomatic removal of previous level roles
.levelset roles autoremoveUnassign a role from a level
.levelset roles remove <level>rem and delAssign a role to a level
.levelset roles add <level> <role>Customize the leveling algorithm for your server
• Default base is 100
• Default exp is 2
Equation
➣ Getting required XP for a level
• base * (level ^ exp) = XP
➣ Getting required level for an XP value
• level = (XP / base) ^ (1 / exp)
Arguments
➣ part - The part of the algorithm to change
➣ value - The value to set it to
.levelset algorithm <part> <value>algoAdd or remove a role to the role group
These roles gain their own experience points as a group
When a member gains xp while having this role, the xp they earn is also added to the role group
.levelset rolegroup <role>Force a profile style for all users
Specify none to disable the forced style
.levelset forcestyle <style>Set LevelUp log channel
Set a channel for all level up messages to send to.
If level notify is off and mention is on, the bot will mention the user in the channel
.levelset levelchannel [channel=None]Toggle whether to mention the user in the level up message
If level notify is on AND a log channel is set, the user will only be mentioned in the channel they are in.
.levelset mentionToggle star reaction mentions
Toggle whether the bot mentions that a user reacted to a message with a star
.levelset starmentionPresence status bonus settings
.levelset presencebonusstatusbonusAdd a range of bonus XP to users with a specific presence status
This bonus applies to voice time XP
Set both min and max to 0 to remove the status bonus
Examples:
• .levelset presencebonus voice online 2 5 - Users with online status get 2-5 bonus XP per minute in voice
• .levelset presencebonus voice idle 1 3 - Users with idle status get 1-3 bonus XP per minute in voice
• .levelset presencebonus voice dnd 0 0 - Remove the bonus for dnd status
.levelset presencebonus voice <status> <min_xp> <max_xp>View all presence status bonuses
.levelset presencebonus viewAdd a range of bonus XP to users with a specific presence status
This bonus applies to message XP
Set both min and max to 0 to remove the status bonus
Examples:
• .levelset presencebonus message online 2 5 - Users with online status get 2-5 bonus XP per message
• .levelset presencebonus message idle 1 3 - Users with idle status get 1-3 bonus XP per message
• .levelset presencebonus message dnd 0 0 - Remove the bonus for dnd status
.levelset presencebonus message <status> <min_xp> <max_xp>msgView all LevelUP settings
.levelset viewAdd XP to a user or role
.levelset addxp <user_or_role> <xp>Set the emojis used to represent each stat type
.levelset emojis <level> <prestige> <star> <chat> <voicetime> <experience> <balance>Set a user's level
Arguments
• user - The user to set the level for
• level - The level to set the user to
.levelset setlevel <user> <level>Base command for all allowed lists
.levelset allowedAdd/Remove a channel in the allowed list
If the allow list is not empty, only channels in the list will gain XP
Use the command with a channel already in the allowed list to remove it
.levelset allowed channel <channel>Add/Remove a role in the allowed list
If the allow list is not empty, only roles in the list will gain XP
Use the command with a role already in the allowed list to remove it
.levelset allowed role <role>Toggle whether users can gain Exp from running commands
.levelset commandxpLevel up alert messages
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
If using dmrole or msgrole
• {role}: The role the user just recieved
.levelset levelupmessageslvlalerts, levelalerts, lvlmessages, and lvlmsgSet the DM a user gets when they level up (Without recieving a role).
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
.levelset levelupmessages dm [message]Set the message sent when a user levels up.
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
.levelset levelupmessages msg [message]Set the message sent when a user levels up and recieves a role.
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
• {role}: The role the user just recieved
.levelset levelupmessages msgrole [message]Set the DM a user gets when they level up and recieve a role.
Arguments
The following placeholders can be used:
• {username}: The user's name
• {mention}: Mentions the user
• {displayname}: The user's display name
• {level}: The level the user just reached
• {server}: The server the user is in
• {role}: The role the user just recieved
.levelset levelupmessages dmrole [message]View the current level up alert messages
.levelset levelupmessages viewToggle whether to show user's economy credit balance in their profile
.levelset showbalanceshowbal