Gaius

Wiki on everything Gaius Cicereius and Gaius Plus

FAQ

Dashboard?

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

View all the details and subscribe for Gaius Cicereius+ here.

Configuration

Permissions

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

Everyone Moderator+ Admin+ Gaius+
👨‍👩‍👧‍👦

🛡️

👑


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

Prefix 👑

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

Command Description Example
!prefix NewPrefix 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)?
NOTE: This also deletes the verification command used by unverified people.
Command About Example
!autodel Toggle autodel !autodel

 

Notifications Feed 👑

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

Command Description Example
!module notifications Begins setting the notifications channel !module notifications

 

Require Reason (Moderations) 👑

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

 

Admins 👑

Admins have the most power with Gaius. They can freely and completely configure the bot and are exempt from auto-mod. It's highly recommended to only give the "Owner" role the "Admin" permissions.

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 👑

Add or rem 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). Provide 'list' to get a list of current bypass roles and channels.

Command Description Example
!bypass add [code] role/channel Adds that role or channel to the bypass. !bypass add filter Trusted
!bypass rem [code] role/channel Removes role or channel from bypass !bypass rem URL #spam
!bypass list Lists all current bypass roles. !bypass list
!bypass help Displays help embed. !bypass help

 

Bypass Codes List


 

Alias/Unalias 👑

Aliases can be quite useful. Let's say you want to have users use the bird command but want !dog to work too. You can add an alias for the bird command so !dog 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 Example
!alias command trigger Sets an alternative to the specified command !alias ban bean
!alias command force Ignores the original command name and only accept aliases of it !alias ban force
(Accepts only aliases of ban)
!alias list Display all aliases !alias list
Command Description Example
!unalias trigger Removes the trigger alias !unalias bean
!unalias command Removes all the command's aliases !unalias ban
!unalias command force Removes the force alias !unalias ban force

 

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.

Command Description

!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.

Command Description

!allow kick @Mention

!allow kick Helpers

!allow kick @Helpers
!allow kick 
#staff

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.

Command Description

!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.

Command Description
!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 utility commands.

REQUIRES: Manage Messages, Embed Links, Manage Roles

Setup 👑

Command Description Example
!module commands Enable/Disable the module !module commands
!learn input output Learn a new command !learn hug %me hugged %user! %cd 2%
!unlearn input Unlearn a command !unlearn hug
!cmds View all local commands !cmds

 

Shortcodes

Add these into the output of the learn command to customize your commands.

Shortcode Description Placement
%message Sends specified response message At the beginning
%server Sends server name Anywhere
%channel Sends current channel name Anywhere
%me Mentions the command issuer Anywhere
%user Mentions the first mentioned user Anywhere
%target Sets the person to receive a dm if %dm is used, only for the first-mentioned user Anywhere
%dm Sets the output to DM At the end
%cCommandName
Example: %cwarn
Sends specified full message into the designated command At the end
%embed Sets output to embed At the end
%admin Sets command for "Admin Only" At the end
%cd #%
Example: %cd 10%
Sets command cooldown in minutes At the end

 

Restrictions

Command Description Example
{require: role, role, role} Requires command user to have a certain role(s)
Either roles' ID or name can be used
Must be separated with a comma
{require: 493297216392396820, Seasonal Event}
Place at the end of the learn command
{deny: role, role, role} Denies usage to the command user with a certain role(s)
Either roles' ID or name can be used
Must be separated with a comma
{deny: Member, Muted, Chad}
Place at the end of the learn command
{role: role, +role, -role} Adds, removes, or toggles a role for the command user
+ ---> Only adds role
- ---> Only removes role
No sign ---> Only toggles role.
Must be spaced by a comma
{role: ToggleRole}
{role: +PepeHands -PepegaHands}
{role: -BeanPole}
Place at the end of the learn command

 

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

In this example, 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

Configurations for posting welcome and/or leave messages for users and utilizing rich embeds and direct messages tailored to your needs.

REQUIRES: Manage Messages, Embed Links

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

Setup 👑

  1. Enable the welcome module

  2. Set the welcome channel: !setchannel #channel

  3. Specify the type of message for welcomes to appear as: !settype welcome embed/text/dm

  4. Configure the welcome message for your server

