Auto-Moderator

The Auto-Moderator is a module which will automatically moderate any text channel in your server. It allows you to customize a number of different modules including a blacklist, mass caps, emoji and mention spam and links/server invite detector.

Enabling Auto-Moderator and Modules

The Auto-moderator must be enabled in order to function. Click the Enable button in the top right of the module page in your dashboard.

Each individual auto-moderator module must also be enabled. To do so click Edit on the module you wish to enable and change the Action from disabled.

Change the action of an Auto-moderator Module to enable it.

Auto-Moderator Actions

The auto-moderator can select from three different actions to take when a member breaches the rules of the server.

Delete the Message

This action simply deletes the message and takes no further action against the member.

Warn the Member

This action registers a warning against the offending member. You can view these warnings by using the warnings command under moderation.

Delete Message and Warn

This action combines the above two actions. The message will be deleted and a warning will be registered against the offending member.

Ignored Roles and Channels

Each individual module can have specified ignored roles and channels. This allows you to have certain channels where certain actions are allowed.

To add ignored roles and channels, click the Edit button next to the module you wish to edit, and add roles or channels from the drop down.

Bad Words

The Bad Words modules allows you to blacklist certain words from being said in your discord server.

Add Blacklisted Words

To add words to the blacklist, click the Edit button next to the Bad Words module. Scroll down to the additional bad words section and type in the words you wish to add separated by commas.

You can also use the black-list command in discord to blacklist words on the go. Simply call the command followed by a list of words to add.

Default Blacklist

BotGhost auto-moderator comes with a large list of profane words built into its blacklist. You can see these words at https://github.com/web-mech/badwords/blob/master/lib/lang.json

Ignored Channels and Roles

With each module you are able to customize which channels and roles the auto-moderator will ignore. Simply select the roles or channels you wish to ignore for the Bad Words module.

Whitelist

The whitelist is a list of words that are removed from the default blacklist. This will allow you to remove words from the default blacklist listed above. To add words to the whitelist follow the same steps as you did for the blacklist, or call the white-list command in discord followed by a list of words to add to the whitelist.

Links

This module allows you to ban people from sending links in your server. The auto-moderator will automatically detect any links and take the action you specify.

To enable the Links Module change the action of the module by clicking Edit and changing the Action from Disabled.

Mass Caps

The Mass Caps module will automatically take the designated action on any message over 20 characters in length that is over 70% caps.

To enable the Mass Caps Module change the action of the module by clicking Edit and changing the Action from Disabled.

Mass Emoji

The Mass Emoji module will take the selected action on any message with over the emoji cap you specify. By default this cap is 8.

Changing the Emoji cap

To change the emoji cap click the Edit button next to the Mass Emoji module. Scroll down and change the field Max Emojis Per Message to your new maximum.

To enable the Mass Emojis Module change the action of the module by clicking Edit and changing the Action from Disabled.

Server Invites

The Server Invites module will automatically stop people from sending server invites in your discord channel.

To enable the Server Invites Module change the action of the module by clicking Edit and changing the Action from Disabled.

Mass Mentions

The mass mentions will delete any message that exceed the your selected maximum amount of mentions. This defaults to 5.

Changing the Mass Mentions cap

To change the Mass Mentions cap click the edit button next to the module. Scroll down to the Max Mentions Per Message field and change this value to your new maximum.

To enable the Mass Mentions Module change the action of the module by clicking Edit and changing the Action from Disabled.

Generic Auto-Moderator Options

This section houses options on how your auto-moderator should generally run. Here you can designate whether to ignore other bots, admins and whether to send a direct message to the member explaining the reason the auto-moderator acted upon their message.

Ignore Bots

Enabling this option will cause the auto-moderator to completely ignore all other bots.

Ignore Admins

This option causes the auto moderator to ignore members with the ADMINISTRATOR permission in your guild.

DM Reason

Enabling this option will cause the bot to direct message the offending member the reason the auto moderator has taken action against them.

Log all Auto-Moderator Actions

This option causes all actions the auto-moderator takes to be logged to a text channel. You can set your own channel or a default channel will be created.

Auto Moderator Logging Channel

You can set a channel for the auto moderator to log actions to. If you select no channel a default channel will be created.

If no channels appear, ensure that your bot is first in a server and then click the refresh button.

Commands

Command

Description

white-list

Adds a word to the servers whitelist

black-list

Adds a word to the servers blacklist

Remember! You can edit any commands trigger or permissions by clicking the edit button next to the command in your dashboard.