Gaius

Wiki on everything Gaius Cicereius and Gaius Plus

FAQ

Dashboard?

At this time it isn't possible but we do plan to provide one in the future.


Patreon

View all the details around the Patreon system here.

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

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.

Modules

Modules

Commands

Create custom commands for your community with variable outputs and settings. Great for social and minor utility commands.

REQUIRES: Manage Messages, Embed Links

Setup

Command Description
!module commands Enable/Disable the module
!learn input output Learn a new command
!unlearn input Unlearn a command
!cmds View all local commands

Shortcodes

Put these at the end of your command to give it special effects

%message Message contents
%server Server name
%channel Channel name
%me Mentions the command issuer
%user First mentioned user
%target Sets the person to receive a dm if %dm is used, just for the first-mentioned user
%dm Sets the output to DM
%cCommandName
Example: %cwarn
Full message into the command designated.
%embed Sets output to embed
%admin Admin only command
%cd #%
Example: %cd 10%
Cooldown in minutes

Restrictions

{require: role, role, role} Require that the person using the command have a certain role or roles, you can use either an id or name, roles must be spaced by a comma.
{deny: role, role, role} Require that the person using the command NOT have a certain role or roles, you can use either an id or name, roles must be spaced by a comma.
{role: role, +role, -role} Add, remove, or toggle a role for the person using the command, a + is a role to be added only, a - is for a role to removed only, and not using either will remove or add the role if the member has it or not. Roles must be spaced by a comma.

Examples

Warn + Custom message.

Because why not? This command will issue a warn for the message provided while also sending the message above the warn DM.


DM + Verbal Warn
The user will receive an embedded DM telling them their avatar must be SFW.
?learn avatar Notify: %server requires users to have SFW avatars. 

Failure to adhere to these requirements may result in punishment from staff %user. %target %dm %embed %admin
Modules

Welcomes

Post welcome and leave messages for users. Utilize rich embeds, Direct Messages and more to suit your needs.

REQUIRES: Manage Messages, Embed Links

Welcomes will not be posted for users blocked by BlankAvatar and JoinAge.

Setup

Command Description
!module welcome Enable/Disable the module.
!setchannel welcome #channel Set the welcome channel
!setchannel leave #channel Set the leave channel
!setwelcome current Display current welcome
!setwelcome new CONFIG Set a new welcome message
!settype welcome embed/text/dm Set the type of welcome
!settype leave embed/text Set the type of leave
!setdelete seconds Auto delete welcome/leaves after X seconds.
!setleave disable Disable leave messages
!settype verifywait Post welcomes once users go through Verify

Setting up welcomes

  1. Enable the welcome module

  2. Mark the welcome channel with !setchannel #channel

  3. Set the type of message you'd like welcomes to appear in using: !settype welcome embed/text/dm

  4. Now it's time to set up the actual welcome message you want for your server, the next section will go over that process which is pretty easy!


Making your welcome message

You have two options when it comes to doing this, make it from scratch or use one of our pre-made templates you can just modify as needed. If you want to use one of our template filters you can check them out below.

Variables
Display Shortcodes Shortcodes
$plain:  %user%
$plain: disable %guild%
$title:   
$desc:   
$thumb:   
$img:   
$field:   
$color:   
%user%  
%guild%  

Template Examples

Example #1
!setwelcome new $plain: plain text goes here
$title: Title
$desc: Description
$thumb: URL (or use %user% for user avatar)
$img: URL
$field: Field name %% Content
$color: Any type of color code accepted by Discord

Example #2
!setwelcome new $plain: This is plaintext, it goes above the welcome message
$title: This is the title, it\'s bolded 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: undefined

image-1586242215100.png

Modules

Verification

REQUIRES: Manage Roles, Manage Messages, Embed Links

Setup

The command you set for users to use to start verification will use your current prefix. For example, if you make the command  Accept and your prefix is   ! then users will do !Accept

Command Description
!module verify Enable/Disable the module
!setverify Setup Verify
When you're ready to set up the Verify module, enable it and then do !setverify.

HELP: My roles aren't being assigned!

If a role is not being assigned when verification is attempted, ensure the following:


Captcha

This is a feature is only available on Gaius Cicereius+.

When users join your server Gaius+ will DM the user having them go through a custom made captcha. This captcha is internal in Discord so your users do not have to open their browsers and spend time outside your community to get verified.

When you start the setup for Verify there will be an option for enabling Captcha. This option will only work with Gaius Plus authorized servers.

Modules

Gatekeeper

REQUIRES: Manage Roles, Manage Messages, Embed Links