Command Description Example
!module welcome Enable/Disable the module. !module welcome
!setchannel welcome #channel Set the welcome channel !setchannel welcome #welcomes
!setchannel leave #channel Set the leave channel !setchannel leave #cyalater
!setwelcome current Display the current welcome !setwelcome current
!setwelcome new yourconfiguration Set a new welcome message !setwelcome new config
!settype welcome embed/text/dm Set the type of welcome !settype welcome embed
!settype leave embed/text Set the type of leave !settype leave text
!setdelete seconds Auto-delete welcome/leave after X seconds. !setdelete 45
!setleave disable Disable leave messages !setleave disable
!settype verifywait Post welcomes after user verification !settype verifywait

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:   
$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 👑

Command Description Example
!module verify Enable/Disable the module !module verify
!setverify Begin verification setup process !setverify
Notes

 

Captcha ➕

Modules

Gatekeeper

REQUIRES: Manage Roles, Manage Messages, Embed Links

About

Using Discords OAuth2 system, new users can go through a specific verification process known as Gatekeeper. Gatekeeper is a service for verifying and filtering new users in communities based on selected social media platforms.

Gatekeeper requires new users to have an account on Reddit, YouTube, and/or Steam, with specific conditions such as, in this example for Reddit, a certain amount of karma, minimum account age, or simply an account.

Setup 👑

Command Description Example
!module gatekeeper Enable/Disable the module. !module gatekeeper
!gatemsg title Text Set the title for gatekeeper messages. !gatemsg title Need Enough Karma
!gatemsg desc Text Set the description for gatekeeper messages. !gatemsg desc Your account can have access after connecting your Discord account to a Reddit account with enough karma.
!gate list Display all your gates. !gate list
!gate add platform
!gate delete platform
Add/Remove that gate. !gate add YouTube
!gate delete Reddit

Supported Platforms

Platform Options
Reddit have (Have an account)
karma (Have at least a certain amount of karma)
age (Have an account that is at least a certain age)
Steam have (Have an account)
game (Have this game)
totalgames (Total number of games own on the account)
totalhours (Total number of hours played on all games)
bans (Allowed to have community, VAC, eco, or game bans?)
YouTube have (Have an account)
viewcount (Have a total number of views)
subcount (Have a minimum number of subscribers)

 

General Setup Steps

Specific questions unique to certain options for chosen platform(s) may very. This section is intended to provide general guidance for the common steps of the gate command in order to help provide a smoother configuration experience.

1. Start by doing !gate add platform (e.g. !gate add YouTube).

2. Next you'll be given a list of options to choose from for the chosen platform.

3. Now you get to choose if you want it to be required, optional, or a part of a group of requirements.

4. After selecting one of the 3 previous options, you can choose to add or remove a role or go to the next step by saying done.

5. Finally, you can choose whether or not users are automatically kicked from the server, then re-added (pending OAuth2 permission) to the server.

General Gatekeeper setup completed. In our example, we have required users to have a YouTube account.

Modules

Tickets

REQUIRES: Manage channels, Manage Messages, Embed Links

Setup 👑

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

Command Example: ?pobox category HelpDesk

Command Description Example
!module tickets Enables/Disables the module !module tickets
!pobox current Shows current settings for POBox !pobox current
!pobox channel #channelToSendFrom Sets staff channel to send tickets for staff review !pobox channel #
!pobox category Tickets Category Sets channel category to send tickets for ticket handling !pobox category Tickets
!pobox agelimit  Sets user age requirement for sending (in days) !pobox agelimit 14
!pobox response Response message to be sent here. Variables Sets sending confirmation message !pobox response Your ticket has been submitted to our team for review. Talk to you soon!
!pobox responsetype embed or text Sets response embed or plain text !pobox responsetype embed
!pobox newmailmsg New message here. Variables Sets ticket message for staff to review in the channel !pobox newmailmsg **New Ticket Submission**

**From:** %name (ID: %id)

%content

%date 
%uimg
!pobox newmailtype Sets newmailmsg embed or plain text !pobox newmailtype embed
!pobox forcedump Sets/Dismisses force dumping of a ticket into the channel and in a specific format.
Valid input is '
html', 'text', or 'off'
!pobox forcedump text

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

