Gaius

Wiki on everything Gaius Cicereius and Gaius Plus

Welcome to the Gaius Cicereius Docs!

Gaius Cicereius (or Gaius for short) is the moderation and utility bot dedicated to keeping your community and people secure and safe from raids, harmful/hateful content, and spam while offering a wide range of intricate features such as multiple filters for additional layered security; organizable, uploadable, and shareable wordlists for managing a network of communities; and customizable configurations for fine-tuning your securities in finesse.

The purpose of this documentation is to provide an in-depth comprehensive guidance and walkthrough on every module, feature, and command for Gaius Cicereius and provide detailed examples and explanations to foster greater understanding of everything Gaius.

Gaius Cicereius is split into modules, in which a set of relevant commands are grouped into, and these docs will provide a rundown of each module and their associated commands in a top-down approach.

Some features require the paid version of Gaius called Gaius Cicereius+.

 

 


 

 

Setting Up Gaius

When Gaius is in your server, you'll notice that no bot role is created in the bot's name. The very first task is to create and/or assign a role to Gaius if you want Gaius to moderate your server. Some communities prefer to have a special bot role (for example, Bot City Gang) for a group of bots without the role that usually comes with a bot, so we keep that option available.

Permissions

The list below details the minimum needed permissions in order for Gaius to function without moderation:

 

The staff permissions needed for Gaius are listed below:

 

If a role is assigned to Gaius, it is very important that its highest role with the Manage Roles perm is higher than the moderator role(s) and below your admin role(s).

 

Prefix

The first fundamental key part of every bot is the bot's prefix. Gaius' prefix is used for every command, so it's super important to ensure that Gaius has a prefix that can be easily used.

Make sure that Gaius' prefix is unique from the other bots to prevent more than one bot responding to one command.

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!prefix newPrefixHere

Examples

!prefix !!   |   Changes Gaius' default prefix to !!
!!prefix prefix !   |   This is a common mistake...the example below shows how to fix this.
prefix !prefix !   |   Changes the above's prefix to !

WARNING
Kicking/Banning any Gaius bot then bringing it back will NOT reset the prefix or any settings.

If you forgot your prefix or don't know what you have changed it to, then the !checkprefix command (by saying !checkprefix) will always respond with the current prefix as long as Gaius has the permissions to see and speak in the same channel as the command.

If you get a weird prefix, for example: prefix !, and want to change it to !, then do, in the same example as before, prefix !prefix !.

 

Modules

Gaius is separated into several modules and all modules are disabled by default, which means that in order to begin configuring a verification system or any other feature, enabling the modules is the first step of the actual configuration process with commands. This is intended so that the only features you need are enabled, and the rest remain disabled. The listed order of the modules below is in a top-down fashion that is commonly configured first from the core of the basics to the extra layered security and utilities.

Make sure that all modules you are want to enable for your server are enabled before proceeding onto the commands in the following pages.

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!module moduleName

Examples

!help module   |   Displays the embedded help message for module
!module list   |   Lists all of Gaius' available features and says whether each module is enabled or disabled
!module bans   |   Enables/Disables the bans module


List of Available Modules

 

Help Command

Whenever quick help or information is needed for a command, using the help command is the most efficient action. It will respond with an embedded interactive help message, which you can navigate by saying any of the listed available options. 

Required Permissions (Staff)

None (Everyone)

Syntax

!help   |   Displays the embedded interactive help message

 

The help message expires after a certain amount of time. If it no longer responds, it has simply expired and the help command has to be sent again.

All commands that are tied to a module will be in the respectively named module in the help message. All other commands that are always enabled are in the "Other" section.

 


 

FAQ

 

Q. Will kicking Gaius reset the bot?

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

 
Q. Why aren't my commands aren't working? Is the bot offline?