About

Gatekeeper is service for verifying and filtering new users in communities based on select social media accounts. Using Discords OAuth system Gaius can have new users go through a verification process.

This allows owners to have new users require an account on select platforms like Reddit, YouTube etc. Using these owners can require new users to have X Reddit karma, minimum account age, specific game owned on steam etc.

Setup

Command Description
!module gatekeeper Enable/Disable the module.
!gatemsg title Text Set the title for gatekeeper messages.
!gatemsg desc Text Set the description for gatekeeper messages.
!gate list Display all your gates.
!gate add/delete/remove platform Add/Remove that gate.

Supported Platforms

Platform Options
Reddit Username, Karma, Creation Date (Age)
Steam Username, Games owned, Total hours, VAC Bans, Eco Bans
YouTube Username
Modules

Tickets

REQUIRES: Manage channels, Manage Messages, Embed Links

Setup

The ?pobox command will configure the mailbox where tickets will be initially dumped and how they are handled.

Command Example ?pobox Category HelpDesk

Command Description
!pobox current Current settings for POBox.
!pobox channel #channel Where tickets will be posted.
!pobox category Modmail Where ticket channels are made.
!pobox agelimit The minimum account age needed to submit tickets.

!pobox response Ticket sent, talk to you soon!

Once the mail is submitted, what gets sent to users.

!pobox responsetype embed/text

Type of response message to give.

!pobox newmailmsg New ticket submitted. %tid.

New ticket message for staff. Appears in the 'channel'.

!pobox forcedump

Whether or not to force dumping of a ticket into the 'channel' and in a specific format, valid input is 'html', 'text', or 'off'.

!pobox newmailtype

Type of response message to give in 'channel'

NOTE: When using newmailmsg and response you are allowed to use multiple flags for variables, listed below

Variables

Variable Description
%name Mentions the ticket sender.
%tag Username#### of ticket sender.

%id

UserID of the ticket sender.
%date Date of ticket submission.

%tid

Ticket ID

%mid

Message-ID from ticketing channel.

%guild

Server Name

%content

Content of the ticket entirely

%uimg

Avatar URL of the ticket sender.

Administration

Command Description
!module tickets Enable/Disable the module.
!assign userid ticketid Assigns the staff member to, and opens if need be, a given ticket. Requires a member reference and ticket number.
!unassign userid ticketid Unassigns a staff member from the ticket.
!closeticket ticketid Closes the given ticket, marking it resolved and deleting the channel. Will also create a full dump of the channel if requested.
!ticketstatus ticketid Displays the given ticket status.
!blockticket userid Prevents that user from submitting tickets.
!unblock userid No longer prevents that user from submitting tickets.

Public

Command Description
!send Send a ticket to the staff of this server. This is completely private. Upon activation the bot will DM you asking for input, waiting up-to 10 minutes.
Modules

Suggest & Report

REQUIRES: Manage Messages, Embed Links

Suggestions

image-1585808616583.png

Some servers love to hear what users want to see on the server or changed, the Suggest feature is great for handling these since it allows for the suggestions to appear in a specific channel and allow users to vote on them.

Setup

Command Description
!set suggest on/off Toggle suggestions.
!set suggest #channel Where suggestions go.

Public

Command Description
!suggest Your suggest described Submits your suggestion.

 

Reports

Example of a user reporting someone

This feature allows users to report user(s) for malicious activity to local staff.

Setup

Command Description
!set reports on/off Toggle reports.
!set reports #channel Where reports go.

Public

Command Description
!report UserID/Mention reason Reports the user.
Modules

Roles

REQUIRES: Manage Messages, Embed Links

Setup

Command Description
!module roles Enable/Disable the module.
!addrole rolename Allows that role to be self-assigned.
!addrole @rolename Allows that role to be self-assigned.
!delrole rolename No longer allows self-assigning of that role.
!setdesc rolename description Sets the description for the role.
!roleslist Displays all self-assignable roles.
!reset rolename Removes that self-assignable role from everyone with it.

 

Roleopt

!roleopt rolename add options

!roleopt Member add auto, perma

Add options to a custom role

Gives the member role automatically and permanently.

!roleopt rolename rem options Removes the options from the custom role.
Roleopt options

unique

unique2

unique3

Let users choose only one role within the unique group.
Create a second group of roles you can only choose one from.
Create a third group of roles you can only choose one from.

reset Assign this to a role you'd like to reset and use the !reset command
perma Once a role with this option is self-assigned/given it cannot be removed
auto Automatically assign this to users upon join
vc Automatically assigned to users when they join a voice channel

