Willkommens- und Abschiedsnachrichten: Banner und Platzhalter

Kage begrüßt neue Mitglieder mit einer Willkommensnachricht und meldet Abschiede mit einer Abschiedsnachricht. Beide bestehen aus einem Text und einem erzeugten Banner mit dem Avatar des Mitglieds. Die Einstellungen sind für beide Module nahezu identisch. Zusätzlich gibt es für Abschiede ein Team-Protokoll mit Details nur für dein Team.

Eine kurze Anleitung findest du in den Ratgebern Willkommensnachricht einrichten, Abschiedsnachricht einrichten und Austritte protokollieren.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff). Die Slash-Befehle /welcome und /leave sind ebenfalls nur mit Server verwalten nutzbar.
• Ein Kanal: Wähle den Kanal für die Nachrichten. Ohne Kanal postet Kage nichts.
• Rechte von Kage im Kanal: Kanal ansehen, Nachrichten senden, Links einbetten und Dateien anhängen. Fehlen sie, versucht Kage, sie selbst zu ergänzen (siehe unten).

So läuft ein Beitritt ab

1. Ein Mitglied tritt bei. Kage verarbeitet den Beitritt in fester Reihenfolge: zuerst Einladungs-Zuordnung, dann Anti-Raid, dann die Willkommensnachricht, danach Auto-Rollen, Verifizierung, Onboarding, Regeln und das Rang-System.
2. Ist die Willkommensnachricht ausgeschaltet oder kein Kanal gewählt, endet der Ablauf hier.
3. Kage sucht den Kanal. Ist er gelöscht oder nicht erreichbar, steht eine Warnung im Betriebslog.
4. Kage prüft seine Rechte im Kanal. Fehlt etwas und hat Kage das Recht Rollen verwalten (oder Administrator), ergänzt er die fehlenden Kanalrechte für seine eigene Rolle selbst. Das erscheint im Reiter Logs als „Fehlende Kanal-Berechtigungen automatisch ergänzt“. Kann er es nicht, steht dort der Fehler mit den fehlenden Rechten, und es wird nichts gepostet.
5. Kage erzeugt das Banner, ersetzt die Platzhalter und postet die Nachricht. Dabei unterscheidet Kage nicht zwischen Menschen und Bots: Auch ein beitretender Bot bekommt eine Begrüßung.
6. Der Post erscheint im Reiter Logs.

Der Aufbau der Nachricht

Es gibt zwei Darstellungen:

• Text und Bild (Standard): Der Titel steht fett über dem Text, das Banner hängt als Bild an derselben Nachricht, ohne Rahmen.
• Embed mit Rahmen: Die Nachricht erscheint als Embed mit farbigem Rand. Schalte dafür „Als Embed mit Rahmen anzeigen“ ein.

Platzhalter

Du kannst in Titel und Text diese Platzhalter verwenden:

Unbekannte Platzhalter, etwa durch einen Tippfehler, bleiben unverändert im Text stehen und führen nicht zu einem Fehler.

Das Banner

• Hintergrund: ein Farbverlauf oder dein eigenes Bild. Das Bild gibst du als Web-Adresse (http oder https) an oder lädst es im Dashboard hoch (PNG, JPEG, WEBP oder GIF, höchstens 8 MB). Am zuverlässigsten ist der Upload. Gibst du im Dashboard eine fremde Adresse an, lädt Kage das Bild beim Speichern einmal herunter und legt es dauerhaft bei sich ab, damit es nicht verschwindet, wenn der Link abläuft (das tun Discord-Anhangs-Links nach einiger Zeit).
• Farben: Textfarbe, Ring um den Avatar und, im Embed-Modus, der Rahmen sind einstellbar.
• Positionen: Im Dashboard ziehst du Avatar und Text in der Banner-Vorschau an die gewünschte Stelle. Die Vorschau ist eine Näherung, Schriftart und Schatten erscheinen erst im gesendeten Banner.
• Namen mit Sonderzeichen stellt Kage mit einer Schrift mit breiter Unicode-Abdeckung dar, zum Beispiel kyrillische oder griechische Zeichen.

Avatar-Aktualisierung

Ändert ein Mitglied innerhalb von 30 Tagen nach dem Beitritt seinen Discord-Avatar, aktualisiert Kage das Banner in der Willkommensnachricht automatisch. Das passiert nur, solange das Modul an ist und der Kanal unverändert blieb. Ältere Nachrichten fasst Kage nicht mehr an.