- This could be for a number of reasons. Here are a list of solutions (beginning with some of the most common solutions):

  1. Say !checkprefix in your server. If Gaius has permission to speak in and see the channel, it will always respond with the current prefix.
    1. If there is no response, try to @Gaius...this will pop up taggable users in a list, along as their online status icon on the lower-left of the user avatar. In the unlikely event that it is a gray icon, then Gaius is offline in your server and should be back online within a few minutes.
    2. If Gaius is online, make sure Gaius has permission to speak in the channel (Server Settings > Roles and/or Edit Channel > Permissions).
    3. If Gaius is not listed when you try to @gaius, then it likely does not have permission to see the channel, which is either because it does not have a role to see the channel(s), or it cannot see the channel in your channel settings.

  2. If Gaius responds with its current prefix, check your enabled modules with the module list command. Most commands are tied with a module, which means if, for example, the mutes module is not enabled, then muteunnmute, and switchm will also be disabled.

  3. If this does not solve your issue, then the next step is to contact support.
 
Q. How do I see all the commands?

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

 
Q. Is there a Dashboard? If so, how do I get to the Dashboard?

-The Dashboard is currently NOT for configuration and can be found at dash.gaiusbot.me. Currently, is only supports premium purchases and leaderboard functionality.

 
Q. Is there a premium (paid) version of Gaius? If so, where can I find more details about it?

- All details, including subscription information for Gaius Cicereius+ can be found here.

 


 

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

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

 

(Top of Page)

This is the First Page   |   Next page







 

 

 

 

 

 

 

Configuring Gaius

All configuration/setting commands require a role with either the Administrator or Manage Server permission or a role added as admin in the staff list.

 

Prefix

The first fundamental key part of every bot is the bot's prefix. Gaius' prefix is used for every command, so it's super important to ensure that Gaius has a prefix that can be easily used.

Make sure that Gaius' prefix is unique from the other bots to prevent more than one bot responding to one command.

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!prefix newPrefixHere

Examples

!prefix !!   |   Changes Gaius' default prefix to !!
!!prefix prefix !   |   This is a common mistake...the example below shows how to fix this.
prefix !prefix !   |   Changes the above's prefix to !

WARNING
Kicking/Banning any Gaius bot then bringing it back will NOT reset the prefix or any settings.

If you forgot your prefix or don't know what you have changed it to, then the !checkprefix command (by saying !checkprefix) will always respond with the current prefix as long as Gaius has the permissions to see and speak in the same channel as the command.

If you get a weird prefix, for example: prefix !, and want to change it to !, then do, in the same example as before, prefix !prefix !.

 

 


 

 

Auto Delete 

Autodel will automatically delete command messages when they are sent. This is turned on by default. You can turn this off by either saying autodel 0 or autodel off.

The number provided in the command is in seconds.

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!autodel #/off/0/current

Examples

!autodel 5   |   Deletes command messages 5 seconds after they have been sent
!autodel off   |   Does not delete command messages after they have been sent
!autodel current   |   Displays the current autodel setting.

 

 


 

 

Staff Role Assigning 

This is also a section that you will likely only have to once. Setting staff roles allows Gaius to know who can use certain parts of the moderation commands needed to help them do their part in keeping your server and members safe from harm's way.

Admin is considered almighty with Gaius. They can freely and completely configure the bot and are exempt from all auto-moderation, filtering, and punishments. It's highly recommended to give the "Admin" only to those who will ever have a need to configure the bot freely (i.e. owner, bot tech, co-owner).

Mod is the chat police for guilds. Mods cannot configure the bot, but can use a range of commands to moderate servers, including kick, mute, and voice moderation commands. Mods are also automatically exempt from auto-moderation except when configured to not be exempt.

Helper is like a trial mod, they have instant access to the !warn command only and are exempt from auto-moderation except when configured to not be exempt.

This is a super important part of the setup because this determines who can use certain mod commands to help keep your community safe and sound.

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!staff admin/mod/helper add/rem role

Examples

!staff list   |   Displays the current list of staff roles that have been set for the server
!staff helper add 123456789012   |   Adds the role as helper in the staff list
!staff mod rem @Troll   |   Removes the role Troll from mod in the staff list
!staff admin add @Owner   |   Adds the role Owner as admin in the staff list

 

 


 

 

Permission Overrides

Permission tuning can be used to allow mods to ban people, perform panic functions, or lock a channel during emergencies. It can also block someone from using a command that they already have access to, restrict a command to only be used by certain people, roles, or in specific channels, or free the command from any permission tuning that are already set for it.

The commands are allow, block, restrict, and free, all of which have specific functions in making sure that certain commands and modules can be accessed or not be accessed by certain conditions.

