Jak zrobić whitelist na serwerze Minecraft (poradnik)

Jeśli prowadzisz serwer tylko dla znajomych, prędzej czy później zadasz sobie pytanie: jak zrobić tak, żeby nie wchodził na niego kto popadnie? Odpowiedzią jest whitelist (po polsku biała lista), czyli lista graczy, którzy mają wstęp na serwer. To najprostszy sposób, żeby zamienić otwarty serwer w prywatną przestrzeń dla ekipy.

W tym poradniku pokażemy Ci, czym dokładnie jest whitelist na serwerze Minecraft, kiedy warto ją włączyć, jak działa pod maską i jak włączyć whitelist komendami oraz w pliku server.properties. Będzie też o haczyku, o którym mało kto mówi: na serwerze non-premium biała lista działa inaczej, niż myślisz.

Czym jest whitelist i kiedy ma sens

Whitelist to mechanizm wbudowany w każdy serwer Minecraft (vanilla, Paper, Spigot, Fabric i inne). Gdy jest wyłączona, na serwer może wejść każdy, kto zna adres. Gdy ją włączysz, serwer wpuści tylko graczy, których wcześniej dodasz do listy. Reszta dostanie komunikat, że nie znajduje się na białej liście, i połączenie zostanie odrzucone.

Biała lista sprawdza się w dwóch typowych sytuacjach.

Serwer prywatny ze znajomymi

To najczęstszy przypadek i główny powód, dla którego ludzie w ogóle sięgają po whitelist. Stawiasz serwer dla paczki znajomych, dodajesz ich nicki i macie spokój, bo nikt z zewnątrz nie wejdzie i nie zepsuje wam rozgrywki. Jeśli dopiero planujesz taki serwer, zajrzyj do poradnika jak stworzyć serwer Minecraft dla znajomych.

Serwer półpubliczny z naborem

Drugi scenariusz to serwer, na który chcesz wpuszczać ludzi, ale nie od razu i nie każdego. Whitelist jest wtedy włączona na stałe, a dostęp dajesz po krótkim naborze, na przykład po wypełnieniu formularza albo napisaniu na Discordzie. To skutecznie odsiewa przypadkowych graczy i grieferów, bo nikt, kto chce po prostu narobić bałaganu, nie będzie się bawił w rekrutację.

Jak działa whitelist: UUID kontra nick

Tu dochodzimy do rzeczy, którą warto zrozumieć, zanim zaczniesz komukolwiek obiecywać, że whitelist to żelazne zabezpieczenie.

Na serwerze premium (czyli z online-mode=true, gdzie gracze logują się przez konto Mojang/Microsoft) każdy gracz ma unikalny, potwierdzony identyfikator UUID. Whitelist zapisuje w pliku whitelist.json zarówno nick, jak i UUID, a serwer porównuje właśnie UUID. Dzięki temu, nawet jeśli ktoś zmieni nick, dalej jest rozpoznawany, a podszywanie się pod cudze konto nie wchodzi w grę.

Haczyk na serwerach non-premium

Na serwerze non-premium (online-mode=false, tzw. cracked) sprawa wygląda inaczej. Serwer nie potrafi zweryfikować tożsamości gracza w Mojangu, więc whitelist praktycznie sprawdza tylko nick. W efekcie każdy, kto ustawi sobie w launcherze nick z Twojej białej listy, wejdzie na serwer jak gdyby nigdy nic. To nie jest błąd whitelist, tylko naturalna konsekwencja tego, jak działa tryb offline.

Jeśli prowadzisz serwer non-premium i zależy Ci na tym, żeby whitelist faktycznie coś dawała, dołóż plugin autoryzacyjny, na przykład AuthMe. Wymusza on logowanie hasłem i pilnuje, żeby dany nick należał do jednej osoby. Do tego możesz dodać FastLogin, który automatycznie loguje graczy premium, żeby nie musieli za każdym razem wpisywać hasła. Krok po kroku opisuje to poradnik o konfiguracji FastLogin.

Jak włączyć whitelist na serwerze Minecraft

Whitelist włączysz na dwa sposoby: komendą z gry lub konsoli albo wpisem w pliku server.properties. Efekt jest ten sam, więc wybierz to, co wygodniejsze.

Sposób 1: komendy /whitelist

Jeśli masz dostęp do gry jako operator (OP) albo do konsoli serwera w panelu, wystarczą Ci te komendy. Uwaga na składnię: w czacie gry wpisujesz je z ukośnikiem (tak jak niżej), a w konsoli w panelu bez ukośnika, np. whitelist add Nick zamiast /whitelist add Nick:

• Włącz białą listę: /whitelist on
• Wyłącz białą listę: /whitelist off
• Dodaj gracza: /whitelist add Nick
• Usuń gracza: /whitelist remove Nick
• Wyświetl listę: /whitelist list
• Przeładuj po ręcznej edycji pliku: /whitelist reload