timer

timer10

Automatically remove the role from the user after X minutes

 

Assigning roles

!role userID/@mention rolename

!role userID/@mention +rolename

!role userID/@mention -rolename

Toggle the role for the user.

Only add the role to the user.

Only remove the role from the user.

!role all rolename

!role all +rolename

!role all -rolename

Toggle the role for everyone in the server.

Only add the role to everyone in the server.

Only remove the role from everyone in the server.

Modules

Reaction Roles

REQUIRES: Manage Messages, Send Links, Add Reactions

This is a feature reserved for Gaius Cicereius+, our Patreon bot.

image-1587096587706.png

Setup

Command Description
!setrolereact #channel Start adding a new reaction role.
!setrolereact current Displays current reaction roles.
!setrolereact delete messageID Delete the reaction roles for that message.
Modules

StatTrack

Create channels to display your server mini-stats. Even display a clock used for events etc in your community if you so choose.

REQUIRES: Manage channels

Members

A member online count tracker that updates a customizable channel to display the number of total online members when a member comes online, DND, idle, or vice versa.

Setup

This is ordered by usage. Start with the first and move down the list. The bold text represents the stat type, underline is the channel name or channel ID.

Example Description
!stattrack add members channelName Sets the channel for the Member counter.
!stattrack msg channelname %d Members Sets the stat format.
!stattrack enable channelName Enables the Member counter.
!stattrack disable channelName Disables the Member counter.
!stattrack delete channelName Deletes the Member counter on that channel. (Y/N)
!stattrack current Display current Stat channels will also, remove deleted ones.
Developer Version
Channel ID Examples Description
!stattrack add members Channel ID Sets the channel for the Member counter.
!stattrack msg Channel ID %d Members Sets the stat format.
!stattrack enable Channel ID Enables the Member counter.
!stattrack disable Channel ID Disables the Member counter.
!stattrack delete Channel ID Deletes the Member counter on that channel. (Y/N)

 

Online

A member online count tracker that updates a customizable channel to display the number of total online members when a member comes online, DND, idle, or vice versa.

Setup

This is ordered by usage. Start with the first and move down the list. The bold text represents the stat type, underline is the channel name or channel ID.

Example Description
!stattrack add online channelName Sets the channel for the Online counter.
!stattrack msg channelName %d Online Sets the stat format.
!stattrack enable channelName Enables the Online counter.
!stattrack disable channelName Disables the Online counter.
!stattrack delete channelName Deletes the Online counter on that channel. (Y/N)
!stattrack current Display current Stat channels will also, remove deleted ones.
Developer Version
Channel ID Examples Description
!stattrack add online channel ID Sets the channel for the Online counter.
!stattrack msg channel ID %d Online Sets the stat format.
!stattrack enable channel ID Enables the Online counter.
!stattrack disable channel ID Disables the Online counter.
!stattrack delete channel ID Deletes the Online counter on that channel. (Y/N)

 

Server Age

A server age counter which tracks the age of the server.

Setup

This is ordered by usage. Start with the first and move down the list. The bold text represents the stat type, underline is the channel name or channel ID.

Example Description
!stattrack add age channelName Sets the channel for the Age counter.
!stattrack msg channelName %d days old. Sets the stat format.
!stattrack enable channelName Enables the Age counter.
!stattrack disable channelName Disables the Age counter.
!stattrack delete channelName Deletes the Age counter on that channel. (Y/N)
!stattrack current Display current Stat channels will also, remove deleted ones.
Developer Version
Channel ID Examples Description
!stattrack add age channel ID Sets the channel for the Age counter.
!stattrack msg channel ID %d days old. Sets the stat format.
!stattrack enable channel ID Enables the Age counter.
!stattrack disable channel ID Disables the Age counter.
!stattrack delete channel ID Deletes the Age counter on that channel. (Y/N)

 

Clock

A clock that updates every minute. It can display the day of the week, month, year, and timezone. The message is completely customizable.

Setup

This is ordered by usage. Start with the first and move down the list. The bold text represents the stat type, underline is the channel name or channel ID.

A list of all applicable time zones in the setup can be found here.

Example Description
!stattrack add clock channelName Sets the channel for the clock.
!stattrack msg channelName %t %tzPST Sets the stat format.
!stattrack enable channelName Enables the Clock.
!stattrack disable channelName Disables the Clock.
!stattrack delete channelName Deletes the Clock on that channel. (Y/N)
!stattrack current Display current Stat channels will also, remove deleted ones.
Developer Version
Channel ID Examples Description
!stattrack add clock channel ID Sets the channel for the clock.
!stattrack msg channel ID %t %tzPST Sets the stat format.
!stattrack enable channel ID Enables the Clock.
!stattrack disable channel ID Disables the Clock.
!stattrack delete channel ID

