Docs/Features/Leveling System
Engagement

Leveling System

Reward active members with XP, levels, and automated role rewards. Encourage engagement and recognize your most active community members.

How XP Works

Members earn XP (experience points) through various activities in your server. As they accumulate XP, they level up and can unlock role rewards.

Chat XP

Earn XP by sending messages. XP is awarded once per minute to prevent spam.

Voice XP

Earn XP while in voice channels. AFK and muted users can be excluded.

Level Progression

XP Required Per Level

The XP required to reach each level follows a curve that increases with each level:

Lvl 1
100
Lvl 2
400
Lvl 3
900
Lvl 4
1600
Lvl 5
2500
Lvl 6
3600
Lvl 7
4900
Lvl 8
6400
Lvl 9
8100
Lvl 10
10000

Formula: Level² × 100 = XP required for that level

Setting Up Leveling

1

Enable the System

Go to Dashboard → Engage → Levels and toggle "Enable Leveling" to on.

2

Configure XP Settings

  • Message XP: 15-25 XP per message (customizable)
  • Voice XP: 10-20 XP per minute in voice
  • Cooldown: Time between XP awards (prevents spam)
3

Set Up Role Rewards

Automatically assign roles when members reach certain levels:

Example Setup

  • Level 5 → @Active Member
  • Level 10 → @Regular
  • Level 25 → @Veteran
  • Level 50 → @Legend
4

Configure Level-Up Announcements

Choose how to announce level-ups:

  • • Current channel (replies in the same channel)
  • • Dedicated channel (all announcements in one place)
  • • DM to user (private notification)
  • • Disabled (no announcements)

XP Multipliers

Boost engagement by giving certain roles or channels XP multipliers:

Role Multipliers

Give Server Boosters, premium members, or NFT holders bonus XP.

Channel Multipliers

Encourage activity in specific channels with bonus XP.

Exclusions

Exclude Channels & Roles

Prevent XP from being earned in specific channels or by specific roles:

  • • Bot command channels
  • • NSFW channels
  • • Staff-only channels
  • • @Bot role (prevent bots from earning XP)

Leveling Commands

CommandDescription
/rankView your current level and XP
/rank @userView another member's rank
/leaderboardView the server's top members by XP
/rewardsView available level rewards

Admin Commands

CommandDescription
/setxp @user [amount]Set a member's XP to a specific amount
/addxp @user [amount]Add XP to a member
/removexp @user [amount]Remove XP from a member
/resetxp @userReset a member's XP to zero

Anti-Spam Protection

WardX includes built-in anti-spam protection. Rapid messaging won't award extra XP - members can only earn chat XP once per cooldown period (default 60 seconds).