These variables can be used anywhere in the message.

 

NewMailMsg & Response Variables

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

 

Administration 👑

Command  Description Example
!module tickets Enables/Disables the module. !module tickets
!assign userID ticketID Opens the ticket and assigns it to the staff member
Requires user reference and ticketID
!assign userID ticketID
!unassign userID ticketID Unassigns a staff member from the ticket
Requires user reference and ticketID
!unassign userID ticketID
!closeticket ticketID Closes 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

 

Public 👨‍👩‍👧‍👦

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
Modules

Suggest & Report

REQUIRES: Manage Messages, Embed Links

Suggest

image-1585808616583.png

Some servers love to hear what users want to see added, removed, or changed on the server.

The suggest feature is great for handling these requests because it allows for them to appear in a specific channel and allows users to voice their vote on suggestions.

 

Setup 👑

Command Description Example
!set suggest on or off Toggles suggestions !set suggest on
!set suggest #channel Sets where server suggestions go !set suggest #user-suggestions


Public 👨‍👩‍👧‍👦

Command Description Example
!suggest This is a suggestion Submits your suggestion !suggestion Need more potatoes!

 

Reports

Reports Tommy.pngSometimes, a server doesn't allow users to ping its mods, and this can be a frustrating matter to community members when there's a disruptive person.

The Reports feature allows users to send reports about user malicious or disruptive activity to the staff.

 

Setup 👑

Command Description Example
!set reports on or off Toggles reports !set reports on
!set reports #channel Sets where user reports go !set reports #user-reports


Public 👨‍👩‍👧‍👦

Command Description Example
!report UserID/Mention reason Reports the user !report @Tommyfoxy2#0001 Doesn't have potatoes
Modules

Roles

REQUIRES: Manage Roles, Manage Messages, Embed Links

c2d4a2d9a5242e63827627fa24a1cdd3.png

Setup

Command Description Example
!module roles Enables/Disables the module !module roles
!addrole rolename/mention/ID Allows that role to be self-assigned !addrole @Potato
!delrole rolename/mention/ID Removes the role from being able to be self-assigned !delrole Potato
!setdesc rolename/mention/ID description Sets the description for the role !setdesc 643001239725932564 I am a delicious potato!
!roleslist Displays all self-assignable roles !roleslist
!reset rolename/mention/ID Removes that self-assignable role from everyone with it !reset @Potato

 

Roleopt

When adding multiple options to a role, putting a comma , between each option is required.

Command Description Example
!roleopt rolename/mention/ID add options Adds options to the custom role !roleopt Member add auto, perma, vc
!roleopt rolename/mention/ID rem options Removes options from the custom role !roleopt Member rem vc

 

Roleopt options

Option Description
unique
unique2
unique3
Lets users choose only one role within the unique group
Creates a second group users can only choose one from
Creates a third group users can only choose one from
reset Enables the reset command to work on the role
perma Disables users from removing the role
lock Disables users from adding or removing the role by command
auto Automatically assigns the role to users upon join
vc Automatically assigns the role whoever joins a voice channel
timer

Example:
timer10
Automatically removes the role from the user after X minutes

 

Assigning roles

Command Description Example

!role userID/@mention rolename

!role userID/@mention +rolename

!role userID/@mention -rolename

Toggles the role on the user

Only adds the role to the user

Only removes the role from the user

!role 104425482757357568 Potato

!role @Tommyfoxy2#0001 +Potato

!role @Tommyfoxy2#0001 -Potato

!role all rolename

!role all +rolename

!role all -rolename

 

Toggles the role on everyone in the server

Only adds the role to everyone in the server

Only removes the role from everyone in the server

!role all Potato

!role all +Potato

!role all -Potato

 

Modules

Reaction Roles - (Premium)

REQUIRES: Manage Messages, Send Links, Add Reactions

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

image-1587096587706.png

Setup ➕ 👑

Command Description Example
!setrolereact #channel Starts process for adding a new reaction role !setrolereact #roles
!setrolereact current Displays current reaction roles !setrolereact current
!setrolereact delete messageID Deletes reaction roles for that message !setrolereact delete 761989065385967626
Modules

StatTrack

