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_onlyReset the weekly leaderboard manually and announce winners
.weeklyset reset <yes_or_no>Remove role from previous winner when new one is announced
.weeklyset autoremoveSet day for weekly stats reset
0 = Monday
1 = Tuesday
2 = Wednesday
3 = Thursday
4 = Friday
5 = Saturday
6 = Sunday
.weeklyset day <day>Set number of winners to display
Due to Discord limitations with max embed field count, the maximum number of winners is 25
.weeklyset winners <count>Toggle whether all winners get the role
.weeklyset roleallToggle auto reset of weekly stats
.weeklyset autoresetSet role to award top weekly winners
.weeklyset role <role>Set hour for weekly stats reset
.weeklyset hour <hour>Set bonus exp for top weekly winners
.weeklyset bonus <bonus>Set channel to announce weekly winners
.weeklyset channel <channel>Toggle weekly stat tracking
.weeklyset toggleView the current weekly settings
.weeklyset viewToggle whether to ping winners in announcement
.weeklyset pingView the LevelUp leaderboard
.leveltop [stat=exp] [globalstats=False] [displayname=True]/leveltop [stat=exp] [globalstats=False] [displayname=True]lvltop, topstats, membertop, and topranksserver_onlyView the leaderboard for roles
.roletopserver_onlyView User Profile
.profile [user]/profile [user]pf3 per 10.0 secondsserver_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_onlyToggle whether your nickname or username is shown in your profile
.setprofile shownick/setprofile shownickRemove a default background from the cog's backgrounds folder
.setprofile rembackground <filename>/setprofile rembackground <filename>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 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 barGet the folder paths for this cog's backgrounds
.setprofile bgpath/setprofile bgpathBOT_OWNERView the all available backgrounds
.setprofile backgrounds/setprofile backgrounds1 per 5.0 secondsSet 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>Set 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>statView your profile settings
.setprofile view/setprofile viewRemove a default font from the cog's fonts folder
.setprofile remfont <filename>/setprofile remfont <filename>BOT_OWNERAdd 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_OWNERSet 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>Get folder paths for this cog's fonts
.setprofile fontpath/setprofile fontpathBOT_OWNERToggle a slight blur effect on the background image where the text is displayed.
.setprofile blur/setprofile blurSet 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]bgView the available fonts you can use
.setprofile fonts/setprofile fonts1 per 5.0 secondsReward 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_onlySet the star cooldown
.starset cooldown <cooldown>Toggle star reaction mentions
.starset mentionToggle whether the bot auto-deletes the star mentions
Set to 0 to disable auto-delete
.starset mentiondelete <delete_after>View Star Settings
.starset viewOwner Only LevelUp Settings
.levelownerBOT_OWNERlvlownerserver_onlySet the maximum number of backups to keep
.levelowner maxbackups <backups>Add/Remove a server from the ignore list
.levelowner ignore <server_id>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 gifSet the external API URL for image generation
Set to an none to disable the external API
Notes
.levelowner externalapi <url>Set the cache time for user profiles
.levelowner cache <seconds>Enable 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>Toggle purging of config data for servers the bot is no longer in
.levelowner autocleanToggle enforcing profile embeds
If enabled, profiles will only use embeds on all servers.
This disables image generation globally.
.levelowner forceembedsforceembedSet the interval for backups
.levelowner backupinterval <interval>View Global LevelUp Settings
.levelowner viewAdmin Only Data Commands
.leveldataADMINlvldata and ldataserver_onlyReset user data for all servers
.leveldata resetglobalBOT_OWNERRestore the cog's data
.leveldata restorecogBOT_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_OWNERBackup this server's data
.leveldata backupCleanup the database
Performs the following actions:
.leveldata cleanupReset all user data in this server
.leveldata resetBackup the cog's data
.leveldata backupcogBOT_OWNERRestore this server's data
.leveldata restoreImport 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_OWNERImport 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_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_OWNERReset the ENTIRE cog's data
.leveldata resetcogBOT_OWNERConfigure LevelUp Settings
.levelsetADMINlvlset and lsetserver_onlyAdd XP to a user or role
.levelset addxp <user_or_role> <xp>Voice settings
.levelset voiceIgnore muted voice users
Toggle whether self-muted users in a voice channel can gain voice XP
.levelset voice mutedIgnore invisible voice users
Toggle whether invisible users in a voice channel can gain voice XP
.levelset voice invisibleSet voice XP gain
Sets the amount of XP gained per minute in a voice channel (default is 2)
.levelset voice xp <voice_xp>Add 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>Add a range of bonus XP to apply to certain channels
This bonus applies to voice time xp
Set both min and max to 0 to remove the role bonus
.levelset voice channelbonus <channel> <min_xp> <max_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 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>Ignore solo voice users
Toggle whether solo users in a voice channel can gain voice XP
.levelset voice soloLevel 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 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 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]View the current level up alert messages
.levelset levelupmessages viewLevel role assignment
.levelset rolesUnassign a role from a level
.levelset roles remove <level>rem and delInitialize level roles
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 autoremoveAssign a role to a level
.levelset roles add <level> <role>Remove XP from a user or role
.levelset removexp <user_or_role> <xp>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]Reset the emojis to default
.levelset resetemojisToggle whether the bot auto-deletes the star mentions
Set to 0 to disable auto-delete
.levelset starmentiondelete <deleted_after>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>algoSet a user to a specific prestige level
Prestige roles will need to be manually added/removed when using this command
.levelset setprestige <user> <prestige>Toggle the LevelUp system
.levelset toggleForce a profile style for all users
Specify none to disable the forced style
.levelset forcestyle <style>Toggle star reaction mentions
Toggle whether the bot mentions that a user reacted to a message with a star
.levelset starmentionSet the emojis used to represent each stat type
.levelset emojis <level> <prestige> <star> <chat> <voicetime> <experience> <balance>Toggle DM notifications
Determines whether LevelUp messages are DM'd to the user
.levelset dmBase command for all ignore lists
.levelset ignoreAdd/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
Use the command with a user already in the ignore list to remove them
.levelset ignore user <user>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>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 to show user's economy credit balance in their profile
.levelset showbalanceshowbalToggle 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 mentionBase 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>Message settings
.levelset messagesmessage and msgAdd 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 role bonus
.levelset messages channelbonus <channel> <min_xp> <max_xp>Set 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 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>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>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>Prestige settings
.levelset prestigeRemove a prestige level
.levelset prestige remove <prestige>rem and delSet the level required to prestige
.levelset prestige level <level>Toggle stacking roles on prestige
For example each time you prestige, you keep the previous prestige roles
.levelset prestige stackAdd a role to a prestige level
.levelset prestige add <prestige> <role> <emoji>bot_has_server_permissionsKeep level roles after prestiging
.levelset prestige keeprolesAdd 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>Toggle whether users can gain Exp from running commands
.levelset commandxpView all LevelUP settings
.levelset viewTest the level algorithm
View the first 20 levels using the current algorithm to test experience curve
.levelset seelevelsToggle using embeds or generated pics
.levelset embedsSet the star cooldown
Users can give another user a star every X seconds
.levelset starcooldown <seconds>