Module · FREE

Leveling & XP

XP per message + per voice minute, customizable level curve, role rewards on threshold, leaderboard and per-user rank card. Configure at /dashboard/[guildId]/leveling.

How XP is earned

Defaults from apps/bot-engine/src/services/levelingService.js (configurable per-guild via the dashboard) :

● Messages — a random XP amount between xpMin and xpMax awarded per message
● Anti-spam cooldown — only one message every 60s grants XP (per user, per guild)
● Voice — voiceXpPerMinute = 10 in active voice channels
● XP combos — short successive messages within a configurable window stack a multiplier (anti-burst)

Rank roles

Assign Discord roles when members hit specific levels. Configure via /level setreward + /level removereward, or in the dashboard.

● Per-level role thresholds
● Per-role XP multiplier (booster role grants extra XP, etc.)
● Per-channel exclusions (no-XP channels for spam / dev)

Slash commands

7 /level subcommands verified in apps/bot-engine/src/bot/commands/level/index.js :

/level rank—See your current XP, level and progress to the next level.

/level leaderboard—View the top 10 users on this server by level (supports type / page).

/level rewards—View level role rewards configured for this server.

/level setreward—Admin — set a role reward for a level.

/level removereward—Admin — remove a role reward for a level.

/level config—Admin — configure XP settings (cooldown, xpMin/xpMax, voice, combo).

/level reset—Admin — reset all XP and levels for this server.

/stats server—Display server statistics.

/stats bot—Display bot statistics.

Configure all of this from your dashboard. Available on every plan including Free.