Leveling System
XP-based leveling with message, voice, and reaction XP sources, role rewards, boosters, and customizable level-up notifications
Overview
The leveling system rewards members with XP for chatting, being in voice channels, and receiving reactions. Navigate to Left sidebar > Levels on your server dashboard to configure all settings. XP accumulates toward levels, and you can assign role rewards at specific level milestones. The system supports three XP sources (message, voice, reaction), customizable formulas, booster multipliers, and configurable level-up notifications.
Enabling the Module
Toggle the enabled switch at the top of the Levels settings page to activate the module.
xpEnabled (toggle, default on): Master switch for XP gain. When disabled, the leveling UI still works (leaderboard, rank cards) but no new XP is earned. This is useful for temporarily pausing XP gain without losing existing progress.
resetOnLeave (toggle, default off): When enabled, a member's XP and level are reset to zero if they leave the server. When disabled, their progress is preserved if they rejoin.
xpEnabled (toggle, default on): Master switch for XP gain. When disabled, the leveling UI still works (leaderboard, rank cards) but no new XP is earned. This is useful for temporarily pausing XP gain without losing existing progress.
resetOnLeave (toggle, default off): When enabled, a member's XP and level are reset to zero if they leave the server. When disabled, their progress is preserved if they rejoin.
XP Formula
Control how much XP is needed to reach each level:
formula mode (select, default 'default'): The mathematical formula used to calculate XP thresholds for each level.
formula base (number input, default 100): The base XP required for level 1. Higher values mean slower progression.
formula multiplier (number input, default 1): A scaling factor applied to the formula. Values above 1 increase XP requirements per level, making progression slower. Values below 1 make it faster.
formula mode (select, default 'default'): The mathematical formula used to calculate XP thresholds for each level.
formula base (number input, default 100): The base XP required for level 1. Higher values mean slower progression.
formula multiplier (number input, default 1): A scaling factor applied to the formula. Values above 1 increase XP requirements per level, making progression slower. Values below 1 make it faster.
Message XP
XP earned from sending messages in text channels:
messageXp enabled (toggle, default on): Turn message XP on or off.
messageXp mode (select, default 'random'): How XP amounts are determined. random gives a random amount between min and max for each message.
messageXp min (number input, default 15): The minimum XP earned per message.
messageXp max (number input, default 25): The maximum XP earned per message.
messageXp cooldown (number input, default 5 seconds): The minimum time between XP-earning messages. Messages sent within the cooldown window do not earn XP. This prevents spam-farming.
messageXp enabled (toggle, default on): Turn message XP on or off.
messageXp mode (select, default 'random'): How XP amounts are determined. random gives a random amount between min and max for each message.
messageXp min (number input, default 15): The minimum XP earned per message.
messageXp max (number input, default 25): The maximum XP earned per message.
messageXp cooldown (number input, default 5 seconds): The minimum time between XP-earning messages. Messages sent within the cooldown window do not earn XP. This prevents spam-farming.
Voice XP
XP earned from spending time in voice channels:
voiceXp enabled (toggle, default off): Turn voice XP on or off.
voiceXp min (number input, default 10): The minimum XP earned per voice XP tick.
voiceXp max (number input, default 20): The maximum XP earned per tick.
voiceXp cooldown (number input, default 300 seconds): The interval between voice XP ticks. At the default of 300 seconds, members earn voice XP every 5 minutes.
voiceXp minMembers (number input, default 2): The minimum number of members that must be in the voice channel for XP to be awarded. Prevents members from farming XP alone in empty channels.
voiceXp antiDeaf (toggle, default off): When enabled, members who are server-deafened or self-deafened do not earn voice XP.
voiceXp enabled (toggle, default off): Turn voice XP on or off.
voiceXp min (number input, default 10): The minimum XP earned per voice XP tick.
voiceXp max (number input, default 20): The maximum XP earned per tick.
voiceXp cooldown (number input, default 300 seconds): The interval between voice XP ticks. At the default of 300 seconds, members earn voice XP every 5 minutes.
voiceXp minMembers (number input, default 2): The minimum number of members that must be in the voice channel for XP to be awarded. Prevents members from farming XP alone in empty channels.
voiceXp antiDeaf (toggle, default off): When enabled, members who are server-deafened or self-deafened do not earn voice XP.
Reaction XP
XP earned when other members react to your messages:
reactionXp enabled (toggle, default off): Turn reaction XP on or off.
reactionXp amount (number input, default 5): The XP earned each time someone reacts to your message.
reactionXp cooldown (number input, default 30 seconds): The minimum time between reaction XP gains from the same user. Prevents reaction spam-farming.
reactionXp enabled (toggle, default off): Turn reaction XP on or off.
reactionXp amount (number input, default 5): The XP earned each time someone reacts to your message.
reactionXp cooldown (number input, default 30 seconds): The minimum time between reaction XP gains from the same user. Prevents reaction spam-farming.
Level-Up Notifications
Configure how members are notified when they reach a new level:
levelUpMessage (text input, default 'Congratulations {user}, you reached level {level}!'): The message sent when a member levels up. Supports {user} for mention and {level} for the new level number.
levelUpChannelId (channel picker): The channel where level-up messages are sent. Leave empty to send the notification in the same channel where the member earned the XP.
levelUpMessageType (select: message or embed, default 'message'): Choose between a plain text message or a rich embed notification.
levelUpImage (toggle): When using embed type, include a level-up image card in the notification.
levelUpMessage (text input, default 'Congratulations {user}, you reached level {level}!'): The message sent when a member levels up. Supports {user} for mention and {level} for the new level number.
levelUpChannelId (channel picker): The channel where level-up messages are sent. Leave empty to send the notification in the same channel where the member earned the XP.
levelUpMessageType (select: message or embed, default 'message'): Choose between a plain text message or a rich embed notification.
levelUpImage (toggle): When using embed type, include a level-up image card in the notification.
Role Rewards
Automatically assign roles when members reach specific levels:
rewards (list): Add role reward entries. Each entry maps a level number to a Discord role. When a member reaches that level, the role is automatically assigned.
stackRewards (toggle, default off): When enabled, members keep all previously earned reward roles as they level up. When disabled, only the highest earned reward role is kept — lower reward roles are removed when a higher one is assigned.
rewards (list): Add role reward entries. Each entry maps a level number to a Discord role. When a member reaches that level, the role is automatically assigned.
stackRewards (toggle, default off): When enabled, members keep all previously earned reward roles as they level up. When disabled, only the highest earned reward role is kept — lower reward roles are removed when a higher one is assigned.
Boosters and Multipliers
Increase XP gain for specific roles or channels:
boosters stack (toggle, default off): When enabled, multiple booster multipliers stack multiplicatively. When disabled, only the highest multiplier applies.
boosters roles (list): Add role-based boosters. Each entry assigns an XP multiplier to a specific role. Members with that role earn multiplied XP. Useful for giving premium or booster members faster progression.
boosters channels (list): Add channel-based boosters. Each entry assigns an XP multiplier to a specific channel. Messages in that channel earn multiplied XP. Useful for encouraging activity in specific channels.
boosters stack (toggle, default off): When enabled, multiple booster multipliers stack multiplicatively. When disabled, only the highest multiplier applies.
boosters roles (list): Add role-based boosters. Each entry assigns an XP multiplier to a specific role. Members with that role earn multiplied XP. Useful for giving premium or booster members faster progression.
boosters channels (list): Add channel-based boosters. Each entry assigns an XP multiplier to a specific channel. Messages in that channel earn multiplied XP. Useful for encouraging activity in specific channels.
Blacklist Settings
Exclude specific channels and roles from earning XP:
ignoredChannels (multi-channel picker): Channels where no XP is earned from messages. Useful for excluding bot command channels, spam channels, or off-topic areas.
ignoredRoles (multi-role picker): Members with any of these roles do not earn XP. Useful for excluding bots or specific member groups from the leveling system.
ignoredChannels (multi-channel picker): Channels where no XP is earned from messages. Useful for excluding bot command channels, spam channels, or off-topic areas.
ignoredRoles (multi-role picker): Members with any of these roles do not earn XP. Useful for excluding bots or specific member groups from the leveling system.
XP Events
Temporarily boost XP gain for the entire server:
xpEvent active (toggle, default off): Activate an XP event. When active, all XP gains are multiplied.
xpEvent multiplier (number input, default 2): The multiplier applied during the event. A value of 2 means double XP.
xpEvent expiresAt (date/time picker): When the event automatically ends. After this time, XP returns to normal rates.
XP events are great for special occasions, weekends, or community milestones.
xpEvent active (toggle, default off): Activate an XP event. When active, all XP gains are multiplied.
xpEvent multiplier (number input, default 2): The multiplier applied during the event. A value of 2 means double XP.
xpEvent expiresAt (date/time picker): When the event automatically ends. After this time, XP returns to normal rates.
XP events are great for special occasions, weekends, or community milestones.
Tips
Start with message XP only and add voice XP once your community has active voice usage. Set the message XP cooldown to at least 5 seconds to prevent spam-grinding. Use ignoredChannels to exclude bot command channels and meme channels from XP gain. Set up 3-5 role rewards at meaningful level milestones to keep members motivated. Use channel boosters on channels you want to encourage activity in. Run XP events during slow periods to boost engagement. Enable antiDeaf for voice XP to ensure members are actually participating in voice conversations.