# Moderación y Automod

> Un bot de Discord de moderación gratis: ban, kick, mute, avisos con historial, automod de 11 reglas y logs detallados. Instalación en 30 segundos.

Canonical: https://ganyu.fr/es/wiki/moderation
Last updated: 2026-09-06

Ganyu cubre toda la cadena de moderación: sanciones manuales, advertencias con historial, automoderación finamente configurable y logs detallados de todo lo que pasa en el servidor. Cada acción requiere el permiso de Discord correspondiente y queda consultable en el dashboard.

## Las sanciones

Se registran y guardan en el historial cuatro tipos de sanciones: ban, mute (timeout), kick y warn. Cada una conserva una razón, el autor y, en su caso, una fecha de expiración. Las sanciones con duración (ban temporal, mute) se levantan automáticamente al vencer, a cargo del bot.

- `/ban <usuario> [reason] [delete_days] [duration]`: Banea a un miembro. delete_days purga los mensajes de los últimos N días (0 a 7); duration convierte el ban en ban temporal (ej. 7d, 12h), levantado automáticamente al vencer.
- `/unban <user_id> [reason]`: Revoca un baneo a partir del identificador del miembro.
- `/kick <usuario> [reason]`: Expulsa a un miembro del servidor (puede volver mediante una invitación).
- `/mute <usuario> <duration> [reason]`: Aplica un timeout de Discord. duration se expresa en minutos (1 a 40320, es decir 28 días máximo impuestos por Discord).
- `/warn add <usuario> <reason>`: Añade una advertencia. La razón es obligatoria.
- `/warn list <usuario>`: Muestra el historial de advertencias de un miembro.
- `/warn remove <usuario> <number>`: Retira una advertencia concreta (por su número en la lista).

Consejo: Configura umbrales de advertencias en el dashboard para desencadenar una sanción automática (mute, kick, ban…) a partir de un cierto número de warns: 5 reglas en FREE, 20 en PREMIUM, 100 en PRO.

## Permisos requeridos

Cada comando exige el permiso nativo de Discord adecuado. No hace falta crear un rol «moderador» especial, porque Ganyu se alinea con tus permisos existentes:

Comando | Permiso de Discord requerido
/ban, /unban | Banear miembros
/kick | Expulsar miembros
/mute, /warn | Silenciar miembros
/clear | Gestionar mensajes
/lockdown, /unlock | Gestionar canales
/role | Gestionar roles
/ghostping | Mencionar @everyone

## Canales, roles y herramientas rápidas

- `/clear <amount> [user] [scope]`: Elimina mensajes en masa. user filtra a un miembro concreto; scope vale channel (el canal actual) o server.
- `/lockdown [reason]`: Bloquea el canal actual en caso de emergencia (impide el envío de mensajes).
- `/unlock [reason]`: Desbloquea el canal.
- `/role give <role> <usuario>`: Da el rol al miembro, o se lo retira si ya lo tiene (alternancia).
- `/role all <role> [action] [ignore_bots]`: Aplica un rol a todo el servidor. action vale grant o remove; ignore_bots excluye a los bots de la operación.
- `/ghostping`: Detecta los ghost pings (menciones enviadas y luego eliminadas).

## Automoderación

El automod filtra automáticamente los mensajes según hasta 11 reglas activables de forma independiente desde la pestaña Automod del dashboard. Cada regla dispone de sus propias exenciones (canales y roles en lista blanca), además de las exenciones globales (roles/canales que escapan a todas las reglas). Número de reglas configurables: 10 en FREE, 25 en PREMIUM, 200 en PRO.

Regla | Qué filtra | Ajustes principales
Palabras prohibidas | Lista de palabras/expresiones baneadas | Lista de palabras
Enlaces | URL no autorizadas | Dominios autorizados, exención de GIF
Invitaciones | Invitaciones de Discord externas | Servidores autorizados
Spam | Mensajes enviados demasiado rápido | Número máx / ventana de tiempo
Mayúsculas | Mensajes gritados en MAYÚS | % máx de mayúsculas, longitud mínima
Menciones | Ping en masa | Menciones máx, menciones de rol, bloqueo de @everyone
Emojis | Sobrecarga de emojis | Número máx de emojis
Saltos de línea | Mensajes estirados verticalmente | Número máx de saltos de línea
Duplicados | Mensajes repetidos idénticos | Ventana de tiempo
Solo foto/vídeo | Canales reservados a medios | Canales afectados
Zalgo | Texto con glitches (marcas combinantes) | % máx, longitud mínima

Consejo: Las reglas Enlaces, Menciones y Foto/Vídeo están entre las más útiles: pon en lista blanca tus propios dominios y canales de compartición antes de activar las sanciones.

## Sanciones graduales del automod