Deletes the Clock on that channel. (Y/N)

Variables
%wd Weekday Sunday
%t Time 8:49pm
%tzZONE
%tzPST
%tzEST
%tzCST
etc...
Timezone to use PST
%-DST Stops using DST time  
%24 24HR clock 21:49
%d Day of the week 14
%m Month 7
%y Year 2020
Some examples would be
Currently %wd %t %tzEST %-DST Currently Sunday 8:49pm
%d %m %t %tzEST %24 14 7 21:49
%wd %d %m %y Sunday 14 7 2019
%t %tzEST %wd 8:49 pm Sunday

 

Modules

Notifications

Posts notifications for errors, issues and other various opt-in notification. 

REQUIRES: Send messages, Embed Links

Setup

!module notifications
Reply mentioning the channel you want notifications in
Enable/Disable the module

Moderation

Moderation

Handbook

Bans (Page)

Command

Description

!ban mention/UserID reason

Bans the user from the guild

!ban @mention @mention reason

Ban multiple users at once

!ban UserID UserID reason

Ban multiple users at once

!unban username

Unbans the user from the guild

!tempban mention/UserID time reason

Tempbans the user from the guild

Time length types: 1d 1h 1m 1s

Kicks (Page)

Command

Description

!kick mention/UserID reason

Kicks the user from the guild

!kick @mention @mention reason

Kick multiple users at once

!kick UserID UserID reason

Kick multiple users at once

!softban mention/userID reason

Kicks the user and deletes the messages from them within the last 24 hours

Mutes (Page)

Command

Description

!mute mention/userID time reason

Mutes the specified user

Time length types: 1d 1h 1m 1s

!unmute mention/userID

Unmutes the user

!vcmute mention time

Voice mutes the mentioned user for X minutes

!vcunmute mention

Voice unmutes the mentioned user

Warns (Page)

Description

Perm

!warn mention/UserID reason

Warns the specified user

!warnlist mention/UserID

Displays all the warns for the user

!warnlist like search text

Displays all warn logs with users containing the specified text

!warnlist mod mention

Displays all the warns the mod has issued

!warnlist all

Displays all warns on your server

!pardon WarnID

Pardons the warn

Purger (Page)

Command

Description

!purge number

Purges the specified amount of messages from the channel

!purge number @mention

Purges the specified amount of messages from a specific user in the channel

!purge number text

Purges the specified amount of messages with that text/letter in the channel

User Information (Page)

Command

Description

!user mention/UserID

Displays detailed information about a user

!rapsheet mention/UserID

Look up the punishment history, mutes, kicks, and bans of a member.

Voice Moderation (Page)

Command

Description

!vcmute mention time

Voice mutes the mentioned user for X minutes

!vcunmute mention

Voice unmutes the mentioned user

Emergency channel locks (Page)

Command

Description

!lock

Disable @everyone perms to talk in that channel

!unlock

Re Enable @everyone perms to talk in that channel

 

Moderation

Bans

REQUIRES: Ban, Manage Messages (If using -d)

Setup

Command Description
!module bans Enable/Disable the module.
!allow ban role Moderator Allows the role Moderator to use the ban command.
!block ban role Moderator No longer allows the Moderator role to use the ban command.

Staff

Command Description
!ban @mention/userID OptionalReason Bans the user
!ban @mention @mention @mention OptionalReason Bans multiple users
!ban userid userid userid OptionalReason Bans multiple users
!unban username/userID Unbans the user
!tempban @mention/userID days OptionalReason Bans the user from your guild for the set amount of days.

Banmsg

Set up a message that will be sent to the user when they are banned, provided they have direct messages open. Provide 'off' to turn it off. It can be used for appeal links etc.
Command Description
!banmsg message Sets the ban message sent upon being banned.
Moderation

Kicks

REQUIRES: Kick, Manage Messages (Softbans)

Setup

Command Description
!module kicks Enable/Disable the module

Staff

Command Description
!kick @mention/userID OptionalReason Kicks the user.
!kick @mention @mention OptionalReason Kicks multiple users.
!kick userid userid OptionalReason Kicks multiple users.
!softban @mention/userID OptionalReason Kicks the user and deletes the last 24hours of their messages.
Moderation

Warns

