🛠️ Comandos de Moderación

Los comandos de moderación de Sentinel Bot te permiten gestionar usuarios y contenido en tu servidor de forma rápida y eficiente. Todos los comandos incluyen verificaciones de permisos, registros automáticos y protección contra errores comunes.

🎯 Características Generales

🔨 Comandos de Baneo

/mod ban add

Banea un usuario del servidor.

1

Sintaxis

/mod ban add usuario:@Usuario [razon:"Razón del baneo"] [dias:7]
  • usuario (requerido): El usuario a banear
  • razon (opcional): Razón del baneo que se mostrará en los logs
  • dias (opcional): Días de mensajes a eliminar (0-7, por defecto 0)
2

Ejemplos

/mod ban add usuario:@Spammer razon:"Spam masivo" dias:7

/mod ban add usuario:123456789012345678 razon:"Comportamiento tóxico"

/mod ban add usuario:@Usuario dias:3
💡 Notas importantes:
  • No puedes banear usuarios en la whitelist
  • No puedes banearte a ti mismo
  • No puedes banear al propietario del servidor
  • Los mensajes eliminados se borran permanentemente (no se pueden recuperar)
  • La acción se registra automáticamente en los logs

/mod ban remove

Desbanea un usuario del servidor.

1

Sintaxis

/mod ban remove usuario:@Usuario
  • usuario (requerido): El usuario a desbanear (puede ser ID si no está en el servidor)
2

Ejemplos

/mod ban remove usuario:@Usuario

/mod ban remove usuario:123456789012345678

/mod ban list

Muestra una lista de todos los usuarios baneados en el servidor.

💡 Información mostrada:
  • Nombre y tag del usuario
  • ID del usuario
  • Fecha aproximada del baneo

👢 Comandos de Expulsión

/mod kick

Expulsa un usuario del servidor (puede volver a unirse con una invitación).

1

Sintaxis

/mod kick usuario:@Usuario [razon:"Razón de la expulsión"]
  • usuario (requerido): El usuario a expulsar
  • razon (opcional): Razón de la expulsión para los logs
2

Ejemplos

/mod kick usuario:@Usuario razon:"Comportamiento inapropiado"

/mod kick usuario:@Usuario razon:"Spam en múltiples canales"
⚠️ Diferencias entre ban y kick:
  • Kick: El usuario puede volver a unirse con una invitación válida
  • Ban: El usuario no puede volver hasta que sea desbaneado

Usa kick para advertencias severas, ban para expulsiones permanentes.

🗑️ Limpiar Mensajes

/mod clear

Elimina mensajes de un canal. Puedes limpiar mensajes generales o solo de un usuario específico.

1

Sintaxis

