EventMessages DE

EventMessages

🌐 English · Deutsch

EventMessages postet automatische, öffentliche Ankündigungen, wenn auf deinem Server etwas passiert — ein Mitglied tritt bei oder verlässt den Server, wird gekickt, gebannt, entbannt, in Timeout versetzt oder dessen Timeout läuft ab. Jedes der sieben Events hat seinen eigenen An-/Aus-Schalter, Zielkanal und seine eigene Nachrichtenvorlage, alles pro Guild konfigurierbar per Slash-Befehl oder über das PDC Web Dashboard. Jedes Event ist standardmäßig deaktiviert, es wird also nichts gepostet, bis du es aktivierst. 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 EventMessages
[p]load EventMessages
[p]slash sync

[p] ist das Präfix deines Bots. Die vollständige Downloader-Anleitung findest du unter Installation. Alle Konfigurationsbefehle sind Slash-Befehle, führe nach dem Laden also einmal [p]slash sync aus.

Events

Event	Auslöser	Hinweise
join	Mitglied tritt bei	—
leave	Mitglied verlässt Server	Wird beim Member-Remove ausgelöst, wenn es kein Kick war.
kick	Mitglied gekickt	Erkennung über das Audit-Log beim Member-Remove — der Cog prüft die letzten 5 kick-Einträge, um das verlassende Mitglied zuzuordnen.
ban	Mitglied gebannt	Moderator und Grund werden aus dem Audit-Log gelesen.
unban	Mitglied entbannt	Moderator wird aus dem Audit-Log gelesen.
timeout	Timeout gesetzt	Moderator, Grund und Endzeit ({duration}) werden aus dem Audit-Log gelesen.
timeout_end	Timeout läuft ab / wird entfernt	Wird ausgelöst, wenn timed_out_until zurückgesetzt wird.

Da kick und leave aus demselben Member-Remove-Event stammen, verlässt sich der Cog auf Discords Audit-Log, um sie zu unterscheiden. Audit-Log-Einträge können leicht verzögert sein; der Bot benötigt die Berechtigung Audit-Log ansehen, damit die Zuordnung für Kick/Ban/Unban/Timeout funktioniert.

Befehle

Alle drei Befehle sind reine Slash-Application-Commands. Das Argument event bietet Autocomplete über die sieben Event-Namen.

Befehl	Parameter	Funktion
em-enabled	event, value (true/false)	Aktiviert oder deaktiviert Nachrichten für ein Event.
em-channel	event, channel	Legt den Textkanal fest, in den ein Event postet.
em-status	—	Zeigt eine ephemere Übersicht aller Events: Aktiv-Status und Zielkanal.

Eine Nachricht für ein Event wird nur gesendet, wenn das Event aktiviert ist und ein Kanal zugewiesen wurde. Alle Befehlsantworten sind ephemeral.

Konfiguration — Einstellungen & Vorlagen pro Event

EventMessages speichert seine Konfiguration pro Guild (Red Config, Identifier 981273598123). Jedes der sieben Events hat ein enabled-Flag und eine channel-ID; eine parallele templates-Zuordnung hält den Nachrichtentext pro Event.

Vorlagenvariablen

Variable	Bedeutung	Befüllt für
{display_name}	Anzeigename des Mitglieds	alle Events
{username}	Vollständiger Username (name#tag)	alle Events
{moderator}	Handelnder Moderator (Erwähnung)	kick, ban, unban, timeout
{reason}	Grund aus dem Audit-Log	kick, ban, timeout
{duration}	Timeout-Endzeit (relativer Zeitstempel)	timeout

Variablen, die auf ein Event nicht zutreffen, fallen auf sichere Standardwerte zurück (z. B. {reason} → „Kein Grund angegeben", {moderator} → „Unbekannt"). Eine ungültige Vorlage wird unverändert gepostet, statt einen Fehler auszulösen.

Standardvorlagen (Deutsch)

Event	Standardvorlage
join	🎉 **{display_name}** ist dem Server beigetreten!
leave	👋 **{display_name}** ({username}) hat den Server verlassen.
kick	👢 **{display_name}** ({username}) wurde gekickt. Moderator: {moderator} | Grund: {reason}
ban	⛔ **{display_name}** ({username}) wurde gebannt. Moderator: {moderator} | Grund: {reason}
unban	🔓 **{display_name}** ({username}) wurde entbannt. Moderator: {moderator}
timeout	⛔ **{display_name}** ({username}) erhielt Timeout. Moderator: {moderator} | Grund: {reason} | Bis: {duration}
timeout_end	⏱️ Timeout für **{display_name}** ({username}) ist abgelaufen.

Dashboard-Integration

EventMessages registriert sich beim Laden automatisch beim PDC Web Dashboard (und hängt sich nach, falls das Dashboard-Cog erst später erscheint). Drei Oberflächen werden bereitgestellt:

Oberfläche	Mount	Berechtigung	Zweck
Widget „Aktive Events"	Dashboard-Startseite (KPI, klein)	guild_member	Zählt, wie viele Events aktuell aktiviert sind.
Panel „Event-Nachrichten"	guild_settings	guild_admin	Pro Event: Aktiv-Schalter, Kanal-Dropdown und Nachrichten-Textfeld mit Variablen-Hinweisen.
Eigenständige Seite eventmessages	eigene Seite (GET/POST)	manage_guild / Bot-Owner	Vollseiten-Editor für Aktiv-Flag, Kanal-ID und Vorlage jedes Events.

Berechtigungen & Hinweise

Die Konfigurationsbefehle erfordern wie bei Red üblich Server-Verwaltungsrechte; die Dashboard-Oberflächen benötigen guild_admin / manage_guild (oder Bot-Owner). Damit der Bot Moderatoren und Gründe korrekt zuordnen kann, benötigt er Audit-Log ansehen sowie Nachrichten senden in jedem konfigurierten Kanal. Der Cog speichert ausschließlich Guild-Einstellungen — Aktiv-Flags, Kanal-IDs und Vorlagen — und keine personenbezogenen Daten.

Siehe auch: Installation · Dashboard-Integration · AdminUtils · Start