Anti-Spam System

Raptor is able to detect and delete messages that contain spammy content, such as links, attachments, and excessive mentions. This documents the settings available for the Anti-Spam system.

Dashboard Management

While some settings can be toggled via /antiraid, the full power of the Anti-Spam system-including custom thresholds and interval timing is best managed via the Bot Dashboard.

Key Features

Prioritized Deletion: Messages are deleted the instant the first violation is detected, providing the fastest possible protection.
Rolling Windows: Uses rolling windows for rate-based filters (Mentions, Links, Attachments, Emojis, Unicode) to prevent "drip spam."
Dashboard Integration: Real-time configuration with instant toggle responsiveness.
Detailed Logging: Every violation is logged with specific reasons (e.g., "Excessive Emojis," "Duplicate Messages").

Filter Types

Message Rate

Prevents users from sending messages too quickly within a short timeframe.

Configurable: Max messages and time window (seconds).

Duplicate Messages

Detects and removes identical messages sent in rapid succession.

Warning

Discord has a issue where users on slower or unstable networks may repeat messages, this can cause false positives.

Duplicate Attachments

Detects and removes messages that contain the same attachments (based on filename and size) sent in rapid succession.

Configurable: Max duplicate attachments and time window (seconds).

Mass Mentions

Protects members from being pinged excessively.

Note: Counts both user and role mentions.

Excessive Links

Limits the number of links a user can post within a specific interval.

Mass Attachments

Prevents flooding channels with attachments.

Note: Attachments include videos, photos, files, so on attached to a message.

Excessive Emojis

Filters messages containing too many emojis.

Excessive Newlines

Prevents "wall of text" spam that stretches the chat window.

Max Characters

Limits the total length of individual messages.

Excessive Caps

Prevents "shouting" in chat.

Note: You can configure the minimum amount of characters before the filter triggers. Often, people will give short uppercase responses, so it's recommended to keep this at a low value (defaults 10).

Info

You can set "Min Characters" to 0 to disable this the minimum character check.

Unicode Characters

Filters messages containing excessive non-Latin or decorative characters.

Emoji Protection: Automatically ignores detected emojis, ensuring they don't count towards Unicode violations.

Command	Purpose
`/antiraid toggle`	Toggle the Master Switch
`/antiraid status`	View current Anti-Spam & Anti-Raid status
`/antiraid joins`	Configure Mass Join settings and actions
`/antiraid spam`	Configure Anti-Spam settings and actions
`/antiraid mention`	Configure Anti-Mention settings and actions
`/antiraid account_age`	Configure minimum account age in days
`/antiraid default_avatar`	Toggle the default avatar filter
`/antiraid reset`	Reset raid status and unpause invites

Mass Join Protection Action Options

When a mass join event is detected, Raptor can take the following action options:

Alert Only: Sends a warning alert to the configured logs channel.
Auto-Kick: Automatically kicks the user triggering the mass join event.
Lockdown (High Verification): Elevates the guild's verification level to the highest setting (double table flip) to prevent instant typing.
Pause Server Invites: Temporarily disables all server invites using Discord's native INVITES_DISABLED guild feature. This is highly recommended for massive raid defense as it does not trigger individual member rate limits.

Edit Scanning

The Anti-Spam system also scans edited messages. If a user tries to bypass a filter by editing an existing message, Raptor will catch it and delete the offending content.