balqis

moderation

warn, timeout, kick, ban and undo

warn, timeout, kick and ban each have a user command, like /ban user. every action saves a case and dms the member first (the dm option; empty = the server default).
undo: /warn undo, /timeout undo, /ban undo.
more: /ban soft (ban and unban at once, to delete messages), /ban hard (banned again if someone unbans them), /warn punish add (an action after a number of warns).
tip: balqis refuses the server owner, itself, you, and anyone whose top role is the same as or higher than yours.

  • 21 commands

playground

warn someone

pyqa is spamming. warn them and see what balqis does: the reply, the case and the dm.

# general

pyqatoday

hiiiiii hiiiiii hiiiiii hiiiiii hiiiiii

pyqatoday

hiiiiii hiiiiii hiiiiii hiiiiii hiiiiii

pyqatoday

hiiiiii hiiiiii hiiiiii hiiiiii hiiiiii

balqisapptoday

shun /warn user

member warned

case: 12 · warn

member: taeraexlovr 611188907744296999

reason: spamming

dm: sent

log: #mod-log

@ balqis (pyqa)

balqisapptoday

a moderator took action in balqis server

action: you were warned

reason: spamming

case: 12

case 12 · 611188907744296999

you are the staff. press the command.

warns

a friendly first step.

/warn userwarn a membershow more

/warn user <user> [reason] [proof] [dm]

how
warn a member. balqis dms them first, saves a case and posts the log. warns can do an action by themselves, see /warn punish add.
example
/warn user user:@pyqa reason:spamming
options
  • user needed member the member to warn
  • reason optional text why (default: no reason given)
  • proof optional file screenshot or file, saved in the log
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the warn members ability (the helper preset and up), or the moderate members permission when the server set no access rules
/warn listshow the warns of a member, or who has the most warnsshow more

/warn list [user]

how
the warns of one member, or leave it empty to see who has the most warns.
example
/warn list user:@pyqa
options
  • user optional member a member (leave empty to see everyone)
who
anyone with the warn members ability (the helper preset and up), or the moderate members permission when the server set no access rules
/warn undoundo one warn or all warns of a membershow more

/warn undo <user> <which> [reason] [keep-record] [dm]

how
undo one warn (its case number) or all warns of a member. keep the record to still see it in their history.
example
/warn undo user:@pyqa which:all
options
  • user needed member the member
  • which needed text pick a warn, or all warns
  • reason optional text why (default: no reason given)
  • keep-record optional yes or no keep it in history, not counted (empty: yes)
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the warn members ability (the helper preset and up), or the moderate members permission when the server set no access rules
/warn punish adddo an action automatically when a member reaches a number of warnsshow more

/warn punish add <warns> <action> [duration]

how
an automatic action when a member reaches a number of warns, like a 1 hour timeout at 3 warns.
example
/warn punish add warns:3 action:timeout duration:1h
options
  • warns needed number number of active warns
  • action needed text what to do pick: timeout, jail, kick, ban
  • duration optional text how long, like 30m, 2h or 7d (needed for timeout)
who
staff who can change the server settings
/warn punish listshow the automatic actions for warnsshow more

/warn punish list

how
shows every automatic action for warns.
example
/warn punish list
options

no options, just run it.

who
staff who can change the server settings
/warn punish removeremove the automatic action for a number of warnsshow more

/warn punish remove <warns>

how
removes the automatic action for a number of warns.
example
/warn punish remove warns:3
options
  • warns needed number number of warns of the rule
who
staff who can change the server settings

timeouts

a short break from chatting.

/timeout usertime out a member (up to 28 days)show more

/timeout user <user> <duration> [reason] [proof] [dm]

how
the member cannot write, talk or react for a while (up to 28 days). they get a dm and it is saved as a case.
example
/timeout user user:@wafi duration:1h reason:arguing in general
options
  • user needed member the member
  • duration needed text how long, like 30m, 2h or 7d (max 28d)
  • reason optional text why (default: no reason given)
  • proof optional file screenshot or file, saved in the log
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the timeout members ability (the helper preset and up), or the moderate members permission when the server set no access rules
balqis needs
moderate members
/timeout listshow members who are timed out nowshow more

/timeout list

how
everyone who is timed out right now, and when it ends.
example
/timeout list
options

no options, just run it.

who
anyone with the timeout members ability (the helper preset and up), or the moderate members permission when the server set no access rules
/timeout undoend a timeout earlyshow more

/timeout undo <user> [reason] [dm]

how
ends a timeout early.
example
/timeout undo user:@wafi reason:said sorry
options
  • user needed member the member
  • reason optional text why (default: no reason given)
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the timeout members ability (the helper preset and up), or the moderate members permission when the server set no access rules
balqis needs
moderate members

kick

out, but they can come back.

/kick userkick a member (optional: also delete their recent messages)show more

/kick user <user> [delete] [reason] [proof] [dm]

how
kicks a member out of the server. they can join again with an invite. pick delete to also remove their recent messages.
example
/kick user user:@merul reason:alt account
options
  • user needed member the member to kick
  • delete optional text delete their messages from this long ago (default: none) pick: last 5m, last 10m, last 30m, last 1h, last 6h, last 12h, last 1d, last 3d, last 7d
  • reason optional text why (default: no reason given)
  • proof optional file screenshot or file, saved in the log
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the kick members ability (the mod preset and up), or the kick members permission when the server set no access rules
balqis needs
kick members, ban members

