balqis

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
  • choice optional 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
  • user optional member whose card (empty: yours)
  • view optional 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
  • member needed member the member
  • amount needed number how much xp
  • reason optional 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
  • member needed member the member
  • amount needed number how much xp
  • reason optional 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
  • member needed member the member
  • amount needed number how much xp
  • reason optional 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
  • member needed member the member
  • reason optional 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
  • level needed number the level that gives the role
  • role needed role the reward role
  • give optional 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
  • mode needed text stack or replace pick: stack, replace
  • give optional 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
  • role needed 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
  • multiplier needed 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, x5
  • role optional role a role (pick one of: role, channel, server-boosters)
  • channel optional channel a channel, thread or category
  • server-boosters optional 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
  • role optional role a role (pick one of: role, channel, server-boosters)
  • channel optional channel a channel, thread or category
  • server-boosters optional 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
  • file optional file a .csv file: user id, level (or user id, xp). up to 50,000 lines
  • values optional 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 import here is asked first: add xp too or numbers only. /activity undo takes the xp back. streaks do not use these numbers. server owner only.
example
/activity set member:@merul messages:5000 voice:40
options
  • member needed member the member
  • messages optional number their messages in total now (empty: keep)
  • voice optional number their voice hours in total now, like 12.5 (empty: keep)
  • global optional 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 import here can get numbers only. leave the file empty to see the format. server owner only.
example
/activity file
options
  • file optional 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 set or 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
  • messages needed number your messages in total, all servers together
  • voice needed number your voice hours in total, all servers together (like 12.5)
  • picture1 needed file a screenshot: a discord search count or another bot's profile
  • picture2 optional 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
  • board optional 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 session
  • time optional text which time (empty: this week) pick: this hour, today, this week, this month, all time
  • where optional 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
  • choice optional 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
  • channel optional channel where the panel goes
  • channel-id optional 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
  • panel needed 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
  • panel needed 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.

add to server