Leveling

Leveling turns everyday activity into progress. Members earn XP for sending messages and for spending time in voice, climb through levels, and can unlock reward roles along the way. Everyone can check their rank or the server leaderboard, and admins control the rates and rewards.

Tier	Free
Command	/xp
Who can use	Everyone to view, Admins to configure
Also on dashboard	Yes

How it works

Leveling is opt-in per server. It does nothing until an admin turns it on from /xp settings (or the dashboard). Once enabled, members earn XP two ways:

• Messages - each message awards a random amount of XP within a range you set (15 to 25 by default). To stop spam farming, XP is only granted once per cooldown window (60 seconds by default), so sending ten messages in a row still only pays out once.
• Voice - time in a real voice or stage channel pays out XP per minute (5 per minute by default), credited when the member leaves or switches channels.

Voice XP is only awarded when the member is genuinely active. It is skipped when:

• They are muted, deafened, server-muted, or server-deafened.
• They are alone (a channel needs at least two non-bot members present).
• They are in the server’s AFK channel, or a channel marked as no-XP.

When a member crosses into a new level, the bot can announce it and hand out reward roles automatically. Reward roles and channels or roles that should never earn XP are managed on the dashboard.

How levels are calculated

The XP needed to reach a level grows with the square of the level (roughly 49.5 × level²), so each level takes a little more than the last. The per-message and per-minute rates are tunable, but the level curve itself is fixed. Like everything else here, XP is shared per server, so a member’s level in one server is independent of any other.

XP is saved in batches roughly once a minute. Up to a minute of the very newest XP can be lost if the bot restarts, which is a fair trade for a leaderboard feature.

Commands

/xp rank

Show your current level, server rank, total XP, and a progress bar toward the next level. Point it at someone else to see their rank instead. The reply is private to you.

Option	Type	Required	Description
member	member	No	Whose rank to show (defaults to you)

/xp rank member:@Someone

/xp leaderboard

Show the server’s XP leaderboard, ranked highest to lowest, with prev/next buttons to page through everyone who has earned XP. The reply is private to you.

Option	Type	Required	Description
(none)

/xp leaderboard

/xp settings

Open an interactive panel to view and change every leveling setting. Toggles apply instantly; the message XP, voice XP, and announcement-channel options open a short pop-up form. The panel refreshes in place as you make changes.

Option	Type	Required	Description
(none)

/xp settings

Admins only

/xp settings needs Administrator or Manage Server, or the server’s Bot Admin role. /xp rank and /xp leaderboard are open to everyone.

Settings

The /xp settings panel covers everything you can tune from inside Discord:

Setting	What it does
Turn leveling on / off	Master switch for earning XP in this server
Message XP	Minimum and maximum XP per message, plus the cooldown in seconds
Voice XP	XP earned per minute in voice (set it to 0 to turn voice XP off)
Announcements	Where level-ups are posted: in the channel where they leveled up, in a set channel, by direct message, or off entirely
Reward mode	Stack keeps every reward role a member has earned. Highest only keeps just the top one

A few settings live on the dashboard at dashboard.codexhelper.com instead, because they are list-based:

• Reward roles - which role to grant at which level.
• No-XP channels - channels (and their threads) where messages and voice earn nothing.
• No-XP roles - roles whose members never earn XP.

The /xp settings panel shows how many reward roles and no-XP entries you currently have, and links you to the dashboard to edit them.

Two ways to manage it

Most day-to-day tuning works from /xp settings in Discord. For setting up reward roles and exclusions, the dashboard gives you the full list view in the browser. Changes from either place take effect right away.