Auto-moderation
Audit Logging
REQUIRES: Manage Messages, Embed Links
Standard Logging
Doing !log all
in a channel will automatically enable all log types to be posted in that channel.
Command | Descriptive Example |
!log current |
- Displays the current logging settings |
!log all channel/off |
- Enables/Disables all logging in that channel |
!log logtype channel / off |
- Sets a certain logging type to the channel
- Removes a certain logging type from the channel |
!log pingroles add/rem logtype Role |
- Adds a role to be pinged when a certain log is made |
!log pingroles rem all |
- Removes all roles that were designated to be pinged when certain logs were made |
!log pingroles list |
- Displays the list of roles designated to be pinged whenever a certain log is made |
Available Log Types
-
Bans
- Kicks
-
Warns
-
Mutes
-
Images
-
Spam
-
Filters
- Settings
- Notifications
- Joinwatch
- Errors
Extreme Logging
This feature is reserved for Gaius Plus only. Learn more.
Command | Description |
!exlog current | Displays the current extreme logging settings |
!exlog all | Toggles all types on/off to be sent in that channel |
!exlog logtype(s) #channel | Sets that log type to the specified channel channel |
!exlog logtype off/-1 | Disables that log type |
!exlog ignore channel | Exlogs will not record that channel |
!exlog recog channel | Exlogs stop ignoring that channel |
Exlog Types
Name | Logs |
memberadd | User joins, account age and other user information |
memberremove | User leaves, when they joined and what roles they had |
memberupdate | Nickname changes, roles and so forth per user |
username | Username changes |
userpic | When users change profile pictures, displays previous if possible as well |
vcjoin | When users join a voice channel and which one |
vcleave | When users leave a voice channel and which one |
vcchange | When users change voice channels and to which ones |
messagedelete | Deleted messages, content, author, channel etc |
messagebulk | This will detail when a BOT mass deletes messages. It will dump a text file with a collection of message_delete style logs |
messageupdate |
Logs before and after copies of edited messages |
rolecreate |
Logs when a role is created |
roleupdate |
Logs when a role is edited and what was changed |
roledelete |
Logs when a role is deleted |
channelcreate |
When channels are created |
channeldelete |
When channels are deleted |
channelupdate |
When channels are edited |
Anti-Spam
We offer highly customizable anti-spam. The settings are off 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.
Commands
Auto
The commands below are purely for example purposes and are in no way whatsoever suggestions on what to set for your server. Every community is unique in its own way and should be configured in its own unique way to best fit your community's needs.
Command | Descriptive Example |
!auto current |
!auto current
-Displays current anti-spam settings |
!auto spamtime/mentiontime/duplicatetime number |
!auto spamtime 5
-Sets the number of seconds (or less) needed for another message by the same person to be considered spam !auto mentiontime 5
- Sets the number of seconds (or less) needed for another message with a mention by the same person to be considered spam !auto duplicatetime 5
- Sets the number of seconds (or less) needed for a duplicated message by the same person to be considered spam |
!auto spamlimit/mentionlimit/duplicatelimit number |
!auto spamlimit 5
- Sets the message limit needed before beginning deleting the next messages or spam by that person !auto mentionlimit 5
- Sets the message (with a mention) limit needed before beginning deleting the next messages or spam by that person !auto duplicatelimit 5
- Sets the duplicated message limit needed before beginning deleting the next messages or spam by that person |
!auto emoji/newline/mention number |
!auto emoji 5
- Sets the maximum number of allowed emojis in a single message !auto newline 5
- Sets the maximum number of allowed line breaks in a single message These !auto mention 5
- Sets the maximum number of allowed mentions in a single message |
!auto duptolerance number |
!auto duptolerance 5
- Sets a stricter rule on similar messages previously sent by the same person In this example: |
Autoset
Command |
Example |
!autoset current | !autoset current |
!autoset nostickers/namecensor/modstaff [on/off/true/false] |
!autoset nostickers on !autoset namecensor false !autoset modstaff true |
!autoset autowarn public/dm/off | !autoset autowarn dm |
!autoset cooldown/mutetime number |
!autoset cooldown 5 !autoset mutetime 15 |
!autoset punishment warn/mute/kick/ban/off number [number...] |
!autoset punishment warn 1 2 3 !autoset punishment mute 2 !autoset punishment kick 3 !autoset punishment ban 4 |
!autoset blankavatar mute#/kick/ban | !autoset blankavatar mute5 |
autoset imagecensor a/t/e |
!autoset imagecensor e e - family friendly |
JoinAge
REQUIRES: Ban, Kick or Manage Roles (if mute).
Setup
Sets the account age restriction for the server as well as the punishments executed upon violation.
Command | Descriptive Example |
!setjoinage current |
- Displays current settings. |
!setjoinage off |
- Disables setjoinage |
!setjoinage punishment mute/kick/ban #days/#d #h #m #s |
- Mutes accounts under the age of 6 days.
- Kicks accounts under the age of 5 hours and 30 minutes.
- Bans accounts under the age of 30 minutes. |
!setjoinage #days/#d #h #m #s |
- Kicks accounts under the age of 3 days. |
!passport userid |
- Allows that user to bypass joinage. |
BlankAvatar
Requires: Ban, Kick or Manage Roles (if mute).
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 |
!autoset blankavatar |
- Toggles the blankavatar filter |
!autoset blankavatar mute#/kick/ban |
- Mutes users, who have no avatar, for 6 minutes
- Kicks users with no avatar |
!passport userid |
- Allows that user to bypass blankavatar |
Banned Words and Filters
Wordlist Management
REQUIRES: Manage messages
Banned word example |
Banword/Unbanword
Bans a word by adding it to a specified wordlist. If no word list is specified, then banned words will be added to the "local" wordlist. You may upload a text file (.txt) with a list of words separated by a new line instead.
Command | Descriptive Example |
!banword word/phrase |
- Bans the word and adds it to the "local" wordlist |
!banword name ListName word/phrase |
- Bans the word and adds it to the Naughty wordlist |
!banword insert your regex here %regex |
- Bans a custom regex Regex is a complicated matter, which may result in unexpected filter behavior. |
!unbanword word/phrase
!unbanword name ListName word/phrase
!unbanword id WordID#
|
- Unbans and removes the word from the "local" wordlist !banword name Naughty nibba
- Unbans and removes the word from the Naughty wordlist
- Unbans the word based on its unique ID number |
Variables
Variable | Description |
%whole | Only the exact match |
%begin | Only from the beginning of words |
%end | Only from the end of words |
%case | Case-sensitive (100% match only) |
%mute | Auto permanent mute |
%mute # | Auto mute for certain amount of minutes |
%warn | Auto warn |
%kick | Auto kick |
%softban | Auto softban |
%ban | Auto ban |
%ban # | Auto ban for certain amount of days |
%name |
Only applies to names/nicknames |
%new
|
Only matches the word or phrase against the name censor ONLY to new members who join the server |
%hoist |
De-hoists people who try to get to the top of the alphabetical member list on the right side if they have a particular name or symbol
The %name nor %begin flag are needed when using the %hoist flag |
%regex
EXAMPLE: !banword b[il1]+t{2,}(er|a)' %regex |
Applies your given regex
EXAMPLE: Blocks common variations of the word bitter |
%notify
|
Posts a log through the Notifications logging channel |
%notifynd
(REQUIRES: Notifications logging enabled) |
Posts a log through the Notifications logging channel
This will not delete the banned word. |
You can filter usernames based on your banned words with !auto name
which checks whenever someone joins your server or whenever a name is updated.
(Learn more)
Wordlist
Command | Descriptive Example |
!wordlist list |
- Displays the list of current wordlists in the server along with their info |
!wordlist view name [serverid] [readable] |
- Sends a list of banned words in an editable .json file It is entirely optional to use a server ID and "readable" in the command. The server ID is primarily meant for cases in which the wordlist did not originate in your server, and that the wordlist is added to your server with the Typing "readable" at the end of the command will output a .txt file instead of .json. This is easier for when you only want to look at it and not re-upload an edited version of the file. |
!wordlist create ListName |
- Creates a new wordlist with a name It is possible to use an edited .json file, template can be found with |
!wordlist delete ListName |
- Deleted the wordlist form the server |
!wordlist formfile |
- Sends a .json template for banning words in bulk when uploading a .json file This is useful for when using the |
!wordlist add/rem name serverid |
- Removes another server's non-locked wordlist to yours
- Removes another server's non-locked wordlist from yours |
!wordlist clear name |
- Clears all banned words from the wordlist without deleting the wordlist |
!wordlist update name *attach a file* |
- Replaces ALL words with words that are listed in the uploaded file |
!wordlist addflag/remflag name flag |
- Adds the mute flag to ALL WORDS in the wordlist
- Removes the mute flag from ALL WORDS in the wordlist |
Managelist
Command | Descriptive Example |
!managelist applyto/unapplyto name [serverid] channel/role |
- Applies the wordlist to only the target channel, meaning that only the specified channel is where the wordlist will be enforced
- Removes the wordlist enforcement from the given role\ Unapply will always override an Applied role or channel Adding a serverID clarifies which wordlist to apply/unapply. If no serverID is provided, then the first wordlist with the given name will be used. |
!managelist applyto/unapplyto current |
- Displays the current list of roles and channels to which a wordlist has been applied to
- Displays the current list of roles and channels to which a wordlist has been unapplied to |
!managelist lock/unlock name |
- Prevents other servers from viewing the wordlist's contents
- Allows other servers to view the wordlist contents |
!managelist public/private name |
- Allows other servers to "wordlist add" the specified wordlist
- Disables other servers from adding your wordlist |
!managelist enable/disable name [serverid] |
- Enables a wordlist that was added from "wordlist add" This will immediately put the enabled wordlist into moderating effect
- Disables the wordlist enforcement and keeps the wordlist |
!managelist merge/unmerge name serverid |
- Merges another server's non-locked wordlist to yours This will not immediately put the merged wordlist into moderating effect
- Removes another server's non-locked wordlist from your local filter |
Filter/Whitelist
Command | Description |
!filter ignore [invert] #channel url/invite/text/auto/activity |
- Ignores url filters in the channel
- Ignores text filters in all channels except for #general |
!filter recog [invert] #channel url/invite/text/auto/activity |
- Re-enables url filters in the channel
- Re-enables url filters in all channels except for #general |
!filter view [ignores] |
- Displays currently active filters in the server
- Displays all currently active filter ignores in the server |
!filter url/invite |
- Toggles the url or invite filter |
!whitelist list |
- Lists the current whitelisted links and domains |
!whitelist add/rem link |
- Adds the domain name to the filters' whitelist |
Channel Types
Command | Descriptive Example |
!ct #OptionalChannel type |
!ct #memes image
- Sets the channel type for the (specified) channel |
!ct #OptionalChannel type off |
!ct image off
- Removes the channel type for the (specified) channel |
Types
Type | Description |
image | Only allow image attachments without text or url |
url | Allows urls as well but no other text is allowed |
text | Allows text only if accompanied by a url or attachment |
BlockTag
REQUIRES: Manage Messages
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.
Command |
Descriptive Exmaple |
!blocktag role/member |
- Blocks the given user/role from being mentioned |
!unblocktag ID |
!unblocktag 104425482757357568 !unblocktag @Tommyfoxy2#0001 !unblocktag @Staff
- Removes the existing blocktag restriction from the user/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 |