Leveling & XP Overview
How Nevi's leveling system works: XP, level calculation, and server setup.
How it works
Nevi's leveling system rewards active members by granting XP (experience points) for every message they send. XP accumulates over time, and once a member crosses a level threshold, they level up automatically.
Every message earns XP
Each message a user sends earns XP. One award per message, regardless of message length. Spam protection prevents rapid farming so only genuine conversation is rewarded.
XP determines your level
Your level is calculated from your total XP using the formula level = floor(0.177 * sqrt(xp)) + 1. Early levels come quickly, while higher levels require exponentially more XP. See the XP Formula & Mechanics page for the full breakdown.
Levels unlock rewards
Levels can trigger autoroles (automatic role assignments), appear on user profiles, and are ranked on your server's leaderboard. Members can check their rank anytime with /rank.
Quick setup
Leveling takes under a minute to set up:
1. Enable the XP system
Run /config set experienceEnabled true to start tracking XP for all messages in your server. Members will immediately begin earning XP.
2. Set a level-up channel
Use /config set levelUpChannel #levels to send all level-up announcements to a dedicated channel. If you skip this step, level-up messages will appear in the same channel where the user leveled up.
3. Customize the level-up message (optional)
Personalize what Nevi says when someone levels up with /config set levelUpMessage "GG {user.mention}! You just hit level {level}!". See Level-Up Messages for all available variables.
That's it. Your server is now tracking XP and celebrating level-ups. From here you can fine-tune the system with level autoroles, channel ignoring, and more.
Key features
Automatic XP Tracking
XP is awarded automatically for every message. No setup beyond enabling the system. XP updates are batched in memory and flushed to the database every 30 seconds for performance.
Customizable Level-Up Messages
Choose exactly what Nevi says when someone levels up. Use template variables like {user.mention}, {level}, and {server} to craft the perfect announcement.
Level Autoroles
Automatically assign (and optionally remove) roles when members reach specific levels. Great for tiered permission systems or cosmetic role rewards.
Leaderboards
Members can compete for the top spot on the server leaderboard. Use /leaderboard to see who has the most XP and the highest level.
Channel & Role Ignoring
Prevent XP from being earned in specific channels (like bot-spam or AFK channels) or by specific roles. Fine-tune where and how XP is awarded.
Related Commands
/configmanagementRequires adminConfigure server settings
/ignoremanagementRequires adminManage where bot modules are active (use /disable for per-command control)
/autorolemanagementRequires ownerManage automatic role assignment on join or level-up
/leaderboardeconomyView the server leaderboard