Server levels
The level ladder a server opens for its members: messages and voice pay XP, and tiers hand back roles.
In short
Server levels are a local ladder, kept by the server and for the server alone. They touch neither your player level nor your progress in the game.
Every message pays between 15 and 25 XP, at most once every 60 seconds. The counter looks at neither the length of the message nor what it says: it looks at the clock.
XP has two sources: what gets typed and what gets said. Voice is counted in regular passes, as long as the channel conditions hold.
The curve starts at 100 XP for the first level, then hardens. Reaching the tenth level asks 4 675 XP, roughly 234 messages.
The server keeps six levers to tune all of it: the roles handed out, the multipliers, the bonus events, the excluded channels, the notifications and the way bonuses stack.
Two taps of XP
A message pays 15 to 25 XP, at most once every 60 seconds. Voice follows the same mechanic, on its own counter.
| Source | XP per pass | Delay | Condition | |
|---|---|---|---|---|
| Message | 15 to 25 XP | 60 s | A message typed in a watched channel | |
| Voice | 10 to 15 XP | 60 s | 1 member minimum in the channel, among 7 microphone requirements |
Everything is set from the server dashboard: a channel can be excluded, a role can be worth double.
The path of a message
six steps separate a message from the XP it pays. A single one that fails and the message counts for nothing.
- Channel not excluded
- Author not a bot
- Length long enough
- Thread accepted
- Last pass more than 60 seconds ago
- Roll between 15 and 25
- Role multipliers
- Bonus events running
- Curve threshold reached
- Tier role granted
Voice XP follows the same path, with its own delay and its own microphone conditions.
Multipliers compose, but their product is capped at 10 times the base XP.
The price of levels
The first level costs 100 XP. The hundredth asks 1 899 250 in total, cumulative included.
The message column counts twenty XP a pass, the average of the default range. The tenth level lands around 234 messages.
Six tuning levers
Everything is set per server, without touching the game. Each lever carries its own cap.
| Lever | Cap | Default | Effect | |
|---|---|---|---|---|
| Tier roles | 25 roles | none | A role granted as soon as the member reaches the declared level. | |
| Role multipliers | 10 roles | x1 | A role multiplies XP from 0 to 5, separately on messages and on voice. | |
| Bonus events | 3 at once | none | A dated window that multiplies XP from 1,5 to 5, once or on a recurrence. | |
| Excluded channels | 25 entries | none | A channel or a whole category stops paying XP. | |
| Notifications | 4 modes | off | A level up is announced in a fixed channel, in the channel of the message, in a direct message, or not at all. | |
| Stacking | 3 modes | multiplicative | Multipliers multiply, add up, or only the strongest counts. The product stays capped at 10. |
The dashboard also keeps the import from another leveling system and from the statistics already collected.
The announcement of a level-up
A level-up shows up in one place only: the announcement. With no setup the bot sends one line of text, and the dashboard can replace it with a hand-built message.
🎉 GG {user.mention}, you just reached Level {level}!
- The default line
Sent as is when no message has been built. It mentions the member and names the level, nothing else.
- The built message
The dashboard starts from this line: the tokens in braces are replaced at send time, and a full embed can be added.
A broken announcement never cancels the level: the bot falls back to the default line and the XP is already counted.
Four ways to announce, one at a time
The mode decides where the announcement goes. It is off by default: a server that sets nothing earns XP nobody ever sees.
In DMs the announcement respects the member's own
levelupswitch: whoever turned it off receives nothing, even on a server that set the mode.
Nine tokens replaced at send time
These are the ones the dashboard builder offers. They work in plain text as well as in an embed, title, description and fields included.
A misspelled token is not replaced: it stays visible as typed in the channel. The dashboard preview shows it before sending.
The commands
View your XP rank card
[user]The user whose rank card you want to see
[user]The user whose rank card you want to see