Leveling

What it does

Leveling tracks how active your members are and rewards them with XP. Members earn XP by chatting and by spending time in voice channels, level up as they accumulate XP, and can automatically receive roles when they hit configured levels. It is the backbone of a sticky, competitive community — your ,leaderboard becomes a reason to stay active.

Leveling is off by default. Turn it on from the Leveling dashboard page (or with ,levels unlock).

How to set it up

1. Open the Leveling page on the dashboard and toggle Enable leveling on.
2. Set your XP rate, message XP cooldown, and optionally Voice XP.
3. Add Role rewards for the levels you want to gate roles behind.
4. Choose how level-ups are announced.

You can also enable everything from chat with ,levels unlock.

Message XP

Each qualifying message grants a random 15–25 XP, multiplied by your XP rate. To stop spam farming, only one message per member earns XP within the cooldown window (default 60 seconds).

• Set the multiplier with ,levels setrate <multiplier> (a positive number; 1.0 is default).
• The cooldown is configured on the dashboard (in seconds).

You can exclude places and people from earning XP:

• ,levels ignore <channel> toggles a no-XP channel.
• ,levels ignore <role> toggles a role whose members never earn XP.

Voice XP

Members also earn XP for time spent in voice. To prevent farming, a member only earns voice XP while un-muted and un-deafened and with at least one other person in the channel. The server AFK channel is excluded.

Configure it on the Leveling page under Voice XP: toggle it on, then set how much XP to award and how many seconds in voice each award is worth (for example, 10 XP every 60 seconds). Voice XP also respects your XP rate multiplier.

XP rate multiplier

The XP rate is a single multiplier applied to all earned XP (message and voice). Raise it to speed up leveling for an event, or lower it to slow progression. Set it with ,levels setrate 2 for a 2x server, or change it on the dashboard.

Role rewards

Give members a role automatically when they reach a level.

• ,levels add <role> <level> — award a role at a level.
• ,levels remove <level> — remove a level reward.
• ,levels roles — list configured rewards.
• ,levels stackroles <on|off> — when on, members keep every reward role they have earned; when off, only the highest reward role is kept and lower ones are stripped.

You can also manage rewards visually with the editor on the Leveling page.

Level-up announcements

Choose where and how level-ups are announced:

• ,levels mode <channel|pm|context|none> — announce in a set channel, DM the member, reply in the channel they leveled up in, or stay silent.
• ,levels channel <channel> — set the announcement channel (also switches mode to channel).
• ,levels message <template> — customise the message. Supports {level} and {user.mention} variables.

Member commands

• ,rank [member] — show your level, XP, rank position, and progress as an image card. See Rank Cards. Alias: ,xp.
• ,leaderboard — paginated server XP leaderboard. Aliases: ,lb, ,top.

Admin XP commands

These require Manage Server:

• ,setxp <member> <xp> — set total XP and recompute the level.
• ,setlevel <member> <level> — set the level and recompute XP.
• ,removexp <member> <xp> — remove XP. Aliases: ,rxp, ,takexp.
• ,removelevel <member> <levels> — remove levels. Aliases: ,rlvl, ,removelvl.

Related

• Quests reward daily activity with bonus XP.
• [Voice-Time Roles] reward sustained voice presence with roles (configured on the Voice-Time Roles dashboard page).