AdminProtocol DE
🌐 English · Deutsch
AdminProtocol ist ein detailliertes Protokoll-Cog im Stil eines Audit-Logs: Es überwacht eine breite Palette administrativer Aktionen und Benutzeraktivitäten auf deinem Server und postet zu jedem Ereignis ein formatiertes Embed in einen frei wählbaren Kanal. 28 einzelne Ereignisse — Nachrichtenänderungen und -löschungen, Kanal-/Thread-/Rollen-Lebenszyklus, Banns, Kicks, Timeouts, Nickname- und Rollenänderungen, Sprachaktivität, Einladungen und Moderationsbefehle — lassen sich jeweils einzeln aktivieren, in einen eigenen Log-Kanal leiten und mit Ausnahmen für Kanäle, Rollen oder User versehen. Jedes Ereignis ist standardmäßig deaktiviert, und das gesamte Cog wird über das PDC Web Dashboard konfiguriert — es gibt keine Chat-Befehle. Autor: pd-codes · benötigt Red 3.5.0+ und Python 3.10+.
[p]repo add PDC_Redbot_Cogs https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC_Redbot_Cogs AdminProtocol
[p]load AdminProtocol
[p] ist das Prefix deines Bots. Die vollständige Downloader-Anleitung findest du unter Installation. AdminProtocol stellt keine Prefix- oder Slash-Befehle bereit — die gesamte Konfiguration läuft über das Dashboard (siehe unten).
Die Ereignisse sind in vier Kategorien gruppiert. Jede Zeile ist ein eigenständiges Log-Ereignis mit eigenem Aktivierungs-Schalter, Ziel-Kanal und Ausnahmelisten.
| Ereignis-Schlüssel | Protokolliert |
|---|---|
message_edit |
Eine Nachricht wurde bearbeitet (alter/neuer Inhalt, Sprung-Link). Bot-Nachrichten und inhaltslose Edits werden ignoriert. |
message_delete |
Eine Nachricht wurde gelöscht; wer gelöscht hat, wird wenn möglich aus dem Audit-Log ermittelt. |
channel_create |
Ein Kanal wurde erstellt. |
channel_delete |
Ein Kanal wurde gelöscht. |
channel_update |
Ein Kanal wurde geändert (Name, Thema oder NSFW-Flag). |
thread_create |
Ein Thread wurde erstellt. |
thread_delete |
Ein Thread wurde gelöscht. |
thread_update |
Ein Thread wurde geändert (Name oder Archiv-Status). |
| Ereignis-Schlüssel | Protokolliert |
|---|---|
user_join |
Ein Mitglied ist beigetreten (mit Schätzung des Kontoalters). |
user_leave |
Ein Mitglied hat den Server verlassen (sofern es kein Kick war). |
nickname_change_other |
Der Nickname eines Mitglieds wurde von jemand anderem geändert. |
nickname_change_self |
Ein Mitglied hat den eigenen Nickname geändert. |
role_create |
Eine Rolle wurde angelegt. |
role_delete |
Eine Rolle wurde gelöscht. |
role_add |
Einem Mitglied wurde eine Rolle zugewiesen. |
role_remove |
Einem Mitglied wurde eine Rolle entzogen. |
| Ereignis-Schlüssel | Protokolliert |
|---|---|
user_ban |
Ein Mitglied wurde gebannt (Moderator + Grund aus dem Audit-Log). |
user_unban |
Ein Benutzer wurde entbannt. |
user_kick |
Ein Mitglied wurde gekickt (per Audit-Log von user_leave unterschieden). |
user_timeout |
Ein Timeout wurde gesetzt oder entfernt (Dauer formatiert). |
mod_command |
Ein Moderationsbefehl wurde verwendet — sowohl Prefix (on_command) als auch Slash (on_app_command_completion). |
Ein Befehl gilt als Moderationsbefehl, wenn er zu den Cogs Mod, Admin oder AdminUtils gehört oder sein Name einer von kick, ban, timeout, warn, mute, unmute, unban, purge, purgefast, messagemove ist.
| Ereignis-Schlüssel | Protokolliert |
|---|---|
voice_join |
Ein Mitglied ist einem Sprachkanal beigetreten. |
voice_leave |
Ein Mitglied hat einen Sprachkanal verlassen (selbst). |
voice_switch |
Ein Mitglied hat selbst den Sprachkanal gewechselt. |
voice_move |
Ein Moderator hat ein Mitglied in einen anderen Sprachkanal verschoben. |
voice_disconnect |
Ein Moderator hat ein Mitglied aus dem Sprachkanal getrennt. |
voice_status |
Sprachstatus geändert (Server-/Selbst-Mute, Deafen, Stream, Kamera). |
invite_create |
Eine Server-Einladung wurde erstellt. |
Die Zuordnung von Moderator und Grund (Banns, Kicks, Timeouts, Kanal-/Thread-Änderungen, Voice-Verschiebungen/-Trennungen, Löschungen) wird aus dem Audit-Log gelesen. Der Bot benötigt die Berechtigung Audit-Log ansehen sowie Nachrichten senden in jedem konfigurierten Log-Kanal. Audit-Log-Einträge werden nur innerhalb von ~15 Sekunden nach der Aktion zugeordnet.
AdminProtocol speichert alles pro Server (Red Config, Identifier 8912389124) in einer einzigen events-Zuordnung. Jedes Ereignis enthält folgende Schlüssel:
| Schlüssel | Typ | Bedeutung |
|---|---|---|
enabled |
bool | Ob das Ereignis protokolliert wird (Standard False). |
channel |
Kanal-ID / null
|
Ziel-Kanal für die Embeds dieses Ereignisses. |
ignored_channels |
Liste von IDs | Von diesem Ereignis ausgenommene Kanäle. |
ignored_users |
Liste von IDs | Ausgenommene User (Betroffene oder Auslöser). |
ignored_roles |
Liste von IDs | Ausgenommene Rollen — geprüft gegen die Rollen von Betroffenem und Auslöser. |
Ein Embed wird nur gepostet, wenn das Ereignis enabled ist, einen channel gesetzt hat und der Betroffene/Auslöser/Kanal/die Rolle auf keiner Ausnahmeliste steht.
AdminProtocol registriert sich beim Laden am PDC Web Dashboard und hängt sich automatisch erneut ein, falls das Dashboard-Cog später erscheint. Es stellt ein Widget, fünf Guild-Settings-Panels und eine eigenständige Vollseite bereit:
| Oberfläche | Mount | Berechtigung | Zweck |
|---|---|---|---|
| Widget „Aktive Log-Events“ | Dashboard-Startseite (KPI, klein) | guild_member |
Zählt, wie viele Ereignisse aktuell aktiviert sind. |
| Panel „Nachrichten & Kanäle“ | guild_settings |
guild_admin |
Aktivieren-Schalter + Kanal-Auswahl je Nachrichten-/Kanal-/Thread-Ereignis. |
| Panel „Mitglieder & Rollen“ | guild_settings |
guild_admin |
Aktivieren + Kanal je Mitglieder-/Rollen-Ereignis. |
| Panel „Moderation“ | guild_settings |
guild_admin |
Aktivieren + Kanal je Moderations-Ereignis. |
| Panel „Sprachkanäle & Einladungen“ | guild_settings |
guild_admin |
Aktivieren + Kanal je Voice-/Einladungs-Ereignis. |
| Panel „Ausnahmen“ | guild_settings |
guild_admin |
Je aktivem Ereignis: ignorierte Kanäle/Rollen (Mehrfachauswahl) und ignorierte User-IDs (Komma-Liste). |
Eigenständige Seite adminprotocol
|
eigene Seite (GET/POST) |
manage_guild / Bot-Owner |
Voll-Editor — Aktivierung, Kanal und alle drei Ausnahmelisten je Ereignis einzeln speichern. |
Das Panel Ausnahmen zeigt nur aktuell aktive Ereignisse. Aktiviere ein Ereignis daher zuerst im jeweiligen Kategorie-Tab, bevor du Ausnahmen dafür einstellst.
Die Dashboard-Panels erfordern guild_admin; die eigenständige Seite erfordert manage_guild (oder Bot-Owner). Für die korrekte Zuordnung von Moderator/Grund benötigt der Bot Audit-Log ansehen sowie Nachrichten senden (und Embed-Recht) in jedem zugewiesenen Log-Kanal. AdminProtocol speichert nur Server-Einstellungen — Kanalauswahlen, Ausnahmelisten und Aktivierungs-Status — und keine personenbezogenen Daten dauerhaft.
Siehe auch: Installation · Dashboard-Integration · EventMessages · AdminUtils · Start