> ## Documentation Index
> Fetch the complete documentation index at: https://xrypton.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 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
```bash theme={null}
/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
```bash theme={null}
/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
Control where level-up messages are sent.
```bash theme={null}
/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
```
```bash theme={null}
/level channel #level-ups # set the dedicated level-up channel
/level channel # remove the dedicated channel (falls back to current channel)
```
```bash theme={null}
/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}`
Fine-tune how much XP members earn per message.
```bash theme={null}
/level cooldown # seconds between XP-earning messages (0–3600)
/level multiplier # XP multiplier applied to every gain (0.1x–10x)
/level xprange # XP awarded per message (min ≥1, max ≤100)
/level maxlevel # cap the maximum reachable level (0 = no cap)
```
**Defaults:** 60s cooldown · 1x multiplier · 15–25 XP per message · no level cap
Reward members for putting in more effort in their messages.
```bash theme={null}
/level effort on # enable effort-based bonus XP
/level effort off # disable effort bonuses
/level effort # check current status
```
```bash theme={null}
/level efforttext # char count required for a text effort bonus (10–500)
/level effortimage # bonus XP for messages that include an attachment (0–50)
/level boosterbonus # 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.
Control whether members keep previous level role rewards when they earn new ones.
```bash theme={null}
/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
```bash theme={null}
/level rewards add <@Role> # assign a role reward for a level
/level rewards remove # 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:**
```bash theme={null}
/level rewards add 5 @Active Member
/level rewards add 20 @Veteran
/level rewards add 50 @Legend
```
***
## Resetting Levels
```bash theme={null}
/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
```bash theme={null}
/level config
```
Displays a full summary of your server's leveling configuration, including:
| 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 |