Verifizierung: Einstellungen, Ablauf und Fehlerbehebung

Die Verifizierung hält neue Mitglieder zunächst von deinem Server fern, bis sie per Klick auf einen Button bestätigen, dass sie die Regeln gelesen haben. Kage tauscht dabei nur Rollen aus: Neue bekommen die Rolle Unverified, nach dem Klick die Rolle Verified. Welche Kanäle jede Rolle sieht, bestimmst du in Discord.

Diese Seite ist die Referenz: jede Einstellung, jeder Schritt im Ablauf, jede Meldung. Eine kurze Anleitung zur Einrichtung findest du im Ratgeber Discord Verifizierung einrichten.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten auf dem Server (oder einen Zugriff, den dir ein Server-Admin für dieses Modul freigegeben hat). Der Befehl /verification ist ebenfalls nur mit Server verwalten sichtbar.
• Zwei Rollen: Lege in Discord die Rollen für „Unverified“ und „Verified“ an. Die Namen sind frei wählbar.
• Rollenreihenfolge: Kages Rolle muss in der Rollenliste über beiden Rollen stehen, sonst kann Kage sie nicht vergeben. Kage braucht außerdem das Recht Rollen verwalten, das in den Rechten der Standard-Einladung enthalten ist.
• Kanalrechte: Kage ändert keine Kanalrechte. Damit die Verifizierung etwas bewirkt, erlaubst du der Unverified-Rolle in Discord nur den Verifizierungskanal und sperrst für sie die übrigen Kanäle.
• Posten im Kanal: Im Verifizierungskanal braucht Kage die Rechte Nachrichten senden und Links einbetten, weil das Panel eine Nachricht mit Einbettung und Button ist.

So läuft die Verifizierung ab

Beim Beitritt eines Mitglieds

1. Ist die Verifizierung eingeschaltet und eine Unverified-Rolle gewählt, vergibt Kage diese Rolle sofort, sofern das Mitglied sie noch nicht hat.
2. Ist die Verifizierung ausgeschaltet oder keine Unverified-Rolle gewählt, passiert nichts.
3. Kann Kage die Rolle nicht vergeben (zum Beispiel wegen der Rollenreihenfolge), erscheint dazu keine Meldung in Discord. Der Fehler wird nur im Betriebslog des Bots festgehalten. Prüfe in so einem Fall die Rollenreihenfolge.

Beim Klick auf den Button

1. Ist die Verifizierung ausgeschaltet, antwortet Kage, dass sie auf dem Server nicht aktiv ist.
2. Ist ein Mindest-Accountalter gesetzt, prüft Kage das Alter des Discord-Kontos (Tag der Konto-Erstellung, nicht Beitritt zu deinem Server). Ist das Konto zu neu, bekommt das Mitglied eine Meldung und wird nicht verifiziert.
3. Hat das Mitglied die Verified-Rolle bereits, antwortet Kage, dass es schon verifiziert ist.
4. Ist eine Verified-Rolle eingestellt, aber nicht mehr auffindbar (zum Beispiel gelöscht), bekommt das Mitglied eine Fehlermeldung. Kage aktualisiert dafür vorher die Rollenliste von Discord, damit eine frisch angelegte Rolle nicht fälschlich als fehlend gilt.
5. Kage vergibt die Verified-Rolle und entfernt die Unverified-Rolle, falls das Mitglied sie hat. Ist keine Verified-Rolle eingestellt, wird nur die Unverified-Rolle entfernt.
6. Verweigert Discord die Rollenvergabe, antwortet Kage mit einem Hinweis auf Rollenreihenfolge und Rechte.
7. Bei Erfolg antwortet Kage nur dem Mitglied sichtbar mit einer Bestätigung.

Der Button funktioniert auch nach einem Neustart des Bots weiter, ebenso bei älteren Panel-Nachrichten.

Einstellungen im Überblick

Du findest sie im Dashboard unter Verifizierung im Reiter Konfiguration. Dieselben Werte lassen sich mit dem Befehl /verification setup setzen.

Der Standardtext und die Standardbeschriftung sind englisch. Auf einem deutschsprachigen Server solltest du beide anpassen.

Einrichtung im Dashboard

1. Lege in Discord die beiden Rollen an und stelle die Rollenreihenfolge sowie die Kanalrechte ein (siehe Voraussetzungen).
2. Öffne im Dashboard das Modul Verifizierung, Reiter Konfiguration.
3. Wähle Verifizierungs-Kanal, Unverified-Rolle und Verified-Rolle. Passe Panel-Text, Button-Beschriftung und Mindest-Accountalter an.
4. Klicke auf Panel posten. Das speichert die Einstellungen, schaltet das Modul ein und postet die Panel-Nachricht in den Kanal. Mit Speichern sicherst du Änderungen, ohne das Panel zu posten.
5. Ändert sich später ein Wert, klicke auf Panel aktualisieren. Dann wird die vorhandene Nachricht angepasst. Ist sie nicht mehr da, postet Kage eine neue.