bans

out until someone unbans them.

/ban userban a member, or anyone by user id (optional: delete messages, set a length)show more

/ban user <user> [delete] [duration] [reason] [proof] [dm] [appeal]

how
bans a member, or anyone by their user id. pick delete to remove their recent messages, and duration for a ban that ends by itself.
example
/ban user user:@merul duration:7d reason:raid
options
  • user needed member the person to ban (a user id also works)
  • delete optional text delete their messages from this long ago (default: none) pick: last 5m, last 10m, last 30m, last 1h, last 6h, last 12h, last 1d, last 3d, last 7d
  • duration optional text how long, like 30m, 2h or 7d (default: forever)
  • reason optional text why (default: no reason given)
  • proof optional file screenshot or file, saved in the log
  • dm optional yes or no send them a dm first (empty: server setting)
  • appeal optional yes or no let them appeal this one (empty: server setting)
who
anyone with the ban members ability (the senior preset and up), or the ban members permission when the server set no access rules
balqis needs
ban members
/ban softban and unban at once, to delete their recent messages (they can join again)show more

/ban soft <user> [delete] [reason] [proof] [dm]

how
bans and unbans at once: their recent messages are gone, but they can join again. good for spam from a hacked account.
example
/ban soft user:@merul delete:last 1h
options
  • user needed member the person (a user id also works)
  • delete optional text delete their messages from this long ago (default: 1d) pick: last 5m, last 10m, last 30m, last 1h, last 6h, last 12h, last 1d, last 3d, last 7d
  • reason optional text why (default: no reason given)
  • proof optional file screenshot or file, saved in the log
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the ban members ability (the senior preset and up), or the ban members permission when the server set no access rules
balqis needs
ban members
/ban undounban someoneshow more

/ban undo <user> [reason] [keep-record] [dm] [invite]

how
unbans someone. you can keep the record, dm them and send them an invite.
example
/ban undo user:merul invite:yes
options
  • user needed text pick a banned person, or type a user id
  • reason optional text why (default: no reason given)
  • keep-record optional yes or no keep it in history (empty: yes)
  • dm optional yes or no send them a dm first (empty: server setting)
  • invite optional yes or no put an invite link in the dm (empty: no)
who
anyone with the ban members ability (the senior preset and up), or the ban members permission when the server set no access rules
balqis needs
ban members
/ban listshow the bans balqis knows aboutshow more

/ban list

how
every ban balqis knows about in this server.
example
/ban list
options

no options, just run it.

who
anyone with the ban members ability (the senior preset and up), or the ban members permission when the server set no access rules
/ban checkcheck if someone is banned here, and their ban historyshow more

/ban check <user>

how
is this person banned here? shows their ban history too.
example
/ban check user:@merul
options
  • user needed member the person (a user id also works)
who
anyone with the ban members ability (the senior preset and up), or the ban members permission when the server set no access rules
balqis needs
ban members
/ban syncadd bans balqis missed as cases, and end cases of people who were unbannedshow more

/ban sync

how
reads discord's ban list: bans balqis missed become cases, and cases of people who were unbanned by hand end.
example
/ban sync
options

no options, just run it.

who
anyone with the ban members ability (the senior preset and up), or the ban members permission when the server set no access rules
balqis needs
ban members

big tools

for administrators and the server owner.

/ban hard addhard ban: banned again if unbanned by hand or when they rejoin (admins)show more

/ban hard add <user> [reason] [proof] [dm] [appeal]

how
a ban that sticks: if someone unbans them by hand or they come back, balqis bans them again.
example
/ban hard add user:@merul reason:ban evading
options
  • user needed member the person (a user id also works)
  • reason optional text why (default: no reason given)
  • proof optional file screenshot or file, saved in the log
  • dm optional yes or no send them a dm first (empty: server setting)
  • appeal optional yes or no let them appeal this one (empty: server setting)
who
anyone with the hard bans ability (add it by hand with /access role), or the administrator permission when the server set no access rules
/ban hard listshow the hard bans (admins)show more

/ban hard list

how
every hard ban of this server.
example
/ban hard list
options

no options, just run it.

who
anyone with the hard bans ability (add it by hand with /access role), or the administrator permission when the server set no access rules
/ban hard undoremove a hard ban and unban them (admins)show more

/ban hard undo <user> [reason] [dm]

how
ends a hard ban and unbans them.
example
/ban hard undo user:@merul
options
  • user needed member the person (a user id also works)
  • reason optional text why (default: no reason given)
  • dm optional yes or no send them a dm first (empty: server setting)
who
anyone with the hard bans ability (add it by hand with /access role), or the administrator permission when the server set no access rules
/ban mass undounban everyone (server owner only), in the backgroundshow more

/ban mass undo [include-hard]

how
unbans everyone, slowly in the background. only the server owner can do it.
example
/ban mass undo include-hard:no
options
  • include-hard optional yes or no also unban hard bans (empty: no)
who
the server owner
/ban mass cancelstop the mass unban that is running (server owner only)show more

/ban mass cancel

how
stops a mass unban that is still running.
example
/ban mass cancel
options

no options, just run it.

who
the server owner

trouble in your server?

add balqis to your server. /warn, /timeout, /kick and /ban work right away, and /setup start sets up the rest.

add to server