Modération
Module de sanctions classiques avec historique persistant et audit log dans un salon dédié.
Activer :
/setup→ bouton Modération, ou/config module nom:moderation actif:true
Commandes
/warn membre raison
Avertit un membre. La sanction est :
- Loguée dans la DB (consultable via
/modlog user) - Postée dans le salon d'audit (si configuré)
- Envoyée en DM au membre
Permission requise : Moderate Members.
/mute membre duree [raison]
Applique un timeout Discord (max 28 jours, limite Discord).
Format de durée : 30s, 5m, 1h, 2h30m, 1d.
/mute membre:@User duree:1h raison:Spam
Permission requise : Moderate Members.
/unmute membre [raison]
Retire le timeout. Échoue si le membre n'est pas timeout.
/kick membre [raison]
Expulse un membre (il peut rejoindre via une nouvelle invite). DM envoyé avant le kick.
Permission requise : Kick Members.
/ban membre [raison] [purge_jours]
Bannit un membre. purge_jours (0–7) supprime les messages des N derniers jours.
/ban membre:@User raison:Trolling purge_jours:1
Permission requise : Ban Members.
/unban id [raison]
Débannit un utilisateur par son ID Discord (le membre n'étant plus mentionnable).
/unban id:123456789012345678
/modlog user membre [limit]
Affiche l'historique de modération d'un membre (par défaut : 10 dernières actions, max 25).
/modlog recent [limit]
Dernières actions du serveur tous membres confondus.
/modlog channel [salon]
Définit le salon où poster les audits. Vide = audit désactivé.
Permission requise : Manage Server.
Hiérarchie
Le bot ne peut sanctionner quelqu'un que si :
- Le rôle du bot est plus haut que le plus haut rôle du membre cible
- Le rôle du modérateur est plus haut que celui du membre cible
- Le membre cible n'est pas l'owner du serveur
Si la hiérarchie n'est pas respectée, le bot refuse la commande avec un message clair.
Audit log
Configure un salon d'audit avec /modlog channel salon:#mod-log. Chaque action y publie un embed avec :
- Type d'action (warn/mute/kick/ban/unban/unmute)
- Membre ciblé
- Modérateur
- Raison
- Durée (pour mute)
- ID de la sanction (pour référence ultérieure)
Dashboard
/servers/<guildId>/moderation permet d'appliquer toutes les actions ci-dessus depuis l'interface web. Validation hiérarchie identique au backend.
/servers/<guildId>/modlog montre les dernières actions du serveur.
/servers/<guildId>/members/<userId> permet d'agir sur un membre depuis sa fiche (Quick mod panel).