Levels

Members earn XP for messages. Enough XP levels them up, which can announce in a channel and grant a role.

!level toggle on

That’s the minimum. Everything below is tuning.

Checking progress

!level

!level @someone

!leaderboard

Aliases: levels, lvls, lvl, rank. The leaderboard is also at !level leaderboard (lb, top).

Role rewards

!level role add 10 @Regular

!level role add 25 @Veteran
!level role add 50 @Elder

!level role remove 25

!level role list

!level add 10 @Regular is a shortcut for the same thing. Requires Manage Roles and Manage Server.

Stacking

!level role stack

Toggles whether members keep lower rewards. Stacking on means a level 50 member holds Regular, Veteran and Elder; off means they only hold Elder, and the earlier roles are removed as they progress.

Backfilling

!level sync

Grants everyone the rewards their current level entitles them to. Run it after adding a new reward tier — otherwise existing members only get it if they level up again.

Level-up messages

!level channel #level-ups

!level channel

!level message {content: gg {user.mention}} {description: you're level **{user.level}**} {color: dominant}

!level message view

!level message remove

Available variables

Variable	Value
`{user.level}`	The level just reached
`{user.next_level}`	The one after
`{user.xp}`	XP toward the current level
`{user.total_xp}`	Lifetime XP
`{user.required_xp}`	XP needed for the next level

Plus all the standard variables.

Only announce role rewards

!level message roles

Only send a message when a level actually grants a role. Cuts the noise dramatically on a busy server. Aliases: reward, roleonly, ro.

Cooldown

!level cooldown 60

Minimum seconds between level-up messages for the same member.

The XP curve

!level spec

Three knobs, all requiring Manage Server.

!level spec gain 10 18

!level spec base 100

!level spec factor 1.2

!level spec reset

The formula is:

xp needed for level N  =  base × N^factor

rounded up to the nearest 10. With the defaults — base 100, factor 1.2, gain 10–18 XP per message — the curve looks like:

Level	XP for that level	Messages (approx)
1	100	~7
5	690	~50
10	1,590	~114
25	4,760	~340
50	10,940	~782
100	25,120	~1,794

Making it faster

Raise the gain, or lower base and factor:

!level spec gain 20 35
!level spec base 75

Making it a real grind

Raise the factor. Small changes matter a lot — 1.5 is dramatically steeper than 1.2 by level 50:

!level spec factor 1.5
!level spec base 150

Capping progression

!level max 100

Members stop gaining XP at that level. Aliases: maxlevel, maximum.

Multipliers

Give a role bonus XP:

!level multiplier 2 @Booster

!level multiplier 3.6 @VIP

!level multiplier list

!level multiplier remove @Booster

Aliases: multipliers, multi, mp, x.

Effort boost

!level effort 25
!level effort cooldown 300

Grants extra XP for longer messages — 25 means +25%. The cooldown prevents someone farming it by posting essays back to back. Alias: boost. Remove it with !level effort remove.

Blacklisting

!level blacklist #spam

!level blacklist @someone

!level blacklist @Muted

!level blacklist view

!level blacklist clear

Toggles, so running it twice undoes it. Aliases: ignore, block, bl.

Blacklist your bot-command channels, spam channels and counting channels. Otherwise the leaderboard measures who spams commands the most, which isn’t what you’re trying to reward.

Manual adjustments

!level set @someone 25
!level set xp @someone 5000

Requires Manage Server. Setting the level recalculates their XP to match.

Reviewing everything

!level settings

Shows whether levelling is on, the channel, the cooldown, the curve, the multipliers, the reward roles and the blacklist.

Command reference

Command	Permission	Description
`level [member]`	—	View level and XP
`leaderboard`	—	Top members
`level toggle (on/off)`	Manage Server	Enable or disable
`level role add <level> <role>`	Manage Server + Roles	Add a reward
`level role remove <level>`	Manage Server + Roles	Remove a reward
`level role list`	—	View rewards
`level role stack`	Manage Server + Roles	Keep lower rewards
`level sync`	Manage Server	Backfill missing rewards
`level channel [channel]`	Manage Channels	Where messages go
`level message <script>`	Manage Server	Customise the message
`level message view`	Manage Server	Preview it
`level message roles`	Manage Server	Only announce rewards
`level message remove`	Manage Server	Reset to default
`level cooldown <seconds>`	Manage Server	Between messages
`level spec base <base>`	Manage Server	Base XP value
`level spec factor <factor>`	Manage Server	Curve steepness
`level spec gain <min> <max>`	Manage Server	XP per message
`level spec reset`	Manage Server	Restore defaults
`level max <level>`	Manage Server	Cap progression
`level multiplier <mp> <role>`	Manage Server	Role XP multiplier
`level multiplier list`	—	View multipliers
`level multiplier remove <role>`	Manage Server	Remove one
`level effort <percentage> [length]`	Manage Server	Bonus for long messages
`level effort cooldown <seconds>`	Manage Server	Effort boost cooldown
`level blacklist [target]`	Manage Server	Toggle a blacklist entry
`level blacklist view`	Manage Messages	View the blacklist
`level blacklist clear`	Manage Messages	Clear it
`level set <member> <level>`	Manage Server	Set a level manually
`level set xp <member> <xp>`	Manage Server	Set XP manually
`level settings`	Manage Server	Full overview

Start here

Security

Restore

Moderation

Server setup

Last.fm

Social

Utility

Checking progress

Role rewards

Stacking

Backfilling

Level-up messages

Available variables

Only announce role rewards

Cooldown

The XP curve

Multipliers

Effort boost

Blacklisting

Manual adjustments

Reviewing everything

Command reference

​Checking progress

​Role rewards

​Stacking

​Backfilling

​Level-up messages

​Available variables

​Only announce role rewards

​Cooldown

​The XP curve

​Multipliers

​Effort boost

​Blacklisting

​Manual adjustments

​Reviewing everything

​Command reference

Checking progress

Role rewards

Stacking

Backfilling

Level-up messages

Available variables

Only announce role rewards

Cooldown

The XP curve

Multipliers

Effort boost

Blacklisting

Manual adjustments

Reviewing everything

Command reference