Help pages Discord XP and leaderboards

Discord XP and leaderboards

Members earn XP in Discord, get roles for it and climb the leaderboard.

In short

  • Members earn XP by chatting, voice chat, /daily, welcoming and being thanked.
  • Make the roles they earn under Ranks & XP, Discord XP roles. /level shows each member's level.
  • /leaderboard shows the top members, in Discord and on a free web page.

How members earn XP

Ways to earn Discord XP and how much each gives at first
WayXP at first
Chatting15, at most once every 60 seconds
Voice chat with someone else2 a minute, up to 120 a day
/daily20, plus 5 for each day in a row
Being thanked with /thanks25
Welcoming a new member100
Boosting the server500, once every 30 days
An approved suggestion150
Change the amounts, and what is never read
  • Change each amount under Settings, XP. 0 turns one off.
  • Chat XP can also come every so many messages instead.
  • Pick channels and roles that earn no XP, like a bot-spam channel or a muted role.
  • Chat XP can be a random amount each time, like 15 to 25.
  • The bot counts messages and never reads or keeps their text.
  • With a Minecraft server, linking an account gives 200 XP once.
  • /xproles shows members what is on. Staff give or take XP by hand under Ranks & XP, Award XP.

Discord XP roles

  1. On the website open Ranks & XP, then Discord XP roles.
  2. Add a role and its XP, or press Make level roles for me.
  3. Members get it by themselves once they have the XP.
Keeping lower roles, and checking everyone
  • Members keep only their highest XP role, unless you switch on Keep lower XP roles.
  • VV-Bot needs Manage Roles, and its own role must sit above the XP roles.
  • Changed a role? Press Check everyone's XP roles now, or type /xprole sync.
  • Make level roles for me makes Level 5, 10, 20, 30 and 50 without any permissions. Or make a new role makes one with your name and colour.

Coming from another bot

Copy your members' levels from your old levelling bot, so nobody starts again at level 0.

How to copy the levels
  1. On your old bot's website, open Leveling and switch on Make my server's leaderboard public.
  2. On the Discord XP roles page press Bring levels from your old bot, paste the link of its leaderboard page, then press Look at the levels.
  3. Check who changes, tick the box and press Copy the levels. Only the server owner can do this.

Each member gets their old XP unless they already have more here, so nobody loses XP. Levels count the same way, so every level stays the same.

Levels and the level card

/level shows a member's level and XP as a picture.

How levels work, and how the card looks
  • Level 1 is 100 XP, level 5 is 1,150 XP and level 10 is 4,675 XP, the same as other levelling bots.
  • Choose the card's colours and a picture under Ranks & XP, Level card. The preview changes as you pick.
  • Members press Style my card under their own card to pick their colours. Their own picture only while you allow it.
  • VV-Bot needs Attach Files in the channel to send the picture.

XP boosts and double XP events

More XP for some roles, channels or a weekend: Ranks & XP, XP boosts.

How boosts add up
  • Boost a role (Server Booster x1.5), a channel or a whole category, or set the rate for everyone.
  • A double XP event has a start and an end, and can repeat every week. VV-Bot switches it on and off.
  • Choose a channel under Tell members about events, and VV-Bot posts when an event starts and ends. /level and /profile show "x2 XP" while one runs.
  • Boosts multiply and stop at x10. With several boosted roles or events, the biggest counts.
  • They count for chat and voice XP. /daily, thanks, welcomes and bonuses stay as you set them.

Congratulations on a new role or level

VV-Bot says "GG" for a new XP role or level.

When, where, and your own words
  • Change it on the Discord XP roles page, under Congratulate members when they level up. The preview shows the post as you type.
  • A new server congratulates every new level. Choose only a new XP role, or both.
  • It goes in the channel the member was chatting in, a channel you pick, or a private message.
  • The words start as GG {member}, you reached {rank}!. {member} pings the member, {rank} is the new role, {level} the level. {name}, {xp} and {server} work too. Up to 300 characters.
  • It pings only that member, at most once every 10 minutes.

Leaderboards

/leaderboard shows the top members by XP. /leaderboard-live posts one that updates by itself.

How often a live leaderboard updates, and starting over

Every 12 hours at first. Change it under Settings, Leaderboards.

The server owner can start everyone's Discord XP from 0 at the end of Ranks & XP, Award XP.

A web page for your server

A small page at your own address: the leaderboard, a Join our Discord button, and more. Free, and off until you switch it on.

How to switch it on
  1. On the website open Leaderboards, then Leaderboard web page.
  2. Switch on Show the web page and choose a page name, like vv-bot.com/top/your-server.
  3. Paste an invite that never runs out, or press Let VV-Bot make the Join link. VV-Bot makes it once; visits never make new ones.
  4. Under What the page shows, tick the parts you want: the Minecraft address with a Copy button, who plays now, players in the last 7 days, vote links, your rules and the leaderboards. The address shows only once you tick it.
  5. Press Save the web page. Leaderboards VV-Bot posts in Discord now get a button to it.
What it shows, and members' privacy
  • Each member's name and picture as Discord shows them in your server, their level and their XP. Never a Discord id. Members who left are not shown.
  • Any member can hide themselves with /leaderboard-hide, and show up again with /leaderboard-hide undo:True. Inside Discord, /leaderboard still lists them.
  • Search engines are asked not to list the page, unless you switch on Let search engines list it.
  • The page is at most a few minutes old. A server with Minecraft also gets a Minecraft XP tab.
  • Each page name belongs to one server. Changing it stops the old address at once. Switching the page off keeps the name yours.