/mod clear cantidad:50 [canal:#canal] [usuario:@Usuario]
  • cantidad (requerido): Número de mensajes a eliminar (1-100)
  • canal (opcional): Canal donde eliminar. Si no se especifica, usa el canal actual
  • usuario (opcional): Solo eliminar mensajes de este usuario
2

Ejemplos

# Eliminar 50 mensajes del canal actual
/mod clear cantidad:50

# Eliminar 20 mensajes de un usuario específico
/mod clear cantidad:20 usuario:@Spammer

# Eliminar 100 mensajes de un canal específico
/mod clear cantidad:100 canal:#general
💡 Límites y restricciones:
  • Máximo 100 mensajes por comando
  • No se pueden eliminar mensajes con más de 14 días de antigüedad (límite de Discord)
  • Los mensajes fijados no se eliminan
  • Si eliminas mensajes de un usuario, el bot busca en los últimos mensajes del canal

⏳ Timeout (Silenciar Usuario)

/mod timeout

Silencia temporalmente a un usuario. No podrá enviar mensajes, reaccionar, hablar en canales de voz, ni unirse a hilos.

1

Sintaxis

/mod timeout usuario:@Usuario minutos:60 [razon:"Razón del timeout"]
  • usuario (requerido): El usuario a silenciar
  • minutos (requerido): Duración del silencio en minutos (1-40320, máximo 28 días)
  • razon (opcional): Razón del timeout para los logs
2

Ejemplos

# Timeout de 1 hora
/mod timeout usuario:@Usuario minutos:60 razon:"Spam"

# Timeout de 1 día
/mod timeout usuario:@Usuario minutos:1440 razon:"Comportamiento inapropiado"

# Timeout de 7 días
/mod timeout usuario:@Usuario minutos:10080 razon:"Infracción grave"
💡 Conversiones útiles:
  • 1 hora = 60 minutos
  • 1 día = 1,440 minutos
  • 1 semana = 10,080 minutos
  • 28 días (máximo) = 40,320 minutos

⚠️ Advertir Usuario

/mod warn

Envía una advertencia privada a un usuario por mensaje directo (DM).

1

Sintaxis

/mod warn usuario:@Usuario [razon:"Razón de la advertencia"]
  • usuario (requerido): El usuario a advertir
  • razon (opcional): Razón de la advertencia
2

Ejemplos

/mod warn usuario:@Usuario razon:"Lenguaje inapropiado"

/mod warn usuario:@Usuario razon:"No seguir las reglas del canal"
💡 Sobre las advertencias:
  • El usuario recibirá un mensaje privado (DM) con la advertencia
  • Si el usuario tiene los DMs deshabilitados, la advertencia no se enviará, pero se registrará en los logs
  • Las advertencias se registran en los logs para seguimiento
  • Puedes usar advertencias para crear un sistema de "strikes" manual

⏱️ Slowmode de Canal

/mod slowmode

Establece el modo lento en un canal. Limita cuánto tiempo debe esperar un usuario entre mensajes.

1

Sintaxis

/mod slowmode segundos:30 [canal:#canal]
  • segundos (requerido): Tiempo de espera entre mensajes (0-21600, máximo 6 horas)
  • canal (opcional): Canal donde aplicar. Si no se especifica, usa el canal actual
2

Ejemplos

# Activar slowmode de 30 segundos en el canal actual
/mod slowmode segundos:30

# Desactivar slowmode (0 segundos)
/mod slowmode segundos:0

# Slowmode de 5 minutos en un canal específico
/mod slowmode segundos:300 canal:#general
💡 Conversiones útiles:
  • 10 segundos = 10
  • 1 minuto = 60
  • 5 minutos = 300
  • 1 hora = 3,600
  • 6 horas (máximo) = 21,600
⚠️ Nota importante:
Para desactivar el slowmode, establece los segundos en 0.

📋 Registros y Logs

Todas las acciones de moderación se registran automáticamente en el canal de logs configurado.

¿Qué se registra?

Configurar Canal de Logs

  1. Ve a Settings → Logs en el panel web
  2. Busca "Canal de Logs de Ban" o "Canal de Logs General"
  3. Pega el ID del canal donde quieres recibir los logs
  4. Guarda los cambios

🛡️ Protecciones de Seguridad

Los comandos de moderación incluyen múltiples protecciones:

1. Protección de Whitelist

Los usuarios en la whitelist no pueden ser baneados ni expulsados. Si intentas hacerlo, el bot rechazará la acción.

2. Prevención de Auto-Moderación

No puedes:

3. Protección del Propietario

El propietario del servidor no puede ser moderado por el bot.

4. Verificación de Permisos

Cada comando verifica que tengas los permisos necesarios antes de ejecutarse:

⚡ Mejores Prácticas

  1. Usa razones descriptivas: Ayuda a otros moderadores a entender por qué se tomó una acción
  2. Revisa los logs regularmente: Te ayudará a identificar patrones y mejorar la moderación
  3. Usa advertencias antes de acciones severas: Da a los usuarios una oportunidad de corregirse
  4. Configura slowmode en canales activos: Previene spam durante eventos o raids
  5. Limpia mensajes después de incidentes: Mantiene el servidor ordenado

❓ Preguntas Frecuentes

¿Puedo moderar usuarios que no están en el servidor?

Sí, para baneos y desbaneos puedes usar el ID del usuario directamente. Para otras acciones (kick, timeout), el usuario debe estar en el servidor.

¿Los comandos funcionan si el usuario está offline?

Sí, puedes banear, desbanear, y aplicar timeout a usuarios incluso si no están conectados.

¿Qué pasa si intento banear a alguien en whitelist?

El bot rechazará la acción y te mostrará un mensaje indicando que el usuario está protegido por la whitelist.

¿Puedo cancelar un timeout antes de que termine?

Sí, puedes usar /mod timeout usuario:@Usuario minutos:0 para quitar el timeout inmediatamente.

¿El bot puede moderar a otros bots?

No, el bot no puede moderar a otros bots por limitaciones de Discord.

💡 Consejo Final:
Los comandos de moderación son herramientas poderosas. Úsalos con responsabilidad y siempre proporciona razones claras para tus acciones. Recuerda que todas las acciones se registran para revisión posterior.