Leveling & XP
Reward activity with XP, levels, reward roles and a leaderboard.
Members earn XP for chatting — and optionally for sitting in voice channels. Crossing a level threshold can announce it and hand out a role.
Beta — tested, but still young.
Set it up
- Enable Leveling & XP in the Plugin Market.
- On the Leveling page, pick the announcement channel and add your reward roles.
Commands
/rank user: — your (or someone else's) level and XP, as a rank card image
/leaderboard top: — the top members (default 10, up to 25)
/rank shows a rank card — the member's avatar, level, rank and an XP progress bar on a designed background, drawn by the same engine as the welcome banner. It uses the CloudMod look by default; you can switch it to any of the banner templates, pick a font, or upload your own background image. Turn the image off to fall back to a plain text card. If the bot can't attach files in the channel, it sends the text version automatically.
The same card style is used for two more places:
- Level-up announcements post a card in the level-up channel when someone levels up (a "LEVEL UP" image; still pings the member via the text).
/leaderboardshows the top members as an image — rank, avatar, name, level and XP per row. The image shows at most 10 rows, even if you ask for more; only the text version lists up to 25.
Set it all up under Rank card image on the Leveling page: the style, the font, your own background, and a live preview.
What you can configure
| Setting | Default | What it does |
|---|---|---|
| XP min / msg · XP max / msg | 15 – 25 | each message grants a random amount in this range |
| Cooldown (s) | 60 | a member earns message XP at most once per cooldown |
| XP per level | 100 | level L needs L² × this much XP — lower means faster leveling |
| Announce level-ups | the Level-up channel (or Same channel as the message) and the Level-up message, with {user} and {level} | |
| Level reward roles | level → role, granted on the way up — and handed out later if you add the mapping after members are already past that level | |
| Keep only the highest role | off | removes lower reward roles when a member reaches a new one |
| XP multiplier roles | a role that earns XP faster (boosters, patrons); the highest multiplier applies, they don't stack | |
| Voice XP | 5 per minute, 2 members | XP per minute in voice and how many non-bot members must share the channel; skips the AFK channel and self-muted / deafened members by default |
| Double / triple XP event | off | a temporary multiplier on all XP, set to run for a number of hours |
| No-XP channels · No-XP roles | messages there, or members with these roles, earn nothing | |
| Rank card image | CloudMod look | the image style for /rank, level-ups and /leaderboard — or off for text only |
Voice XP needs a minimum member count — otherwise someone parks alone in a channel overnight and farms levels.
The Leveling page also shows a Leaderboard (top 20) and has Reset all levels, which permanently deletes every member's XP and level for the project and removes the configured reward roles from everyone who holds them, on every server of the network. On large servers the bot spreads the removals over a few minutes.
Good to know
- There's a cooldown between XP grants, so a wall of one-word messages doesn't pay.
- Leaving the server resets a member's XP and level there — the same happens when they are banned.
- Reward roles must sit below the CloudMod role. If one can't be granted, the level-up still counts.
- Adding a reward role later works. Members who are already past that level get it on their next message — you don't have to reset anyone's XP. The same applies when you switch on "keep only the highest role": stacked rank roles get cleaned up on the next message.
- Levels are per server.
Requirements: Send Messages and Manage Roles. Image cards also need Attach Files; without it CloudMod sends the text version.