DocsModeraciónSanciones (Ban/Kick/Timeout)

Sanciones

Tipos de sanción

Tres niveles de sanción según la gravedad. Todos registran un caso en el log de moderación y, si está activado, notifican al usuario por DM.

Ban
Permanente. El usuario no puede volver a unirse a menos que se revierta.
Kick
Expulsión temporal. El usuario puede volver con una nueva invitación.
Timeout
Silencio temporal. El usuario sigue en el servidor pero no puede interactuar.

Comandos

Todos funcionan como slash commands (/) y con prefijo de texto. Los argumentos entre < > son obligatorios y los de [ ] opcionales.

/ban <@usuario> [días] [razón]
Banea · alias: banear
/unban <ID> [razón]
Revierte el ban · alias: desbanear
/kick <@usuario> [razón]
Expulsa · alias: expulsar
/mute <@usuario> <duración> [razón]
Timeout · alias: silenciar, timeout
/unmute <@usuario> [razón]
Quita el timeout · alias: desilenciar, untimeout

El parámetro [días] del ban indica cuántos días de historial de mensajes se borran al aplicarlo (0–7, por defecto 0). La duración del timeout acepta minutos (10m), horas (2h) y días (7d), con un máximo de 28 días — límite de Discord. Para el /unban se usa el ID numérico del usuario, no la mención, ya que ya no está en el servidor.

Comportamiento

DM al usuario: por defecto el bot envía un mensaje privado al sancionado informando de la acción y la razón. Se puede desactivar desde el dashboard en la configuración de Moderación.
Registro: cada sanción genera una entrada en el canal de log de moderación con la acción, el moderador, el usuario y la razón. Puedes configurar canales de log separados para bans y advertencias.
Jerarquía de roles: solo puedes sancionar usuarios con roles por debajo del tuyo. No se pueden sancionar administradores ni usuarios con el mismo rango o superior. Los roles configurados como inmunes tampoco se pueden sancionar.
Moderadores y roles: además de los permisos nativos de Discord (Ban Members, Kick Members, Moderate Members), puedes definir roles de moderador y roles inmunes desde el dashboard en la sección de Moderación.