Welcome & Goodbye

Moduł Welcome obsługuje wiadomości powitalne i pożegnalne — wysyłane automatycznie gdy ktoś dołącza do serwera lub go opuszcza. Obsługuje zarówno wiadomości tekstowe, jak i embedy z pełną personalizacją.

Włączanie modułu

1. Dashboard → Twój serwer → toggle Welcome
2. Kliknij Edit aby skonfigurować wiadomości
3. Skonfiguruj osobno sekcję Welcome (dołączenie) i Goodbye (opuszczenie)
4. Zapisz zmiany

Konfiguracja

Konfiguracja modułu Welcome składa się z dwóch niezależnych sekcji:

Sekcja welcome (dołączenie do serwera)

Opcja	Typ	Opis
enabled	boolean	Czy wiadomość powitalna jest aktywna
channel_id	string	ID kanału, na który wysyłana jest wiadomość
type	"message" / "embed"	Typ wiadomości
message	string	Treść wiadomości tekstowej (gdy type = message)
embed	object	Konfiguracja embeda (gdy type = embed)
ping_everyone	boolean	Czy pingować @everyone
send_dm	boolean	Czy wysłać wiadomość prywatną do nowego członka

Sekcja goodbye (opuszczenie serwera)

Opcja	Typ	Opis
enabled	boolean	Czy wiadomość pożegnalna jest aktywna
channel_id	string	ID kanału docelowego
type	"message" / "embed"	Typ wiadomości
message	string	Treść wiadomości tekstowej
embed	object	Konfiguracja embeda
ping_everyone	boolean	Czy pingować @everyone

Placeholders

W treściach wiadomości i embedów możesz używać zmiennych:

Placeholder	Zastępowany przez
{user}	Mention użytkownika (np. @Jan)
{username}	Nazwa wyświetlana użytkownika
{server}	Nazwa serwera
{membercount}	Aktualna liczba członków serwera

Przykład:

Witaj {user} na serwerze {server}! Jesteś naszym {membercount}. członkiem!

Konfiguracja embeda

Gdy typ wiadomości to embed, dostępne są pola:

Pole	Opis
title	Tytuł embeda
description	Treść główna
color	Kolor hex (np. #22C55E)
thumbnail	URL miniaturki
image	URL głównego obrazka
author_name	Nazwa autora
author_icon	URL ikony autora
footer	Tekst stopki
fields	Lista pól (name, value, inline)

Wszystkie pola tekstowe obsługują placeholders.

Dashboard — konfiguracja

Panel edycji Welcome w dashboardzie zawiera:

Sekcja Welcome

• Przełącznik Enabled
• Wybór kanału (dropdown z kanałami tekstowymi)
• Wybór typu: Message / Embed
• Edytor embeda (visual inline builder) — gdy wybrany typ Embed
• Checkbox Ping @everyone
• Checkbox Send as DM — gdy zaznaczony, pojawia się dodatkowe pole tekstowe na wiadomość DM

Sekcja Goodbye

• Analogiczna konfiguracja jak Welcome
• Brak opcji Send as DM

UnsavedBar

Panel używa paska UnsavedBar — zmiany nie są zapisywane automatycznie. Kliknij Save aby zapisać lub Cancel aby cofnąć.

Wysyłanie DM

Gdy opcja send_dm jest włączona:

• Po dołączeniu do serwera, bot wysyła nowego członka tą samą wiadomość (tekst lub embed) co na kanał
• Jeśli użytkownik ma wyłączone DM lub zablokował bota, wiadomość jest po cichu pomijana (bez logowania błędu)

wskazówka

DM jest szczególnie przydatny do wysyłania regulaminu serwera lub instrukcji dla nowych członków.

Nasłuchiwane zdarzenia

Zdarzenie	Akcja
on_member_join	Wysyła wiadomość powitalną + opcjonalny DM + log
on_member_remove	Wysyła wiadomość pożegnalną + log

informacja

Moduł nie posiada żadnych komend slash — działa wyłącznie na zdarzeniach.

Logowanie

Akcje modułu Welcome są logowane przez Logs pod kategorią welcome:

• Member Joined — gdy ktoś dołączy do serwera
• Member Left — gdy ktoś opuści serwer

Wskazówki

Best practices

• Użyj typu Embed dla profesjonalnie wyglądających wiadomości z obrazkami i kolorami
• Placeholder {membercount} jest świetny do budowania poczucia społeczności
• Ustaw osobny kanał na wiadomości powitalne (np. #welcome) aby nie zaśmiecać głównego czatu
• Włącz DM z regulaminem serwera, aby nowi członkowie od razu wiedzieli jakie zasady obowiązują

ostrzeżenie

Bot musi mieć uprawnienie Send Messages i Embed Links na wybranym kanale. Jeśli uprawnienia zostaną odebrane po konfiguracji, wiadomości nie będą wysyłane (ale zostanie to zalogowane jako warning).