Configuration

Permissions

You'll need the following roles to use the commands marked with these icons

Everyone Moderator+ Admin+ Gaius+
 

Moderator

Admin

Gaius+ Feature


All configuration/setting commands require a role with Administrator or a role marked as Admin with Gaius.

Prefix

Sometimes bots overlap with their prefixes if that's the case for you with Gaius' default prefix !, then you can easily change it to suit your needs.

Command About Example
!prefix Changes the prefix !prefix !!
!checkprefix Displays the current prefix !checkprefix

Auto Delete

Want command messages like !ban, !mute, !purge etc deleted upon successful execution? (Enabled by default)
Command About Example
!autodel Toggle autodel !autodel

 

Notifications Feed

This will send error reports and important bot announcements into your designated channel.

!module notifications Sets up the process for the notifications channel

 

Required Reason (for mod commands)

!module reqreason Requires mod commands like kick, ban, and mute to have a reason in order to be performed

 

 

Admins

Admins have the most power whilst using Gaius. They can configure the bot freely and completely for the specific guild. It is very much recommended to only give the "Owner" role the "Admin" permissions for Gaius. Admins are automatically exempt from Auto-mod measures.

Command Description Example
!admin add rolename Sets the role as bot admin. !admin add Admins
!admin rem rolename Removes that role as bot admin. !admin rem Admins
!admin list List all current admin roles. !admin list

Moderators

Moderators are the chat police for guilds. Mods cannot configure the bot, however, they can use a range of commands to moderate servers. Mods are also automatically exempt from Auto-mod measures.

Command Description Example
!mod add rolename Sets the role as bot moderator. !mod add Mods
!mod rem rolename Removes that role as bot mod. !mod rem Mods
!mod list Lists all current mod roles. !mod list

Helpers

Helpers are like trial mods, they have instant access to the !warn command only. They are also exempt from Auto-mod measures.
Command Description Example
!helper add rolename Sets the role as bot helper. !helper add Helpers
!helper rem rolename Removes that role as bot helper. !helper rem Helpers
!helper list Lists all current helper roles. !helper list

Bypass Roles

Roles marked with the bypass command will be ignored by Gaius when it comes to auto-mod measures, just like staff.

Command Description Example
!bypass add rolename Adds that role to the bypass. !bypass add Trusted
!bypass rem rolename Removes role as bypass. !bypass rem Trusted
!bypass list Lists all current bypass roles. !bypass list
!bypass help Displays help embed. !bypass help
List of Bypasses
  • Filter
  • Invite
  • URL
  • Spam
  • Duplicate
  • Mention
  • Emoji
  • Newline
  • Image
  • Slowmode

Aliases

Aliases can be quite useful. Let's say you want to have users use the bird command but want !burb to work too. You can add an alias for the bird command so !burb triggers the bird command.

You can also disable let's say the ban command entirely and only allow alias versions you make like !bean.

Command Description

!alias command force

!alias ban force

Ignore this command and only accept aliases of it

!alias command trigger

!alias ban bean

Use this as an alternative to the specified command

Now bean will execute the ban command

!alias ban force Now the ban command only works via aliases
!alias list Display all aliases
Command Description
!unalias command force Removes the force alias
!unalias command trigger Removes the trigger alias
!unalias ban force  
!unalias kick  

Permission Tuning

Restrict

Restrict a command or module to only be used in a certain channel, by a certain role, or by a certain user. Supply what type by adding role and rolename, member mention, or a channel mention.

!help restrict Displays the help embed and examples.

!restrict ban @Mention

!restrict ban Moderator

!restrict ban @Moderator

!restrict ban #staff

Restrict who and where the ban command can be utilized.
!cmdperm ban Display current tuned settings for the ban command.

Allow

Allows command permissions override, so that the designated, channel, role, or member can use the command.
This is for use when someone does NOT have permission to use a command and you want them to.

!help allow Displays the help embed and examples.

!allow kick @Mention

!allow kick Helpers

!allow kick @Helpers

Restrict who and where the kick command can be utilized.
!cmdperm kick Display current tuned settings for the kick command.

Block

Block usage of a command or module by specific members, roles or in a specific channel. Supply what type of ignore by adding server, role and rolename, member mention, or a channel mention.

This is for use when someone HAS permission to a command, but you don't want them too.

!help block Displays the help embed and examples.

!block mute @Mention

!block mute Trial-Mods

!block mute @Trial-Mods

!block mute #General

Restrict who and where the kick command can be utilized.
!cmdperm mute Display current tuned settings for the mute command.

Free

Clean a command of usage restrictions, takes command or module name and the same format as allow and block.
This is for when you block, restrict etc a command or module. You can use Free to undo it.

!help free Displays the help embed and examples.
!free kick Frees the command/module of all restrictions on it.