Skip to content

Discord leveling bot

XP, levels and role rewards for your server.

Members earn XP for chatting and talking in voice. When they level up, your bot posts it and gives them the role for that level. Leaderboards show who's on top this week, this month and of all time. It's all set up on one page in BotGhost, the no-code Discord bot maker.

Every feature is free on every bot, from voice XP to rank cards.

How members earn XP for messages and voice

Chatting and voice are on from the start. Everything else is a switch on the XP tab, with its own amount.

  • Chatting15 to 25 XP, once a minuteXP from messages, on to start with. Pick the amounts and how long between.
  • Talking in voice10 XP a minuteXP from voice, on to start with. Only with other people, never alone, deafened or in the AFK channel.
  • A longer message25% more over 200 charactersLonger messages earn more. Spaces, emoji, mentions and links don't count.
  • A picture or file5 XP extraPictures and files earn extra, for a picture, video or file.
  • A reply5 XP extraReplies earn extra, for replying to someone else's message.
  • The first message of the day50 XP extraFirst message of the day bonus, in your server's time zone.
  • Reactions on their message3 XP a reactionReactions on their messages, once per person per message.
  • A new forum post25 XPNew forum posts, at most once every 10 minutes.
  • Boosting the server500 XPBoosting the server, once per boost.
  • A live server eventx2 voice XPLive server events: voice XP is multiplied in the event's channel while it's live.
  • Sharing their screenNo bonus until you set oneStreaming bonus. x2 doubles their voice XP while they share their screen.
  • Listening on a stageOff to start withStage audience earns XP. Muted members earn voice XP unless you switch that off.

What earns nothing

  • Messages shorter than 3 characters. Emoji, mentions and links don't count.
  • The same message twice in a row.
  • Only a picture or a link, with no words of its own.
  • Commands: messages starting with ! ? . or /
  • Anything past the daily cap, if you set one (5,000 XP from messages, 600 minutes of voice).
  • The channels and roles you switch off, and other bots unless you let them earn.

Pick the channels that earn XP (every channel except some, or only some) and the roles that never earn it. Threads and forum posts follow their channel.

XP multipliers, double XP events and streaks

Give some members, channels or hours more XP. Each multiplier is a row on the XP tab.

  • Roles and channels. Supporters earn x1.5, your events channel x2. A thread uses its own row, then its channel's, then the category's.
  • Server boosters earn more while they boost.
  • Time windows in your server's time zone, like double XP every Saturday and Sunday. Up to 20.
  • Double XP events from the XP tab, or staff run /xp boost 2 3h. Up to 30 days.
  • How they add up: use the highest, multiply them, or add them up, never past your cap (x5 to start with). A Supporter on a x2 weekend gets x2, x3 or x2.5.
  • Daily streaks add 2% more XP for each day in a row, up to 30%. Missing a day starts it again, and days 7, 30 and 100 get a post.
The post when Tom runs /xp boost 2 3h, and a streak post. Both messages can be changed with the Message Builder.

Level roles, rewards and perks

Give each level something to aim for, on the Levels and rewards tab. Members see it all with /level rewards.

  • Role rewards for any level, up to 100 levels. Members keep every role they earn, or only the newest.
  • Taken back and given back. Roles come off if their level drops, and come back when they rejoin.
  • Coins and other numbers. Pay coins on every level up, or add to any number your bot keeps for members, like gems or tickets.
  • Written perks, like picture permissions, listed beside the roles. Up to 10 a level.
  • Every level from a level on. Level 51 and every level after can pay 100 * (level - 50) coins.
  • Prestige. At level 100, members can run /prestige to start again from level 0 for a prestige, 5% more XP each time, and a prestige role if you set one.
/level rewards ticks what a member already has.

How fast levels come

Pick a curve, or write your own. Changing it later never changes anyone's XP, only the level it reaches.

  • Classic
  • Gentle
  • Steep
  • Same every level
  • Your own numbers
  • Your own table

Set a highest level if you want one. Past it, XP keeps counting for the leaderboards.

The Classic curve

LevelTotal XPSteady chatting
11005 minutes
51,15058 minutes
104,6754 hours
2542,00035 hours
50268,375224 hours
1001.9M1,583 hours

At 15 to 25 XP a message, once a minute.

Level-up messages and level-up cards

Your bot can put a card under each level-up message. Pick one of 16 level-up designs from the Card Studio, or edit one. The card starts off.

  • Where they go

    Where they chatted, a level-up channel, their DMs, or nowhere. Members still get their rewards when nothing is posted.

  • When to announce

    Every level, reward levels only, or every few levels. Delete them after a while if you like, up to an hour.

  • Random and milestone messages

    Four more messages to pick from at random, and five milestone messages for the levels you choose.

