# Modération & Automod

> Un bot Discord de modération gratuit : ban, kick, mute, avertissements suivis, auto-modération à 11 règles et logs détaillés. Installation en 30 secondes.

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

Ganyu couvre toute la chaîne de modération : sanctions manuelles, avertissements historisés, auto-modération finement configurable et logs détaillés de tout ce qui se passe sur le serveur. Chaque action requiert la permission Discord correspondante et reste consultable dans le dashboard.

## Les sanctions

Quatre types de sanctions sont enregistrés et historisés : ban, mute (timeout), kick et warn. Chacune conserve une raison, l'auteur et, le cas échéant, une date d'expiration. Les sanctions à durée (ban temporaire, mute) sont automatiquement levées à échéance par le bot.

- `/ban <utilisateur> [reason] [delete_days] [duration]`: Bannit un membre. delete_days purge les messages des N derniers jours (0 à 7) ; duration transforme le ban en ban temporaire (ex. 7d, 12h), levé automatiquement à l'échéance.
- `/unban <user_id> [reason]`: Révoque un bannissement à partir de l'identifiant du membre.
- `/kick <utilisateur> [reason]`: Expulse un membre du serveur (il peut revenir via une invitation).
- `/mute <utilisateur> <duration> [reason]`: Applique un timeout Discord. duration s'exprime en minutes (1 à 40320, soit 28 jours maximum imposés par Discord).
- `/warn add <utilisateur> <reason>`: Ajoute un avertissement. La raison est obligatoire.
- `/warn list <utilisateur>`: Affiche l'historique des avertissements d'un membre.
- `/warn remove <utilisateur> <number>`: Retire un avertissement précis (par son numéro dans la liste).

Astuce: Configurez des paliers d'avertissements dans le dashboard pour déclencher une sanction automatique (mute, kick, ban…) à partir d'un certain nombre de warns : 5 règles en FREE, 20 en PREMIUM, 100 en PRO.

## Permissions requises

Chaque commande exige la permission Discord native adéquate. Inutile de créer un rôle « modérateur » spécial, Ganyu s'aligne sur vos permissions existantes :

Commande | Permission Discord requise
/ban, /unban | Bannir des membres
/kick | Expulser des membres
/mute, /warn | Rendre les membres muets
/clear | Gérer les messages
/lockdown, /unlock | Gérer les salons
/role | Gérer les rôles
/ghostping | Mentionner @everyone

## Salons, rôles et outils rapides

