Problemy

Bot nie połączył się w ogóle. Sprawdź po kolei:

1. Token. Najczęstsza przyczyna. Sprawdź, czy w config.yml nie została wartość YOUR_TOKEN_HERE, czy nie ma spacji na początku lub końcu i czy token jest w cudzysłowie.
2. Token został zresetowany. Jeśli kiedykolwiek klikałeś Reset Token w Developer Portalu, stary przestał działać. Wygeneruj nowy i wklej go.
3. Serwer nie ma dostępu do internetu. Rzadkie, ale zdarza się na maszynach za restrykcyjnym firewallem. Bot łączy się wychodząco po HTTPS z discord.com.
4. Java starsza niż 21. Sprawdź java -version. Na starszej Javie plugin może się w ogóle nie wczytać — zajrzyj do konsoli.

Po każdej poprawce: /grzybciowhitelist reload.

To niemal zawsze jedna z dwóch rzeczy.

Message Content Intent jest wyłączony. Bez niego bot widzi, że ktoś napisał, ale nie widzi treści. Wejdź na Developer Portal → twoja aplikacja → Bot → Privileged Gateway Intents → włącz MESSAGE CONTENT INTENT → Save Changes. Potem /grzybciowhitelist reload.

Złe ID kanału. Bot nasłuchuje dokładnie jednego kanału. Sprawdź, czy channel-id w config.yml to ID tego kanału, na którym piszecie, i czy jest w cudzysłowie.

Sprawdź też, czy bot ma na tym kanale uprawnienia:

Bot działa prawidłowo — po prostu wiadomość nie przeszła walidacji. Nick musi:

• mieć maksymalnie 16 znaków,
• składać się wyłącznie ze znaków a-z, A-Z, 0-9 i _.

Najczęstsze przyczyny u graczy:

Dopisz do tematu kanału, żeby wysyłali sam nick. To rozwiązuje większość zgłoszeń.

Whitelista to nie jedyna rzecz, która blokuje wejście. Sprawdź po kolei:

1. Czy whitelista jest w ogóle włączona? /whitelist list pokaże listę, ale jeśli white-list=false, lista nie jest egzekwowana — problem leży gdzie indziej.
2. Ban. /banlist — ban działa niezależnie od whitelisty i ma pierwszeństwo.
3. Ban IP. /banlist ips.
4. Literówka w nicku. /whitelist list i porównaj znak po znaku. Grzybcio i Grzybcl0 wyglądają podobnie.
5. Serwer pełny. Gracze spoza listy operatorów nie wejdą ponad max-players.
6. Whitelista wczytana ze starego pliku. Po ręcznej edycji whitelist.json zrób /whitelist reload.

Poszukaj w logs/latest.log linii z GrzybcioWhitelist.

Plugin nie weryfikuje tożsamości — dopisuje każdy poprawny nick. Jeśli to problem w twojej społeczności:

1. Usuń wpis: /whitelist remove Nick.
2. Ogranicz dostęp do kanału do zaufanych ról.
3. Rozważ włączenie trybu powolnego i logowanie wiadomości przez bota moderacyjnego.

Jeśli potrzebujesz prawdziwej weryfikacji (kod w grze, potwierdzenie konta), ten plugin tego nie zrobi — potrzebujesz rozwiązania z parowaniem kont.

Bot ma dostęp do kanału i czyta wiadomości, ale nie może odpowiadać. Sprawdź uprawnienia Send Messages oraz Read Message History — do odpowiadania na konkretną wiadomość potrzebne są oba.

Sprawdź też, czy kanał nie jest zablokowany dla roli bota na poziomie uprawnień kanału (nadpisania uprawnień mają pierwszeństwo nad rolą).