Leveling Commands¶
The leveling system uses /xp for user commands and /levels for admin management.
User Commands — /xp¶
/xp level [user]¶
View level and XP progress.
| Parameter | Type | Required | Description |
|---|---|---|---|
user |
Member | No | User to check (defaults to yourself) |
Shows current level, total XP, message count, and a progress bar to next level.
/xp rank [user]¶
Generate a visual rank card image.
| Parameter | Type | Required | Description |
|---|---|---|---|
user |
Member | No | User to check (defaults to yourself) |
Produces a rendered image showing:
- Server rank position (e.g. #5 / 250)
- Level and total XP
- XP progress bar
- Message count
- Custom background (if set)
Falls back to a text embed if image generation fails.
/xp xpleaderboard [page]¶
Paginated XP leaderboard with 10 users per page.
| Parameter | Type | Required | Description |
|---|---|---|---|
page |
Integer | No | Page number (default: 1) |
/xp top [count]¶
Quick top-N leaderboard display.
| Parameter | Type | Required | Description |
|---|---|---|---|
count |
Integer | No | Users to show, 1-25 (default: 10) |
Shows rank medals (🥇 🥈 🥉), level, and XP.
/xp setcard [url] [image] [opacity]¶
Customise your rank card background.
| Parameter | Type | Required | Description |
|---|---|---|---|
url |
String | No | HTTPS image URL |
image |
Attachment | No | Direct image upload (preferred) |
opacity |
Integer | No | Overlay darkness, 0-100 (default: 60) |
/xp removecard¶
Remove your custom background and revert to the server default.
Admin Commands — /levels¶
Permission
Requires Manage Server permission or an explicit leveling permission override.
/levels setxp <user> <amount> [reason]¶
Set a user's XP to an exact amount. Level is recalculated automatically.
| Parameter | Type | Required | Description |
|---|---|---|---|
user |
Member | Yes | Target user |
amount |
Integer | Yes | New XP total (≥ 0) |
reason |
String | No | Audit log reason |
/levels addxp <user> <amount> [reason]¶
Add bonus XP to a user.
| Parameter | Type | Required | Description |
|---|---|---|---|
user |
Member | Yes | Target user |
amount |
Integer | Yes | XP delta to apply (positive adds, negative removes) |
reason |
String | No | Audit log reason |
Advanced Leveling Settings¶
Advanced leveling configuration is not exposed through additional /levels ... slash commands in the current build.
Use the Dashboard/API configuration pages for:
- XP min/max and cooldown
- XP/voice rate settings
- Ignore lists and bonus role multipliers
- Level-up message/channel/DM settings
- Reward role mappings and default XP card options