Geschiedeniscommando's

Zoek op welke moderatierecords een lid op je server heeft, laat leden hun eigen records bekijken en wis de afgesloten records van een lid wanneer die een schone lei heeft verdiend.

Drie commando's doen dit: /history (staf), /my-history (iedereen) en /clear-history (staf, verwijdert).

🔎 Het dossier van een lid bekijken: `/history`

Kopieer het Discord-gebruikers-ID van het lid: zet in Discord de Ontwikkelaarsmodus aan (Developer Mode; Gebruikersinstellingen, Geavanceerd), klik met de rechtermuisknop op het lid en kies Gebruikers-ID kopiëren (Copy User ID).
Typ /history, plak het ID in user_id en druk op Enter.
De bot antwoordt privé, alleen aan jou, met de laatste 10 records, nieuwste eerst.

Elke regel ziet er zo uit:

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

het type in hoofdletters (BAN, MUTE, KICK, WARN, SOFTBAN, UNBAN, UNMUTE)
🔴 als het record nog actief is
de duur tussen haakjes bij bans, mutes en softbans
de reden, of "No reason"
wanneer het gebeurde
het zaaknummer na de #. Dat nummer gebruik je met /reason om de formulering van een record te wijzigen.

Je hebt in Discord de permissie Kick Members nodig om het commando te zien. Dezelfde lijst, met meer details, staat in het paneel: Moderatie → tabblad Geschiedenis, een tabel met één rij per record die je kunt filteren op type en op status.

🙋 Leden hun eigen dossier laten zien: `/my-history`

Iedereen kan /my-history typen. De bot toont dan privé de laatste 10 moderatierecords die de server over hen bewaart. Zo is de vraag "waarvoor ben ik gewaarschuwd?" snel beantwoord zonder de staf lastig te vallen.

De functie Moderatie moet op je server aanstaan. Staat ze uit, dan krijgt het lid een bericht dat dat zegt.
Het negeert je instelling Toegestane moderatorrollen: er is geen rol nodig.
Is er een voorvoegsel voor tekstcommando's ingesteld, dan werkt ook !my-history, maar een tekstantwoord kan niet privé zijn: de bot plaatst het in het kanaal en verwijdert het na 30 seconden.
Een lid zonder records krijgt "You have no moderation records on this server." (je hebt geen moderatierecords op deze server).

De eigen pagina van het lid in het paneel, Mijn sancties, toont dezelfde records over alle servers heen.

🧹 De afgesloten records van een lid wissen: `/clear-history`

/clear-history verwijdert elk record van één lid op je server dat niet meer actief is. Gebruik het als iemand zijn straf heeft uitgezeten en je een schoon dossier wilt.

Controleer of het lid niets actiefs heeft (zie hieronder).
Typ /clear-history, plak het gebruikers-ID van het lid in user_id en druk op Enter.
De bot antwoordt Cleared N inactive records for @member (N inactieve records gewist) of No inactive records found for @member (geen inactieve records gevonden).

Dit kan niet ongedaan worden gemaakt. De records worden verwijderd, niet verborgen.

Wat als inactief telt

Record	Wanneer het inactief wordt
Ban, mute	Zodra het afloopt of wordt opgeheven (unban, unmute, verlopen, of Opheffen in het paneel)
Warn, softban	Alleen als een moderator het in het paneel verwijdert (Moderatie → tabblad Geschiedenis → Verwijderen bij het record). Een waarschuwing heeft geen einddatum.
Kick, unban, unmute	Meteen: ze zijn al inactief op het moment dat ze worden geschreven

Actieve records blijven met rust. Wil je dat ook de waarschuwingen van een lid verdwijnen, verwijder ze dan eerst in het paneel en voer daarna /clear-history uit.

Wie het kan gebruiken

Al deze voorwaarden moeten waar zijn:

de functie Moderatie staat aan op de server
de persoon heeft in Discord de permissie Ban Members (let op: hoger dan bij /history, dat Kick Members vraagt)
heb je Toegestane moderatorrollen (slash-commando's) ingesteld bij de Moderatie-instellingen, dan heeft de persoon ook een van die rollen

Dezelfde actie in het paneel

Moderatie → tabblad Geschiedenis, daarna Alles wissen bij een afgesloten (niet actief) record van dat lid: klik erop en klik nog een keer waar Opnieuw klikken om te bevestigen staat. Het verwijdert alle afgesloten records van dat lid, precies dezelfde verwijdering als het commando.

De paneelknop schrijft een regel in het Activiteitenlogboek van je server ("Inactieve geschiedenis ... gewist") en plaatst ook een bericht in je moderatielogkanaal, als je dat hebt ingesteld. Het commando /clear-history doet geen van beide: het laat geen vermelding achter in het Activiteitenlogboek en plaatst niets in het logkanaal. Wil je team een zichtbaar spoor, gebruik dan de paneelknop of schrijf met de hand een regel in je logkanaal.

💡 Voorbeeld

Een lid is in maart twee keer gewaarschuwd en in april een dag gemute. Het is oktober en het lid gedraagt zich.

/history user_id:123456789012345678 toont: MUTE (1d, geen stip, afgesloten), WARN 🔴, WARN 🔴.
De twee waarschuwingen zijn nog 🔴, dus /clear-history alleen zou enkel de mute verwijderen.
In het paneel: Moderatie → tabblad Geschiedenis, zoek het lid en klik bij elke waarschuwing op Verwijderen.
Nu /clear-history user_id:123456789012345678. De bot antwoordt Cleared 3 inactive records en het dossier van het lid is leeg.

🔧 Als er iets misgaat

🚨 "The Moderation feature is not enabled for this server"

Zet de functie aan in het paneel en probeer het opnieuw. Het bericht bevat de link.

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

Je server beperkt moderatiecommando's tot bepaalde rollen. Vraag een beheerder om de jouwe toe te voegen onder Toegestane moderatorrollen (slash-commando's), of om die lijst leeg te maken.

🚨 Ik zie `/clear-history` niet in de commandolijst

Discord verbergt het voor iedereen zonder Ban Members. Een serverbeheerder kan ook wijzigen wie het ziet via Serverinstellingen → Integraties → YAWBDB (Server Settings → Integrations).

🚨 "No inactive records found" maar `/history` toont records

De records zijn nog actief. Hef ze eerst op of verwijder ze in het paneel (waarschuwingen en softbans worden altijd met de hand verwijderd).

🚨 "Failed to clear history" of "Server not registered in panel"

De bot kon het paneel niet bereiken, of de server is er niet mee verbonden. Probeer het over een minuut opnieuw; is de server nieuw, verbind hem dan eerst.

🚨 Ik heb het verkeerde lid gewist

Het kan niet worden hersteld. Maak de records opnieuw aan op basis van je eigen notities of je Activiteitenlogboek; het Activiteitenlogboek bewaart alleen een regel bij een wisactie vanuit het paneel.

🚨 `/my-history` zegt dat de server niet is geregistreerd

Dezelfde oorzaak als hierboven: de server is niet met het paneel verbonden.