Konfiguracja
Token, kanał i trzy wiadomości bota — opis wszystkich opcji z config.yml.
Plik konfiguracyjny jest krótki — cztery rzeczy do ustawienia. Leży w
plugins/GrzybcioWhitelist/config.yml.
Pełny domyślny plik
# GrzybcioWhitelist Configuration
# Wspierane serwery: Paper/Spigot 1.21.x - 26.1.x (Java 21+)
# Discord Bot Token
discord-token: "YOUR_TOKEN_HERE"
# Channel ID where the bot listens for nicknames
channel-id: "000000000000000000"
messages:
success: "Dodano gracza {player} do whitelisty!"
already-whitelisted: "Gracz {player} jest już na whiteliście."
error: "Wystąpił błąd podczas dodawania gracza {player}."Opcje
discord-token
Token bota z Discord Developer Portal. Bez niego plugin nie połączy się z Discordem.
discord-token: "MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.GxXxXx.przykładowy-token"Nie udostępniaj tego pliku
config.yml z wpisanym tokenem to plik, którym nie dzielisz się z nikim. Jeśli wysyłasz
komuś konfigurację do pomocy, zamień token na USUNIETO. Gdy token wycieknie,
zresetuj go w Developer Portalu — stary od razu przestanie działać.
channel-id
ID kanału, którego bot nasłuchuje. Bot ignoruje wiadomości ze wszystkich innych kanałów.
channel-id: "1234567890123456789"Zostaw cudzysłowy
ID kanału to 18–19 cyfr. Bez cudzysłowów YAML potraktuje je jako liczbę, a przy tej długości może stracić precyzję i bot będzie nasłuchiwał nieistniejącego kanału. Zawsze w cudzysłowie.
Wiadomości
Sekcja messages zawiera trzy teksty, którymi bot odpowiada na Discordzie.
| Klucz | Kiedy | Zmienne |
|---|---|---|
success | Gracz został dopisany do whitelisty | {player} |
already-whitelisted | Gracz już był na whiteliście | {player} |
error | Dopisanie się nie powiodło | {player} |
{player} zostaje zastąpione nickiem, który gracz wpisał.
messages:
success: "Gotowe, {player} — możesz wchodzić na serwer!"
already-whitelisted: "{player} już jest na liście, po prostu wejdź."
error: "Coś poszło nie tak przy {player}. Napisz do administracji."Wiadomość o błędnym nicku
Tekst o niepoprawnym formacie nicku jest wbudowany w plugin i nie da się go zmienić w konfiguracji:
To nie wygląda na poprawny nick z Minecrafta (a-z, 0-9, _, max 16 znaków).Pokazuje się, gdy wiadomość ma więcej niż 16 znaków albo zawiera coś poza a-z, A-Z,
0-9 i _.
Dlaczego to ma znaczenie
Gracz, który napisze na kanale „cześć, czy mogę dostać dostęp?", dostanie właśnie tę odpowiedź — bo to nie jest poprawny nick. Warto opisać to w temacie kanału, żeby ludzie wiedzieli, że mają wysłać sam nick.
Przeładowanie
/grzybciowhitelist reloadPrzeładowuje config.yml i połączenie z Discordem. Użyj tego po każdej zmianie
tokenu albo ID kanału — restart serwera nie jest potrzebny.
| Uprawnienie | Domyślnie |
|---|---|
grzybciowhitelist.reload | operatorzy |
Przykładowa konfiguracja produkcyjna
discord-token: "MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.przykład.token"
channel-id: "1234567890123456789"
messages:
success: "✅ {player} dodany do whitelisty. Serwer: mc.twojadomena.pl"
already-whitelisted: "ℹ️ {player} jest już na whiteliście — wchodź śmiało."
error: "❌ Nie udało się dodać {player}. Zgłoś to na #pomoc."Emoji działają bez problemu — Discord renderuje je normalnie.