Einrichtung per Befehl

Wichtig zu wissen:

• Jeder Aufruf von /verification setup postet eine neue Panel-Nachricht. Frühere Panels bleiben stehen und funktionieren weiter. Willst du die vorhandene Nachricht ändern, nutze Panel aktualisieren im Dashboard.
• Kage weist in der Antwort darauf hin, wenn eine der beiden Rollen nicht unter Kages höchster Rolle liegt.
• Beim Posten mit /verification setup zeigt der Button die Standardbeschriftung „I agree ✅“. Die von dir angegebene button_label wird gespeichert und erscheint erst, wenn du im Dashboard Panel aktualisieren wählst.
• Schaltest du die Verifizierung aus, vergibt Kage keine Unverified-Rolle mehr und der Button antwortet nicht mehr mit einer Verifizierung. Mitglieder, die die Unverified-Rolle bereits haben, behalten sie. Du musst sie dann selbst entfernen oder ihnen die Verified-Rolle geben.

Meldungen, die Mitglieder sehen

Diese Antworten sendet Kage derzeit auf Englisch und nur für das jeweilige Mitglied sichtbar:

Ergebnis überprüfen

1. Einstellungen: Rufe /verification status auf. Status, Kanal, beide Rollen und Mindest-Accountalter sollten stimmen.
2. Praxistest: Tritt mit einem zweiten Discord-Konto bei, das die Mindestanforderung erfüllt. Es sollte die Unverified-Rolle erhalten und nur den Verifizierungskanal sehen. Nach dem Klick auf den Button sollte es die Verified-Rolle haben und die übrigen Kanäle sehen.
3. Protokoll in Discord: Ist das Modul Audit-Log eingeschaltet und ein Protokollkanal gewählt, schreibt Kage dort Einträge mit dem Titel „Verification“ für erfolgreiche Verifizierungen, abgelehnte Konten (zu neu) und eine fehlende Verified-Rolle. Eine Ablehnung wegen der Rollenreihenfolge wird dort nicht protokolliert.
4. Protokoll im Dashboard: Im Modul Verifizierung zeigt der Reiter Logs jede erfolgreiche Verifizierung, der Reiter Statistik die Anzahl über die Zeit.

Fehlerbehebung

Neue Mitglieder bekommen die Unverified-Rolle nicht

Prüfe, ob „Verification aktiv“ an ist und eine Unverified-Rolle gewählt wurde. Prüfe dann die Rollenreihenfolge: Kages Rolle muss über der Unverified-Rolle stehen. Mitglieder, die schon vor der Einrichtung auf dem Server waren, bekommen die Rolle nicht nachträglich.

Mitglieder sehen trotz Unverified-Rolle alle Kanäle

Kage ändert keine Kanalrechte. Sperre die Unverified-Rolle in Discord für alle Kanäle außer dem Verifizierungskanal.

Das Panel lässt sich nicht posten

Im Dashboard: Wähle zuerst einen Kanal. Meldet Kage, dass der Kanal nicht existiert, wähle ihn neu. Meldet Kage fehlende Berechtigung, gib Kage in diesem Kanal die Rechte „Nachrichten senden“ und „Links einbetten“. Per Befehl erscheint bei fehlendem Recht die Antwort „I can't post in that channel.“.

Der Button meldet einen Fehler zur Rolle

Meist liegt es an der Rollenreihenfolge. Stelle Kages Rolle über „Unverified“ und „Verified“. Meldet Kage, die Verified-Rolle sei nicht auffindbar, wurde sie gelöscht oder falsch ausgewählt.

Das Button-Label ist nicht das, was ich eingestellt habe

Nach /verification setup zeigt der Button die Standardbeschriftung. Wähle im Dashboard Panel aktualisieren, um deine Beschriftung zu übernehmen.

Echte Mitglieder werden wegen des Kontoalters abgelehnt

Die Grenze gilt für das Alter des Discord-Kontos, nicht für die Zeit auf deinem Server. Senke den Wert oder setze ihn auf 0.

Weiterführend

Die Verifizierung ist ein Baustein für den Einstieg neuer Mitglieder. Gegen koordinierte Massen-Beitritte hilft das Modul Anti-Raid: Discord Raids verhindern. Wenn Neue nach der Verifizierung Rollen wählen sollen, hilft das Onboarding.