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 three ways:

• Messages - each message awards a random amount of XP within a range you set (15 to 40 by default). To stop spam farming, XP is only granted once per cooldown window (10 seconds by default), so sending several 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.
• Bot commands - using the bot’s own slash commands earns XP too, on the same cooldown as messages. You can turn this off per server if you prefer. It is on by default.

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 (50 × level² - 100 × level + 150, the same curve Lurkr uses), so each level costs a bit more than the last. The per-message, per-minute, and command rates are tunable, but the level curve itself is fixed. If you are moving over from Lurkr, your members keep the exact same levels. 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)
XP from bot commands	Whether using the bot’s slash commands earns XP (on by default)
Announcements	Where level-ups are posted: in the channel where they leveled up, in a set channel, by direct message, or off entirely (off by default)
Reward mode	Stack keeps every reward role a member has earned. Highest only keeps just the top one
Role rewards	Add or remove a role to grant at a chosen level (pick the role, then set the level)
No-XP channels	Channels (and anything under an excluded category) where messages and voice earn nothing
No-XP roles	Roles whose members never earn XP

Role rewards, no-XP channels and no-XP roles are list-based, so each opens its own sub-menu in the panel with native role and channel pickers to add or remove entries. The main panel also shows how many of each you currently have.

Prefer a browser? The same settings are on the dashboard at dashboard.codexhelper.com, with a roomier list view.

Two ways to manage it

Everything, including reward roles and exclusions, can be set up from /xp settings right inside Discord. The dashboard offers the same controls with a full list view in the browser. Changes from either place take effect right away.