Levels and XP
Visible progress that makes people want to come back, with roles to unlock.
In this guide
01Earning XP
| Source | Default |
|---|---|
| Message | 15 to 25 XP, once per minute |
| Voice | 10 XP per minute, if the session lasted at least one minute |
| Typing race | 25 XP to the winner of each round of /game typerace, adjustable (0 for none) |
Each channel can have its own rate, or 0 to be excluded. The AFK channel never earns XP.
/infotools xp shows each member what they still need to reach the next level: their XP, a progress bar, the remaining XP, the estimated effort in messages or in voice (bonuses included), the next five levels and the next reward. xp 20 gives what's missing for a specific level, xp @membre someone else's progress.
02XP per level
You choose how much XP it takes to pass each level, with two numbers: the XP to pass the first level, and the XP added at each following level.
| Setting | Result |
|---|---|
leveling courbe 100 0 | Each level costs 100 XP: level 1 at 100 XP, level 2 at 200 XP, level 10 at 1,000 XP |
leveling courbe 100 50 | The first level costs 100 XP, the next one 150, then 200... Level 10 at 3,250 XP |
leveling courbe defaut | The default curve: 155 XP for level 1, then 10 more XP at each level. Level 10 at 1,100 XP |
leveling courbe | The table of the current curve: what each level costs and the total XP |
- The same setting is in
/leveling panneau, "XP per level" button, and on the dashboard. - Members' XP doesn't change: only their level is recalculated with the new curve. Level roles now reached are given; a role already given isn't removed if the level drops.
- Members see what they still need with
/infotools xp.
03Rewards and announcements
/leveling gives roles at set levels. They stack, or only the highest level role is kept with the "exclusive roles" option. Level-ups are announced in a chosen channel, either with an image card (nickname, new level, tier, leaderboard rank, progress) or with a customizable text message. The member ping can be removed: their name is still shown, with no notification. /config levelnotify lets each member turn off the public announcement of their level-ups.
04Boosts and prestige
/config xpbooststarts a temporary boost for the whole server, up to x10./config xprolesgives a permanent multiplier to a role (the best role counts, no stacking).- Voting for AshBots with
/ashbots votergives x1.5 for 12 hours. - Prestige opens at level 50: back to zero in exchange for +5% XP per prestige.
05Leaderboards
/leveling classement shows the XP leaderboard. /classementmessages and /vocal classementvocal show the most active members in text and in voice: the all-time top as an image, with a menu to switch to today, 7, 30 or 365 days.
06Counting old messages
The bot only counts messages from the moment it joins. /synchroniser goes through the server's history and adds the messages sent before to the statistics: a member who had written 500 gets them back in their counter and in the message leaderboard.
| Command | Effect |
|---|---|
synchroniser | Starts the sync, or resumes it where it stopped |
synchroniser etat | Where it's at: messages added, channels done, unreadable channels |
synchroniser pause | Pauses it, without losing anything |
synchroniser annuler | Removes everything it added, after confirmation |
- Every channel the bot can see with "Read Message History" is read: text channels, announcements, voice channel chats, threads and forum posts, archived ones included. Unreadable channels are counted separately in the summary.
- No message is counted twice. Only messages from before the bot joined are read, later ones are already counted. Each finished channel is never read again: running the command again only goes through channels that have become readable since.
- Messages from bots, webhooks and system messages don't count, just like live.
- The sync runs in the background and shows its progress in a message. It resumes on its own after a bot restart. On a very large server, it can take more than an hour.
- Only message counters change: not XP, not levels, not coins.
Command reserved for members with "Manage Server". Resetting the message leaderboard for the whole server also clears the sync: it can then be run again.
07Resets
/classementresetclears the voice leaderboard, the message leaderboard or both, for the whole server or a single member, after confirmation. Levels, coins and gifts don't move, and ongoing voice sessions start again from now./leveling xp resetallresets the whole server's levels to zero: only XP drops, prestiges, card colors, level roles already held and gifts (coins, items, boosts, advent calendar) are kept. The "Erase everything" button also deletes prestiges and colors./resetlevel alland/resetlevel membredo exactly the same thing in a shorter form./leveling xp resetdoes the same thing for a single member.
Commands in this guide
/leveling /level /game typerace /infotools xp /config levelnotify /config xpboost /config xproles /ashbots /classementmessages /vocal classementvocal /synchroniser /classementreset /resetlevelSomething unclear? Tell us on the support server, and the guide will be fixed.