🛡️ Anti-Raid System

The Anti-Raid system is the main feature of Sentinel Bot. It detects when multiple malicious users try to attack your server and stops them automatically.

🎯 What is a Raid?

A raid is when a group of users (usually coordinated) join your server with the intention of causing damage. For example:

Raid Example:
14:30:00 - 14:30:00 - User1 joins the server
14:30:05 - 14:30:05 - User2 joins the server
14:30:10 - 14:30:10 - User3 joins the server
14:30:15 - 14:30:15 - User4 joins the server
14:30:20 - 14:30:20 - User5 joins the server
14:30:25 - 14:30:25 - They all start sending spam, mentioning everyone, posting malicious links...

Without protection, this would destroy your server in minutes. With Sentinel Bot, the raid is detected and stopped automatically.

🔍 How does it work?

The Anti-Raid system works in 3 simple steps:

1

The bot constantly monitors

Every time someone joins your server, the bot records it. Think of this as a "visitor counter".

2

Counts users in a time window

Suppose that: You configured a threshold of 5 users in 1 minute.

3

Activates protection automatically

When it detects a raid, the bot:

⚙️ Anti-Raid Configuration

You can configure the Anti-Raid system from Discord commands or from the web panel. We show you both ways:

1️⃣ 1. Enable/Disable

docs.sections.antiraid.config1Desc

Using commands:

/antiraid enable   # Activates protection/antiraid disable  # Deactivates protection/antiraid status   # View current status

Using the web panel:

  1. Go to your server in the web panel
  2. Settings tab
  3. Find "Anti-Raid Protection"
  4. Activate or deactivate the switch

2️⃣ 2. Configure Threshold

The threshold is "how many users can join before activating protection".

💡 What threshold to use?
The threshold depends on your server size. Here are some recommendations:

Using commands:

/antiraid umbral usuarios:5

This means: "If 5 or more users join in 1 minute, activate protection".

Using the web panel:

  1. Go to Settings → Anti-Raid
  2. Find "Detection Threshold"
  3. Enter the number (for example, 5)
  4. Save changes

3️⃣ 3. Configure Action

When a raid is detected, what should the bot do?

Using commands:

/antiraid action-raid accion:ban

4️⃣ 4. Configure Auto-Ban

Auto-ban means the bot automatically bans ALL users who join during a raid, without asking.

⚠️ Important: If you have a special event (for example, a famous streamer causes many legitimate users to join), temporarily disable auto-ban to avoid banning innocent users.
docs.sections.antiraid.config4WarningDesc

Using commands:

/antiraid autoban activar:true   # Activates auto-ban/antiraid autoban activar:false  # Deactivates auto-ban

💡 Complete Example

Let's configure anti-raid step by step with a real example:

1

Your server

Suppose you have a gaming server with 200 members. Normally 1-2 new members join per day.

2

Recommended configuration

For this server, we recommend:

/antiraid enable/antiraid umbral usuarios:5/antiraid action-raid accion:ban
3

Commands to execute

Run these commands in order:

4

What happens if there's a raid?

Now, if a raid occurs:

✅ Verify it works

To verify that anti-raid is working:

/antiraid status

This command will show you the current status of Anti-Raid protection.

💡 Tip
We recommend checking the status periodically to make sure everything is configured correctly.

❓ Frequently Asked Questions

Can I temporarily disable anti-raid?

Yes, use /antiraid disable. Remember to reactivate it afterwards.

What happens if there's a legitimate event with many users?

If you know there will be an event, you can:

Can the bot ban legitimate users by mistake?

It's very rare, but it can happen if: