Plugins

Moderation

The Moderation plugin provides moderation commands and configurable filters.

# Flytrap

A flytrap is a channel that catches spam bots which blindly send a message in every channel they can see. When someone sends a message in the flytrap, Atlas bans them and purges their messages from the previous hour. Put the flytrap at the top of your channel list so these bots are more likely to reach it before they can send spam elsewhere.

Select an empty channel for the flytrap. Atlas will create and maintain a message in it. It also forces at least five minutes of slow mode. The channel must stay clear: messages sent there are removed, including messages from exempt users and other bots.

By default, anyone other than Atlas who sends a message in the channel is banned. The Flytrap Cutoff sets how recently someone must have joined to be banned; it is set to seven days by default. Members who joined before the cutoff still have their flytrap message deleted but are not banned. Atlas must be able to delete messages and ban the member for this to work.

The flytrap message is a script. Use {$flytrap.bans} in it to show the total number of users the flytrap has banned. For example:

This is the flytrap channel! Don't use it unless you want to be banned doofus.
{$flytrap.bans} people hae been banned so far!

Atlas updates the managed message in the background when edit it on the dashboard or when someone is banned if your script uses {$flytrap.bans}. It may take up to a minute for changes to appear from the dashboard and longer for the {$flytrap.bans} trigger.

# Filters

Moderation filters are automatic rules that help you moderate your server. A filter runs when a trigger matches and every condition passes. It then runs its effects.

# Building a filter

• Triggers decide what to look for, such as message content, links, attachments, repeated messages, or mentions.
• Conditions add requirements to a matching event. Every condition must pass.
• Effects are the result. A filter can delete a message, warn, mute, kick, ban, change a nickname, or send a message.

Any trigger can match. All the effects are run. The dashboard shows the available types and limits.

# Restrictions and scope

A filter restriction works like other restrictions, controlling where the filter applies. A blacklisted role or channel bypasses the filter. Restrictions do not alter Discord permissions.

Filters skip moderators, ticket channels, and threads by default. The sanction settings make a filter apply to them.