🛡️

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).