REQUIRES: Manage Messages

Setup

Command

Description

!module warns

Enable/Disable the module

!pwarnings ?

Display information for the command

!pwarnings list

Display your current settings

!purgewarn WarnID

Completely deletes the warning from the record

!pwarnings number punishment

Sets an auto punishment for when users reach the specified amount of warns

!pwarnings autopurge days

Automatically purge warnings after X days

!pwarnings autopardon days

Automatically pardon warns after X days

!pwarnings time 5

Sets the auto-mute for warns to 5 minutes

Punishments

When utilizing pwarnings you can set punishments to be executed at different amounts of warns. 

Staff

Command

Description

!warnlist mod mention

Displays all warns issued by the mod

!warn mention/userID reason

Warns the specified user

!rewarn warnID New reason

Changes the warn reason.

!warnlist mention/userID

Displays all the warns for the user

!warnlist like search text

Displays all warn logs with users containing the specified text

!warnlist all

Displays all warns on your server

!pardon WarnID

Pardons the warn

What are Warn IDs?

Every warn has an ID when issued. This ID is can be used for the Purgewarn and Pardon command. You can see the WarnID below is 3.

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

Moderation

Mutes

REQUIRES: Manage Roles, Manage Channels (If channel overwrite)

Mute Types

When you enable the mutes module you'll be presented with 3 mute type choices. Simply reply in the chat with the Type name you want.

Type

Description

Role

Will remove all the roles a member has and add a mute role the bot creates. Then it will re-add the roles after the mute expires.

Cleanrole

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.

Overwrites

Will automatically put channel overrides in every channel blocking their permissions.

Staff

Command

Description

!module mutes

Enable/Disable the module.

!switchm

Redo your Mute type.

!mute @mention/userID time OptionalReason

Mutes the specified user.

Time length types: 1d 1h 1m 1s

!unmute @mention/userID

Unmutes the user.

!vcmute @mention time

Voice mutes the mentioned user for X minutes.

!vcunmute @mention

Voice unmutes the mentioned user.

!switchm

Switches from channel-based muting to role-based.

Note

By default mutes are in minutes. However you can issue mutes in more precise times for example:

Moderation

Voice Chat Tools

REQUIRES: Mute Members, Move Members

Commands

Command

Description

!vcmute @mention time

Voice mutes the mentioned user for X minutes

!vcunmute @mention

Voice unmutes the mentioned user

!vckick @mention/UserID

Voice kicks the user(s), accepts list format.

!vckick userid userid userid

!vckick mention mention mention

!vcmove

See note below this table to learn how to use this

How do I use !vcmove

Move users from one designated voice channel to another. The bot will join the designated channel, move the bot to the channel you would like to move the users to and it will move them.

  1. Set the start point for the move, where are the users you want to move to? !vcmove Solo

  2. Now move Gaius to the channel you want them in now. For example, move Gaius from the Solo to the Duo voice channel

  3. Now all the users you wanted have been moved to Duo

Moderation

Purger

REQUIRES: Manage Messages

Commands

Command

Description

!module purger

Enable/Disable the module

!purge number

Purges the specified amount of messages from the channel

!purge number @mention

Purges the specified amount of messages from a specific user in the channel

!purge number @rolemention

Purges the specified amount of messages from a specific role in the channel

!purge number text

Purges the specified amount of messages with that text/letter in the channel

Advanced Purging

Example: !purge 10 images will purge the last 10 images in the channel.

Variable

Description

role

Whether or not to check for roles

mentioned

The role or user id to look for

not

Whether to invert all options except the role

startswith

Check if 'themsg' ends the string

endswith

Check if 'themsg' ends the string

links

Checks for links

bots

Check for messages by bots

text

Check for messages containing text

images

Check for messages containing only image attachments

Invites

Check for messages containing invites only

Embeds

Check for messages containing embeds

Moderation

Panic

REQUIRES: Manage Roles

Panic

Auto mutes all new users that join your server via a created role.

Setup

Command Description
!panic Enable/Disable panic mode.

Auto Panic

This feature is reserved for Gaius Plus only. Learn more.

When several users join within a few seconds Gaius will automatically engage panic mode muting users that join henceforth till disabled by a member of staff.

Setup

Command Description
!setautopanic ? Displays help embed.
!setautopanic on/off Enable/Disable auto panic.
!setautopanic current Displays current settings.
!setautopanic users number Users needed to trigger AP.
!setautopanic time number

Time to check for the needed amount of users to trigger.

!setautopanic users 5

The minimum users needed to trigger AP is 5 now.
(Default is 5 users)

