balqis

invites

who invited who, and how many invites a member has

balqis works out who invited each new member. tracking is on by default, and it needs manage server.
total = real + imported + bonus. real: joined with your link, still here, not fake, first time in this server. left: they left later. fake: a very new account, or a join with their own link. rejoin: they were here before. they give no new invite: if they had left, the first person who invited them gets that invite back, however they came back, and the person whose link they used only gets rejoin +1. a person can only ever give one invite per server.
the vanity link, unknown joins and bots count for nobody.
/invites show: a member's numbers, who invited them, their rank.
/invites list: the people they invited.
/invites links: their links that still work. another person's links need the invites ability.
/invites settings: tracking, fake account age (default 7 days), and the invite lines in the members log.
the log type invites shows links made and deleted. pick a channel with /log add. it is not in the "all" channels by default.
old numbers from before balqis: /invites set (one member, it replaces the old number), /invites file (a .csv) and /invites start (one time, adds up the links the server has now, not exact). /invites undo brings the old numbers back within 7 days. /invites bonus adds or takes away, with a reason in the log. these need the invites ability.
/top show board:invites is the leaderboard: all time is the total, week and month only count real invites. welcome and goodbye designs have placeholders for who invited them (see design syntax in /help). /greet welcome set -> more -> show who invited puts one line on the balqis card. /invites settings -> ping inviter also pings them in the welcome post. never a dm.
/invites role add gives a role at a number of invites, using the total. /invites role mode: stack or replace, and keep roles (they stay when the count drops). it changes about 30 seconds after the count, never with a dm.

  • 13 commands

playground

who invited who

atid shares a link and friends join. see who invited them, count the invites and give a role.

# general

atidtoday

join us! my invite link: discord.gg/balqis

pyqa joined the server.

balqisapptoday

shun /invites show

invites

member: mlynaryna 642559061493022772

total: 1

real: 1

left: 0

fake: 0

rejoin: 0

imported: 0

bonus: 0

invited by: before balqis

rank: 1

# members-log

balqisapptoday

member joined

member: taeraexlovr 611188907744296999

how: invited by atid

first time here (that balqis saw).

4 more friends joined the server.

balqisapptoday

invite roles

member: mlynaryna 642559061493022772

got: @recruiter

atid shares an invite link. press the event: pyqa joins with it.

the numbers

who invited who, and how many invites a member has.

/invites showhow many invites a member has, and who invited themshow more

/invites show [member]

how
how many invites a member has: total, real, left, fake, rejoin, imported and bonus, who invited them, and their rank. leave member empty to see yourself. total = real + imported + bonus.
example
/invites show member:@atid
options
  • member optional member the member (empty: you)
who
everyone in the server
/invites listthe people a member invited: still here, left or fakeshow more

/invites list [member]

how
the people a member invited: still here, left or fake.
example
/invites list member:@atid
options
  • member optional member the member (empty: you)
who
everyone in the server

settings

tracking, fake accounts and the members log.

/invites settingsinvite tracking on or off, the fake account age and the members log linesshow more

/invites settings

how
one page: invite tracking on or off, the fake account age (7 days by default), the invite lines in the members log, and ping inviter (the welcome post also pings who invited the member). tracking needs manage server for balqis.
example
/invites settings
options

no options, just run it.

who
staff who can change the server settings

numbers from before balqis

bring old invites in, or give a bonus. needs the invites ability.

/invites setset the invites a member had before balqis (replaces the old number)show more

/invites set <member> <number>

how
sets the invites a member had before balqis. the number replaces the old imported number, it never adds on top. you can undo it for 7 days.
example
/invites set member:@atid number:12
options
  • member needed member the member
  • number needed number their imported invites, 0 to 1,000,000
who
anyone with the invites ability (the senior preset and up), or the administrator permission when the server set no access rules
/invites fileset imported invites for many members with a .csv (empty: see the format)show more

/invites file [file]

how
sets imported invites for many members with a .csv: user_id,invites. a preview comes first, and nothing changes until you press the button. leave the file empty to see the format.
example
/invites file
options
  • file optional file a .csv file: user_id,invites. up to 50,000 lines
who
anyone with the invites ability (the senior preset and up), or the administrator permission when the server set no access rules
/invites startone time: imported invites from the uses of the links this server has now (not exact)show more

/invites start

how
one time: imports invites from the uses of the links the server has now. it is not exact: deleted links are gone, so they cannot count. a preview comes first.
example
/invites start
options

no options, just run it.

who
anyone with the invites ability (the senior preset and up), or the administrator permission when the server set no access rules
/invites undoundo the newest /invites set, file or start (within 7 days)show more

/invites undo

how
brings the old numbers back after /invites set, file or start, within 7 days. bonus does not change.
example
/invites undo
options

no options, just run it.

who
anyone with the invites ability (the senior preset and up), or the administrator permission when the server set no access rules
/invites bonusadd bonus invites to a member, or take them away with a negative numbershow more

/invites bonus <member> <number> <reason>

how
adds bonus invites to a member, or takes them away with a negative number. the reason shows in the log. there is no undo: to fix a mistake, give the opposite number.
example
/invites bonus member:@atid number:3 reason:helped with an event
options
  • member needed member the member
  • number needed number how many to add. negative takes away. not 0
  • reason needed text why. it shows only in the invites log
who
anyone with the invites ability (the senior preset and up), or the administrator permission when the server set no access rules

invite roles

give a role at a number of invites.

/invites role addgive a role at a number of invitesshow more

/invites role add <number> <role> [give]

how
gives a role at a number of invites (the total). members get it at their next change of invites, and give:yes also gives it now to members who already reach it.
example
/invites role add number:5 role:@recruiter give:yes
options
  • number needed number the invites that give the role
  • role needed role the role
  • give optional yes or no yes: give it now to members who already reach it (empty: no, at their next change)
who
staff who can change the server settings
balqis needs
manage roles
/invites role listthe roles given for invites, and any problem with themshow more

/invites role list

how
the roles given for invites, and any problem with them.
example
/invites role list
options

no options, just run it.

who
staff who can change the server settings
/invites role modekeep every invite role or only the highest, and keep roles when the count dropsshow more

/invites role mode [mode] [keep]

how
stack keeps every invite role, replace keeps only the highest. keep:yes keeps roles when the count drops. a role changes about 30 seconds after the count.
example
/invites role mode mode:replace keep:yes
options
  • mode optional text stack or replace (empty: keep this setting) pick: stack, replace
  • keep optional yes or no yes: nothing comes off when the count drops (empty: keep this setting)
who
staff who can change the server settings
/invites role removestop giving a role for invites (members who have it keep it)show more

/invites role remove <role>

how
stops giving a role for invites. members who have it keep it.
example
/invites role remove role:@recruiter
options
  • role needed role the role
who
staff who can change the server settings

who brings your friends?

add balqis to your server, then run /invites show to see who invited who.

add to server