Gracza możesz dodać, nawet jeśli akurat nie jest online, więc spokojnie przygotujesz listę jeszcze przed startem serwera. Dobra wiadomość: operatorzy są wpuszczani automatycznie i nie musisz dopisywać ich do whitelist. Jeśli chcesz przy okazji ogarnąć nadawanie OP i banowanie graczy, zebraliśmy to w dokumentacji: OP, whitelist i bany.

Sposób 2: server.properties

Jeśli wolisz konfigurację w pliku, otwórz server.properties i ustaw:

white-list=true

Po zapisaniu pliku i restarcie serwera biała lista będzie aktywna. Samą listę graczy przechowuje plik whitelist.json w katalogu serwera. Jeśli edytujesz go ręcznie przy działającym serwerze, pamiętaj o komendzie /whitelist reload, żeby serwer wczytał zmiany bez restartu.

enforce-whitelist: co z graczami, którzy są już online

Tu kryje się szczegół, który potrafi zaskoczyć. Domyślnie, gdy włączysz whitelist w trakcie działania serwera, gracze, którzy są już połączeni i nie ma ich na liście, nie zostaną z niej wyrzuceni. Biała lista zablokuje dopiero kolejne, nowe logowania.

Odpowiada za to ustawienie enforce-whitelist w server.properties:

• enforce-whitelist=false (domyślnie): gracze spoza whitelist, którzy są już online, nie są wyrzucani.
• enforce-whitelist=true: gracze spoza whitelist zostają wyrzuceni z serwera.

Gdy ustawisz enforce-whitelist=true, serwer egzekwuje białą listę po jej przeładowaniu, czyli po komendzie /whitelist reload albo po restarcie. Wszyscy zalogowani gracze, których nie ma na liście, zostają wtedy rozłączeni. To przydatne, jeśli chcesz posprzątać serwer natychmiast, a nie dopiero przy następnym logowaniu.

Whitelist a inne sposoby ochrony serwera

Whitelist świetnie kontroluje, kto w ogóle wejdzie na serwer, ale nie jest cudownym zabezpieczeniem na wszystko. Warto znać jej granice.

Po pierwsze, w podstawowej wersji Minecraft nie ma czegoś takiego jak hasło do serwera. Nie ustawisz kodu wejścia jak w grach z prywatnymi lobby, więc whitelist (a na trybie offline dodatkowo plugin logowania) to najbliższy odpowiednik prywatnego dostępu.

Po drugie, whitelist nie ochroni Cię przed kimś, kogo sam wpuściłeś. Jeśli dodany gracz okaże się grieferem, biała lista nic nie da, bo on przecież jest na liście. Do tego potrzebujesz osobnych narzędzi: pluginów do cofania zniszczeń, ochrony regionów i backupów. Wszystkie zebraliśmy w poradniku o ochronie serwera Minecraft przed grieferami.

Najlepiej myśleć warstwami: whitelist decyduje, kto wchodzi, a reszta zabezpieczeń pilnuje, co ci ludzie mogą zrobić w środku.

Najczęstsze pytania (FAQ)

Czy whitelist działa na serwerze non-premium?

Działa, ale sprawdza wyłącznie nick, więc każdy, kto ustawi sobie nick z listy, wejdzie na serwer. Na trybie offline whitelist warto łączyć z pluginem autoryzacyjnym, na przykład AuthMe. FastLogin możesz dodać, aby automatycznie logować graczy premium.

Czy operator (OP) musi być na whitelist?

Nie. Operatorzy są wpuszczani automatycznie, nawet gdy biała lista jest włączona i nie ma ich w pliku whitelist.json.

Włączyłem whitelist, a gracze dalej są na serwerze. Dlaczego?

Bo domyślnie whitelist blokuje tylko nowe logowania, a nie rozłącza osób już połączonych. Jeśli chcesz od razu wyrzucić graczy spoza listy, ustaw enforce-whitelist=true i przeładuj listę komendą /whitelist reload.

Gdzie jest zapisana whitelist?

W pliku whitelist.json w głównym katalogu serwera. Możesz edytować go ręcznie, ale po zmianach uruchom /whitelist reload, żeby serwer wczytał nową wersję.

Podsumowanie

Whitelist to najprostszy i najskuteczniejszy sposób, żeby zapanować nad tym, kto wchodzi na Twój serwer Minecraft. W skrócie:

• Włącz ją komendą /whitelist on albo wpisem white-list=true w server.properties.
• Dodawaj i usuwaj graczy przez /whitelist add i /whitelist remove, a całą listę podejrzysz komendą /whitelist list.
• Na serwerze non-premium połącz whitelist z pluginem logowania, bo sama sprawdza tylko nick.
• Ustaw enforce-whitelist=true, jeśli chcesz od razu wyrzucać graczy spoza listy.
• Traktuj whitelist jako pierwszą warstwę ochrony, a nie jedyną.

Chcesz mieć to wszystko pod ręką w prostym panelu? Sprawdź hosting Minecraft od voxelhost, postaw serwer w mniej niż minutę i włącz whitelist w kilka kliknięć. A jeśli utkniesz, pomożemy Ci na naszym Discordzie.