Die Abschiedsnachricht

Sie funktioniert wie die Willkommensnachricht, mit eigenen Einstellungen: eigener Kanal, Titel, Text, Banner (mit dem Satz „Name hat den Server verlassen.“) und Farben. Es gelten dieselben Platzhalter. Die Standardtexte sind „{user} has left the server. We wish them all the best!“ und „Goodbye, {user}!“.

Das Team-Protokoll

Zusätzlich kann Kage bei jedem Austritt Details in einen Kanal posten, den nur dein Team sieht:

• Servername, Discord-Name, Benutzername und ID
• Beitrittszeit und Austrittszeit
• die Rollen, die das Mitglied beim Verlassen hatte (bis zu 25, danach „… +N“)

Das Team-Protokoll ist unabhängig von der öffentlichen Abschiedsnachricht: eigener Kanal, eigener Schalter („Team-Protokoll aktiv“, „Kanal für das Team-Protokoll“), und es läuft auch, wenn die Abschiedsnachricht ausgeschaltet ist. Es ist an einen Tarif gebunden; der Tarifhinweis oben auf dieser Seite zeigt, welcher. Kage braucht im Team-Kanal die Rechte zum Senden und Einbetten.

Slash-Befehle

/welcome und /leave haben dieselben Unterbefehle. Alle Antworten sehen nur du selbst, außer bei test.

Die Feinplatzierung von Avatar und Text sowie das Team-Protokoll stellst du nur im Dashboard ein.

Einstellungen im Überblick

Ergebnis überprüfen

1. Vorschau: Führe /welcome test aus. Es erscheint die Nachricht mit deinem Avatar.
2. Status: /welcome status zeigt Kanal, Stil, Farben und Texte.
3. Echter Test: Tritt mit einem Zweitkonto bei. Die Nachricht erscheint im Kanal.
4. Protokoll: Der Reiter Logs zeigt Posts, automatisch ergänzte Rechte und Fehler.

Fehlerbehebung

Es erscheint keine Willkommensnachricht

Prüfe, ob die Nachricht aktiv ist und ein Kanal gewählt und gespeichert wurde. Schau im Reiter Logs nach „Mir fehlen im … -Kanal folgende Berechtigungen“. Gib Kage Rollen verwalten, damit er Kanalrechte selbst ergänzen kann, oder vergib im Kanal Nachrichten senden, Links einbetten und Dateien anhängen von Hand. Eine Kanal-Überschreibung wie „@everyone darf nicht schreiben“ kann Kage sonst blockieren.

Das Banner zeigt ein falsches Bild oder keinen Hintergrund

Prüfe die Adresse des Hintergrundbilds. Sie muss öffentlich erreichbar sein und mit http:// oder https:// beginnen. Ohne Bild verwendet Kage den Farbverlauf. Lässt sich das Bild beim Posten nicht laden (abgelaufener Link, Zeitüberschreitung), nutzt Kage die zuletzt erfolgreich geladene Kopie und vermerkt es im Reiter Logs („Hintergrundbild konnte nicht geladen werden“, mit dem Grund). Nur wenn das Bild noch nie geladen werden konnte, erscheint der Farbverlauf. Mit dem Befehl background lädt Kage das Bild sofort und meldet dir, falls das nicht klappt. Dabei speichert Kage nur die Adresse, die Zwischenkopie ist ein Notbehelf und nicht dauerhaft gesichert. Der sicherste Weg ist, das Bild im Dashboard hochzuladen: Dann liegt es dauerhaft bei Kage und hängt von keinem fremden Link ab.

Die Platzhalter erscheinen als Text

Der Platzhalter ist falsch geschrieben. Erlaubt sind nur {member}, {user}, {guild} und {membercount}, genau so, in geschweiften Klammern.

Der Avatar im Banner ist veraltet

Kage aktualisiert die Nachricht nur innerhalb von 30 Tagen und nur, wenn die Nachricht und der Kanal noch unverändert sind. Wurde die Nachricht gelöscht, bleibt sie weg.

Das Team-Protokoll bleibt leer

Prüfe „Team-Protokoll aktiv“ und den Kanal, den Tarif und die Rechte von Kage im Kanal. Ein Fehler steht als „staff_log_error“ im Reiter Logs.

Weiterführend

Rollen beim Beitritt: Auto-Rollen und Verifizierung. Weitere Schritte für neue Mitglieder: Onboarding und Server-Regeln.