Leveling
The leveling system rewards active members with XP as they chat. Members level up over time and can earn role rewards, compete on leaderboards, and show off customized rank cards.
Commands
| Command | Description | Usage |
|---|---|---|
/rank | View your rank card or another member's | /rank [@user] |
/leaderboard | View the server's XP leaderboard | /leaderboard |
/setxp | Manually set a member's XP (admin) | /setxp @user <amount> |
/setlevel | Manually set a member's level (admin) | /setlevel @user <level> |
/reset | Reset a member's XP and level (admin) | /reset @user |
Dashboard Configuration
Configure the leveling system from the Leveling section of the dashboard.
General Settings
| Setting | Description |
|---|---|
| XP Rate | The base amount of XP awarded per message (and the randomization range) |
| Level-Up Channel | Where level-up announcements are posted (current channel, specific channel, DM, or disabled) |
Role Rewards
Assign roles automatically when members reach specific levels. You can configure as many role rewards as you need.
Example:
| Level | Role |
|---|---|
| 5 | Active Member |
| 10 | Regular |
| 25 | Veteran |
| 50 | Legend |
Role rewards stack by default. A member who reaches level 10 keeps all roles earned at previous levels unless you configure them to be replaced.
Rank Card Customization
Members can personalize their /rank card through the dashboard or commands. Customization options include:
- Background image or color
- Accent color
- Progress bar style
XP Multipliers
Assign XP multipliers to specific roles so that certain members earn XP at a boosted rate. This is useful for rewarding server boosters or premium members.
Features
Ignored Channels and Roles
You can exclude specific channels or roles from earning XP. Messages sent in ignored channels or by members with ignored roles will not grant any experience.
This is useful for bot command channels, spam channels, or roles that should not participate in the leveling system.
How XP Works
- Members earn XP for each message they send (with a short cooldown to prevent spam).
- The amount of XP per message is determined by the XP Rate setting plus a small random bonus.
- The XP required for each level increases progressively.
- Level-up notifications are sent according to your Level-Up Channel setting.
Resetting a member's XP with /reset is permanent and cannot be undone. Use this command with caution.