Manage channels to display your server mini-stats and even display a clock for events and such in your community if you so choose.

REQUIRES: Manage channels

Free users are allowed one stattrack channel per feature (for example, one clock channel, one members channel, one online channel, etc).

Gaius Plus users are allowed multiple channels of the same stattrack feature.

Members

A total member count tracker displaying the number of total members when a member comes online, DND, idle, etc., in a customizable channel.

 

Setup 👑

This is ordered by usage. Start with the first and move down the list. The bold text is required in the command; underlined is the channel name or channel ID; and italics are optional, but recommended.

Example Description
!stattrack add members channelName/ID Sets the channel for the member counter
!stattrack msg channelName/ID %d Members Sets the stat format
!stattrack enable or disable channelName/ID Enables or disables the member counter
!stattrack delete channelName/ID Deletes the member counter on that channel (Y/N)
!stattrack current Displays current stat channels, also removes those deleted

 

Online

A member online count tracker displaying the number of total online members when a member comes online, DND, idle, etc., in a customizable channel.

 

Setup 👑

This is ordered by usage. Start with the first and move down the list. The bold text is required in the command; underlined is the channel name or channel ID; and italics are optional, but recommended.

Example Description
!stattrack add online channelName/ID Sets the channel for the online counter
!stattrack msg channelName/ID %d Online Sets the stat format
!stattrack enable or disable channelName/ID Enables or disables the online counter
!stattrack delete channelName/ID Deletes the online counter on that channel (Y/N)
!stattrack current Displays current stat channels, also removes those deleted

 

Server Age

A server age counter that tracks the age (in days) of the server in a customizable channel.

 

Setup 👑

This is ordered by usage. Start with the first and move down the list. The bold text is required in the command; underlined is the channel name or channel ID; and italics are optional, but recommended.

Example Description
!stattrack add age channelName/ID Sets the channel for the age counter
!stattrack msg channelName/ID %d days old Sets the stat format
!stattrack enable or disable channelName/ID Enables or disables the age counter
!stattrack delete channelName/ID Deletes the age counter on that channel (Y/N)
!stattrack current Displays current stat channels, also removes those deleted

 


 

Clock

A clock that updates every 5 minutes, capable of displaying the day of the week, month, year, timezone, etc., in a completely customizable message in a customizable channel.

 

Setup 👑

This is ordered by usage. Start with the first and move down the list. The bold text is required in the command; underlined is the channel name or channel ID; and italics are optional, but recommended.

The list of applicable time zones can be found here.

Example Description
!stattrack add clock channelName/ID Sets the channel for the clock
!stattrack msg channelName/ID %t %tzPST Sets the stat format
!stattrack enable or disable channelName/ID Enables or disables the clock
!stattrack delete channelName/ID Deletes the clock on that channel (Y/N)
!stattrack current Displays current stat channels, also removes those deleted
 

Variables

Variable Description Example Display
%wd Weekday Sunday
%t Time 8:49 pm
%tzZONE
%tzPST
%tzEST
%tzCST
etc...
Timezone to use PST
%-DST Stops using DST time  
%24 24HR clock 21:49
%d Day of the week 7
%m Month 9
%y Year 2020

 

Some examples would be
Example Example Output
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 with the channel you want notifications in.

Enables/Disables 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

Changing User Nicknames

Command Description
!nick mention/UserID newNickname

Changes a user's display name

Say (Sending Messages with Gaius)

Command Description
!say [optional #channel] Message here. Sends a plain text message in a channel.
!say [optional #channel] %e Message here. Sends an embedded message in a channel.
!say [optional #channel] %e %c#000000 Message here. Sends an embedded message with a specified color hex tag in a channel.
Moderation

Bans

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

Setup

Command Description
!module bans Enable/Disable the module.

!allow ban Moderator

Allows the role Moderator to use the ban command.
!block ban 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 multiplier #

Sets the multiplier to X times the amount of the previous auto-mute punishment

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 searchText

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

Adds the mute role to the member.

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 Premium 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-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 insert your regex here %regex

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.

%regex

!banword b[il1]+t{2,}(er|a)' %regex

Applies your given regex

Blocks common variations of the word bitter

%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

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

REQUIRES: Manage Messages

image-1587021284194.png

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.