The 3 tuning commands accepts many types of input for your needs:
•  Server
•  Role/Role Name/ID
•  Member Mention/ID
•  Channel Mention/ID

If you are ever unsure about or want to ensure that you have permission overrides for a command or module, you can say the command below:
•  !listperms command

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!allow/block/restrict command member/role/channel
!free command
!listperms command

Examples

!allow ban @Moderator   |   Allows the Moderator role to use the ban command
!block ban Moderator  |   Takes away the Moderator role's ability to use the ban command
!restrict ban @Moderator  |   Only allows the Moderator role to use the ban command
!free ban #staff  |   Removes all permission overrides that were set to the ban command
!listperms bans   |   Displays the list of permission overrides for the bans module

 

 


 

 

Bypass 

Bypass allows specific channels or roles to have a pass from being subjected to specific automoderation features. One common use is to reward people with a filter bypass or two after they reach a certain level with a leveling bot, such as slowmode, URL, images, or stickers. Some bypasses can be used for long-time regular users, or helpers with specific bypasses needed from automoderation.

The examples below will specify a code in [brackets] that indicate putting the code in is optional, but be warned that not providing a [code] will default to all codes turning ON or OFF. THE BRACKETS ARE NOT INCLUDED IN THE ACTUAL COMMAND.

Add, rem, or toggle can be used...if not specified, then it will 'toggle' which will switch the code ON or OFF.

If the [code] is blank, then it will default to 'all', which toggles all codes ON or OFF (only OFF when all codes are ON).

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!bypass add/rem/toggle [code]/all Role
!bypass add/rem/toggle [code]/all Channel
!bypass list

Examples

!bypass add invite @Member   |   Allows the Member role to send server invites
!bypass rem invite @Member  |   Removes the Member role's ability to use send server invites
!bypass toggle invite #general-chat  |   Toggles the allowance of server invites to be sent in the channel
!bypass #general-chat  |   Toggles all filters either on or off for the #general-chat channel
!bypass list   |   Displays the list of bypasses in the server

Bypass Codes List

  • Filter
  • BlockedTags
  • Invite
  • URL
  • Spam
  • Duplicate
  • Mention
  • Emoji
  • Newline
  • Stickers
  • Image
  • Slowmode
  • Activity

 


 

 

Alias/Unalias 

Let's say you want to have staff use the mute command but want !b to work, too. Alias allows for the ban command to also be !b, triggering the ban command. You can also make the command to only work with the alias that has been set. Alias list will give you a list of all aliases set for the command, which takes away the guess work.

Another helpful command is unalias, which removes the alias that has been set for the target command. Want to remove a forced alias, but keep the same alias without needing to do the alias command again? No problem!

Setting an alias using alias force command, you are telling Gaius that you only want the set alias(es) to be the command that gives the action. For example, if you have an alias for ban set to b, then !b or !ban will be used for the ban command; if you say !alias force ban afterwards, then only !b will work for the ban command.

Required Permissions (Staff)

Manage Server (Admin)

Syntax

!alias command NewName 
!alias force command
!alias list command

!unalias command alias
!unalias force command

Examples

!alias ban bean   |   Sets bean to be an alias for the ban command
!alias force ban  |   Sets the alias(es) as the only option(s) to use the ban command
!alias list ban  |   Displays the currently set alias(es) that are set for the ban command

!unalias ban   |   Removes all aliases that have been set for the ban command
!unalias ban bean   |   Removes the alias "bean" from the ban command
!unalias force ban   |   Removes the force option from the ban command if the force option is turned on




 

FAQ

 

Q. Will kicking Gaius reset the bot?

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

 
Q. Why aren't my commands aren't working? Is the bot offline?

- This could be for a number of reasons. Here are a list of solutions (beginning with some of the most common solutions):

  1. Say !checkprefix in your server. If Gaius has permission to speak in and see the channel, it will always respond with the current prefix.
    1. If there is no response, try to @Gaius...this will pop up taggable users in a list, along as their online status icon on the lower-left of the user avatar. In the unlikely event that it is a gray icon, then Gaius is offline in your server and should be back online within a few minutes.
    2. If Gaius is online, make sure Gaius has permission to speak in the channel (Server Settings > Roles and/or Edit Channel > Permissions).
    3. If Gaius is not listed when you try to @gaius, then it likely does not have permission to see the channel, which is either because it does not have a role to see the channel(s), or it cannot see the channel in your channel settings.

  2. If Gaius responds with its current prefix, check your enabled modules with the module list command. Most commands are tied with a module, which means if, for example, the mutes module is not enabled, then muteunnmute, and switchm will also be disabled.

  3. If this does not solve your issue, then the next step is to contact support.
 
