XP
Beemo’s XP system allows for members to gain experience as they participate in the server via text & voice channels.
About
Users can gain XP through both text and voice channels, with customizable curves and role rewards for levels. Servers can add roles to be rewarded at different level milestones and benefit from an integrated XP leaderboard.
If enabled alongside XP, users will also gain Honey at the same rate, which is consumable in a Honey role shop. See https://docs.beemo.gg/utility/honey for more information on the Honey shop.
Commands
| Command | Example | Usage |
|---|---|---|
| xp all [enable] | /xp all enable:false | Enables or disables the XP system. |
| xp rewards set [level] [role name/id] | /xp rewards set level:10 role:@Level 10 | Adds the specified role as an XP role reward for the level specified. |
| xp rewards remove [level] | /xp rewards remove level:10 | Removes the role reward for the level specified. |
| xp rewards list | - | Lists the current XP role rewards for the server. |
| xp reset user [user] | /xp reset user:@Beemo#4570 | Resets the specified user’s XP on the server. |
| xp reset role [role] | /xp reset role:@Beemo#4570 | Resets all the users with the role’s XP on the server. |
| xp reset user [user] | /xp reset all | Resets the xp of all the users in the server. |
| xp set [user mention/id] [new amount] | /xp set user:@Beemo#4570 amount:100 | Sets the specified user’s XP to the new XP amount. |
| xp refresh roles | - | Refreshes all of the user’s XP role rewards. Use this command after you add or remove xp role rewards from the system. |
| xp cooldown text [seconds] | /xp cooldown text seconds:10 | Sets how often 1 XP / honey can be earned through text channels, in seconds. |
| xp cooldonw voice [seconds] | /xp cooldown voice seconds:10 | Sets how often 1 XP / honey can be earned through voice channels, in seconds. |
| xp blacklist role [role name/id] | /xp blacklist role role:@Banned | Adds or removes the specified role as an XP & Honey-blacklisted role. |
| xp blacklisted roles | - | List the current XP and honey-blacklisted roles. Users with these roles cannot gain XP or honey. |
| xp blacklist channel [channel name/id] | /xp blacklist channel channel:#general | Adds or removes the specified text or voice channel as an XP and honey-blacklisted channel. |
| xp blacklisted channels | - | Lists the current XP and honey-blacklisted text and voice channels. |
| xp admin role [role name/id] | /xp admin role role:@Admin | Adds or removes the specified role as an XP and honey admin role. |
| xp admin roles | - | Lists the current XP and honey admin roles. Users with these roles can use XP and honey admin commands. |
| xp keep roles [enable] | /xp keep roles enable:true | Sets if users should keep their previous XP roles when they reach the next role reward. |
| xp reset leave [enable] | /xp reset leave enable:true | Sets if user XP / honey should be reset upon leaving the server. |
| xp reset ban [enable] | /xp reset ban enable:true | Sets if user XP / honey should be reset upon being banned from the server. |
| xp notifications enable [status] | /xp notifications enable status:false | Sets if a level up notification should be sent when a user levels up. |
| xp notifications channel [channel name/id] | /xp notifications channel channel:#notify | Sets the channel to send level up notifications to. Put none for the channel name to remove a set channel. If no channel is specified, the notice will be sent to the user’s DMs. |
| xp cooldown rankcommand [seconds] | /xp cooldown rankcommand seconds:5 | Sets the cooldown in seconds for the /rank command. |
| xp difficulty [new difficulty (decimal)] | /xp difficulty value:2.0 | Sets the difficulty of the XP system. This modifies the multiplier so that the amount of XP needed to reach the next level is either larger or smaller. IMPORTANT: This setting will change the XP curve, which will affect the current level of all users. |
| xp leveltoxpratio [new ratio (decimal)] | /xp leveltoxpratio value:1.5 | This modifies the exponent of the XP function, which changes the relationship between XP gained and level achieved. The curve is determined by the formula: XP = Difficulty * (Level)^(Level to XP Ratio) + 4. For example, a difficulty of 1.2 and a level to XP ratio of 3.1 will result in a curve of xp = 1.2 * level^3.1 + 4, which means that it requires xp xp to be acquired in order to reach level level. |