Moderacja

Moduł moderacji zapewnia kompletny zestaw narzędzi do zarządzania użytkownikami: banowanie, wyrzucanie, wyciszanie, ostrzeżenia, czyszczenie wiadomości, zmiana pseudonimów i zarządzanie rolami.

Włączanie modułu

1. Dashboard → Twój serwer → toggle Moderation
2. Kliknij Edit i dodaj role moderacyjne
3. Zapisz zmiany

Ważne

Bez skonfigurowania moderation_roles żadna komenda moderacyjna nie będzie działać — dotyczy to wszystkich użytkowników, włącznie z administratorami Discord. Przynajmniej jedna rola musi być dodana do listy, a użytkownik musi posiadać jedną z tych ról, aby komendy działały.

Konfiguracja

Opcja	Typ	Domyślnie	Opis
moderation_roles	lista ID ról	[]	Role mające dostęp do komend moderacyjnych
warning_threshold	liczba (1–10)	3	Próg ostrzeżeń — po osiągnięciu wysyła powiadomienie do logów
dm_on_action	boolean	true	Czy wysyłać DM do użytkownika o akcji moderacyjnej
auto_delete_warnings_days	liczba	0	Auto-usuwanie starych ostrzeżeń (0 = wyłączone)

Konfiguracja w dashboardzie

Panel edycji modułu Moderation zawiera:

• Moderation Roles — multi-select z rolami serwera
• Warning Threshold — suwak 1–10
• DM on Action — checkbox
• Auto-delete Warnings — pole liczbowe (dni, 0 = off)

Komendy

/ban

Banuje użytkownika z serwera.

Parametr	Wymagany	Opis
target	✅	Użytkownik do zbanowania
reason	❌	Powód (max 512 znaków)

/kick

Wyrzuca użytkownika z serwera.

Parametr	Wymagany	Opis
target	✅	Użytkownik do wyrzucenia
reason	❌	Powód (max 512 znaków)

/mute

Wycisza użytkownika (Discord timeout).

Parametr	Wymagany	Opis
target	✅	Użytkownik do wyciszenia
duration	❌	Czas w minutach (1–40320, domyślnie 10)
reason	❌	Powód (max 512 znaków)

informacja

40320 minut = 28 dni (maksymalny limit Discord timeout).

/unmute

Zdejmuje wyciszenie (timeout) z użytkownika.

Parametr	Wymagany	Opis
target	✅	Użytkownik do odmutowania
reason	❌	Powód (max 512 znaków)

/warn

Nadaje ostrzeżenie użytkownikowi (zapisywane w bazie danych).

Parametr	Wymagany	Opis
target	✅	Użytkownik do ostrzeżenia
reason	❌	Powód (max 512 znaków)

Po nadaniu ostrzeżenia:

• Ostrzeżenie jest zapisywane w tabeli warnings
• Użytkownik otrzymuje DM (jeśli dm_on_action jest włączone)
• Bot sprawdza, czy osiągnięto warning_threshold
• Jeśli tak — wysyła powiadomienie do kanału logów moderacji

/warnings

Wyświetla historię ostrzeżeń użytkownika (ostatnie 10).

Parametr	Wymagany	Opis
target	✅	Użytkownik do sprawdzenia

/clear

Usuwa wiadomości z bieżącego kanału.

Parametr	Wymagany	Opis
amount	✅	Liczba wiadomości (1–100)

/setnick

Zmienia pseudonim użytkownika.

Parametr	Wymagany	Opis
target	✅	Użytkownik
nickname	❌	Nowy pseudonim (puste = reset do nazwy użytkownika)

informacja

Discord ogranicza pseudonimy do 1–32 znaków.

/role add

Nadaje rolę użytkownikowi.

Parametr	Wymagany	Opis
target	✅	Użytkownik
role	✅	Rola do nadania

/role remove

Odbiera rolę użytkownikowi.

Parametr	Wymagany	Opis
target	✅	Użytkownik
role	✅	Rola do odebrania

Hierarchia ról

Wszystkie komendy respektują hierarchię ról Discord:

• Moderator nie może wykonać akcji na użytkowniku z wyższą rolą
• Bot nie może zarządzać rolami wyższymi od swojej

Jeśli hierarchia nie pozwala na akcję, bot zwraca błąd "hierarchy_error".

DM do użytkownika

Gdy dm_on_action jest włączone, bot wysyła embed do użytkownika przed wykonaniem akcji:

• Informacja o typie akcji (banned from / kicked from / muted in / warned in)
• Nazwa serwera
• Czas trwania (dla mute)
• Powód (jeśli podany)

wskazówka

DM jest wysyłany "best effort" — jeśli użytkownik ma wyłączone DM lub zablokował bota, akcja nadal się wykona.

Auto-usuwanie ostrzeżeń

Jeśli auto_delete_warnings_days > 0, co 6 godzin bot automatycznie usuwa ostrzeżenia starsze niż podana liczba dni. Przydatne do utrzymania aktualnej historii i automatycznego "wygaszania" dawnych ostrzeżeń.

Logowanie

Każda akcja moderacyjna jest logowana przez moduł Logs pod kategorią moderation. Logi zawierają:

• Typ akcji (ban, kick, mute, warn, clear, setnick, role_add, role_remove)
• Target (użytkownik docelowy)
• Moderator (kto wykonał)
• Powód

Wskazówki

Best practices

• Ustaw warning_threshold na 3–5, aby otrzymywać powiadomienia o problematycznych użytkownikach
• Włącz dm_on_action aby użytkownicy wiedzieli, dlaczego zostali ukarani
• Używaj /warnings przed podjęciem poważniejszych akcji (ban/kick)
• Skonfiguruj logi moderacji, aby mieć pełny audit trail