levels and leaderboards
levels and xp, and the top members by messages, voice, streaks and more
levels: where activity is on (/setup activity, on by default), balqis gives xp for messages (a reply is a message) and for time in active voice. reactions give xp only when staff turn it on in /level settings. xp gives levels./level card shows your level card: level, xp, rank, messages and voice time. view:global shows your global card for every server. /level design makes the card yours, /level privacy hides parts of your global card./level settings (staff) turns levels on, picks the speed and the difficulty, and says where the level up message goes. /level reward add gives a role at a level. /level booster add gives more or less xp for a role, a channel or the server boosters. /level xp add, remove, set and reset change the xp of one member.
from before balqis: /level import brings old levels in, and /activity set and /activity file bring old messages and voice hours in (the server owner).
leaderboards: /top show opens a leaderboard: level, messages, voice, active voice, streaks, pair streaks, counting, boosts, invites, lucky or sponsors (this week, this month or all time).
lucky (most giveaway wins) and sponsors (most giveaways sponsored, with the total value) come from /giveaway: staff can make them staff only or turn them off in /giveaway settings, leaderboards.
pick the time: this hour, today, this week, this month or all time. today, week and month start at midnight in the server time zone of /streak settings.
where: global shows every server with balqis (the top 100). /top hide takes you off every global board; server boards stay the same.
the level card has a leaderboard button too. find me jumps to your own place. picture shows the page as a picture with avatars, list goes back./top panel create posts a live panel with up to 3 boards, as a list or a picture: it updates by itself, and see the full board opens the whole list (3 panels free, 15 with premium)./top week posts member of the week and staff of the week every monday, with a reward role for 7 days if you want one./top look picks the look of the pictures: look a is free, look b, own designs and own staff points are premium.shop boards: /top show also has top buyers (who spent the most) and top stores (the stores with the most done and paid orders, with their stars). the server owner picks who sees them (everyone, staff only or off) and if the amounts show, in /setup shop, boards. top stores is for everyone by default, top buyers for staff only. a buyer can hide themselves from top buyers with the button on /shop spend view.
tip: /counting settings global:no shows your server as a private server on the global counting board.
- 30 commands
- live leaderboard panels: 3 free, 15 with premium
playground
level up and climb the board
merul chats and levels up. look at the level card, open the leaderboard, then make a live panel.
# general
merultoday
anyone up for a game tonight?
merultoday
i just finished all my homework
merultoday
good morning everyone!
balqisapptoday
level up
merul reached level 5.
balqisapptoday
merul /level card
level card
merul
rank #2 · 1,490 xp total
level 5 · 340 / 475 xp
next: @regular at level 10 · balqis server · 1,204 messages · 18h in voice
a pretend card. the real one is drawn by balqis.
balqisapptoday
only you can see this
leaderboard
board: level
time: this week
where: this server
1. shun · level 8 · 3,100 xp
2. merul · level 5 · 1,490 xp
3. atid · level 4 · 1,020 xp
4. pyqa · level 3 · 600 xp
5. wafi · level 2 · 310 xp
you: #2 · level 5 · 1,490 xp
# leaderboard
balqisapptoday
shun /top panel create
leaderboard
level · this week · this server
1. shun · level 8 · 3,100 xp
2. merul · level 5 · 1,490 xp
3. atid · level 4 · 1,020 xp
updates every 10 minutes · last change today
merul chats in #general. balqis counts every message, reply, reaction and voice minute. press the event.
activity
levels, streaks and boards all start here.
/setup activityturn activity counting on or off (messages, replies, reactions, voice time)show more
/setup activity [choice]
- how
- turns activity counting on or off for the server: messages, replies, reactions and voice time. levels, streaks and the leaderboards all need it. it is on by default.
- example
/setup activity choice:yes- options
choiceoptional yes or no yes: count activity here. no: count nothing (empty: show the current state)
- who
- staff who can change the server settings
level cards
your level, your global card, and make it yours.
/level cardyour level card: level, xp, rank, messages and voice time in this servershow more
/level card [user] [view]
- how
- shows a level card: level, xp, rank, messages and voice time in this server. leave user empty to see yourself. view:global shows balqis' own numbers for every server. there is a leaderboard button under it.
- example
/level card user:@merul- options
useroptional member whose card (empty: yours)viewoptional text server: this server (empty). global: the numbers of all servers together pick: server, global
- who
- everyone in the server
/level designyour own card: background picture, filter, panel and colorsshow more
/level design
- how
- makes your own card: a background picture, a filter, the panel and the colors. a preview comes first, and nothing counts until you press save. there is a short wait between changes.
- example
/level design- options
no options, just run it.
- who
- everyone in the server
/level privacyhide parts of your global card from other peopleshow more
/level privacy
- how
- hides parts of your global card from other people: messages, voice hours, level and xp. you always see all of your own card. the card of a server is never hidden.
- example
/level privacy- options
no options, just run it.
- who
- everyone in the server
level settings and xp
speed, difficulty, and the xp of one member.
/level settingsturn levels on, pick the speed, the difficulty and the level up messageshow more
/level settings
- how
- one page for staff: turn levels on or off, pick the speed and the difficulty, voice xp and reaction xp, and where the level up message goes (the same channel, a level channel, a dm or off). edit design changes the level up message. pictures turns member pictures on or off. reset on leave clears the xp of members who left.
- example
/level settings- options
no options, just run it.
- who
- staff who can change the server settings
/level xp addgive a member xpshow more
/level xp add <member> <amount> [reason]
- how
- gives a member xp. the reward roles follow the new level, quietly, and the levels log posts it.
- example
/level xp add member:@merul amount:200 reason:event winner- options
memberneeded member the memberamountneeded number how much xpreasonoptional text why (default: no reason given)
- who
- staff who can change the server settings
/level xp removetake xp from a membershow more
/level xp remove <member> <amount> [reason]
- how
- takes xp from a member. the reward roles follow the new level, quietly.
- example
/level xp remove member:@wafi amount:50 reason:spam- options
memberneeded member the memberamountneeded number how much xpreasonoptional text why (default: no reason given)
- who
- staff who can change the server settings
/level xp setset the xp of a member to a numbershow more
/level xp set <member> <amount> [reason]
- how
- sets the xp of a member to a number.
- example
/level xp set member:@pyqa amount:1000- options
memberneeded member the memberamountneeded number how much xpreasonoptional text why (default: no reason given)
- who
- staff who can change the server settings
/level xp resetput one member back to 0 xpshow more
/level xp reset <member> [reason]
- how
- puts one member back to 0 xp.
- example
/level xp reset member:@wafi reason:fresh start- options
memberneeded member the memberreasonoptional text why (default: no reason given)
- who
- staff who can change the server settings
reward roles
give a role when a member reaches a level.
/level reward addgive a role at a levelshow more
/level reward add <level> <role> [give]
- how
- gives a role when a member reaches a level. one role per level, up to 25 rewards. give:yes also gives it now to the members who already have the level.
- example
/level reward add level:10 role:@regular give:yes- options
levelneeded number the level that gives the roleroleneeded role the reward rolegiveoptional yes or no yes: give it now to members who already have the level (empty: no, from their next level up)
- who
- staff who can change the server settings
- balqis needs
- manage roles
/level reward modekeep every reward role (stack) or only the highest one (replace)show more
/level reward mode <mode> [give]
- how
- keep every reward role (stack) or only the highest one (replace).
- example
/level reward mode mode:stack- options
modeneeded text stack or replace pick: stack, replacegiveoptional yes or no yes: fix the roles of members now (empty: no, from their next level up)
- who
- staff who can change the server settings
- balqis needs
- manage roles
/level reward removestop giving a reward role (members keep it)show more
/level reward remove <role>
- how
- stops giving a role as a reward. members who have it keep it.
- example
/level reward remove role:@regular- options
roleneeded role the reward role
- who
- staff who can change the server settings
/level rewardsthe reward roles of this server and the level that gives each oneshow more
/level rewards
- how
- the reward roles of this server and the level that gives each one. staff also see why a reward could not be given.
- example
/level rewards- options
no options, just run it.
- who
- everyone in the server
xp boosters
more or less xp for a role, a channel or boosters.
/level booster addmore or less xp for a role, the server boosters or a channelshow more
/level booster add <multiplier> [role] [channel] [server-boosters]
- how
- more or less xp for a role, a channel or the server boosters: a multiplier from x0 to x5. boosters change the xp of this server only, never the global xp.
- example
/level booster add multiplier:x2 role:@supporter- options
multiplierneeded text x0 = no xp, x1 = normal, x2 = double pick: x0, x0.25, x0.5, x0.75, x1, x1.25, x1.5, x1.75, x2, x2.25, x2.5, x2.75, x3, x3.25, x3.5, x3.75, x4, x4.25, x4.5, x4.75, x5roleoptional role a role (pick one of: role, channel, server-boosters)channeloptional channel a channel, thread or categoryserver-boostersoptional yes or no yes: the members who boost this server
- who
- staff who can change the server settings
/level booster listthe xp boosters of this servershow more
/level booster list
- how
- the xp boosters of this server.
- example
/level booster list- options
no options, just run it.
- who
- staff who can change the server settings
/level booster removeremove an xp boostershow more
/level booster remove [role] [channel] [server-boosters]
- how
- removes an xp booster.
- example
/level booster remove role:@supporter- options
roleoptional role a role (pick one of: role, channel, server-boosters)channeloptional channel a channel, thread or categoryserver-boostersoptional yes or no yes: the booster of the members who boost this server
- who
- staff who can change the server settings
bring old levels in
levels from another bot or a .csv, with an undo.
/level import rolesimport levels from the reward roles members have now (a preview first)show more
/level import roles
- how
- imports levels from the reward roles members have now: a member with an old level role gets that level. a preview comes first, and nothing is saved until you agree. server owner only.
- example
/level import roles- options
no options, just run it.
- who
- the server owner
/level import fileimport levels or xp from a .csv file (empty: see the format and an example file)show more
/level import file [file] [values]
- how
- imports levels or xp from a .csv (user id and level, or user id and xp). a preview comes first. leave the file empty to see the format and an example file. turn off the level roles of your old bot first, so two bots do not fight over roles. server owner only.
- example
/level import file values:level- options
fileoptional file a .csv file: user id, level (or user id, xp). up to 50,000 linesvaluesoptional text what the numbers are (empty: the first line says, else level) pick: level, xp
- who
- the server owner
/level import undoundo the newest level import (within 7 days; xp earned since stays)show more
/level import undo
- how
- undoes the newest level import, within 7 days. xp earned since then stays. server owner only.
- example
/level import undo- options
no options, just run it.
- who
- the server owner
numbers from before balqis
old messages and voice hours for the all-time numbers.
/activity setset the messages and voice hours a member had before balqis (server owner)show more
/activity set <member> [messages] [voice] [global]
- how
- sets the messages and voice hours a member had before balqis. they add to the all-time numbers (the level card and the all-time boards), never to daily, weekly or monthly lists. balqis also gives xp once for what you add: a quarter of the normal xp per message and 3 of 5 of the normal voice xp per voice minute, with no boosters. there is no xp when levels are off, and no voice xp when voice xp is off. a member who got a
/level importhere is asked first: add xp too or numbers only./activity undotakes the xp back. streaks do not use these numbers. server owner only. - example
/activity set member:@merul messages:5000 voice:40- options
memberneeded member the membermessagesoptional number their messages in total now (empty: keep)voiceoptional number their voice hours in total now, like 12.5 (empty: keep)globaloptional yes or no yes: also your global card (only the owner of balqis, for themselves)
- who
- the server owner
/activity fileset numbers from before balqis for many members with a .csv (empty: see the format)show more
/activity file [file]
- how
- sets old messages and voice hours for many members with a .csv (user id, messages, voice hours). a preview comes first. like
/activity set, it also gives xp once, and members who got a/level importhere can get numbers only. leave the file empty to see the format. server owner only. - example
/activity file- options
fileoptional file a .csv file: user id, messages, voice hours. up to 50,000 lines
- who
- the server owner
/activity undoundo the newest /activity set or file (within 7 days)show more
/activity undo
- how
- undoes the newest
/activity setor file, within 7 days. server owner only. - example
/activity undo- options
no options, just run it.
- who
- the server owner
/activity claimask for your old messages and voice hours on your global card (home server)show more
/activity claim <messages> <voice> <picture1> [picture2]
- how
- only in the balqis home server: ask for the messages and voice hours you had before, on your global card. send the numbers and 1 or 2 pictures as proof. the owner of balqis approves or says no. in other servers it shows a friendly card.
- example
/activity claim messages:12000 voice:80- options
messagesneeded number your messages in total, all servers togethervoiceneeded number your voice hours in total, all servers together (like 12.5)picture1needed file a screenshot: a discord search count or another bot's profilepicture2optional file a second screenshot (optional)
- who
- everyone in the server
leaderboards
the top members, this server or every server.
/top showa leaderboard: level, messages, voice, rooms, streaks, counting, invites and moreshow more
/top show [board] [time] [where]
- how
- opens a leaderboard: level, messages, voice, active voice, streaks, pair streaks, counting, boosts, invites, lucky (most giveaway wins) or sponsors (most giveaways sponsored, with the total value). pick the time (this hour, today, this week, this month or all time) and where (this server or every server). find me jumps to your own place. picture shows the page as a picture. lucky and sponsors can be staff only or off:
/giveaway settings, leaderboards. top buyers and top stores show the shop: the server owner picks who sees them in/setup shop, boards. most used rooms (permanent and server voice rooms) and longest session (every room) are for this server only: the server owner picks who sees them in/voice settings. - example
/top show board:level time:this week where:server- options
boardoptional text which board (empty: level) pick: level, messages, voice, active voice, streak, best streak, pair streak, counting, boosts, invites, lucky, sponsors, most used rooms, longest sessiontimeoptional text which time (empty: this week) pick: this hour, today, this week, this month, all timewhereoptional text server: this server (empty). global: every server with balqis pick: server, global
- who
- everyone in the server
/top hidehide yourself from every global leaderboard (server boards stay the same)show more
/top hide [choice]
- how
- hides you from every global leaderboard. the boards of a server stay the same.
- example
/top hide choice:yes- options
choiceoptional yes or no yes: hide me on the global boards. no: show me again
- who
- everyone in the server
/top lookthe look of leaderboard pictures in this server, and own designs for panels and winner postsshow more
/top look
- how
- the look of the leaderboard pictures in this server. look a is free. look b, own designs and own staff points are premium.
- example
/top look- options
no options, just run it.
- who
- staff who can change the server settings
live panels
a leaderboard that updates by itself.
/top panel createmake a live leaderboard panel that updates by itselfshow more
/top panel create [channel] [channel-id]
- how
- posts a live panel with up to 3 boards, as a list or a picture. a page opens first: pick the boards and the names, then press post. the panel updates by itself, and see the full board opens the whole list.
- example
/top panel create channel:#leaderboard- options
channeloptional channel where the panel goeschannel-idoptional text or paste a channel or thread id (for archived threads)
- who
- staff who can change the server settings
- balqis needs
- view channel, send messages, send messages in threads, read message history, embed links
/top panel editchange the boards, names or winners message of a live leaderboard panelshow more
/top panel edit <panel>
- how
- changes the boards, the names or the winners message of a live panel. the posted panel changes at once.
- example
/top panel edit panel:1- options
panelneeded text the leaderboard panel
- who
- staff who can change the server settings
- balqis needs
- view channel, send messages, send messages in threads, read message history, embed links
/top panel deletedelete a live leaderboard panel and its messageshow more
/top panel delete <panel>
- how
- deletes a live panel and its message.
- example
/top panel delete panel:1- options
panelneeded text the leaderboard panel
- who
- staff who can change the server settings
top of the week
member of the week and staff of the week.
/top weekmember of the week and staff of the week: channels, reward roles and what countsshow more
/top week
- how
- member of the week and staff of the week: pick the channels, the reward roles (they last 7 days) and what counts. balqis posts the winners every monday.
- example
/top week- options
no options, just run it.
- who
- staff who can change the server settings
- balqis needs
- view channel, send messages, send messages in threads, embed links, attach files
who is on top?
add balqis to your server, then run /level card to see your level and /top show to see the board.