Leveling

XP-based leveling system with rank cards, level rewards, voice XP, and MEE6 import.

The Leveling module tracks member activity and rewards engagement with XP and levels. Members earn XP from messages and voice activity, unlock levels, and can receive role rewards at specific milestones.

Quick Reference

Command	Description	Permission	Cooldown
`.rank`	View your or someone's rank card	Everyone	5s
`.leaderboard`	View the server leaderboard	Everyone	5s
`.levels`	Configure the leveling system	Admin	3s

User Commands

rank

View your rank card or someone else's. Shows level, XP progress, and position on the leaderboard.

.rank [user]

Aliases: level, xp Cooldown: 5 seconds

Examples:

.rank
.rank @Alex

leaderboard

View the server's XP leaderboard. Supports sorting by XP, voice time, or message count.

.leaderboard [voice|messages] [page]

Aliases: lb, top Cooldown: 5 seconds

Examples:

.leaderboard
.leaderboard voice
.leaderboard messages
.leaderboard 2
.leaderboard voice 3

Configuration

Use .levels (admin only) to configure the entire leveling system.

Enable / Disable

.levels enable
.levels disable

Level-Up Messages

.levels channel <#channel|current|off>   — Where level-up messages are sent
.levels message <text>                    — Customize the level-up message

current sends the message in the channel where the user leveled up. off disables level-up messages entirely.

XP Settings

.levels xp <min> <max>          — Set the XP range earned per message (e.g., .levels xp 15 25)
.levels cooldown <seconds>      — Set XP cooldown between messages (default: 60s)

Voice XP

.levels voice                   — Toggle voice XP on/off
.levels voicexp <amount>        — Set XP earned per minute in voice

No-XP Channels and Roles

Prevent XP gain in specific channels or for specific roles:

.levels noxp channel add <#channel>
.levels noxp channel remove <#channel>
.levels noxp role add <@role>
.levels noxp role remove <@role>

Level Rewards

Award roles when members reach specific levels:

.levels reward add <level> <@role>
.levels reward remove <level>
.levels reward list

Role Stacking

.levels stack                   — Toggle role stacking on/off

When role stacking is on, members keep all previously earned reward roles. When off, only the highest reward role is kept.

Reset

.levels reset                   — Reset all leveling data for the server

View Settings

.levels settings                — View all current leveling settings

MEE6 Import

.levels import mee6             — Import leveling data from MEE6

The MEE6 import reads from MEE6's public API. It imports each member's XP and level, preserving their progress. Make sure your MEE6 leaderboard is set to public before importing.

Full Configuration Example

Here is a complete example of setting up leveling for a server:

.levels enable
.levels channel #level-ups
.levels message Congrats {user.mention}, you reached **Level {level}**!
.levels xp 15 25
.levels cooldown 60
.levels voice
.levels voicexp 5
.levels noxp channel add #bot-commands
.levels noxp role add @Muted
.levels reward add 5 @Active
.levels reward add 10 @Regular
.levels reward add 25 @Veteran
.levels stack

How XP Works

Members earn a random amount of XP (within the configured range) each time they send a message.
There is a cooldown between XP awards to prevent spam farming.
Voice XP is earned per minute spent in voice channels (deafened members do not earn XP).
XP required per level increases as levels go up, following a standard curve.
Channels and roles on the no-XP list do not earn any XP.

Leveling

On this page