!setautopanic time 25

Minimum seconds to check for 5 users joining to trigger AP.
(Default is 25 seconds)

The example numbers above translate simply to, if 5 users join within 25 seconds, Panic mode will automatically be enabled and all new users joining will be muted via role.
Moderation

Channel Locks

REQUIRES: Manage Channel, Manage Permissions

Small freeze, simply turns the @everyone role to not be able to speak in the channel you do it in, basic stuff.

Commands

Command

Description

!lock

Disable @everyone perms to talk in that channel

!unlock #channel

Re-Enable @everyone perms to talk in that channel

Moderation

WHOIS

Staff

Command

Description

!user mention/UserID

Displays detailed information about a user

!getid mention

Posts the userID of the mentioned user

!get mention/UserID

Displays brief information about the user

!guildinfo

Displays information about your guild

Moderation

SmartPrune

REQUIRES: Kick

A smart prune that will remove people based on certain aspects. You can specify avatar to remove everyone with a blank avatar or invite to remove all active invites with less than x uses.

Commands

Command

Description

!smartprune avatar

Kicks all users without custom avatars

!smartprune invite uses

Removes all invites with less than the stated number of uses

Moderation

Freeze & Thaw

REQUIRES: Manage Channels, Manage Permissions

This feature is reserved for Gaius Plus only. Learn more.

Freeze the server by denying everyone permission to speak or add reactions, for after raid clean up and mid raid stopping. Thaw a server from "freeze" restoring all previous permissions that were present before the freeze.

Staff

Command

Description

?freeze

Freezes the server completely

?thaw

Restores the server to its previous state

Moderation

Slowmode

REQUIRES: Manage Channel, Manage Messages

Setup

Command

Description

!slowmode number

Sets that channels slowmode to the specified number of seconds

!slowmode 0

Turns slowmode off in that channel

!slowmode ?

Displays current slowmode configuration

!slowmode #channel number

Sets that channels slowmode

!slowmode server number

Sets a serverwide slowmode

Auto-moderation

Auto-moderation

BotLog

REQUIRES: Manage Messages, Embed Links

Standard Logging

Doing !toggle log in a channel will automatically enable all log types to be posted in that channel.

Command Description
!toggle log Enables all logging in that channel.

!toggle type

!toggle bans

Toggles that type to the channel.

!toggle #channel type

!toggle #logs bans

Set that log to the channel.

!toggle -1 type

!toggle -1 bans

Disables that log type
!toggle View current settings

Available log types


Extreme Logging

This is a feature reserved for Gaius Cicereius+, our Patreon bot.

Command Description
!exlog View current settings.
!exlog log Toggles all types on/off in that channel.
!exlog #channel logtype Set that log type to the channel.
!exlog -1 logtype Disables that log type.
!exlog ignore Exlogs will not record that channel.

Exlog types

Name Logs
member_add User joins, account age and other user information.
member_remove User leaves, when they joined and what roles they had.
member_update Nickname changes, roles and so forth per user.
user_name Username changes.
user_pic When users change profile pictures, displays previous if possible as well.
vc_join When users join a voice channel and which one.
vc_leave When users leave a voice channel and which one.
vc_change When users change voice channels and to which ones.
message_delete Deleted messages, content, author, channel etc.
message_bulk This will detail when a BOT mass deletes messages. It will dump a text file with a collection of message_delete style logs.

message_update

Logs before and after copies of edited messages.

role_update

Logs when a role is edited and what was changed.

role_delete

Logs when a role is deleted.

channel_create

When channels are created.

channel_delete

When channels are deleted.

channel_update

When channels are edited.
Auto-moderation

Anti-Spam

We offer highly customizable anti-spam. The settings are ideal by default, but, if you'd like to configure them yourself, you can view that information below. You may also turn off any of these settings by supplying the number -1. Notify and name doesn't need -1.

Overview

Foundation
!auto ? Display auto-configuration help embed

!auto

Display current settings

!auto modstaff

Force anti-spam and filters to apply to your moderators.

!auto notify

Should users be notified when they trigger automod?

!filter ignore auto

Disable anti-spam in the channel.

!filter ignore auto #channel

Disable anti-spam in the mentioned channel.

 

Mentions

Limitations you can require for mentions. The last two are used to handle mention spam.

!auto mention 5 Amount of mentions allowed in a single message
!auto mentiontime 5 The amount of seconds to wait for the mentionlimit to be triggered across multiple messages.
!auto mentionlimit 5 Amount of mentions per message, includes the same mentions and unique mentions

 

