Modules
Warns
Make sure that your warns module is enabled before configuring the warns module (!module warns
to enable, and !module list
to see if it's enabled).
The roles set as helper or mod🔗 are able to warn other people.
Setting Up Warns Module
The command used for setting up the warns module is pwarnings, which has a set of other subcommands. The warns module is integrated with the mutes, kicks, and bans modules when set up to automatically apply a punishment whenever someone reaches a certain amount of warnings. It's also possible to have warnings to be automatically purged from the system or pardoned from the user after the warning is at a certain age.
Permissions
The list below details the minimum needed permissions in order for the warns module to function:
- View Channels
- Send Messages
- Manage Roles (if you want to auto-mute people with enough warnings)
- Kick Members (if you want to auto-kick people with enough warnings)
- Ban Members (if you want to auto-ban people with enough warnings)
Pwarnings
This is the command that is used to change the settings for the warnings module. There are many subcommands to it, each with their own unique purpose.
Required Permissions (Staff)
(Admin)
Syntax
!pwarnings list
!pwarnings mutemulti number
!pwarnings allowstaff [on/off/true/false]
!pwarnings autopardon/autopurge off/number
!pwarnings WarnCount# [off/ban/kick/mute] [# (minutes for mutes...days for bans)]
Examples
!pwarnings list | Displays your current warning module settings
!pwarnings mutemulti 3 | Sets the multiplied amount of time the next auto-mute to be greater than the previous
!pwarnings allowstaff on | Allows staff to mute each other (They are still exempt from punishment)
!pwarnings autopardon/autopurge 14 | Sets an automatic purge or pardon after the warn is 14 days old
!pwarnings 3 mute 15 | Automatically mutes a person for 15 minutes when they get 3 warnings
!pwarnings 5 kick | Automatically kicks a person when they get 5 warnings.
For mutemulti:
If you set the first mute punish to be at 30 minutes, the first mute punishment will mute someone for 30 minutes.
If you set a mute punishment in your pwarnings list without a number, then it will permanently mute someone.
If you set the mutemulti to 15, then the warned person will be muted for 15 minutes on the first mute punishment, 30 minutes on the second mute punishment, 45 minutes for the third mute punishment, and so on.
Staff Commands
These are a list of commands that staff can use at their disposal. Staff roles set to helper or mod have access to these commands besides purgewarn
, which is a command that wipes the warning from the system's records.
The warnID can be found by doing the warnlist command. For visual reference, check the question in the FAQ at the bottom of the page.
Warn
This is used to warn those pesky people....or to have fun warning staff since staff cannot be auto-punished by warnings.
Required Permissions (Staff)
(Helper)
Syntax
,warn member [Optional Reason]
Examples
!warn @yeetmaster#3000 | Warns a person, sends the warning in their DM, and sends a warn log (if enabled)
Bulkwarn
A new feature that allows multiple people to be warned in the same command. This is great for when you don't want to send many messages when warning a group of people.
The syntax is super important to follow because Gaius will not add a warning to any line that is not following the syntax rules.
Required Permissions (Staff)
(Helper)
Syntax
!bulkwarn WarnedUserID % Moderator % Reason
Warned User % Moderator % Reason
Warned User % Moderator % Reason
Examples
!bulkwarn 507121360831234530 % 507121360833609730 % trolling
507121360812349730 % 507121360833609730 % trolling
512341360833609730 % 507121360833609730 % trolling
507121360123609730 % 507121360833609730 % trolling | Warns group, sends warning in DM, sends warn log (if enabled)
If there is no reason for the warning, include the second % but simply leave it blank.
Example:
!bulkwarn 507121360831234530 % 507121360833609730 %
507121360812349730 % 507121360833609730 % trolling
512341360833609730 % 507121360833609730 %
Warnings that are improperly filled out will be skipped. A new line (which can be made with Shift+Enter) is required for each new warning. Any reason with a line break inside it will have the reason cut off.
Rewarn
If you ever warned someone for the wrong reason or no reason or maybe accidentally pressed Enter in the middle of typing, the rewarn command will save you from having to get a mod to pardon or purge the warn by providing a second chance to re-type the warn reason. Be sure to have your warn ID handy.
Required Permissions (Staff)
(Helper)
Syntax
!rewarn warnID This is the new reason
!reward member
Examples
!rewarn 638 Did not share popcorn during movie night.
!rewarn yeemasteer#3000 | Sends a prompt with a current list of warnings you can choose from that the user has
Forcewarn
If you've ever needed to warn someone for something but feel as if the behavior does not warrant a punishment or a weighted decision in a punishment, forcewarn would be ideal over using the warn command. Forcewarn applies the warning to the user and the record, however it will not notify the offender and it will not apply any punishments. Another helpful use case for this command is for when someone breaks the rules and then leaves to try to avoid getting punished or a record being added to them.
This command will NOT apply punishments or notifications, however it will still generate a warns log.
Required Permissions (Staff)
(Helper)
Syntax
!forcewarn member [Reason]
Examples
!forcewarn 123456789012345678 Did not share popcorn during movie night.
Pardon
You can pardon a warn from a person who was not supposed to be warned, or maybe they humbly apologized for their behavior. Pardons are like a forgiveness...but along the lines of "I forgive, but I don't forget," because pardon drops the active strike from their active warn counts that are tracked for auto-punishment and results in the display of the pardoned warns in strikethrough text. This is a moderator command.
Required Permissions (Staff)
(Mod)
Syntax
!pardon WarnID
!pardon member
Examples
!pardon 638 | Pardons Warn #638
!pardon yeemasteer#3000 | Sends a prompt with a current list of warnings you can choose from that the user has
This command is reserved for mods instead of being accessed by helpers because a mod should be the one to decide if a warning a helper made was pardonable, and this prevents one helper from pardoning every warning that another helper sends out.
Purgewarn
Good warn? Bad warn? No problem! Purgewarn is here to wipe it and sweep the warning from the system. Any warning that is purged or auto-purged will be permanently removed from the system and will not be displayed in the warnlist. This is a moderator command.
Required Permissions (Staff)
(Mod)
Syntax
!purgewarn all member
!purgewarn member
!purge warnID
Examples
!purgewarn all yeetmaster#3000 | Purges all warnings from yeetmaster#3000
!purgewarn yeetmaster#3000 | Sends a prompt with a current list of warnings you can choose from that the user has
!purgewarn 324 12 125 | Purges warnings # 324, 12, and 125
This command is reserved for mods instead of being accessed by helpers because a mod should be the one to decide if a warning a helper made should be purged, and this prevents one helper from purging every warning that another helper sends out.
Purging a warning removes it permanently from the system and cannot be taken back. Only purge warnings that you are absolutely sure you never will have to look at again or will never bee important enough to keep.
Warnlist
Warnlist provides you with a customizable generated list of warnings along with each of their respective target, mod, reason, and warn ID. You can get a list of all warnings that a staff member has made, all warnings a person has received, or search through warnings by reason. For example, if you want to see all warnings for racial slurs, you can do so by searching for the word racism or racial.
Required Permissions (Staff)
(Mod)
Syntax
!warnlist all
!warnlist mod member
!warnlist id warnID
!warnlist reason This is a part of or the whole reason
!warnlist member
Examples
!warnlist all | Lists every single warning that is currently in the system
!warnlist mod @DabbingOnHaters#3000 | Lists all warnings that DabbingOnHaters#3000 has sent
!warnlist ID 638 | Displays warning number 638
!warnlist reason popcorn | Lists all warnings with the word popcorn in the reason
!warnlist @yeetmaster#3000 | Lists all the warns yeetmasteer#3000 has
Extremely useful utility and resource for record keeping, auditing, and moderating your server and staff team.
This command is reserved for mods instead of being accessed by helpers because a mod should be the one to decide if a warning a helper made should be purged, and this prevents one helper from purging every warning that another helper sends out.
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
Q. What are Warn IDs?
- Every warn has a special ID that can be used for the purgewarn
and pardon
command. The WarnID in the example photo below is 3. Using this example, you would say !purgewarn 3
or !pardon 3
to pardon or purge the warn.
Q. What are pardoned warns?
- Warns that are pardoned will show up in !warnlist
as strikethrough text. This means it will not count towards auto punishments but will remain on the record until it is either purged or auto-purged.
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
Mutes
Make sure that your mutes module is enabled before configuring the mutes module (!module mutes
to enable, and !module list
to see if it's enabled).
The roles set as mod🔗 are able to mute other people.
Setting Up Mutes Module
The command used for setting up the mutes module is mutetype, which displays a prompt for you to either say “role” or “clean” depending on what mute type you would like. “Role” mutetype is simply adding the role onto the offending person “Clean” mutetype clears all roles from the offending person and gives them the mute role in return. Once a person is unmuted after being muted through the “clean” mutetype, they will receive all the roles that were removed from them.
Permissions
The list below details the minimum needed permissions in order for the mutes module to function:
- View Channels
- Send Messages
- Manage Roles
Staff Commands
Make sure that Gaius' role is higher than your mod role(s) but below your admin role
The role(s) set as mod🔗 are able to mute other people.
Mutetype
When you run this command, you'll be given 2 mute type choices: role and clean Simply reply in the chat with the name of the mute type you want.
Required Permissions (Staff)
Manage Roles (Mod)
Syntax
!mutetype
Type |
Description |
Role | Adds the mute role to the member. |
Clean | The same as role except for the bot first removes all roles associated with the member. Upon unmute, the member will receive all their roles back. |
Mute/Unmute
This command is reserved for mods. If you would like for your helpers in your staff list to use the mute and unmute commands, then allowing them through the allow
command🔗 will get you what you need.
Required Permissions (Staff)
Manage Roles (Mod)
Syntax
!mute member [#w #d #h #m #s] [reason]
!unmute member
Examples
!mute @yeetmaster#3000 420d | Mutes the person, sends the mute in their DM, and sends a mute log (if enabled)
!unmute @yeetmaster#3000 | Unmutes the person
If the mute role was added, or member roles were cleaned then the mute role added, and the bot works as intended, but the muted person can still speak in channels, then there is a configuration error in your channel or role permissions.
If you are using the "role" mutetype and the above situation is happening, the easiest possible fix would be to swap to the "clean" mutetype.
By default mutes are in minutes. Saying !mute @user 6
will mute them for 6 minutes.
Mutelist
This command is reserved for mods. If you would like for your helpers in your staff list to use the mute and unmute commands, then allowing them through the allow
command🔗 will get you what you need.
Required Permissions (Staff)
Manage Roles (Mod)
Syntax
!mutelist
Examples
!mutelist | Lists all the currently active mutes
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
Q. Gaius doesn't say anything or mute people when I try to mute. What's going on?
- Very likely the mutes module is disabled. You can see if it's enabled by saying !module list. If it shows the module is disabled, you can enable it with !module mutes, and then follow the setup process.
Q. What if I mute someone for a different time than they already had?
- The new mute timer will overwrite, meaning they will be muted for the time given on the second mute instead of the first mute
Q. What mute type should I use?
- That depends. Some servers have many roles with many more channel override permissions that would make the act of only giving the mute role inefficient…meaning that the supposedly muted user can still interact in other channels. A clean mute type is ideal in this situation to avoid any discrepancies in permissions and ensure the muted person really is muted.
Q. I muted someone but they can still speak? Is this a bug?
- No. If the mute role was added, or member roles were cleaned then the mute role added, then the bot works as intended. However, if the muted person can still speak in channels, then there is a configuration error in your channel or role permissions. This can be fixed by checking your channel and role perms to make sure that there are not unwanted discrepancies in permissions within your community.
- If you are using the "role" mutetype and the above situation is happening, the easiest possible fix would be to swap to the "clean" mutetype.
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
Kicks
Make sure that your kicks module is enabled before configuring the mutes module (!module kicks
to enable, and !module list
to see if it's enabled).
The roles set as mod🔗 are able to kick other people.
Setting Up Kicks 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 kick rowdy people, raiders, or even spam accounts from your community.
Permissions
The list below details the minimum needed permissions in order for the kicks module to function:
- View Channels
- Send Messages
- Kick Members
Staff Commands
Make sure that Gaius' role is higher than your mod role(s) but below your admin role
Kick
It is possible to kick people by their role, This will result in the irrevocable kicking of everyone who has this role. This cannot be canceled because a processed command cannot be canceled.
Required Permissions (Staff)
Kick Members (Admin)
Syntax
!kick member [Reason]
!kick member member member [Reason]
!kick role role [Reason]
Examples
!kick @yeetmaster#3000 Not sharing popcorn during movie night | Kicks person, sends kick DM, and sends kick log (if enabled)
!kick @yeetmaster#3000 @yeetmaster#3001 | Kicks multiple people, sends kick DMs, and sends kick log (if enabled)
!kick @Troll Role | Kicks everyone who has the Troll Role role, sends kick DMs, and sends kick log (if enabled)
Softban
It is possible to softban people by their role, This will result in the irrevocable softbanning of everyone who has this role. This cannot be canceled because a processed command cannot be canceled.
This is in the kicks module because it acts like a hard kick, or a soft ban. Gaius bans the person, so that all their messages in the last 24 hours are automatically purged, and unbans them. This is preferable over a ban or a kick in cases where a person is being a toxic troll but you don't think what they have done is necessarily ban-worthy and should not be in the server at the time.
Required Permissions (Staff)
Ban Members (Admin)
Syntax
!softban member [Reason]
!softban member member member [Reason]
!softban role role [Reason]
Examples
!softban @yeetmaster#3000 Not sharing popcorn on movie night | Softbans person, sends DM, and sends kick log (if enabled)
!softban @yeetmaster#3000 @yeetmaster#3001 | Softbans multiple people, sends DMs, and sends kick logs (if enabled)
!softban @Troll Role | Softbans everyone who has the Troll Role role, sends DMs, and sends kick logs (if enabled)
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
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
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 with the banrole command. This will result in the uninterruptable 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] [%d0-7] [Reason]
!ban member member member [%d0-7] [Reason]
!ban role role [%d0-7] [Reason]
!unban user [Reason]
!unban user user user [Reason]
Examples
!ban @yeetmaster#3000 420s %d2 | 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
!banrole @Troll Role | Bans everyone who has the Troll Role role, sends ban DMs, and sends ban log
!unban @yeetmaster#3000 420s %d2 | 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 [temp] 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 temp You're temporarily banned. | Sets the new ban message to be sent to temp-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
REQUIRED PERMISSIONS:
Ban Members
BanSync is NOT a part of the band module, so there is NOT a need to enable the band module.
This feature is reserved for Gaius Plus only. Learn more.
BanSync with a server will result in both bans and unbans linking between the servers.
Setup
Command | Descriptive Example |
!bansync current |
!bansync current
- Displays the current BanSync settings |
!bansync add/rem [export/import] id |
!bansync add/rem export 270438133584232449
- Adds/removes the target server to/from the exporting list This will tell Gaius to export, or send, all future bans to the target server that has been specified. Be aware not to use the same server ID that you are doing the command in. It must be the target server that you want to send the bans to. !bansync add/rem import 270438133584232449
- Adds/removes the target server to/from the importing list This will tell Gaius to import, or receive or get, all future bans from the target server that has been specified. Be aware not to use the same server ID that you are doing the command in. It must be the target server that you want to receive the bans from. |
!bansync approve/unapprove id |
!bansync approve 270438133584232449
- Approves the target server for BanSync !bansync unapprove 270438133584232449
- Unapproves, or removes, the target server for BanSync |
!bansync clear |
!bansync clear
- Removes all bansync connections with all servers This will still keep the bansync setting to remain enabled instead of disabled. Only the listed servers in the current bansync sommands are removed from the list. |
!bansync enable/disable |
!bansync enable
- Enables BanSync integration with other servers !bansync disable
- Disables BanSync integration with other servers |
!bansync recursive id |
!bansync recursive 270438133584232449
- Adds all previous bans from the specified ServerID to your own |
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
Verify
Make sure that your verify module is enabled before configuring the verify module (!module verify
to enable, and !module list
to see if it's enabled).
Setting Up Verify Module
The command used for setting up the verify module is verification, which has a set of other subcommands that allows you to edit the module's current settings without the need to re-run the entire process again. Verification is also possible through DMs, a server channel, or a captcha (which is done in the person's DMs and is a Premium feature).
Permissions
The list below details the minimum needed permissions in order for the verify module to function:
- View Channels
- Send Messages
- Embed Links
- Manage Messages
- Manage Roles
- Kick Members (If autokick is enabled)
Verification
There are many subcommands to the verification module, each with their own unique purpose. This section will have a lot of information to process, so please re-read this as many times as it takes in order to set your verification to the best fit for your community. Instead of the conventional format as seen in the previous pages, this section will have a specialized list for the subcommands and what to understand about each of them.
!setverify
is no longer the setup command; it has changed to !verification
. !verification
cannot be ran by itself to start the setup process as was possible with the Legacy version of Gaius. A subcommand must be used to with the command in order to change the module's properties. This is done so that you won't have to go through the whole setup process each time something happens or changes after the first setup.
Required Permissions (Staff)
- Embed Links
- Manage Messages
- Manage Roles
- Kick Members (Admin)
Syntax
!verification subcommand [input or arguments to set]
Examples
Instead of the conventional example list and because there are many subcommands for the verification command, a detailed table for all the subcommands and their applicable inputs are listed below.
Subcommand | Descriptive Example |
current |
!verification current - Displays all current settings in the verify module |
type |
- What do you want Gaius to do with the verify role?
The overall configuration of your community's channel and role permissions will greatly determine which type of verification works best for your community and keep unverified people out of the social spaces. |
role |
- Sets which role(s) to add or remove from a verified person |
dm/captcha |
You must say either 'on' or 'off' when using this subcommand. What is captcha? |
message |
One helpful tip is to provide the verification command somewhere in the message to help the next user understand what the verification command is. |
dmmessage |
!verification dmmessage This is a DM message about verification. - IF verification is set to DM, instead of channel, then this message will be sent to the person's DM for verification. |
autokick |
!verification autokick number/off - How many minutes you would like to wait until Gaius automatically kicks the new person if they did not pass verification. - Saying OFF, instead of a number, will turn this feature off. |
channel |
!verification channel #channel - Sets what channel the verification process will take place for newcomers |
command |
!verification command command - Sets the command a person must use in order to be verified. The command MUST include the prefix. |
Testverify
After you set up verification, the most important step with any security configuration is to test it and make sure everything is working as intended. Testverify will help provide a streamlined troubleshooter and reliable debugging tool to help ensure the best fit verification system for your community.
Required Permissions (Staff)
- Embed Links
- Manage Messages
- Manage Roles
Syntax
!testverify member
Examples
!testverify @yeetmaster#3000 | Begins the testing of the current verification setup
Manualverify
Required Permissions (Staff)
- Embed Links
- Manage Messages
- Manage Roles
Syntax
!manualverify member
Examples
!manualverify @yeetmaster#3000 | Manually verifies the person
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
Q. My roles aren't being assigned! Is the bot broken?
- If a role is not being assigned when verification is attempted, check the following:
-
- Gaius' role has Manage Roles permission
- Gaius' role is above the role(s) you're trying to (un)assign
- Gaius is able to read/send messages in the verification channel (unless you're using DM verify)
- If DM verify is enabled, users are able to receive DMs
Q. How can I verify someone manually?
- The manualverify command is handy for situations that verify isn't working as intended for a newcomer.
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
Welcome
Make sure that your welcome module is enabled before configuring the welcome module (!module welcome
to enable, and !module list
to see if it's enabled).
Setting Up Welcome Module
The command used for setting up the welcome module is welcome, which has a set of other subcommands that allows you to edit the module's current settings without the need to remember several commands.
The list below details the minimum needed permissions in order for the welcome module to function:
- View Channels
- Send Messages
- Embed Links
Welcome/Leave
Configuring the welcome module is done with this command. This will allow for posting welcome and/or leave messages for people and utilize rich embeds and direct messages to best fit your needs. Multiple welcome messages are made possible with the !welcome add [name]
feature.
There are many subcommands to the welcome module, each with their own unique purpose. This section will have a lot of information to process, so please re-read this as many times as it takes in order to set your welcome to the best fit for your community. Instead of the conventional format as seen in the previous pages, this section will have a specialized list for the subcommands and what to understand about each of them.
Welcomes will not be posted for users blocked by BlankAvatar and JoinAge.
Both !welcome
and !leave
have the same subcommands and will be sharing the same table.
!setwelcome
, !setchannel
, !settype
, !setdelete
, !setleave
, are no longer the commands for setting up the welcome module; it has changed to !welcome
and !leave
. !welcome
and !leave
cannot be ran by on their own to start the setup process. A subcommand must be used to with the command in order to change the module's properties.
Required Permissions (Staff)
- Send Messages
- Attach Images
- Embed Links (Admin)
Syntax
!welcome subcommand [input or arguments to set]
!leave subcommand [input or arguments to set]
Examples
Instead of the conventional example list and because there are many subcommands for the welcome and leave commands, a detailed table for all the subcommands and their applicable inputs are listed below.
Subcommand | Descriptive Example |
current |
- Displays all current settings in the welcome module |
type |
- What kind of message do you want Gaius to send with newcomers/leavers?
The type with the greatest freedom of customization is embed. Text is better for a short and simple design. |
add/rem |
- Adds or removes a welcome/leave to or from the list by name
|
channel |
- Sets the designated channel for the welcome/leave |
autodel |
- Sets how many seconds to wait to delete the welcome/leave message - Using either |
explain |
|
Notes
Two options are available for setting up welcomes:
- Making it from scratch
- Using pre-made templates to modify as needed.
Templates can be found below.
Variables
The Display Variables MUST be listed with line breaks and in the order in which it appears in the table below.
This
is
a
line
break
Display Shortcodes | Shortcodes |
$plain: | %user |
$plain: disable | %guild |
$title: | %tag |
$desc: | %id |
$thumb: | |
$img: | |
$field: | |
$color: | |
%user% | |
%guild% |
Template Examples
Example #1
!welcome add $plain: plain text goes here
$title: Title
$desc: Description
$thumb: URL (or use https://%user for user avatar)
$img: URL
$field: Field name %% Content
$color: Any type of color code accepted by Discord
Example #2
!welcome add $plain: This is plaintext, it goes above the welcome message
$title: This is the title, it is in bold text at the top
$desc: This is the description of the embed, it goes directly below the title
$thumb: %user
$field: This is the field name %% This is the field value
$color: #18d76e
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
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
Tickets
Make sure that your tickets module is enabled before configuring the tickets module (!module tickets
to enable, and !module list
to see if it's enabled).
Setting Up Tickets Module
The command used for setting up the tickets module is pobox, which has a set of other subcommands that allows you to edit the module's current settings without the need to remember several commands. The tickets module allows for a modmail system in which your community members can interact with your staff about issues, suggestions, reports, etc.
The list below details the minimum needed permissions in order for the tickets module to function:
- View Channels
- Send Messages
- Embed Links
- Manage Channels (to open and close ticket system channels)
Pobox
As previously stated, this is the only command needed for the configuration of the tickets module. The other commands within the tickets module are solely used for moderation purposes, aside from !send
.
Make sure that your tickets module is enabled before configuring the tickets module (!module tickets
to enable, and !module list
to see if it's enabled).
Required Permissions (Staff)
- Send Messages
- Attach Images
- Embed Links (Admin)
Syntax
!pobox subcommand [input or arguments to set]
Examples
Instead of the conventional example list and because there are many subcommands for the pobox command, a detailed table for all the subcommands and their applicable inputs are listed below.
Subcommand | Descriptive Example |
current |
- Displays all current settings in the tickets module |
channel/category |
- For channel, sets which channel new ticket notifications are posted - For category, sets the category where all ticket handling channels to be created |
agelimit |
- Sets how old an account must be before they can submit a ticket |
responsetype |
- Sets the message type received after submitting a ticket to either text or embed |
newmailtype |
- Sets the notification's message type of new mail to either text or embed |
newmail/response |
- For newmail, sets what the notification for new mail will say or in a discohook link form - For response, sets the message to be sent to the person who submits a ticket |
forcedump |
|
NewMail & Response Variables
NOTE: When using newmail
and response
, you are allowed to use multiple variables listed below.
These variables can be used anywhere in the message.
The variables listed below provide a more tailored response and notification system for your modmail tickets system. As a reminder, these variables can be used anywhere in the response
or newmail
.
Variable | Description | Where Can I Place This? |
%name | Mention of ticket sender | Anywhere |
%tag | Username#### of ticket sender | Anywhere |
%id | UserID of ticket sender | Anywhere |
%date | Date of ticket submission | Anywhere |
%tid | TicketID | Anywhere |
%mid | MessageID from ticketing channel | Anywhere |
%guild | Server name | Anywhere |
%content | Entire ticket contents | Anywhere |
%uimg | Avatar URL of ticket sender | Anywhere |
Moderation Commands
The commands listed below are used solely for moderation purposes. It's possible to allow some of these commands for trusted senior moderators with the allow command. Restricting the command to a certain channel helps instill a process for your staff to utilize in the community's tickets system.
This table will get an update soon.
Command | Description | Example |
!assign userID ticketID | Opens the ticket and assigns it to the staff | !assign userID ticketID |
!unassign userID ticketID | Unassigns a staff from the ticket | !unassign userID ticketID |
!closeticket ticketID | Closes and marks resolved the ticket, marks it resolved, and deletes the channel If requested, creates a full dump of the channel |
!closeticket ticketID |
!ticketstatus ticketID | Displays the ticket status | !ticketstatus ticketID |
!blockticket userID | Prevents that user from sending tickets | !blockticket userID |
!unblock userID | Re-allows that user to send tickets | !unblock userID |
Send (Public Command)
Anyone can use this command except for those in panicd or muted.
Command | Description | Example |
!send | Sends a completely private ticket to the server staff Upon activation, the bot will DM you and ask for input, waiting up to 10 minutes. NOTE: You must allow DMs to be sent from server members in your privacy settings. |
!send |
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
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
Roles
Make sure that your roles module is enabled before configuring the roles module (!module roles
to enable, and !module list
to see if it's enabled).
Setting Up the Roles Module
There are a few commands used for setting up the roles module, which help create and customize your self-assignables, auto roles, and special roles. The roles modules is intended to provide a detailed means of utility, additional roles management, source of automation to help your staff focus more on moderating and interacting with your community.
The list below details the minimum needed permissions in order for the roles module to function:
- View Channels
- Send Messages
- Manage Roles
- Connect (for adding voice roles)
Addrole
Make sure that your roles module is enabled before configuring the roles module (!module roles
to enable, and !module list
to see if it's enabled).
This command takes a Role Name or roleID
Before you can begin customizing your roles in the module, they must first be added to a special list of roles that tells Gaius that it is allowed to work with. If a role is not added, then it cannot have its behavior customized with the roleopt
command below.
Required Permissions (Staff)
- Manage Roles (Admin)
Syntax
!addrole rolename/roleid
Example
!addrole Citizen | Adds the role to Gaius' list of custom roles
Roleopt
This command takes a Role Name or roleID
After a role has been added to the list, any person can self-assign or remove the role to or from themselves by, using the above example, saying !Citizen. This can be prevented by giving the role the lock option to disable the assignment/removal of the role via command.
The subcommands for roleopt are set, add, and rem. Add will add more options to the current list of options that have already been set to the role, rem will remove certain options that are currently set to the role, and set will set or overwrite all previous options that were set on the role to the new options, which means that saying !roleopt RoleName set auto
will remove all other options that could have been set on this role and then add the auto option to the role.
Other options for customizing your roles are available in a detailed table below.
Required Permissions (Staff)
- Connect (for the voice option)
- Manage Roles (Admin)
Syntax
!roleopt role view
!roleopt role add/rem/set option, [option], [option]
Examples
!roleopt Citizen view | Lists the current options that are set to the role
!roleopt Citizen set auto | Sets the Citizen role to be automatically assigned to a newcomer
!roleopt Citizen add perma, lock, reset, timed 5 | Adds the perma, lock, reset, and timer options to Citizen
!roleopt Citizen rem lock | Removes the lock option from the list of applied options from the Citizen role
!roleopt Citizen set auto, perma | Sets (overwrites all previous options to the new options) auto and perma to Citizen
Roleopt Options
Below are the available options for customizing your roles with the roleopt command, each with their own descriptive example to help you gain an understanding on what they are used for and what they can do.
Subcommand | Descriptive Example |
view
|
- Displays the current options for the given role |
unique |
- Adds/removes a role to a unique list of roles Unique 1 is considered the first list of roles in this option. If a person has a role in this list number and receives another role that is also in this unique list number, then the previous role will be removed from them because they are unique from one another and cannot be shared with the same person. |
timed |
- Adds or removes a timer on the role - If the number is positive, then the role will be removed after X minutes - If the number is negative, then the role will be added after X minutes The # can be either positive or negative (i.e. 23 and -4). |
voice |
- Adds a role onto a person when they join a voice channel Gaius must be able to see and connect to the voice channel in order to give it to a person who joins a voice channel |
pair |
- Adds the first role to someone when they are given the second role The first role (the role that is given the roleopt option of pair added to it) will be added to the person only when the second named role as given to them. This is not possible the other way around. The second named role will not be added to the person if the first role is given to them. |
lock |
- Removes the ability for a person to self-assign the role via command |
perma |
- Sets the role to be permanently assigned to someone |
auto |
- Sets the role to be automatically assigned to a newcomer |
reset |
- Sets the role to be able to be reset (removed from everyone) with the reset command |
age |
- Sets the person's age requirement to X number of days for the role |
Delrole
This is a very simple command that will simply remove the role from Gaius' role list. After sending this command, you will also be asked if you would like to delete the role from the server to. Saying yes to this prompt will result in the deleting of said role.
Required Permissions (Staff)
- Manage Roles (Admin)
Syntax
!delrole rolename/roleid
Example
!delrole Citizen | Deletes the role from Gaius' list of custom roles
Other Commands
These commands are simple and not a part of the setup of the roles module, but help provide some utility to the module to help the staff see their roles, gather info about roles and see approximately how many people have which role.
Rolelist
Required Permissions (Staff)
- (Mod)
Syntax
!rolelist
Example
!rolelist | Lists all the roles currently in Gaius' list of custom roles.
Roleinfo
Roleinfo is able to gather information about a role and says approximately how many people have the role.
Required Permissions (Staff)
- (Mod)
Syntax
!roleinfo [role]
Example
!roleinfo | Lists all the roles in the server
!roleinfo Citizen | Displays info on the role Citizen and how many people have the role assigned to them
Manually Assigning Roles
Self-assignables, auto roles, and specially assigned roles are not the only means to assign roles to community members with the roles module. Another feature is manually assigning roles to or from members. There are various ways to operate the command, such as only adding the role to members if they don't have it and vice versa, assign/remove a role to all members who have a certain role, all human users, or even bots.
Required Permissions (Staff)
- Manage Roles (Admin)
Syntax
!role bots/all [+/-]role
!role role/member [+/-]role
Example
!role bots +Megazoid | Assigns the role to all bots
?role @Citizen -@Beep Beep | Removes the role for all users with a certain role
!role all Beep Beep | For all people, removes the role if they have it, assigns the role if they don't have it
!role @yeetmaster#3000 Citizen | For the person, removes the role if they have it, assigns the role if they don't have it
Reaction Roles (Premium)
This is a feature reserved for Gaius Cicereius+, our Premium bot.
Reaction roles are not a part of the roles module, therefore you do not need to enable the roles module to set up and operate the setrolereact command.
Reaction roles are not a part of the roles module, but they are tied into the roles management and utilities for your community. You can have multiple reaction role systems set up, transfer reactions from one message to another, and add or remove certain reactions from an existing system without dismantling it.
There is only one command used during the configuration of reaction roles (setrolereact
) with a set of subcommands that follow. some of the subcommands allow for tweaks and editions to your currently existing reaction role systems without the need to restart the entire process.
Setrolereact
Examples
Instead of the conventional example list and because there are many subcommands for the setrolereact command, a detailed table for all the subcommands and their applicable inputs are listed below.
Subcommand | Descriptive Example |
!setrolereact |
- Begins the process for setting up a new reaction roles system Please carefully read and follow all instructions during the setup to ensure proper configurations and prevent the need to edit a system multiple times during the first setup. |
current |
- Displays all current settings in the reaction roles system - Providing a message ID displays the current system on the message |
delete |
- Deletes the reaction role system from the given message |
restart |
- Restarts the reaction role setup process for an already existing system |
move |
- Moves an existing reaction roles system from one message to another |
addreact |
- Adds a reaction role to an existing system. Supplying the @role is mandatory. |
deletereact
|
- Deletes a reaction role from an existing system. Supplying the @role is mandatory. |
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
Q. I have Gaius Blue and can't set up reaction roles. Is it broken?
- The reaction roles system is currently only available for Gaius Cicereius+ (the orange bot) users, and the feature works as intended and is not broken.
Q. Do I enable roles module for reaction roles?
- No, reaction roles is a feature on its own and is separated from the roles module. It is in this page because it is relevant to providing extra roles management and utilities to your community.
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
Purger
Make sure that your purger module is enabled before configuring the purger module (!module purger
to enable, and !module list
to see if it's enabled).
Purging Messages & Channels
There is no configuration for the purger module. It only has one command, purge, which offers a huge selection of options to customize Gaius' message cleaning. The maximum number of messages that can be deleted at one time is 500. The oldest messages Gaius will search for it 2 weeks to save resources due to Discord API limitations.
Purge
Required Permissions (Staff)
- Manage Messages (Admin)
Basic Examples
There isn't a need to understand the entire functional possibilities in order to use the purge command. Sometimes, only deleting a number of messages or a number of messages from a person or role is good enough. Deleting messages that contain a certain word is just as easy.
Command |
Descriptive Example |
!purge amount |
- Purges 10 messages from the channel |
!purge amount @mention |
- Purges 10 messages from a specific user in the channel |
!purge amount @rolemention |
- Purges 10 messages from a specific role in the channel |
!purge amount text |
- Purges 10 messages with that text/letter in the channel |
Advanced Examples
The listed modifiers below give your purging process some extra oomph to its accuracy and precision. These modifiers are attached at the end of the command message. As a helpful tip, you can still use the examples above while adding the modifiers below at the end.
Modifier |
Descriptive Example |
--startat |
- "Start at this message ID and work your way downward" |
--stopat |
- "Work your way upward until you get to this message ID" |
--range |
- "Start at this message ID, but don't go past that message ID" |
--startswith |
- "Delete messages that starts with the word 'pancakes'" |
--includes |
- "Delete messages that has the word 'pancakes'" |
--endswith |
- "Delete messages that has the word 'pancakes' at the end" |
--mentions |
- "Delete messages that have this specific mention" It is possible to use more than one mention for a wider search. |
--links |
- "Delete messages that have a link" |
--bots |
- "Delete messages created by bots" |
--images |
- "Delete messages that have an attachment" |
--invites |
- "Delete messages that have a server invite link" |
--embeds |
- "Delete messages that contain embedded text" |
--not |
- "Invert, or make into the opposite of, whatever other modifiers I gave you" In the given example, this would result in the Gaius deleting any message that was NOT sent by a bot. |
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
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
Commands
Make sure that your commands module is enabled before configuring the commands module (!module commands
to enable, and !module list
to see if it's enabled).
Creating Custom Commands
There is no configuration for the commands module. It only has three commands: learn, unlearn, and cmds. Learn tells Gaius to learn an new custom command unique for your server. Every custom command is capable of being customized for added security, utility, or fun for your community, staff, and members. Custom commands can even be used to assign special roles to people, or even remove it. Unlearn removes the custom command, and cmds lists all your community's custom commands along with their contents and shortcodes.
Learn
Learn tells Gaius to learn an new custom command unique for your server. Every custom command is capable of being customized for added security, utility, or fun for your community, staff, and members. Custom commands can even be used to assign special roles to people, or even remove it. When using the learn command, you say !learn CommandName This is a message
followed by whatever shortcodes you want to associate the new custom command with. CommandName will be the new name of the new custom command. In order to use the newly created custom command, you would say !CommandName
.
Required Permissions (Staff)
- Embed links
- Manage Roles (Admin)
Basic Examples
There isn't a need to understand the entire functional possibilities in order to use the purge command. Sometimes, only deleting a number of messages or a number of messages from a person or role is good enough. Deleting messages that contain a certain word is just as easy.
Shortcode |
Descriptive Example |
Placement |
%content/%message |
- Sends the specified response message |
Beginning |
%target |
- Targets a person to mention in the command In this example !yeet @yeetmaster#3000 will result in a pinged message to the target user with the message saying yeet. Mentioning one person to target will only result in the first specified person to being the target for the custom command. This shortcode will not successfully operate as intended without the %dm shortcode for the command. |
Anywhere |
%mention |
- Mentions the specified person in the command message If no person is or userID is used in the command message, then the person who sent the command message will be mentioned instead. |
At the end |
%embed |
- Sends an embedded message |
At the end |
%c |
- Sends an embedded message with a specified accent color Accent color is the left-side colored bar on the embedded message. %c accepts any hexadecimal color code |
At the end |
%dm |
- Sends the message YEEEEETTT in DMs |
At the end |
%option |
- For use with the 'list' option, whatever valid option from the 'list' is used will be placed here. |
|
--deny= |
- Denies the permission of a certain role from using the command You can use more than one role for this shortcode |
At the end |
--role= |
- Toggles, adds, or removes a role from whomever uses the command You can use more than one role for this shortcode |
At the end |
--list=
|
- A list of valid inputs for the custom command
|
At the end |
%admin, %mod, %helper |
- Learns |
At the end |
%cd |
- Sets the cooldown for the command to 10 seconds The maximum limit for cooldown is 9,999,999 |
At the end |
Unlearn
A very simple command to remove a currently existing custom command from your community. Once the command is deleted, it's deleted for good unless you re-add the custom command with the learn command.
Example
!unlearn CommandName
Cmds
Another very simple command for the commands module. This command will display all of the custom commands within your community along with each of their contents and relative shortcodes.
Example
!cmds
FAQ
Q. Will kicking Gaius reset the bot?
- No, kicking/banning Gaius will never reset your settings or prefix.
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