Anti-Raid System

Squint's anti-raid system protects your server from coordinated attacks where multiple users join with identical or very similar profile pictures. It detects these patterns and automatically applies punishments.

Quick Start (5 Minutes)

1. Run ;antiraid enable

2. Set detection threshold: ;antiraid config threshold 5

3. Set punishment: ;antiraid config punishment ban

4. Set log channel: ;antiraid config logchannel #mod-logs

5. Check status: ;antiraid status

You're done! Read full setup below for advanced options.

Setup

1. Enable anti-raid protection: ;antiraid enable

2. (Optional) Configure detection threshold: ;antiraid config threshold 5

3. (Optional) Set punishment type: ;antiraid config punishment ban

4. (Optional) Set a log channel: ;antiraid config logchannel #mod-logs

5. View current status: ;antiraid status

Configuration

• enabled: Toggles the entire anti-raid system on or off.

• threshold: The number of users with identical profile pictures joining within the timeWindow to trigger a raid detection (default: 3).

• timeWindow: The time frame in minutes during which identical profile picture joins are counted (default: 5).

• punishment: The action taken against detected raiders: kick, ban, timeout, or role.

• punishmentDuration: The duration in minutes for timeout punishments (default: 10).

• punishmentRole: The ID of the role to assign if punishment is set to role.

• exemptRoles: A list of role IDs that are exempt from anti-raid checks.

• logChannel: The ID of the channel where raid detections and punishments are logged.

Common Issues:

• System is not detecting raids → Ensure the threshold is low enough and the timeWindow is long enough to catch the pattern.

• Punishment fails → Check that the bot's highest role is above the target user's highest role and the bot has the necessary permissions (Kick Members, Ban Members, Moderate Members).

• Legitimate users are being caught → Increase the threshold or add roles to the exemptRoles list.

• Logs are not sent → Verify the logChannel is set and the bot has Send Messages permission there.

Usage

Once enabled, the anti-raid system will monitor new member joins. If a raid pattern is detected, it will automatically apply the configured punishment to all users involved in the detected raid. All actions are logged to the specified logChannel.

Related Commands

• ;antiraid - Main command for managing anti-raid settings.

• ;antinuke - General anti-nuke protection features.