Commandes d'historique

Consulte les enregistrements de modération d'un membre sur ton serveur, laisse les membres vérifier les leurs, et efface les enregistrements terminés d'un membre quand il a mérité de repartir de zéro.

Trois commandes s'en chargent : /history (staff), /my-history (tout le monde) et /clear-history (staff, supprime).

🔎 Voir le dossier d'un membre : `/history`

Copie l'identifiant d'utilisateur Discord du membre : dans Discord, active le Mode développeur (Developer Mode ; Paramètres utilisateur, Avancé), fais un clic droit sur le membre, Copier l'identifiant de l'utilisateur (Copy User ID).
Tape /history, colle l'identifiant dans user_id, appuie sur Entrée.
Le bot répond en privé, à toi seul, avec les 10 derniers enregistrements, du plus récent au plus ancien.

Chaque ligne ressemble à ceci :

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

le type en majuscules (BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
🔴 quand l'enregistrement est encore actif
la durée entre parenthèses pour les bans, mutes et softbans
la raison, ou « No reason »
le moment où cela s'est produit
le numéro de cas après le #. C'est le numéro à utiliser avec /reason pour changer le libellé d'un enregistrement.

Il te faut la permission Kick Members dans Discord pour voir la commande. La même liste, en plus détaillé, se trouve dans le panel : Modération → onglet Historique, un tableau avec une ligne par enregistrement que tu peux filtrer par type et par statut.

🙋 Laisser les membres voir leur propre dossier : `/my-history`

Tout le monde peut taper /my-history. Le bot leur montre, en privé, les 10 derniers enregistrements de modération que le serveur détient sur eux. C'est un moyen rapide de régler le « pourquoi j'ai été averti ? » sans déranger le staff.

Elle exige que la fonctionnalité Modération soit activée sur ton serveur. Si elle est désactivée, le membre reçoit un message qui le lui dit.
Elle ignore ton réglage Rôles de modération autorisés (commandes slash) : aucun rôle n'est nécessaire.
Avec un préfixe de commandes texte défini, !my-history fonctionne aussi, mais une réponse texte ne peut pas être privée : le bot la publie dans le salon et la supprime au bout de 30 secondes.
Un membre sans enregistrement reçoit « You have no moderation records on this server. » (il n'a aucun enregistrement de modération sur ce serveur).

La page personnelle du membre dans le panel, Mes sanctions, liste les mêmes enregistrements sur tous les serveurs.

🧹 Effacer les enregistrements terminés d'un membre : `/clear-history`

/clear-history supprime tous les enregistrements qui ne sont plus actifs pour un membre sur ton serveur. Utilise-la quand quelqu'un a purgé sa peine et que tu veux un dossier propre.

Vérifie que le membre n'a plus rien d'actif (voir plus bas).
Tape /clear-history, colle l'identifiant du membre dans user_id, appuie sur Entrée.
Le bot répond Cleared N inactive records for @member (N enregistrements inactifs effacés) ou No inactive records found for @member (aucun enregistrement inactif trouvé).

Cette action est irréversible. Les enregistrements sont supprimés, pas masqués.

Ce qui compte comme inactif

Enregistrement	Quand il devient inactif
Ban, mute	Dès qu'il se termine ou qu'il est levé (unban, unmute, expiration, ou Lever dans le panel)
Warn, softban	Seulement quand un modérateur le retire dans le panel (Modération → onglet Historique → Retirer sur l'enregistrement). Un avertissement n'a pas de date de fin.
Kick, unban, unmute	Immédiatement : ils sont déjà inactifs au moment où ils sont écrits

Les enregistrements actifs sont laissés en place. Si tu veux aussi faire disparaître les avertissements d'un membre, retire-les d'abord dans le panel, puis lance /clear-history.

Qui peut l'utiliser

Toutes ces conditions doivent être réunies :

la fonctionnalité Modération est activée sur le serveur
la personne a la permission Ban Members dans Discord (attention : c'est plus élevé que /history, qui demande Kick Members)
si tu as défini Rôles de modération autorisés (commandes slash) dans les réglages de Modération, elle possède aussi l'un de ces rôles

La même action dans le panel

Modération → onglet Historique, puis Tout effacer sur un enregistrement terminé (non actif) de ce membre : clique, puis clique à nouveau là où il est écrit Cliquez à nouveau pour confirmer. Cela supprime tous les enregistrements terminés de ce membre, c'est la même suppression que la commande.

Le bouton du panel écrit une ligne dans le journal d'activité de ton serveur (« Historique inactif de … vidé (supprimé : N) ») et, si tu as défini un salon de journal de modération, y publie aussi. La commande /clear-history n'écrit ni l'un ni l'autre : elle ne laisse aucune entrée dans le journal d'activité et ne publie rien dans le salon de journal. Si ton équipe veut une trace visible, utilise le bouton du panel, ou écris une ligne à la main dans ton salon de journal.

💡 Exemple

Un membre a été averti deux fois en mars et mis en sourdine une journée en avril. Nous sommes en octobre et il s'est bien tenu.

/history user_id:123456789012345678 affiche : MUTE (1d, sans point, terminé), WARN 🔴, WARN 🔴.
Les deux avertissements sont toujours 🔴, donc /clear-history seule ne supprimerait que le mute.
Dans le panel : Modération → onglet Historique, trouve le membre et clique sur Retirer sur la ligne de chaque avertissement.
Maintenant /clear-history user_id:123456789012345678. Le bot répond Cleared 3 inactive records et le dossier du membre est vide.

🔧 En cas de problème

🚨 « The Moderation feature is not enabled for this server »

Active la fonctionnalité dans le panel, puis réessaie. Le message contient le lien.

🚨 « You do not have a role that is allowed to use moderation commands on this server »

Ton serveur limite les commandes de modération à certains rôles. Demande à un admin d'ajouter le tien dans Rôles de modération autorisés (commandes slash), ou de vider cette liste.

🚨 Je ne vois pas `/clear-history` dans la liste des commandes

Discord la masque à quiconque n'a pas Ban Members. Un admin du serveur peut aussi changer qui la voit dans Paramètres du serveur → Intégrations → YAWBDB (Server Settings → Integrations).

🚨 « No inactive records found » alors que `/history` affiche des enregistrements

Les enregistrements sont encore actifs. Lève-les ou retire-les d'abord dans le panel (les avertissements et les softbans ne sont jamais retirés qu'à la main).

🚨 « Failed to clear history » ou « Server not registered in panel »

Le bot n'a pas pu joindre le panel, ou le serveur n'y est pas connecté. Réessaie dans une minute ; si le serveur est nouveau, connecte-le d'abord.

🚨 J'ai effacé le mauvais membre

Impossible de restaurer. Recrée les enregistrements à partir de tes propres notes ou de ton journal d'activité ; le journal d'activité ne garde une ligne que pour un effacement fait depuis le panel.

🚨 `/my-history` dit que le serveur n'est pas enregistré

Même cause que ci-dessus : le serveur n'est pas connecté au panel.