XP rules
Configure message XP, voice XP, multipliers, and the announcement template.
Message XP
| Setting | Default | What it does |
|---|---|---|
| Message XP min / max | 15 / 25 | Random XP per qualifying message. |
| Message cooldown (seconds) | 60 | Time between awards for the same member. Stops spam farming. |
| Min message length | 0 | Minimum chars before a message counts. Set to 5–10 to reward more substantive posts. |
Voice XP
| Setting | Default | What it does |
|---|---|---|
| Voice XP per minute | 5 | Earned per minute spent in voice. |
| Count muted | true | Muted members still earn. |
| Count deafened | false | Deafened don't earn (sleep VC). |
| Count alone | false | Alone-in-channel doesn't earn. |
Voice XP is awarded once per minute, so you won't see it flow in real-time — it ticks up at the top of each minute.
Multipliers
Two kinds:
- Channel multipliers — e.g.
#trading-floor → 2x. Bonus for active business-end channels. - Role multipliers — e.g.
@Booster → 1.5x. Reward server boosters.
Multipliers stack multiplicatively. Channel 2x + role 1.5x = 3x.
Server-wide multiplier
xp_multiplier (default 1.0) is a global multiplier applied to everything. Useful for "double XP weekends" — bump to 2.0 for the event, drop back to 1.0 after.
XP blacklist
A list of channels where messages don't earn XP. See XP blacklist — typically off-topic, spam, bot-command channels.
Announcements
Mode— off / channel / current / dmChannel— when mode = channelMessage— the template (see overview for placeholders)Auto-delete after (seconds)—0keeps the message;>0deletes after that many secondsAlso DM— additionally DM the user even in channel mode
Role stack vs replace
Per-guild toggle: when a member levels up and earns a new level-role, do they:
- Stack — keep all previously-earned level-roles (so a max-level member has every level-role)
- Replace — only the highest currently-earned level-role sticks; lower ones get stripped
Default is stack. Tiered ladders (Bronze → Silver → Gold) typically want replace.
Reset on leave
false(default) — XP persists across leave/rejointrue— leaving wipes their XP
For most servers, persistence is the right call (welcome-backers feel welcomed-back).
Permissions
levelling.view— see settingslevelling.edit— change anything on this page
Limits
- Message XP min/max: 0–1000
- Cooldown: 0–3600s
- Voice XP per minute: 0–1000
- Multipliers: 0.1–10.0
- Level cap: 500
Related pages
- Level roles — what to do with the XP
- Leaderboard — public display
- Blacklist — where XP doesn't accrue
