🛡️ Sistema Anti-Raid

El sistema Anti-Raid es la característica principal de Sentinel Bot. Detecta cuando múltiples usuarios malintencionados intentan atacar tu servidor y los detiene automáticamente.

🎯 ¿Qué es un Raid?

Un raid es cuando un grupo de usuarios (generalmente coordinados) entran a tu servidor con la intención de causar daño. Por ejemplo:

Ejemplo de Raid:
14:30:00 - Usuario1 se une al servidor
14:30:05 - Usuario2 se une al servidor
14:30:10 - Usuario3 se une al servidor
14:30:15 - Usuario4 se une al servidor
14:30:20 - Usuario5 se une al servidor
14:30:25 - Todos empiezan a enviar spam, mencionar a todos, publicar enlaces maliciosos...

Sin protección, esto destruiría tu servidor en minutos. Con Sentinel Bot, el raid se detecta y se detiene automáticamente.

🔍 ¿Cómo funciona la detección?

El bot cuenta cuántos usuarios nuevos se unen en un período de tiempo. Si superan el umbral que configuraste, se activa la protección.

1

El bot monitorea constantemente

Cada vez que alguien se une a tu servidor, el bot lo registra. Piensa en esto como un "contador de visitantes".

2

Cuenta usuarios en una ventana de tiempo

Supongamos que: Configuraste un umbral de 5 usuarios en 1 minuto.

El bot cuenta: "En los últimos 60 segundos, ¿cuántos usuarios nuevos entraron?"

  • Si entraron 3 usuarios → ✅ Todo normal, no hace nada
  • Si entraron 5 usuarios → ⚠️ ¡Alerta! Posible raid
  • Si entraron 10 usuarios → 🚨 ¡RAID DETECTADO! Activa protección
3

Activa la protección automáticamente

Cuando detecta un raid, el bot:

  1. Envía una alerta al canal de logs
  2. Ejecuta la acción que configuraste (banear, expulsar, cuarentena, etc.)
  3. Protege los canales y roles
  4. Registra todo para revisión posterior

⚙️ Configuración del Anti-Raid

1. Activar/Desactivar

Usando comandos:

/antiraid enable   # Activa la protección
/antiraid disable  # Desactiva la protección
/antiraid status   # Ver estado actual

Usando el panel web:

  1. Ve a tu servidor en el panel web
  2. Pestaña "Configuración"
  3. Busca "Protección Anti-Raid"
  4. Activa o desactiva el interruptor

2. Configurar el Umbral

El umbral es "cuántos usuarios pueden entrar antes de activar la protección".

💡 ¿Qué umbral usar?
  • 3-5 usuarios: Para servidores pequeños (menos de 100 miembros). Protección muy estricta.
  • 5-10 usuarios: Para servidores medianos (100-1000 miembros). Balance entre protección y flexibilidad.
  • 10-15 usuarios: Para servidores grandes (más de 1000 miembros). Permite eventos legítimos.

Usando comandos:

/antiraid umbral usuarios:5

Esto significa: "Si entran 5 o más usuarios en 1 minuto, activa la protección".

Usando el panel web:

  1. Ve a Configuración → Anti-Raid
  2. Busca "Umbral de detección"
  3. Escribe el número (por ejemplo, 5)
  4. Guarda los cambios

3. Configurar la Acción

Cuando se detecta un raid, ¿qué debe hacer el bot?

Acción Descripción Cuándo usar
Advertir (DM) Envía un mensaje privado al usuario Para raids menores o cuando quieres ser menos estricto
Expulsar Expulsa al usuario del servidor (puede volver a entrar) Para raids moderados
Banear Banea permanentemente al usuario Para raids graves (recomendado)
Cuarentena Aísla al usuario en un canal especial Para investigar antes de banear

Usando comandos:

/antiraid action-raid accion:ban

4. Configurar Auto-Ban

El auto-ban significa que el bot banea automáticamente a TODOS los usuarios que entran durante un raid, sin preguntar.

⚠️ Importante: Si tienes un evento especial (por ejemplo, un streamer famoso hace que entren muchos usuarios legítimos), desactiva el auto-ban temporalmente para evitar banear usuarios inocentes.

Usando comandos:

/antiraid autoban activar:true   # Activa auto-ban
/antiraid autoban activar:false  # Desactiva auto-ban

5. Configurar Canal de Logs

El canal de logs es donde el bot reporta todo lo que pasa. Es muy importante configurarlo.

Usando comandos:

/antiraid logs canal:#logs

Supongamos que: Tienes un canal llamado #logs. Cada vez que se detecte un raid, verás un mensaje ahí diciendo qué pasó.

📊 Ejemplo Completo

Vamos a configurar el anti-raid paso a paso con un ejemplo real:

1

Tu servidor

Supongamos que tienes un servidor de gaming con 200 miembros. Normalmente entran 1-2 miembros nuevos por día.

2

Configuración recomendada

  • Umbral: 5 usuarios (si entran 5 en 1 minuto, es sospechoso)
  • Acción: Banear (los atacantes no deben volver)
  • Auto-ban: Activado (protección automática)
  • Canal de logs: #logs (para ver qué pasa)
3

Comandos a ejecutar

/antiraid enable
/antiraid umbral usuarios:5
/antiraid action-raid accion:ban
/antiraid autoban activar:true
/antiraid logs canal:#logs
4

¿Qué pasa si hay un raid?

14:30:00 - Usuario1 se une
14:30:10 - Usuario2 se une
14:30:20 - Usuario3 se une
14:30:30 - Usuario4 se une
14:30:40 - Usuario5 se une
14:30:41 - 🚨 RAID DETECTADO!
14:30:42 - El bot banea a Usuario1, Usuario2, Usuario3, Usuario4, Usuario5
14:30:43 - Mensaje en #logs: "Raid detectado. 5 usuarios baneados."

✅ Verificar que funciona

Para verificar que el anti-raid está funcionando:

  1. Ejecuta /antiraid status - Deberías ver que está activo
  2. Revisa el canal de logs - Deberías ver un mensaje de confirmación
  3. Ve al panel web → Stats - Deberías ver estadísticas de protección
✅ ¡Listo!
Tu servidor está protegido contra raids. El bot trabajará en segundo plano y protegerá automáticamente cuando sea necesario.

❓ Preguntas Frecuentes

¿Puedo desactivar el anti-raid temporalmente?

Sí, usa /antiraid disable. Recuerda volver a activarlo después.

¿Qué pasa si hay un evento legítimo con muchos usuarios?

Si sabes que habrá un evento, puedes:

  1. Aumentar temporalmente el umbral (por ejemplo, a 20)
  2. Desactivar el auto-ban
  3. Desactivar completamente el anti-raid durante el evento

¿El bot puede banear usuarios legítimos por error?

Es muy raro, pero puede pasar si:

Solución: Puedes desbanear usuarios desde Discord o el panel web si fue un error.