Leveling & Rank Cards
Configure XP rates, level-up messages, role rewards, per-role/channel multipliers, voice XP, and rank card styling.
On this page
Overview
Members earn XP from sending messages, with a configurable range and cooldown to prevent spam-farming. The dashboard lets you tune the XP curve, level-up announcement mode, role rewards, and per-channel or per-role XP multipliers.
Rank cards are rendered images, not plain embeds. Members personalize their background, gradient, accent color, and avatar border shape with /rankcard set, and can preview changes live before saving. Java Lava Pro servers unlock a higher saved-style limit (15 vs. Free’s 3).
Beyond the base XP system, Leveling also supports optional voice-channel XP, a weekly/monthly/all-time leaderboard window, gradual XP decay for inactive members, and custom rank-title tiers shown next to a member's level.
Setup
- 1
Enable Leveling
Toggle the module on from Overview or the Leveling page.
- 2
Tune the XP curve
Set the XP range awarded per eligible message and the cooldown between XP-earning messages.
- 3
Set level-up announcements
Choose whether level-ups announce in the current channel, a dedicated channel, via DM, or not at all, and customize the announcement message text.
- 4
Add role rewards and multipliers
Grant roles automatically at specific levels, and set XP multipliers for specific channels or roles (e.g. 2x XP for boosters).
- 5
Exclude channels and roles from XP
Mark bot-command channels as no-XP zones, and exclude roles like Bot from earning XP at all.
- 6
Style the rank card
Use /rankcard set or the dashboard's rank card editor to customize background, accent color, text color, and avatar border shape, with a live preview.
Examples
Illustrative mockups of what leveling & rank cards posts in Discord. They are not a live capture, but they match the real thing.
A level-up announcement posted in the current channel
Java LavaBOT
🎉 **@Rin** just reached **Level 12**!
Total XP
18,420 XP
Next level in
580 XP
Configuration options
| Option | Description |
|---|---|
XP Per Message Default: 15–25 XP | Random XP amount awarded per eligible message, expressed as a min–max range. |
XP Cooldown Default: 60 seconds | Minimum seconds between XP awards for the same member. |
Level-Up Announce Mode Default: Current channel | None, in the channel the message was sent, a dedicated channel, or DM. |
Level-Up Channel | Destination channel when announce mode is set to a dedicated channel. |
Level-Up Message | Customizable announcement text with placeholders for user, level, and more. |
Role Rewards | Roles automatically granted at specific levels. |
Per-Role / Per-Channel XP Multipliers | Multiply XP earned in specific channels or by members with specific roles. |
No-XP Roles Default: Bot | Roles that never earn XP (e.g. Bot). |
No-XP Channels | Channels excluded from XP gain entirely (e.g. bot-commands). |
Voice XP Default: On, 5 XP/min, requires others present | Awards XP per minute connected to a voice channel, optionally only while another non-bot member is also present. |
Booster XP Multiplier Default: 2x | Extra XP multiplier applied to server boosters. |
Role Reward Stack Mode Default: Stack | Whether members keep every role reward they've earned (stack) or only the highest tier (highest-only). |
Level-Up Message Auto-Delete Default: Never | Seconds after which the level-up announcement is auto-deleted. 0 = never. |
Leaderboard Window Default: All-time | All-time, this month, or this week. Controls the ranking period shown on the leaderboard. |
XP Decay Default: Off, 5%/week, 14-day grace | Gradually removes a percentage of XP per week from inactive members, with a grace period before it starts applying. |
Rank Titles | Custom named tiers (e.g. Novice, Regular, Veteran, Legend) shown next to a member's level based on a level range. |
Rank Card Style | Background type/color/gradient/image, accent color, text colors, avatar border shape, and overlay opacity, editable per member via /rankcard set with a live preview. |
Permissions
Bot permissions required
Who can configure this
Anyone with the dashboard's Owner or Admin access tier (Staff Access page), or Editor tier for day-to-day config changes
Commands
Click any command to copy it.