Skip to content

Set up levels & XP

Turn on XP for chatting and voice, choose where level-ups are posted and change the card colour.

5 min read · 5 steps

  1. 1. Turn levels on
  2. 2. Choose where level-ups go
  3. 3. Keep XP fair
  4. 4. Rank cards and leaderboards
  5. Fix a level by hand

1. Turn levels on#

/levels settings enabled:true - or the Levels & XP page in the dashboard.

By default members get 15-25 XP per message, once a minute, and 5 XP per minute in voice while at least one other person is there (not when deafened).

2. Choose where level-ups go#

OptionResult
announce: The channel they chatted inDefault - a short message right there
channel:#level-upsEvery level-up goes to one channel
announce: By DMPrivate message to the member
announce: NowhereSilent levels

Change the text with message: - {user}, {level} and {server} are filled in.

3. Keep XP fair#

  • cooldown: - seconds between XP from messages (stops spam levelling).
  • voice_xp: - XP per minute in voice, 0 turns it off.
  • ignore_channel:#bot-commands - no XP there (run again to remove it).

4. Rank cards and leaderboards#

Members see their card with /rank (or ?level) and pick its colour with /levels card. /leaderboard shows the top 10 by XP; type: switches to voice time, messages, reputation, invites or coins.

Fix a level by hand#

/levels xp set user: level: puts someone at an exact level, /levels xp add gives or takes XP, and /levels xp reset resets one member or the whole server.