Leveling
Members earn XP for chatting, level up and collect level roles, with a rank card, a leaderboard in Discord and on the web. Free, with more level roles and extras on Premium.
Do this on my dashboardLeveling rewards the members who keep your server alive. Each message earns XP, XP adds up to levels, and levels can give roles. It is off until you switch it on, on the Leveling page.
The core is free: XP, levels, level-up messages, the rank card, the leaderboard and its public page. Premium raises the level roles from 5 to 50 and adds XP multipliers, your own rank card and a leaderboard that updates itself in a channel.
How XP is earned
- A message earns a random amount of XP in the range you set (15 to 25 by default).
- After a message earns XP, the member's next messages earn nothing until the cooldown has passed (1 minute by default). Flooding the chat earns nothing more.
- Bots never earn XP.
Levels follow the curve most leveling bots share: level 1 at 100 XP, level 10 at 4,675 XP. With the default settings, level 10 takes about 234 messages that earn XP, so about four hours of steady chatting.
Where it does not count
- Channels without XP: pick channels, or a whole category. Good for bot commands, spam and counting channels.
- Roles without XP: members with one of these roles earn nothing.
Level-ups
When a member reaches a new level, the bot can say so:
| Where | |
|---|---|
| Where they wrote | In the channel of the message that got them there |
| One channel | Every level-up goes to the channel you pick |
| By DM | Privately; members with closed DMs are not told |
| Nowhere | Levels and roles still count, silently |
The message is in the bot's language by default. Write your own with {user} (a mention), {username}, {level} and {server}. Only the member is pinged, never a role.
Level roles
Give a role when a member reaches a level: for example level 5 → Regular, level 20 → Veteran.
- With Keep earlier roles on, members hold every role up to their level. Off, they hold only the highest one.
- The bot needs the Manage Roles permission, and its own role must sit above the roles it gives. A role it cannot give is skipped.
- A member who left and came back gets their roles again at their next level-up.
XP multipliers (Premium)
Give more or less XP to a role's members, or in a channel: ×0.25, ×0.5, ×1.5, ×2 or ×3. For example ×2 for your boosters, or ×0.5 in a meme channel.
- A multiplier on a category covers its channels; one on a channel covers its threads.
- The channel's multiplier and the member's best role multiplier are combined. A member with several role bonuses gets the highest one, not all of them.
- A message always earns at least 1 XP, and never more than 500.
Your own rank card (Premium)
/rank draws a card with the member's avatar, rank, level and progress. With Premium you can put your own picture behind it (an https link, about 900 × 260), choose its colour, and darken the picture so the text stays readable. The Leveling page shows your own card as it would look, before you save.
Leaderboards
/leaderboardin Discord, ten members per page.- Public leaderboard page: switch it on and anyone with the link
supreo.xyz/leaderboard/<your server id>sees the ranking, with members' server names and avatars. It is off by default, and search engines are told not to index it. Free servers show their top 100; Premium shows everyone. - Channel leaderboard (Premium): pick a channel and the bot keeps one message there with the top ten, checked every 10 minutes and edited when the ranking changed. If someone deletes the message, the bot posts it again.
Commands
| Command | Who | |
|---|---|---|
/rank | Everyone | Your level card: rank, level and progress to the next level. Add a member to see theirs |
/leaderboard | Everyone | The most active members, ten per page |
/xp give, remove, set-level, reset | Manage Server | Change one member's XP by hand; their level roles follow |
You can turn a command off, or open /xp to other roles, on the Command permissions page.
Importing from another bot
On the Leveling page, Import XP brings levels over so nobody starts from zero.
- From MEE6: one click. Your MEE6 leaderboard must be public while the import runs (in MEE6's dashboard, under Leaderboard). MEE6 uses the same levels, so everyone lands where they were, and its role rewards can come along as level roles (up to your plan's limit). The import reads MEE6's public leaderboard page; if MEE6 changes or blocks it, the import says so and you can use a list instead.
- From a list: for any other bot. Paste one member per line, their Discord ID then a number, separated by a comma, and say whether the number is XP or a level. Up to 20,000 lines at a time.
By default a member keeps the higher of their XP here and the imported one, so importing twice, or after people started chatting, never takes XP away. Switch on Overwrite to replace it instead. Nothing is announced during an import, and level roles are given at each member's next level-up.
Giveaways for active members
A giveaway can ask for a minimum level: members below it cannot join. Set it under Who can join when you create the giveaway.
Starting over
Reset everyone's XP, on the Leveling page, puts every member back to zero. It cannot be undone. Roles already given stay on the members.
Good to know
- XP is saved in batches, about once a minute, so
/rankcan be up to a minute behind a message you just sent. - Switching leveling off keeps everyone's XP; switching it back on carries on from there.
- A member's XP stays when they leave the server, so a returning member keeps their level.
Giveaways
Giveaways members join with one button — with entry requirements, bonus entries, a captcha, claims and templates — drawn on time by the bot. Every feature is free.
Overview
Everything SUPREO does to keep a server clean — sanctions with one numbered record, reports, appeals, anti-spam, anti-raid, the honeypot, scam pictures and verification.
