Nouveau-25% on Premium with the code NOEL25, until December 31
Documentation Community

Levels and XP

Visible progress that makes people want to come back, with roles to unlock.

4 min read 7 sections 13 commandes

In short
/leveling enables the system, /level shows a member's card.
In this guide
  1. Earning XP
  2. XP per level
  3. Rewards and announcements
  4. Boosts and prestige
  5. Leaderboards
  6. Counting old messages
  7. Resets

01Earning XP

SourceDefault
Message15 to 25 XP, once per minute
Voice10 XP per minute, if the session lasted at least one minute
Typing race25 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.

SettingResult
leveling courbe 100 0Each level costs 100 XP: level 1 at 100 XP, level 2 at 200 XP, level 10 at 1,000 XP
leveling courbe 100 50The first level costs 100 XP, the next one 150, then 200... Level 10 at 3,250 XP
leveling courbe defautThe default curve: 155 XP for level 1, then 10 more XP at each level. Level 10 at 1,100 XP
leveling courbeThe 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 xpboost starts a temporary boost for the whole server, up to x10.
  • /config xproles gives a permanent multiplier to a role (the best role counts, no stacking).
  • Voting for AshBots with /ashbots voter gives 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.

CommandEffect
synchroniserStarts the sync, or resumes it where it stopped
synchroniser etatWhere it's at: messages added, channels done, unreadable channels
synchroniser pausePauses it, without losing anything
synchroniser annulerRemoves 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

  • /classementreset clears 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 resetall resets 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 all and /resetlevel membre do exactly the same thing in a shorter form.
  • /leveling xp reset does the same thing for a single member.

Commands in this guide

Options and permissions for each command

Something unclear? Tell us on the support server, and the guide will be fixed.