A level-up message pings only the member who levelled up, and members who'd rather not be pinged run /level quiet.

Discord rank cards for /rank

/rank shows a member's level, rank, XP and streak on a card, with the details under it. It starts on.

  • 8 rank card designs in the Card Studio, from a glass card to an arcade screen and a tall one for phones. Edit any of them.
  • Members' own style. From level 5, members pick their colour and background with /level style, from the ones you allow.
  • Double XP events show on the card while they run.
Arcade rank card: Player 1, Fabian, level 25, rank 3, an XP bar at 51%, 12,804 messages, 48h 15m in voice, a 14 day streak, 610 XP to level 26.
Tall rank card for phones: Fabian, top 2% of Ghost Hangout, level 25, rank 3, streak 14, 640 of 1,250 XP, 610 XP to level 26.
Two more rank card designs: Rank, arcade and Rank, phone. The card above /rank is Rank, glass.

Leaderboards for the week, the month and the season

/level top shows the top members on a card, with buttons for each board and page. /level climbers shows who gained the most this week.

  • All time, this week, this month and a season with its own name and dates. Each starts again on its own schedule, and All time never resets.
  • A winners post before a board starts again, with a role for the top 1 or top 3 until next time.
  • A hall of fame. Each week's winners and each season's top ten are kept, for the Hall of fame page on your bot's BotPanel website (it needs BotPanel Plus).
  • XP decay, off to start with. Members quiet for 30 days lose 5% of their XP each week, so the board shows who is active now.
  • 15 leaderboard designs in the Card Studio for /level top and the winners post.
/level top with the Leaderboard, winners design.

Leveling commands for members and staff

Switching Leveling on adds these commands. Each one can be switched off on its own.

  • For members: /rank, /level top, /level climbers, /level rewards, /level quiet, /level style and /prestige.
  • /xp give, take and set change the XP of a member, or of everyone with a role. Staff need Manage Server.
  • /xp reset asks first, then clears a member's XP. /xp boost starts a double XP event, and /xp boost 1 ends it.
  • /level sync puts everyone's reward roles right after you change the rewards.
  • The Members tab in your dashboard: find anyone and change their XP, export a CSV, undo from backups kept 30 days, or reset a server.
Staff get a private answer when they change someone's XP.

Every Leveling setting in the dashboard

Leveling has one page in your dashboard: six tabs, then its commands and events. A live preview beside the tabs shows the messages as you change them. You set it up server by server, from the server menu at the top.

How members earn XP

A random amount for chatting, minutes in voice with other people, reactions, forum posts and boosts. Spam is checked first, so it costs nothing, and multipliers, double XP events and streaks sit on top.

An XP boost started with /xp boost.
XP from messages: 15 to 25 XP once every minute, XP in threads and forum posts on, and switches for longer messages, pictures and files, replies and the first message of the day
What earns nothing: messages shorter than 3 characters, the same message again, only a picture or a link, command prefixes and the daily cap
XP from voice: 10 XP a minute with at least 1 other person, muted members, stage audience, a streaming bonus and a daily voice cap
More ways to earn: 3 XP a reaction, 25 XP a new forum post, 500 XP a boost, a x2 bonus during live server events, and Remove XP when members leave
Role multipliers with Supporter at x1.5, channel multipliers, and server boosters at x1

Messages

From, To and Once every
15 to 25 XP at most once a minute to start with.
XP in threads and forum posts
Off means messages in threads and forum posts earn nothing.
Longer messages, pictures and files, replies
Each can earn a bonus on top.
First message of the day bonus
Their first message that earns XP each day, in the server's time zone.

What earns nothing

Messages shorter than
Emoji, mentions and links don't count. 0 lets any message earn.
The same message again, only a picture or a link
Sending the same words twice earns XP once, and a message needs words of its own.
Commands
Messages starting with the characters you list.
Daily cap
The most XP a member can earn from messages in a day.

Voice and more

XP from voice
Counted in minutes spent with other people. The AFK channel and deafened members never count.
Reactions, forum posts and boosts
Each has its own amount. A boost pays every time someone boosts.
Bots earn XP
Off to start: other bots never earn XP unless you switch it on.
Channels and roles that earn nothing
Every channel except some, or only some. Threads follow their channel.

Multipliers

Roles, channels and server boosters
Members with the role, in the channel or boosting earn this many times the XP.
Time windows
Double XP at weekends, or any hours you pick, in the server's time zone.
Double XP event
Start one from the page, or staff run /xp boost with a multiplier and a time.
How multipliers add up
Use the highest, multiply them or add them up, never more than x5 to start.
Daily streaks
A bonus for each day in a row a member chats, 2% a day up to 30% to start.

Under the tabs: the commands and events