En lugar de una respuesta única, defines una escala de sanciones desencadenada según el número de infracciones acumuladas. Las acciones posibles son: warn (advertir), delete (eliminar el mensaje), timeout (silenciar, con duración en minutos), kick y ban.

Un parámetro de decaimiento (infraction decay) permite olvidar las infracciones antiguas tras un plazo, y la opción resetOnSanction pone el contador a cero una vez aplicada una sanción. Cada infracción queda registrada.

## Logs de servidor

El módulo de logs registra los eventos del servidor (mensajes eliminados/editados, llegadas y salidas, sanciones, cambios de roles…) en los canales que elijas. Retención: 30 días en FREE, 90 en PREMIUM, 365 en PRO (ver premium).

Consejo: El premium de jugador incluye /antimove, una protección personal contra los movimientos forzados en voz (activable/desactivable mediante un estado verdadero/falso).

## Preguntas frecuentes

### ¿Cómo hago un ban temporal?

Añade la opción `duration` a `/ban` (ej. `7d` para siete días, `12h` para doce horas). Ganyu levanta automáticamente el baneo al vencer; sin esta opción, el ban es definitivo.

### ¿Cuál es la duración máxima de un mute?

28 días (40320 minutos), el límite del sistema de timeout impuesto por Discord. La duración se expresa en minutos en la opción `duration`.

### ¿Las advertencias desencadenan sanciones automáticas?

Sí, si configuras umbrales en el dashboard: al cabo de N warns, Ganyu puede silenciar, expulsar o banear automáticamente. El número de reglas depende del tier (5 / 20 / 100).

### ¿El automod puede ignorar a los moderadores?

Sí. Cada regla tiene sus propias listas blancas de roles y canales, y puedes definir exenciones globales que cortocircuitan todas las reglas para tu staff.

### ¿Dónde encuentro el historial de sanciones?

Todas las sanciones (ban, mute, kick, warn) quedan en el historial y se consultan en el dashboard, con su razón, su autor y su eventual fecha de expiración.

### ¿Hay que crear un rol de moderador para usar Ganyu?

No. Cada comando se apoya en el permiso nativo de Discord correspondiente: `/ban` exige Banear miembros, `/clear` exige Gestionar mensajes, `/lockdown` exige Gestionar canales. Tu jerarquía de roles actual basta, no hay nada que recrear.

### ¿Cómo bloqueo los enlaces y las invitaciones de Discord?

Activa las reglas Enlaces e Invitaciones en la pestaña Automod del [[dashboard]]. La primera solo permite los dominios de tu lista blanca y puede dejar pasar los GIF, la segunda bloquea las invitaciones a otros servidores salvo los que autorices.

### ¿Cómo borro varios mensajes de una vez?

`/clear ` borra mensajes en masa en el canal actual. La opción `user` limita la purga a un miembro concreto y la opción `scope` la extiende a todo el servidor en lugar de solo al canal.

### ¿Cómo bloqueo un canal durante un raid?

`/lockdown` corta al instante el envío de mensajes en el canal actual y `/unlock` lo reabre. Ambos comandos piden el permiso Gestionar canales y aceptan un motivo, que queda en los logs.

### ¿Cuántas reglas de automod puedo activar?

El automod ofrece 11 tipos de reglas. Puedes configurar 10 en FREE, 25 en PREMIUM y 200 en PRO, cada una con sus propios canales y roles exentos.

### ¿El automod puede sancionar de forma progresiva?

Sí. Defines una escala que se activa según el número de infracciones acumuladas, entre `warn`, `delete`, `timeout`, `kick` y `ban`. Un ajuste de decaimiento olvida las infracciones antiguas tras un plazo, y resetOnSanction pone el contador a cero en cuanto cae una sanción.

### ¿Cuánto tiempo se conservan los logs de moderación?

30 días en FREE, 90 días en PREMIUM y 365 días en PRO. Las sanciones siguen guardadas en el historial del dashboard con su motivo, su autor y su fecha de vencimiento.

## Fuentes y documentación oficial

- [Discord Developer Docs: Auto Moderation](https://discord.com/developers/docs/resources/auto-moderation)
- [Discord Safety Center](https://discord.com/safety)

## Related

- [La wiki de Ganyu](https://ganyu.fr/es/wiki.md)
- [Tickets de soporte](https://ganyu.fr/es/wiki/tickets.md)
- [Sorteos](https://ganyu.fr/es/wiki/giveaways.md)
- [Roles automáticos y bienvenida](https://ganyu.fr/es/wiki/roles-automatiques.md)
- [Seguimiento de invitaciones](https://ganyu.fr/es/wiki/invitations.md)
- [Canales de voz temporales](https://ganyu.fr/es/wiki/vocaux-temporaires.md)
- [Canal trampa contra el spam](https://ganyu.fr/es/wiki/salon-piege.md)
- [Clonación de servidores y plantillas](https://ganyu.fr/es/wiki/clonage-serveur.md)
