ChannelJoinNotification DE

ChannelJoinNotification

🌐 English · Deutsch

ChannelJoinNotification schickt einem Mitglied in dem Moment, in dem es einem konfigurierten Sprachkanal beitritt, eine Direktnachricht mit anpassbarem Text. Jeder Sprachkanal hat einen eigenen Ein/Aus-Schalter und eine eigene DM-Vorlage — so begrüßt du Leute in einer Lobby, briefst sie beim Betreten eines Support-Raums oder sprichst sie in einem privaten Kanal an, ganz ohne öffentliche Nachricht. Die Konfiguration ist auf drei Wegen möglich: ein ephemerer Slash-Setup-Assistent in Discord, Dashboard-Panels und eine eigene Guild-Dashboard-Seite. Autor: pd-codes · Version 1.0.0 · benötigt Red 3.5.0+.

Installation

[p]repo add PDC_Redbot_Cogs https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC_Redbot_Cogs channeljoinnotification
[p]load channeljoinnotification
[p]slash sync

[p] ist das Prefix deines Bots. Die Setup-Oberfläche ist ein Slash-Befehl, führe daher nach dem Laden einmal [p]slash sync aus. Die vollständige Downloader-Anleitung findest du unter Installation.

Befehl

Befehl	Typ	Funktion
/join-notification	Slash, nur Server	Öffnet einen ephemeren Setup-Assistenten (nur du siehst ihn).

Es gibt keinen Prefix-Befehl — /join-notification ist der einzige Einstiegspunkt in Discord.

Ephemerer Setup-Assistent

Der Assistent hält alles in einer einzigen ephemeren Nachricht, die sich Schritt für Schritt selbst aktualisiert:

1. Sprachkanal auswählen über die Kanal-Auswahl (auf Sprachkanäle beschränkt).
2. Die Nachricht zeigt den aktuellen Status des Kanals (aktiv/deaktiviert) und eine Vorschau des DM-Texts.
3. Aktivieren öffnet ein Modal zum Eingeben oder Ändern des DM-Texts und aktiviert den Kanal anschließend.
4. Deaktivieren schaltet die Benachrichtigungen für diesen Kanal ab, ohne den Text zu löschen.

Der Assistent läuft nach 10 Minuten ab und reagiert nur auf den Nutzer, der ihn geöffnet hat.

DM-Text & Variablen

Der DM-Text unterstützt zwei Platzhalter, die beim Versand ersetzt werden:

Variable	Wird ersetzt durch
<Username>	Den Anzeigenamen des Mitglieds
<Channelname>	Den Namen des Sprachkanals

Beispielvorlage: Hi <Username>! Du bist in <Channelname> gejoint ...

Nur Sprachkanäle. Der Listener des Cogs reagiert ausschließlich auf Joins in discord.VoiceChannel und ignoriert Bots sowie Kanalwechsel, deren Ziel nicht überwacht wird. Hat ein Mitglied DMs deaktiviert, schlägt der Bot still fehl — keine Fehlermeldung und keine öffentliche Nachricht. (Auch wenn das Cog als „Voice-/Stage“-Kanäle beschrieben wird, filtert der aktuelle Quellcode strikt auf Sprachkanäle.)

Konfiguration

ChannelJoinNotification speichert alles pro Server (Red Config, Identifier 771194222451) in einer einzigen notifications-Zuordnung mit der Kanal-ID als Schlüssel:

notifications = {
  "<channel_id>": { "enabled": true, "text": "Hi <Username>! ..." }
}

Schlüssel	Typ	Bedeutung
enabled	bool	Ob beim Join in diesen Kanal eine DM gesendet wird.
text	string	Die DM-Vorlage (max. ~1500–1900 Zeichen je nach Eingabeweg).

Eine DM wird nur gesendet, wenn der betretene Kanal einen Eintrag hat, der enabled ist und nicht leeren text besitzt.

Dashboard-Integration

ChannelJoinNotification registriert sich beim Laden am PDC Web Dashboard und hängt sich erneut ein, falls das Dashboard-Cog später erscheint. Es stellt ein Widget, ein Panel, eine verwaltete Liste und zwei Dashboard-Seiten bereit:

Oberfläche	Mount	Berechtigung	Zweck
Widget „Join-Notify Channels“	Dashboard-Startseite (KPI, klein)	guild_member	Zählt, für wie viele Kanäle Benachrichtigungen aktiviert sind.
Panel „Join-Benachrichtigungen“	guild_settings	guild_admin	Je Sprachkanal: ein Aktivieren-Schalter und ein DM-Text-Feld mit Variablen-Hinweisen.
Liste „Konfigurierte Benachrichtigungen“	guild_settings	guild_admin	Tabelle der konfigurierten Kanäle (Kanal, aktiv, Text-Vorschau) mit Inline-Bearbeiten und -Löschen.
Seite (Start)	Dashboard-Startseite	—	Eine kleine Info-Karte, die anzeigt, dass die Integration aktiv ist.
Eigenständige Seite channeljoinnotification	eigene Seite (GET/POST)	manage_guild / Admin / Bot-Owner	Voll-Editor: Eintrag hinzufügen/aktualisieren (Kanal + Aktivierung + Text), Eintrag entfernen und eine Live-Tabelle aller Einträge.

Die eigenständige Seite füllt das Formular automatisch mit den vorhandenen Einstellungen eines Kanals, sobald du ihn auswählst, und bietet ein separates Formular zum Entfernen von Einträgen, um nicht mehr benötigte Kanäle aufzuräumen.

Berechtigungen & Hinweise

Der Bot muss lediglich in der Lage sein, dem Nutzer eine DM zu senden — es sind keine besonderen Server-Berechtigungen nötig (in info.json ist keine deklariert). Der Slash-Setup-Assistent ist für jedes Mitglied nutzbar, das ihn ausführen darf, bearbeitet aber nur die Konfiguration der ausgewählten Kanäle; die Dashboard-Panels erfordern guild_admin, die eigenständige Seite erfordert manage_guild (oder Admin / Bot-Owner). Es werden nur server-bezogene Einstellungen gespeichert — Kanal-IDs, Aktivierungs-Status und Nachrichten-Vorlagen — keine personenbezogenen Daten.

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