🛠️ 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
- ✅ Verificación de Permisos: Solo usuarios con permisos apropiados pueden usar estos comandos
- ✅ Respeto a la Whitelist: Los usuarios en whitelist están protegidos de baneos y expulsiones
- ✅ Registros Automáticos: Todas las acciones se registran en los logs de seguridad
- ✅ Respuestas Privadas: Las respuestas solo las ve quien ejecuta el comando
- ✅ Validaciones de Seguridad: Previene errores comunes (auto-baneo, etc.)
🔨 Comandos de Baneo
/mod ban add
Banea un usuario del servidor.
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)
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
- 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.
Sintaxis
/mod ban remove usuario:@Usuario
- usuario (requerido): El usuario a desbanear (puede ser ID si no está en el servidor)
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.
- 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).
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
Ejemplos
/mod kick usuario:@Usuario razon:"Comportamiento inapropiado"
/mod kick usuario:@Usuario razon:"Spam en múltiples canales"
- 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.
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
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
- 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.
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
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"
- 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).
Sintaxis
/mod warn usuario:@Usuario [razon:"Razón de la advertencia"]
- usuario (requerido): El usuario a advertir
- razon (opcional): Razón de la advertencia
Ejemplos
/mod warn usuario:@Usuario razon:"Lenguaje inapropiado"
/mod warn usuario:@Usuario razon:"No seguir las reglas del canal"
- 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.
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
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
- 10 segundos = 10
- 1 minuto = 60
- 5 minutos = 300
- 1 hora = 3,600
- 6 horas (máximo) = 21,600
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?
- ✅ Usuario que ejecutó la acción
- ✅ Usuario objetivo
- ✅ Tipo de acción (ban, kick, timeout, etc.)
- ✅ Razón proporcionada
- ✅ Canal donde ocurrió (si aplica)
- ✅ Timestamp del evento
Configurar Canal de Logs
- Ve a Settings → Logs en el panel web
- Busca "Canal de Logs de Ban" o "Canal de Logs General"
- Pega el ID del canal donde quieres recibir los logs
- 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:
- Banearte a ti mismo
- Expulsarte a ti mismo
- Aplicarte timeout a ti mismo
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:
- Ban: Requiere permiso "Banear Miembros"
- Kick: Requiere permiso "Expulsar Miembros"
- Timeout: Requiere permiso "Moderar Miembros"
- Clear: Requiere permiso "Gestionar Mensajes"
- Slowmode: Requiere permiso "Gestionar Canales"
⚡ Mejores Prácticas
- Usa razones descriptivas: Ayuda a otros moderadores a entender por qué se tomó una acción
- Revisa los logs regularmente: Te ayudará a identificar patrones y mejorar la moderación
- Usa advertencias antes de acciones severas: Da a los usuarios una oportunidad de corregirse
- Configura slowmode en canales activos: Previene spam durante eventos o raids
- 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.
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.