- `/clear <amount> [user] [scope]`: Supprime des messages en masse. user filtre un membre précis ; scope vaut channel (le salon courant) ou server.
- `/lockdown [reason]`: Verrouille le salon courant en urgence (empêche l'envoi de messages).
- `/unlock [reason]`: Déverrouille le salon.
- `/role give <role> <utilisateur>`: Donne le rôle au membre, ou le retire s'il le possède déjà (bascule).
- `/role all <role> [action] [ignore_bots]`: Applique un rôle à tout le serveur. action vaut grant ou remove ; ignore_bots exclut les bots de l'opération.
- `/ghostping`: Détecte les ghost pings (mentions envoyées puis supprimées).

## Auto-modération

L'automod filtre automatiquement les messages selon jusqu'à 11 règles activables indépendamment depuis l'onglet Automod du dashboard. Chaque règle dispose de ses propres exemptions (salons et rôles en liste blanche), en plus des exemptions globales (rôles/salons qui échappent à toutes les règles). Nombre de règles configurables : 10 en FREE, 25 en PREMIUM, 200 en PRO.

Règle | Ce qu'elle filtre | Réglages principaux
Mots interdits | Liste de mots/expressions bannis | Liste de mots
Liens | URL non autorisées | Domaines autorisés, exemption des GIF
Invitations | Invitations Discord externes | Serveurs autorisés
Spam | Messages envoyés trop vite | Nombre max / fenêtre de temps
Majuscules | Messages criés en CAPS | % max de majuscules, longueur mini
Mentions | Ping de masse | Mentions max, mentions de rôle, blocage @everyone
Émojis | Surcharge d'émojis | Nombre max d'émojis
Sauts de ligne | Messages étirés verticalement | Nombre max de retours à la ligne
Doublons | Messages répétés à l'identique | Fenêtre de temps
Photo/Vidéo uniquement | Salons réservés aux médias | Salons concernés
Zalgo | Texte glitché (marques combinantes) | % max, longueur mini

Astuce: Les règles Liens, Mentions et Photo/Vidéo comptent parmi les plus utiles : whitelistez vos propres domaines et salons de partage avant d'activer les sanctions.

## Sanctions graduées de l'automod

Au lieu d'une réponse unique, vous définissez une échelle de sanctions déclenchée selon le nombre d'infractions cumulées. Les actions possibles sont : warn (avertir), delete (supprimer le message), timeout (rendre muet, avec durée en minutes), kick et ban.

Un paramètre de décroissance (infraction decay) permet d'oublier les vieilles infractions après un délai, et l'option resetOnSanction remet le compteur à zéro une fois une sanction appliquée. Chaque infraction est journalisée.

## Logs de serveur

Le module de logs enregistre les événements du serveur (messages supprimés/édités, arrivées et départs, sanctions, changements de rôles…) dans les salons de votre choix. Rétention : 30 jours en FREE, 90 en PREMIUM, 365 en PRO (voir premium).

Astuce: Le premium joueur inclut /antimove, une protection personnelle contre les déplacements forcés en vocal (activable/désactivable par un état vrai/faux).

## Questions fréquentes

### Comment faire un ban temporaire ?

Ajoutez l'option `duration` à `/ban` (ex. `7d` pour sept jours, `12h` pour douze heures). Ganyu lève automatiquement le bannissement à l'échéance ; sans cette option, le ban est définitif.

### Quelle est la durée maximale d'un mute ?

28 jours (40320 minutes), la limite du système de timeout imposée par Discord. La durée s'exprime en minutes dans l'option `duration`.

### Les avertissements déclenchent-ils des sanctions automatiques ?

Oui, si vous configurez des paliers dans le dashboard : au bout de N warns, Ganyu peut muter, kicker ou bannir automatiquement. Le nombre de règles dépend du tier (5 / 20 / 100).

### L'automod peut-il ignorer les modérateurs ?

Oui. Chaque règle possède ses propres listes blanches de rôles et de salons, et vous pouvez définir des exemptions globales qui court-circuitent toutes les règles pour votre staff.

### Où retrouver l'historique des sanctions ?

Toutes les sanctions (ban, mute, kick, warn) sont historisées et consultables dans le dashboard, avec leur raison, leur auteur et leur date d'expiration éventuelle.

### Faut-il créer un rôle modérateur pour utiliser Ganyu ?

Non. Chaque commande s'appuie sur la permission Discord native correspondante : `/ban` exige Bannir des membres, `/clear` exige Gérer les messages, `/lockdown` exige Gérer les salons. Votre hiérarchie de rôles actuelle suffit, il n'y a rien à recréer.

### Comment bloquer les liens et les invitations Discord ?

Activez les règles Liens et Invitations dans l'onglet Automod du [[dashboard]]. La première n'autorise que les domaines de votre liste blanche et peut laisser passer les GIF, la seconde bloque les invitations vers d'autres serveurs sauf ceux que vous autorisez.

### Comment supprimer plusieurs messages d'un coup ?

`/clear ` supprime les messages en masse dans le salon courant. L'option `user` limite la purge à un membre précis et l'option `scope` étend l'opération à tout le serveur au lieu du seul salon.

### Comment verrouiller un salon pendant un raid ?

`/lockdown` coupe immédiatement l'envoi de messages dans le salon courant et `/unlock` le rouvre. Les deux commandes demandent la permission Gérer les salons et acceptent une raison, qui part dans les logs.

### Combien de règles d'automod puis-je activer ?

L'automod propose 11 types de règles. Vous pouvez en configurer 10 en FREE, 25 en PREMIUM et 200 en PRO, chacune avec ses propres salons et rôles exemptés.

### L'automod peut-il sanctionner progressivement ?

Oui. Vous définissez une échelle déclenchée au nombre d'infractions cumulées, parmi `warn`, `delete`, `timeout`, `kick` et `ban`. Une décroissance oublie les vieilles infractions après un délai, et resetOnSanction remet le compteur à zéro dès qu'une sanction tombe.

### Combien de temps les logs de modération sont-ils conservés ?

30 jours en FREE, 90 jours en PREMIUM et 365 jours en PRO. Les sanctions elles-mêmes restent historisées dans le dashboard avec leur raison, leur auteur et leur date d'expiration éventuelle.

## Sources et documentation officielle

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

## Related

- [Le wiki Ganyu](https://ganyu.fr/wiki.md)
- [Tickets de support](https://ganyu.fr/wiki/tickets.md)
- [Giveaways](https://ganyu.fr/wiki/giveaways.md)
- [Rôles automatiques & bienvenue](https://ganyu.fr/wiki/roles-automatiques.md)
- [Suivi des invitations](https://ganyu.fr/wiki/invitations.md)
- [Salons vocaux temporaires](https://ganyu.fr/wiki/vocaux-temporaires.md)
- [Salon piège contre le spam](https://ganyu.fr/wiki/salon-piege.md)
- [Clonage de serveur et modèles](https://ganyu.fr/wiki/clonage-serveur.md)
