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.

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 stickers

Block posting of stickers

 

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.

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.

 

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.

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.

 

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.

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.

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.

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.

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.

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