Leveling adds /rank, /level, /xp and /prestige, and the events it runs on. They are made of ordinary builder blocks, so you can open them in the builder and add your own.

The Leveling commands: /rank, /level with 6 subcommands, /xp with 5 subcommands and /prestige, each with Settings and a switch
The Leveling events, each with Open in builder and a switch: Message Sent, Give XP, Settle Level and Level Up

Commands

/rank and /prestige
For everyone: your level and rank, or start again for a prestige.
/level top, climbers, rewards, quiet and style
For everyone: the boards, the week's climbers, the rewards, pings and your card's style.
/xp give, take, set, reset and boost, /level sync
For staff.

Events

Message Sent, voice, reactions, forum posts and boosts
Every way to earn runs Give XP: the multipliers, the caps, the streak and every board.
Settle Level, Level Up and Level Down
Works out the level, then the perks, the roles and the level-up message.
Hourly and Voice Tick
The resets with their winners, decay, the end of a boost, and long voice sessions.

Leveling leaderboards on your bot's website

With a BotPanel website for your bot, members can check the leaderboards, their rank and the rewards on the web.

The website pages need BotPanel Plus
  • Leaderboards

    Each server's top members, for XP and any number your bot keeps for members, like coins or wins. As many boards as you like.

  • My rank

    Members sign in and see their place on every board, with their rank card.

  • Climbers

    Who gained the most this week, on each board.

  • Hall of fame

    Each board's top three when its week or month ends.

  • Server activity

    Each board's total per day for 30 days, and the busiest channels.

  • Rewards

    Every level's roles and perks, ticked for what a signed in member has.

  • Member profiles

    Click a name to see that member on every board. Members can hide themselves.

Server admins change Leveling there

They sign in with Discord on the website's server dashboard and change Leveling for their own server. Card designs, members' XP, server resets and double XP events stay in your BotGhost dashboard.

  • XP from messages
  • XP from voice
  • More ways to earn
  • Where XP is off
  • How fast levels come
  • What each level gives
  • Coins on level up
  • Multipliers
  • Daily streaks
  • Level-ups
  • Leaderboards
  • Prestige
  • XP decay
  • Rank cards
  • Messages

Leveling itself is free in Discord. The website pages follow the normal BotPanel plans.

Set up a leveling bot on Discord

Haven't got a bot in your server yet? Start with how to make a Discord bot, then come back here.

  1. 1Open Leveling from Modules in your dashboard and switch it on, then pick your server in the menu at the top right.
  2. 2On the Level-ups tab, pick where level-up messages go.
  3. 3On the Levels and rewards tab, add a role to a level. Press Save Changes.
  4. 4In Discord, move your bot's role above the reward roles, so it can give them.
  5. 5Try it: send a few messages, then run /rank to see your card.

Using the old Leveling? The new page offers Move my settings and XP, and everyone keeps their level.

Post the perks list from the Levels and rewards tab. Press it again after a change, and the same post is edited.

A free Discord leveling bot

Every Leveling feature works on the free plan, voice XP and cards included. There's nothing to unlock, only the limits below, which are the same on every bot. What Premium changes for the rest of your bot is on the free and Premium plans page.

Free

$0
  • XP for messages, voice, reactions, forum posts, boosts and events
  • Multipliers, time windows, double XP events and daily streaks
  • Role rewards, coins, level perks and prestige
  • Level-up cards, rank cards, every leaderboard and the winners post
  • Leveling's commands, events and saved XP don't use up your free limits

On free bots, a small Made with BotGhost line shows under the messages about one time in three.

The limits

in each server
Levels with rewards
Up to 100
Role and channel multipliers
Up to 50 each
Time windows
Up to 20
A multiplier
Up to x100
A double XP event
Up to 30 days
One /xp change
Up to 1,000,000 XP
Backups
Kept 30 days

Premium ($12.50 a month for one bot) takes the Made with BotGhost line off and adds unlimited commands, events, and servers. Free bots go offline after 2 days with no activity. Read about free hosting

Leveling is made of ordinary builder blocks. Open any of its events or commands in the builder and add your own blocks, the way you build Discord bot events. Your own blocks under Level Up are kept when Leveling updates.

Discord leveling bot questions

Didn't find your question? Ask us in the BotGhost Discord, or read the Leveling docs.

Yes. Every Leveling feature is free on BotGhost: XP for messages and voice, multipliers and double XP, role rewards and level perks, level-up cards, rank cards, every leaderboard, prestige and the staff commands. Leveling's commands, events and saved XP don't count toward your free limits.

Leveling on the free plan

Give your members levels to reach

Switch on Leveling, add a role reward, and members start earning XP. The free plan doesn't need a card.

Set up Leveling for free