Bans

Make sure that your bans module is enabled before configuring the bans module (!module bans to enable, and !module list to see if it's enabled).

Setting Up Bans Module

This is one of the most easiest features to set up because enabling the module means the feature has been set up. There are no configuration commands for this module. Its sole purpose is simply to ban rowdy people, raiders, or even spam accounts from your community.

Permissions

The list below details the minimum needed permissions in order for the bans module to function:

  • View Channels
  • Send Messages
  • Manage Messages (If using %d as an argument at the end of the ban command)
  • Ban Members

 


 

 

 

Staff Commands

Make sure that Gaius' role is higher than your mod role(s) but below your admin role

 

Ban/Unban

If you would like your mods to use the ban command, you can do so by doing !allow ban @Mod Role.🔗

It is possible to ban people by their role, This will result in the irrevocable banning of everyone who has this role. This cannot be canceled because a processed command cannot be canceled.

Required Permissions (Staff)

Manage Messages
Ban Members
(Admin)

Syntax

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

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

Examples

!ban @yeetmaster#3000 420s %d 2   |   Bans person, sends ban DM, deletes 2 days of their messages and sends ban log
!ban @yeetmaster#3000 @yeetmaster#3001   |   Bans multiple people, sends ban DMs, and sends ban log
!ban role @Troll Role   |   Bans everyone who has the Troll Role role, sends ban DMs, and sends ban log

!unban @yeetmaster#3000 420s %d 2   |   Unbans person and sends a log in the ban log
!unban @yeetmaster#3000 @yeetmaster#3001   |   Unbans multiple people and sends logs in the ban log

 

Banmsg

This is for permanently banned users, not users who were softbanned. Softban is in the kicks module because it doubles as a hard kick.

This is highly useful for servers that allow banned people to submit ban appeals.

Banmsg allows banned members the opportunity to see your community's customized ban message. Whether it's to allow a ban appeal opportunity, tell them to get yeeted on, or say who banned them, where, and why, banmsg makes these possibilities possible.

Required Permissions (Staff)

(Admin)

Syntax

!banmsg message
!banmsg reqreason [off/on/true/false]
!banmsg requnreason [off/on/true/false]

Examples

!banmsg Get yeeted on, %user! :Dabalicious:   |   Sets the new ban message to be sent to banned people
!banmsg reqreason on   |   Sets the requirement to say the reason in all bans, kicks, mutes, and vcmutes
!banmsg requnreason on   |   Sets the requirement to say the reason in all unbans, unmutes, and vcunmutes

Banmsg Flags

These flags are useful tools available to you and will be replaced by whatever that flag is meant for (example: %server will be replaced by the name of your server). In the example, any time you change your server's name after the setup, the flag will also change to that server's current name.

Flag Description
%server Will be replaced with the server's name
%user Will be replaced with the banned user's name
%reason Will be replaced with the reason provided by the moderator
%mod

Will be replaced with the name of the moderator who performed the ban

 

Allbans/Tempbanlist

As the command name suggests, these commands allows you to see the list of permanently and temporarily banned users respectively...very easy to use and quite useful for auditing and reviewing purposes.

Required Permissions (Staff)

(Admin)

Syntax

!allbans [noreason] [nodelete]

!tempbanlist

Examples

!allbans noreason   |   Lists all permanent bans that don't have a reason along with other details of each ban
!allbans nodelete   |   Lists all permanent bans of account that have not been deleted from Discord

!tempbanlist   |   Lists all temporary bans (softbans) that are currently active in the server

 


 

FAQ

 

Q. Will kicking Gaius reset the bot?

- No, kicking/banning Gaius will never reset your settings or prefix.

Q. Can I set the bans to not send a message to someone when they are banned?

- No, this is currently not a feature.

Q. How do I see all the commands?

- The help command is man's best friend (not dogs).

 

 


 

Video

Not yet available

If you have or find a video on Gaius specifically for what is covered in this documentation page, you can send the info to Fairy 狐 紫#0001 via DM (You must be in the support server in order to make contact).

 


 

Points of Interest

Staff Handbook
Bot Logging/Exlog
Verification Module
Anti-Spam Protection
Wordlist Filtering

 

(Top of Page)

Previous Page   |   Next page