Instalacja

Wgranie pluginu, włączenie whitelisty na serwerze i połączenie z botem Discord.

Najpierw bot

Zanim tu wejdziesz, potrzebujesz tokenu bota i ID kanału. Jeśli ich nie masz, zacznij od Bota na Discordzie.

Wymagania

Wymaganie	Jak sprawdzić
Paper lub Spigot, 1.21.x – 26.1.2	`version` w konsoli serwera
Java 21+	`java -version` na maszynie z serwerem
Token bota	Discord Developer Portal → Bot
ID kanału	Prawy przycisk na kanale → Kopiuj ID kanału

Krok po kroku

Włącz whitelistę na serwerze

To jest krok, bez którego cała reszta nie ma sensu — plugin dopisuje graczy do whitelisty, ale whitelista musi być włączona, żeby cokolwiek egzekwowała.

W pliku server.properties:

server.properties

white-list=true

Albo z konsoli:

/whitelist on

Po włączeniu whitelisty wszyscy gracze spoza niej zostaną odrzuceni — łącznie z tobą, jeśli nie jesteś na liście. Dopisz się najpierw: /whitelist add TwojNick.

Wgraj plugin

Wrzuć plik JAR do katalogu plugins/:

GrzybcioWhitelist-1.0.jar

server.properties

Uruchom serwer raz

Przy pierwszym starcie plugin utworzy katalog plugins/GrzybcioWhitelist/ z domyślnym config.yml. Bot jeszcze się nie połączy — token jest pusty.

Wpisz token i ID kanału

Otwórz plugins/GrzybcioWhitelist/config.yml i uzupełnij dwie linie:

plugins/GrzybcioWhitelist/config.yml

discord-token: "TU_TOKEN_Z_DEVELOPER_PORTAL"
channel-id: "1234567890123456789"

Przeładuj

/grzybciowhitelist reload

Komenda przeładowuje konfigurację i połączenie z Discordem — nie musisz restartować serwera.

W konsoli powinna pojawić się informacja o połączeniu bota. Na Discordzie bot zmieni status na online.

Przetestuj

Wejdź na kanał i wpisz swój nick. Bot powinien odpowiedzieć jedną z wiadomości z konfiguracji. Sprawdź w konsoli:

/whitelist list

Twój nick powinien być na liście.

Struktura plików po instalacji

GrzybcioWhitelist-1.0.jar

config.yml

Budowanie ze źródeł

Projekt używa Mavena.

git clone https://github.com/Grzybcio-plugins/GrzybcioWhitelist.git
cd GrzybcioWhitelist
mvn clean package

Gotowy plik pojawi się w target/. Bierz ten bez przedrostka original- — tamten nie zawiera wbudowanych zależności i nie uruchomi się.

Wyłączanie pluginu

Przy wyłączaniu serwera plugin rozłącza bota w kontrolowany sposób, więc nie zostawia wiszącego połączenia. Nie trzeba niczego robić ręcznie.

Jeśli chcesz tymczasowo wyłączyć samo whitelistowanie, a zostawić plugin, najprościej odebrać botowi dostęp do kanału po stronie Discorda.

Na tej stronie