Anti-Spam

These are various limitations you can require messages to stay within. You can disable a setting by doing -1 as the number.

Time and limit are inversely related. This means that setting the time lower has the same effect as setting the limit higher. For high-speed chats setting the limit higher is better as it reduces the chance of a quick 3 or 4 messages from triggering.

For low-speed chats setting the time lower is best as it'll be more sensitive to quick spam messages.

!auto limit 5 Amount of messages to check for
!auto time 5 Amount of time to check for spammed messages
!auto duptime 5 Time between messages to wait for duplicates.
!auto tolerance 2

If someone posts a duplicate of a previous message with a difference of 2 letters or less, it will be deleted.

 

The difference between messages to tolerate in terms of letters changed.

!auto newline 10 Amount of lines allowed per message
!auto emoji 10 Max amount of emojis per message

 

Auto Punishments

Escalate punishments overtime when users trigger anti-spam. When setting the punishments those will only be applied at the number set. This means you can do let's say !auto warn 1 and then  !auto warn 2 so warns are issued for their first and second violation of anti-spam.

To remove a warn punishment at 1 you can do let's say !auto warn 1 again to toggle it off.

!auto mutetime 20 The number of minutes the auto-mute should last.
!auto mute 1 Auto mute users for the first violation.
!auto kick 2 Auto kick users for their second violation.
!auto ban 3 Auto ban users for their third violation.
!auto warn 1 Auto warn users for their first violation.
!auto cooldown 5 Amount of minutes between anti-spam triggers before de-escalating the punishments

 

User Checks

The name setting is tied to the filters you have enabled. If a user tries to nickname or has a username with a word on any of your enabled word filters their name will be edited to remove the offending content.

!auto name Automatic name censor on member join and when someone changes their name.
!auto status Automatic status censor on member join and when someone changes their custom status.
Auto-moderation

JoinAge

REQUIRES: Ban, Kick or Manage Roles (if mute).

AccountTooYoung.png

Setup

Sets the account age restriction for the server as well as the punishments executed upon violation.

Command Description
!setjoinage ? Displays help embed.
!setjoinage current Displays current settings.

!setjoinage off

Disables joinage

!setjoinage 5

Sets the required age to 5 days minimum.

!setjoinage mute/kick/ban 5

Sets the punishment and required age.
!setjoinage mute/kick/ban Execute that action if unable to meet the age requirements.
!passport userid Allows that user to bypass joinage.

Durations

Joinage allows you to set very specific age requirements. 

Command Example Description
!setjoinage ban 3d 12h 6m 2s The minimum age needed is 3d 12h 6m 2s.
Failure to meet that results in ban.
!setjoinage mute 30m Mutes the user for 30 minutes if too young.

 

Auto-moderation

BlankAvatar

Requires: Ban, Kick or Manage Roles (if mute).

BlankAvatar.png

Setup

Requires users that join to have a custom avatar in order to join. Failure to have one will result in the set punishment.

Command Description
!auto blankavatar Enable/Disable the blankavatar filter.
!auto blankavatar ban/kick/mute Execute that action if no avatar set.
!passport userid Allows that user to bypass blankavatar.
Auto-moderation

Banned Words

REQUIRES: Manage messages

Filter.png

Banned word example

BanName.png

Banned word example with variables.

Setup

Command Description

!banword word

!banword potato

Bans the word.

!banword word, word

!banword potato, tomato

Bans multiple words.

!unbanword word

!unban potato

Unbans the word.

!unbanword word, word

!unban potato, tomato

Unbans multiple words.

!filter clear

Empties your filter.

!banword %regex insert your regex here

Ban a custom regex

Variables

Variable Description
%w Only the exact match.
%b Check only the beginning of words.
%e Check only the end of words.
%c Case sensitive (100% match only)
%mute Auto perma mute.
%mute6 Auto 6 minute mute.
%warn Auto warn.
%kick Auto kick.
%ban Auto ban.
%name Only apply that banned word to names/nicknames.
%notify
(REQUIRES: the Notifications module)
Posts a notification through the Notifications module

%notifynd

(REQUIRES: the Notifications module)

Posts a notification through the Notifications module
But will not delete the banned word.

You can filter usernames based on your banned words with  !auto name which checks joins and name updates.
(Learn more)

Tuning

Command Description
!filter ignore text Ignores text filters in the channel.
!filter ignore text #channel Ignores text filters in that channel.
!filter recog text No longer ignores text filters in the channel.
!filter recog text #channel No longer ignores text filters in that channel.
!filter view ignores View all active ignores in your server.
!filter view local View your current banned words list.

