AdminProtocol DE

AdminProtocol

🌐 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+.

Installation

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

Protokollierte Ereignisse

Die Ereignisse sind in vier Kategorien gruppiert. Jede Zeile ist ein eigenständiges Log-Ereignis mit eigenem Aktivierungs-Schalter, Ziel-Kanal und Ausnahmelisten.

Nachrichten & Kanäle

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

Mitglieder & Rollen

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.

Moderation

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.

Sprachkanäle & Einladungen

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.

Konfiguration

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.

Dashboard-Integration

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.

Berechtigungen & Hinweise

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