XP Leveling System: Configure and Manage Server Levels

Enable and tune XRYPTON’s XP leveling system — set XP rates, level-up notifications, role rewards, effort bonuses, and booster perks for your server.

XRYPTON’s leveling system rewards members for being active in your server. Every message earns XP (subject to a configurable cooldown), and members level up automatically as they accumulate it. You can attach role rewards to specific levels, customise the level-up notification, and tune every aspect of how XP is earned. All leveling commands are available as both prefix and slash commands.

---

Checking Rank & Leaderboard

/rank              # view your own rank card
/rank @User        # view another member's rank card
/level leaderboard # top 10 members by total XP (alias: lb)

The rank card shows the member’s current level, XP progress, and a visual progress bar. The leaderboard is sorted by total lifetime XP and limited to the top 10 members.

---

Enabling / Disabling the System

/level toggle

Permission: Manage Server
Toggles the entire leveling system on or off for your server. The first time you run this, it enables the system and creates the default configuration. Run it again to disable without losing your settings.

---

Configuration

Notifications

Control where level-up messages are sent.

/level levelup dms       # send level-up messages to the member's DMs
/level levelup channel   # send to a dedicated channel (set with /level channel)
/level levelup off       # disable level-up messages entirely

/level channel #level-ups   # set the dedicated level-up channel
/level channel              # remove the dedicated channel (falls back to current channel)

/level message {user} just hit level {level} — congrats!
# set a custom level-up message template
# leave blank to reset to default

Available template placeholders: {user}, {username}, {guild}, {level}, {xp}, {total_xp}

XP Settings

Fine-tune how much XP members earn per message.

/level cooldown <seconds>        # seconds between XP-earning messages (0–3600)
/level multiplier <value>        # XP multiplier applied to every gain (0.1x–10x)
/level xprange <min> <max>       # XP awarded per message (min ≥1, max ≤100)
/level maxlevel <level>          # cap the maximum reachable level (0 = no cap)

Defaults: 60s cooldown · 1x multiplier · 15–25 XP per message · no level cap

Effort Bonuses

Reward members for putting in more effort in their messages.

/level effort on    # enable effort-based bonus XP
/level effort off   # disable effort bonuses
/level effort       # check current status

/level efforttext <chars>    # char count required for a text effort bonus (10–500)
/level effortimage <xp>      # bonus XP for messages that include an attachment (0–50)
/level boosterbonus <xp>     # extra XP for server boosters per message (0–100)

When effort mode is on, members receive +5 XP for messages that exceed the text threshold, plus any configured image and booster bonuses — all before the multiplier is applied.

Role Stacking

Control whether members keep previous level role rewards when they earn new ones.

/level stackroles

Permission: Manage Server
Toggles between two modes:

• Stacking enabled — members accumulate all role rewards they have unlocked.
• Stacking disabled (default) — only the highest unlocked reward role is assigned; lower-level roles are removed.

---

Role Rewards

Assign a Discord role as a reward for reaching a specific level.

Permission: Manage Server

/level rewards add <level> <@Role>    # assign a role reward for a level
/level rewards remove <level>         # remove the reward for a specific level
/level rewards reset                  # clear all role rewards in the server
/level rewards list                   # view all configured role rewards

You cannot assign roles with Administrator or Manage Server permissions as level rewards. XRYPTON will reject the request to prevent privilege escalation.

/level rewards reset requires Administrator permission. Adding and removing individual rewards only requires Manage Server.

Example:

/level rewards add 5 @Active Member
/level rewards add 20 @Veteran
/level rewards add 50 @Legend

---

Resetting Levels

/level reset @User    # reset XP and level for a specific member
/level reset          # reset XP and level for every member in the server

Permission: Administrator

Resetting all member levels is irreversible. All XP and level data for every member in your server will be permanently deleted.

---

Viewing Your Configuration

/level config

Displays a full summary of your server’s leveling configuration, including:

Fields shown in /level config

Field	Description
Status	Whether the leveling system is enabled
Cooldown	Seconds between XP-earning messages
XP Range	Min and max XP per message
XP Multiplier	Current multiplier value
Max Level	Level cap (or “None” if uncapped)
Stack Roles	Whether role rewards accumulate
Effort Rewards	Whether effort bonuses are active
Text Threshold	Character count for text effort bonus
Image Bonus	Bonus XP for attachment messages
Booster Bonus	Extra XP for server boosters
Level Up DMs	Whether level-up messages go to DMs
Level Up Channel	Dedicated notification channel (if set)
Custom Message	Whether a custom template is configured