Documentation / Bans & Kicks

Bans & Kicks

Remove members from the server, temporarily or for good, and manage the ban list.

!ban

AdminPrefixModule: bans

Ban a member, or a list or members with a provided reason as well as optionally removing a number of days worth of messages. You can also temporarily ban people by providing the following format #w #d #h #m #s. W: Week; D: Day, H: Hour, M: Minute, S: Second.

Members with the Discord Ban Members permission can also use this command.

Usage

!ban member [#w #d #h #m #s] [%d0-7] [Reason]
!ban member member member [%d0-7] [Reason]

Examples

!ban @Member
!ban 1234567890 @Member 0987654321 @Member %d4  With Reason Y
!ban  @Member 1w 1d 1h 1m 1s %d4 For Reason X

“BYE FELICIA!”

!banrole

AdminPrefixModule: bans

Ban all members in a role with a provided reason as well as optionally removing a number of days worth of messages. You can also temporarily ban people by providing the following format #w #d #h #m #s. W: Week; D: Day, H: Hour, M: Minute, S: Second.

Usage

!banrole role [#w #d #h #m #s] [%d 0-7] [Reason]

Examples

!banrole @Role With Reason X
!banrole @Role 1w 1d 1h 1m 1s %d 4 For Reason X

“BYE FELICIA AND FRIENDS!”

!unban

ModeratorPrefixModule: bans

Unban a user, or a list of users with an optional provided reason.

Members with the Discord Ban Members permission can also use this command.

Usage

!unban user [Reason]
!unban user user user [Reason]

Examples

!unban 1234567890
!unban 1234567890 0987654321

“Meh, save your forgiveness for someone who deserves it”

!tempbanlist

ModeratorPrefixModule: bans

Get a list of people who are temporarily banned from the server.

Usage

!tempbanlist

Examples

!tempbanlist

“This is just a quicker way of contacting your local probation services.”

!allbans

AdminPrefix + Slash

View all bans on the server. This simply fetches your ban list and outputs it in a condensed readable format. You can filter bans by using 'noreason' for bans that do not have a reason, and 'nodeleted' to filter out possible deleted accounts.

Usage

!allbans [noreason] [nodeleted]

Examples

!allbans
!allbans noreason nodeleted
Slash command /allbans
OptionTypeDescription
noreasonTrue / FalseOmit the reason associated with each ban
nodeletedTrue / FalseOmit possible deleted users

“I don't know why you would care about people who are dead to you.”

!banpurge

AdminPrefixModule: bans

Set the default amount of days worth of messages to default purge for softbans and bans if not provided. To turn off, use 'off' or '0'.

Members with the Discord Ban Members permission can also use this command.

Usage

!banpurge current
!banpurge 0-7/off

Examples

!banpurge current
!banpurge 7

“Hmm? What member? I didn't see anyone.”

!bansync

AdminPrefix

Set up bansync or confirm bansync for your server. First a server must use 'approve' to pre-approve a server for bansync. Then the approved server must 'add' that server. You may use import or export to determine if you want to import only or export only. You can also enable or disable bansync at specific times. You may also use 'clear' to clear all bansyncs.

Recursive option will add all the bans from the target server to your server, note, your server must importing bans from the target server.

Not available on the Gaius Blue bot.

Usage

!bansync current
!bansync add/rem ['export'/'import'] id
!bansync approve/unapprove id
!bansync clear
!bansync enable/disable id
!bansync recursive id

Examples

!bansync current
!bansync add export 270438133584232449
!bansync approve 270438133584232449
!bansync clear
!bansync enable 270438133584232449
!bansync recursive 270438133584232449

“So it wasn't enough to manage your server, I have to manage other servers too!?”

!kick

ModeratorPrefixModule: kicks

Kick a member, a list or members, or all members in a role with a provided reason.

Members with the Discord Kick Members permission can also use this command.

Usage

!kick member [Reason]
!kick member member member [Reason]
!kick role role [Reason]

Examples

!kick @Member
!kick 1234567890 @Member 0987654321 @Member With Reason Y
!kick role @Role With Reason X

“My boot is bigger than yours, I'll lend it to you.... for now.”

!softban

ModeratorPrefixModule: kicks

Softban a member, a list or members, or all members in a role with a provided reason as well as optionally removing a number of days worth of messages. A softban is a kick

Members with the Discord Ban Members permission can also use this command.

Usage

!softban member %d 0-7 [Reason]
!softban member member member %d 0-7 [Reason]
!softban role role %d 0-7 [Reason]

Examples

!softban @Member %d 2
!softban 1234567890 @Member 0987654321 @Member %d 4 With Reason Y
!softban role @Role %d 3 With Reason X

“For when kicking someone does not quite get the stink out.”