Example Bulk Bans

Example Notes
!banword pop, pizza, bacon  
!banword pop, pizza %mute, bacon %kick  
!banword pop %kick, pizza, %kick  
!banword rude %name, potato %name %kick  
!unbanword pop, pizza, bacon You do not need to include variables when unbanning words. Just the plain word itself only.

 

Auto-moderation

Template Filters

REQUIRES: Manage Messages

image-1587021284194.png

Template Filters

We've created and tuned categorized filters so you don't have to spend time thinking about every possible bad word to ban.

Filters

Setup

Command Description
!filter name Enables/Disables that filter.
!filter recommended Toggles the recommended filter.
!filter view name PM's a copy of the filter.
!filter ignore text #OptionalChannel Ignores the text filter in that channel.
!filter recog text #OptionalChannel No longer ignores the text filter in that channel.

Customize

Merge a template with your local Banned Words so you can customize it for your server. Once merged you can use banword and unbanword to customize it.

Example Description
!merge recommended Merges the recommended filter.
!unmerge filter Unmerges the recommended filter.

NSFW Filter

Our image scanning may not always be accurate as we use a third party API to handle the massive load of images we process. So bare with us if a rare issue arises.

One of our best (and most popular) features is our image filtering. This allows Gaius to keep NSFW images off of your server and keep you, and your users safe from nasty imagery.

Levels

A

"Adult" - Filter off (Default setting)

T

"Teen" appropriate and under images only

E "Everyone" appropriate only - Kid-friendly

Setup

Command Description
!censor letter Sets the image tolerance level.
!filter ignore URL #OptionalChannel Ignores the NSFW & URL filter in that channel.
!filter recog URL #OptionalChannel No longer ignores the NSFW & URL filter in that channel.

NOTE: Gaius will auto ignore all NSFW channels and not filter images in them.

Auto-moderation

URL & Invites

REQUIRES: Manage Messages

Invite Filter

Invite.png

Filter invites in your community. For example: discord.gg/, discordapp.com/invite, etc.

Setup

Command Description
!filter invite Enable/Disable the invite filter.
!whitelist add invitelink Allows that invite to be posted.
!whitelist rem invitelink No longer allows that invite.
!whitelist list Displays allowed links.
!filter ignore invite #OptionalChannel Ignores invites in the channel again.
!filter recog invite #OptionalChannel Filters invites in the channel again.
!filter ignore invert invite #OptionalChannel

Ignores invites in all channels except for the current or

mentioned channel.

URL Filter

Filter all HTTP and HTTPS links in your server.

Setup

Command Description
!filter URL Enable/Disable the URL filter.
!whitelist add link Allows that link to be posted.
!whitelist rem link No longer allows that link.
!whitelist list Displays allowed links.
!filter ignore URL #OptionalChannel Ignores URL's filter in the channel again.
!filter recog URL #OptionalChannel Filters URL's in the channel again.
!filter ignore invert URL #OptionalChannel Ignores URL's in all channels except for the current or mentioned channel.
Auto-moderation

Channel Types

REQUIRES: Manage Messages

Types

Type Description
Image Only allow image attachments.
URL Allows URL's as well but no accompanying text.
Text Allows text only if accompanied by a URL or attachment.

Setup

Command Description
!ct #OptionalChannel type Sets the channel type for that channel.
!ct #OptionalChannel type off Removes the channel type for that channel.
Auto-moderation

BanSync

REQUIRES: Ban

This feature is reserved for Gaius Plus only. Learn more.

Upon BanSyncing with a server, both bans and unbans will be linked between the servers.

Setup

Command Description
!bansync

The base command for BanSync.

!bansync open

Opens the server for BanSync requests.

!bansync close

Closes the server to BanSync requests.

!bansync add serverID

Request a BanSync with the specified server.

!bansync rem serverID

Removes a BanSync with the specified server.

Auto-moderation

BlockTag

Block user or role tags in chat so that the message is automatically deleted. You can either define a custom message or let the bot default one for you.

REQUIRES: Manage Messages

blocktag.png

Setup

!blocktag ID optional message

!blocktag 104425482757357568 This user is AFK!

!blocktag @Tommyfoxy2#0001 This user is AFK!

!blocktag @Staff Do not ping staff unless needed!

Blocks the given tag or role from being mentioned.

!unblocktag ID

!unblocktag 104425482757357568 

!unblocktag @Tommyfoxy2#0001

!unblocktag @Staff

Unblocks the given tag or role.