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
%das 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
BanSync
REQUIRES: Ban
This feature is reserved for Gaius Plus only. Learn more.
BanSync with a server will result in both bans and unbans will be linked between the servers.
Setup
| Command | Description |
| !bansync |
The base command for BanSync |
| !bansync open |
Opens the server for BanSync requests |
| !bansync close |
Closes the server to BanSync requests |
| !bansync add serverID |
Request a BanSync with the specified server |
| !bansync rem serverID |
Removes a BanSync with the specified 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