Levels and role rewards

How XP becomes a level

Each level costs more than the one before it. The XP needed to go from a level to the next one is:

5 x level x level + 50 x level + 100

So level 0 to 1 costs 100 XP, level 1 to 2 costs 155, level 2 to 3 costs 220, and it keeps growing. What a member sees on their rank card is the progress inside their current level, not their lifetime total.

Cumulative totals, if you want a sense of the scale:

At the default 1x rate, level 10 is roughly 230 qualifying messages, or about ten hours in voice. Halving or doubling the XP rate moves those numbers with it.

The curve is the same for the text track and the voice track, so in Separate mode a voice level 10 costs exactly as much as a text level 10.

Maximum level

Max Level, under Additional Settings, stops progression at a level you choose. 0 means no limit, and that is the default.

Once a member is at the cap they keep earning XP inside that level until the bar is full, then stop. They never level up again, so no further announcement is posted and no higher reward role is granted. The cap applies per track, so in Separate mode text and voice each stop at the same number independently.

Role rewards

Role Rewards map a level to a role. When a member reaches that level, the bot gives them the role.

Two rules decide what actually happens:

• Only one role is granted per level-up: the highest tier the member has now reached. If someone jumps from level 4 to level 12 in one go and you have rewards at 5, 10 and 15, they get the level 10 role, not all three.
• Remove Old Reward Roles (Additional Settings, off by default) strips every strictly lower reward role when a new one is granted. Leave it off if reward roles are meant to stack visibly, turn it on if they are meant to be a single rank.

For the grant to work, the bot's own highest role must sit above the reward role in your role list, and the role must not be a managed one (a bot role or a booster role). If the bot cannot give a role, the rest of the level-up still happens: the announcement is posted and the member keeps their level.

The dashboard also refuses reward roles you would not be able to assign yourself, so you cannot use the level system to hand out a role above your own.

Rewards and leveling mode

In Separate mode, reward roles are granted by the text track only. A voice level-up never grants a reward role, otherwise every voice level would re-grant whatever role sits at that number. In Combined and Sum mode there is one level being announced, so every level-up can grant.

How many rewards you can set

Saving more than your tier allows is rejected and the dashboard shows an upgrade prompt rather than silently dropping rows.

Editing XP by hand

/xp lets anyone with Manage Server correct a member's progress. It is slash only.

kind picks the track: message (the default) or voice. Amounts go up to 1,000,000,000 and levels up to 1,000.

Three things to know before you use it:

• /xp never posts a level-up announcement and never grants reward roles, even when the member crosses a reward threshold. Give the role by hand if you want it.
• It refuses to run if leveling is disabled, and it refuses to run on a bot account.
• If another bot owns leveling for your server, /xp tells you which one to use instead of writing to the wrong place.