Skip to Content
DocumentationLeveling System

📈 Leveling & Experience System

Alya includes a fully customizable, in-house Leveling & XP engine designed to reward active community members without spam or database slowdowns.


⚙️ Administration Commands (/levelconfig)

Server administrators can tailor the leveling experience to suit their server:

CommandDescriptionExample
`/levelconfig system [onoff]`Toggle the entire leveling engine on or off for the server.
`/levelconfig notify [onoff]`Toggle celebratory messages when a member levels up.
/levelconfig channel [#channel]Route level-up announcements to a specific channel./levelconfig channel #level-ups
/levelconfig channel resetReset announcements to appear in the channel where the user is chatting./levelconfig channel reset
/levelconfig statusDisplay an overview of the server’s current leveling configuration./levelconfig status

🎮 Member Commands

Viewing Your Rank (/rank)

Check your current level, experience points, progress bar to the next level, and server leaderboard position:

/rank /rank user:@Ainz

The rank card displays:

  • Current Level & Server Position
  • Current XP / Next Level XP Goal
  • Custom Profile Bio & Badges

Server Leaderboard (/leaderboard)

View top-ranked members in your guild with paginated leaderboard cards:

/leaderboard

🔬 How the XP System Works

1. Earning Experience

  • Every non-bot message sent in text channels awards random XP between 15 and 25 XP.
  • Anti-Spam Cooldown: Members can only earn XP once every 60 seconds. Rapid message spamming will not grant additional XP.

2. Level Calculation Formula

Experience required for each level scales smoothly using a standard RPG curve:

Required XP for Level (L) = 5 * (L^2) + (50 * L) + 100

This ensures that early levels are attained quickly to engage new members, while higher levels represent long-term community dedication.

3. High-Performance Caching

All guild leveling settings and user cooldown timestamps are kept in memory and synchronized across shards, ensuring zero lag on busy servers with high chat activity.

Last updated on