Q. How do I see all the commands?

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

 
Q. Is there a Dashboard? If so, how do I get to the Dashboard?

-The Dashboard is currently NOT for configuration and can be found at dash.gaiusbot.me. Currently, is only supports premium purchases and leaderboard functionality.

 
Q. Is there a premium (paid) version of Gaius? If so, where can I find more details about it?

- All details, including subscription information for Gaius Cicereius+ can be found here.




 

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




Modules(rewrite)

Modules(rewrite)

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:

 

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

 

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.

The Warn ID here is 3
 
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

 

(Top of Page)

Previous Page   |   Next page



 

Modules(rewrite)

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:

 


 

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

 

(Top of Page)

Previous Page   |   Next page



 

Modules(rewrite)

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:

 


 

 

 

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

 

(Top of Page)

Previous Page   |   Next page

Modules(rewrite)

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:

 


 

 

 

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

Modules(rewrite)

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:


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)

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

!verification type add/rem/switch

 

- What do you want Gaius to do with the verify role? 

  • Add - Adds the verification role to the verified person
  • Rem - Removes the unverified role from the person
  • Switch - Removes the unverified role and adds the verified 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

!verification role @Role

 

- Sets which role(s) to add or remove from a verified person

dm/captcha

!verification dm on/off
!verification captcha on/off (Premium feature)

- Sets the location for verification in the person's DM if set to ON
- Saying OFF, instead of ON, will disable dm verification

 

You must say either 'on' or 'off' when using this subcommand.

What is captcha?
- Captcha is a form of verification through DMs where a person has to select the right object in a picture in order to be verified. 
- This is all done within Discord so no links or leaving Discord is needed.

message

!verification message This is a message about verification.

- This message will be sent to the when someone passes verification, regardless of verify is set to a channel or DM.

 

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.

For example:
!verification command LetMeInCoach

Newcomers must say !LetMeInCoach in order to get verified.

 

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)

Syntax

!testverify member

Examples

!testverify @yeetmaster#3000   |   Begins the testing of the current verification setup

 

Manualverify

Required Permissions (Staff)

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:

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

 

(Top of Page)

Previous Page   |   Next page

 

 

 

Modules(rewrite)

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:

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)

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

!welcome current [name]

!leave current [name]

 

-  Displays all current settings in the welcome module
- Optional welcome/leave name to search for when multiples are used

type

!welcome type embed/text

!leave type embed/text

 

- What kind of message do you want Gaius to send with newcomers/leavers? 

  • embed - Sends a neat customizable embedded message
  • text - Sends a regular text message

The type with the greatest freedom of customization is embed. Text is better for a short and simple design.

add/rem

!welcome add name This is the welcome message!/DiscohookLink
!welcome rem name

 

!leave add name This is the leave message!/DiscohookLink
!leave rem name

 

- Adds or removes a welcome/leave to or from the list by name
- When adding a new welcome/leave, you can either:

  • Create a new welcome/leave message in the command message
  • Use a generated Discohook webbook link
channel

!welcome channel #channel

!leave channel #channel

 

- Sets the designated channel for the welcome/leave

autodel

!welcome autodel #

!leave autodel #

 

- Sets how many seconds to wait to delete the welcome/leave message

- Using either 0 or off will turn this off

explain

!welcome explain

!leave explain

- Displays embed formatting information

 

Notes

Two options are available for setting up welcomes:

  1. Making it from scratch
  2. 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

image-1586242215100.png

 


 

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

 

(Top of Page)

Previous Page   |   Next page

 

 

Modules(rewrite)

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:

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)

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

!pobox current

 

- Displays all current settings in the tickets module

channel/category

!pobox channel #channel

!pobox category Tickets 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

!pobox agelimit number

 

