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 !prefix?

Auto Delete

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

Staff Roles

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

Command

Description

!Allow

This command GIVES full permission overrides to a person, role, channel or server, this can be used to gives mods ban perms, or regular users access to other commands. This is for use when someone does NOT have permission to use a command

!Block

This command DENIES full permissions to a person, role, channel or server. This can be used when someone does not want their mods the ability to mute, or people to be able to use certain commands such as cat dog etc. This is for use when someone HAS permission to a command, but they shouldn't

!Restrict

This command LIMITS permissions to a person, role, channel or server. This can be used to lock commands/modules to a certain channel, like how we have games locked to the #games-testing? channel. This is for use when you want only a specific role to be able to use a command, or only in a specific channel.

!Free

This command REMOVES the indicated type from a command. EG I !allow @Buckshot to use ban, !allow ban @Buckshot, I would then do !free ban @Buckshot. You can also leave it blank for full permission reset.

!Cmdperm

This command will list any permission overrides currently in effect, also letting you know what kind of override it is.

Common Examples

Commands

Description

!allow bans role @rolename

Allows the specified role to use the ban command.

!block colors @mention

Denies the specified user to interact with the colors module

!free colors @mention

No longer restricts the color module for that user

!cmdperm bans

Displays all permission overrides for the ban module.