Skip to main content
Percy’s leveling system tracks how active members are in your server and rewards them with XP, a visual rank card, and optional roles when they reach certain levels. Everything is per-server and stays off until you turn it on, so you stay in full control.

​
How XP Is Earned

Members earn XP in two ways:
  • Sending messages — every qualifying message grants XP. Messages shorter than 3 characters or sent by bots are ignored. A per-member cooldown prevents spam from inflating scores.
  • Voice activity — members in a voice channel earn XP every minute, as long as at least two humans are present and the member is not AFK, server-deafened, or self-deafened.
Both sources respect the same blacklists and multipliers you configure. XP multipliers from different sources (role multipliers, channel multipliers, active boosts) stack on top of each other.

​
Commands

​
Core commands

​
Configuration sub-commands

All /level config sub-commands require Manage Guild.

​
Examples

​
Setting Up Leveling

1

Enable the system

Run /level config toggle true. Percy will create a default configuration for your server.
2

Choose where announcements go

Run /level config channel #level-ups to send all level-up messages to a dedicated channel. Pass dm to slide them into the member’s DMs, or leave the argument empty to disable announcements entirely.
3

Assign level roles

Run /level config roles to open the interactive role editor. Add a role and the level required to earn it. Percy assigns the role automatically when a member hits that level.
4

Set XP multipliers (optional)

Run /level config multiplier to boost XP gain for certain roles or channels. For example, you can give server boosters a 2× multiplier so their activity counts for double.
5

Enable voice XP (optional)

Run /level config voice true 10 to grant 10 XP per minute to members active in voice channels.

​
Voice XP Details

The voice XP loop runs every minute. Percy checks every populated voice channel on your server and awards voice_xp points to each qualifying member. A member is skipped if:
  • They are the only human in the channel (fewer than 2 humans required).
  • They are AFK, server-deafened, or self-deafened.
  • They appear on the leveling blacklist.
The per-minute XP rate defaults to the value you set with /level config voice. Active economy boosts and vote multipliers stack on top of it.

​
Level-Up Message Template

Customize what Percy says when a member levels up with /level config message. Use these placeholders in your message: Example:
Leveling is disabled by default. You must run /level config toggle true before any XP is earned in your server.
XP multipliers from different sources stack multiplicatively. A member with a 2× role multiplier in a 1.5× channel earns 3× the base XP.
Use /level config ignore #bot-spam to stop members from farming XP in bot command channels.