Zum Hauptinhalt springen

Welcome & Goodbye

Das Welcome-Modul verwaltet Willkommens- und Abschiedsnachrichten — sie werden automatisch gesendet, wenn jemand dem Server beitritt oder ihn verlässt. Es unterstützt sowohl Textnachrichten als auch Embeds mit vollständiger Personalisierung.

Modul aktivieren

  1. Dashboard → Ihr Server → Toggle Welcome
  2. Klicken Sie auf Edit, um Nachrichten zu konfigurieren
  3. Konfigurieren Sie separat den Abschnitt Welcome (Beitritt) und Goodbye (Verlassen)
  4. Speichern Sie die Änderungen

Konfiguration

Die Konfiguration des Welcome-Moduls besteht aus zwei unabhängigen Abschnitten:

Abschnitt welcome (Beitritt zum Server)

OptionTypBeschreibung
enabledbooleanOb die Willkommensnachricht aktiv ist
channel_idstringID des Kanals, in den die Nachricht gesendet wird
type"message" / "embed"Nachrichtentyp
messagestringTextnachrichteninhalt (wenn type = message)
embedobjectEmbed-Konfiguration (wenn type = embed)
ping_everyonebooleanOb @everyone gepingt werden soll
send_dmbooleanOb eine private Nachricht an das neue Mitglied gesendet werden soll

Abschnitt goodbye (Verlassen des Servers)

OptionTypBeschreibung
enabledbooleanOb die Abschiedsnachricht aktiv ist
channel_idstringID des Zielkanals
type"message" / "embed"Nachrichtentyp
messagestringTextnachrichteninhalt
embedobjectEmbed-Konfiguration
ping_everyonebooleanOb @everyone gepingt werden soll

Platzhalter

In Nachrichten- und Embed-Inhalten können Sie Variablen verwenden:

PlatzhalterWird ersetzt durch
{user}Erwähnung des Benutzers (z.B. @Jan)
{username}Anzeigename des Benutzers
{server}Servername
{membercount}Aktuelle Mitgliederzahl des Servers

Beispiel:

Willkommen {user} auf dem Server {server}! Du bist unser {membercount}. Mitglied!

Embed-Konfiguration

Wenn der Nachrichtentyp embed ist, stehen folgende Felder zur Verfügung:

FeldBeschreibung
titleEmbed-Titel
descriptionHauptinhalt
colorHex-Farbe (z.B. #22C55E)
thumbnailURL des Miniaturbilds
imageURL des Hauptbilds
author_nameAutorenname
author_iconURL des Autoren-Icons
footerFußzeilentext
fieldsListe der Felder (name, value, inline)

Alle Textfelder unterstützen Platzhalter.

Dashboard — Konfiguration

Das Bearbeitungspanel von Welcome im Dashboard enthält:

Abschnitt Welcome

  • Schalter Enabled
  • Kanalauswahl (Dropdown mit Textkanälen)
  • Typauswahl: Message / Embed
  • Embed-Editor (visueller Inline-Builder) — wenn Typ Embed ausgewählt
  • Checkbox Ping @everyone
  • Checkbox Send as DM — wenn aktiviert, erscheint ein zusätzliches Textfeld für die DM-Nachricht

Abschnitt Goodbye

  • Analoge Konfiguration wie Welcome
  • Keine Option Send as DM

UnsavedBar

Das Panel verwendet die UnsavedBar — Änderungen werden nicht automatisch gespeichert. Klicken Sie auf Save zum Speichern oder Cancel zum Rückgängigmachen.

DM-Versand

Wenn die Option send_dm aktiviert ist:

  • Nach dem Beitritt zum Server sendet der Bot dem neuen Mitglied dieselbe Nachricht (Text oder Embed) wie an den Kanal
  • Wenn der Benutzer DMs deaktiviert oder den Bot blockiert hat, wird die Nachricht stillschweigend übersprungen (ohne Fehlerprotokollierung)
tipp

DM ist besonders nützlich zum Versenden der Serverregeln oder Anweisungen für neue Mitglieder.

Überwachte Ereignisse

EreignisAktion
on_member_joinSendet Willkommensnachricht + optionale DM + Log
on_member_removeSendet Abschiedsnachricht + Log
info

Das Modul hat keine Slash-Befehle — es arbeitet ausschließlich über Events.

Protokollierung

Aktionen des Welcome-Moduls werden durch Logs unter der Kategorie welcome protokolliert:

  • Member Joined — wenn jemand dem Server beitritt
  • Member Left — wenn jemand den Server verlässt

Tipps

Best Practices
  • Verwenden Sie den Typ Embed für professionell aussehende Nachrichten mit Bildern und Farben
  • Der Platzhalter {membercount} eignet sich hervorragend zum Aufbau eines Gemeinschaftsgefühls
  • Richten Sie einen separaten Kanal für Willkommensnachrichten ein (z.B. #welcome), um den Hauptchat nicht zu überfüllen
  • Aktivieren Sie DM mit Serverregeln, damit neue Mitglieder sofort die geltenden Regeln kennen
warnung

Der Bot muss die Berechtigung Send Messages und Embed Links im ausgewählten Kanal haben. Wenn die Berechtigungen nach der Konfiguration entzogen werden, werden keine Nachrichten gesendet (aber es wird als Warning protokolliert).