- Sets how old an account must be before they can submit a ticket

responsetype

!pobox responsetype text/embed

 

- Sets the message type received after submitting a ticket to either text or embed

newmailtype

!pobox newmailtype text/embed

 

- Sets the notification's message type of new mail to either text or embed

newmail/response

Variables

!pobox newmail text/discohooklink

!pobox response text/discohooklink

 

- 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

Variables

forcedump

!pobox forcedump off/text/html


- After closing a ticket, the entire channel will be archived in either:

  • Text format
  • HTML format
  • No archive

 

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

 

(Top of Page)

Previous Page   |   Next page

 

 

Modules(rewrite)

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:

 

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)

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.

c2d4a2d9a5242e63827627fa24a1cdd3.png

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)

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

 

roleopt RoleName view

 

- Displays the current options for the given role

unique

!roleopt RoleName add/rem/set 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

!roleopt RoleName add/rem/set 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

!roleopt RoleName add/rem/set 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

!roleopt RoleName add/rem/set pair Role:@Role

 

- 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

!roleopt RoleName add/rem/set lock

 

- Removes the ability for a person to self-assign the role via command

perma

!roleopt RoleName add/rem/set perma

 

- Sets the role to be permanently assigned to someone

auto

!roleopt RoleName add/rem/set auto

 

- Sets the role to be automatically assigned to a newcomer

reset

!roleopt RoleName add/rem/set reset

 

- Sets the role to be able to be reset (removed from everyone) with the reset command

age

!roleopt RoleName add/rem/set 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)

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)

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)

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)

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.

image-1587096587706.png

 

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

!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

!setrolereact current [message id]

 

- Displays all current settings in the reaction roles system

- Providing a message ID displays the current system on the message

delete

!setrolereact delete messageID

 

- Deletes the reaction role system from the given message

restart

!setrolereact restart messageID

 

- Restarts the reaction role setup process for an already existing system

move

!setrolereact move messageID messageID

 

- Moves an existing reaction roles system from one message to another

addreact

!setrolereact addreact messageID @reactionRole

 

- Adds a reaction role to an existing system.

Supplying the @role is mandatory.

deletereact

 

!setrolereact deletereact messageID @reactionRole

 

- 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

 

(Top of Page)

Previous Page   |   Next page

Modules(rewrite)

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)

 

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

!purge 10

 

- Purges 10 messages from the channel

!purge amount @mention

!purge 10 @yeetmaster#3000

 

- Purges 10 messages from a specific user in the channel

!purge amount @rolemention

!purge 10 @Troll Role

 

- Purges 10 messages from a specific role in the channel

!purge amount text

!purge 10 REEE

 

- 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

!purge 10 --startat 833536475148058624

 

- "Start at this message ID and work your way downward"

--stopat

!purge 10 --stopat 833536475148058624

 

- "Work your way upward until you get to this message ID"

--range

!purge 10 --range 833536475148058624 833536475148058625

 

- "Start at this message ID, but don't go past that message ID"

--startswith

!purge 10 --startswith pancakes

 

- "Delete messages that starts with the word 'pancakes'"

--includes

!purge 10 --includes pancakes

 

- "Delete messages that has the word 'pancakes'"

--endswith

!purge 10 --endswith pancakes

 

- "Delete messages that has the word 'pancakes' at the end"

--mentions

!purge 10 --mentions @Staff

 

- "Delete messages that have this specific mention"

It is possible to use more than one mention for a wider search.

Example: !purge 10 --mentions @Staff @Mod @Supporter

--links

!purge 10 --links

 

- "Delete messages that have a link"

--bots

!purge 10 --bots

 

- "Delete messages created by bots"

--images

!purge 10 --images

 

- "Delete messages that have an attachment"

--invites

!purge 10 --invites

 

- "Delete messages that have a server invite link"

--embeds

!purge 10 --embeds

 

- "Delete messages that contain embedded text"

--not

!purge 10 --not --bots

 

- "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

 

(Top of Page)

Previous Page   |   Next page

Modules(rewrite)

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)

 

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

!learn yeet %content WOOHOO!

 

- Sends the specified response message

Beginning

%target

!learn yeet YEEETTT %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

!learn yeet YEEETTT %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