Dzięki whiteliście Minecraft ograniczasz swój serwer do wyraźnie dopuszczonych graczy. Ma to sens przy prywatnych światach survivalowych, projektach budowlanych, eventach albo społecznościach, w których chcesz zachować kontrolę nad dostępem. Kluczowe są trzy rzeczy: white-list=true, poprawnie utrzymane nazwy graczy oraz enforce-whitelist=true, aby zmiany działały niezawodnie.

Wymagania

Potrzebujesz dostępu do konsoli serwera, uprawnień OP w grze albo dostępu do pliku server.properties. Powinieneś też znać dokładne nazwy graczy w Minecraft. W przypadku kont Java zwykle wystarczy nazwa gracza. Jeśli gracze Bedrock dołączają przez Geyser, nazwa może pojawiać się z prefiksem zależnie od konfiguracji Geyser; w przykładzie wyjściowym używana jest kropka.

Jeśli dopiero konfigurujesz serwer od podstaw, pomoże Ci bardziej szczegółowy poradnik Wynajem i konfiguracja serwera Minecraft – kompletny poradnik 2026. Więcej konfiguracji co-op o podobnym podejściu do dostępu znajdziesz też w poradniku Wynajem i konfiguracja serwera Valheim – poradnik co-op 2026.

Konfiguracja whitelisty Minecraft

Czym jest whitelist?

Whitelist to kontrola dostępu do Twojego serwera. Dołączyć mogą tylko gracze z listy. Nie zastępuje moderacji, ale zapobiega temu, że nieznane konta po prostu wejdą przez adres serwera. Przy płatnym hostingu multi-game jest to szczególnie praktyczne, bo pozwala wyraźniej oddzielić dostęp do serwera, sprawy supportowe i procesy operacyjne: kto nie jest na liście, nie wejdzie.

Microsoft dokumentuje odpowiednią komendę Bedrock jako /allowlist; tam /whitelist jest wymienione jako alias, a akcje add, remove, list, off, on i reload są opisane tutaj: Microsoft Learn o allowlist/whitelist. Dla serwerów Java praktyczną podstawą pozostają pokazane niżej wpisy server.properties i komendy /whitelist.

Włączanie whitelisty

W server.properties:

white-list=true
enforce-whitelist=true

Skoro jesteś już w server.properties: linia motd określa wpis Twojego serwera na liście serwerów — możesz nadać mu kolory za pomocą naszego darmowego generatora MOTD.

Albo komendą w grze:

/whitelist on

Jeśli edytujesz plik bezpośrednio, wcześniej zatrzymaj serwer albo uruchom go ponownie po zmianach. Zmiany przez komendy są wygodniejsze podczas pracy serwera, bo nie musisz za każdym razem przechodzić do pliku.

Dodawanie graczy

/whitelist add <Spielername>

Dla graczy Bedrock przez Geyser:

/whitelist add .<BedRockName>

Zwróć uwagę na pisownię. Jeśli gracz nie może dołączyć, mimo że go dodałeś, porównaj nazwę z tym, co widać przy próbie logowania albo w logach serwera. Przy konfiguracjach Geyser szczególnie ważne jest, czy używany jest prefiks i jak traktowana jest wielkość liter.

Zarządzanie whitelistą

Komenda Opis
/whitelist list Pokaż wszystkich graczy
/whitelist add <name> Dodaj gracza
/whitelist remove <name> Usuń gracza
/whitelist reload Wczytaj listę ponownie
/whitelist on/off Włącz/wyłącz whitelistę

Używaj /whitelist list po każdej większej zmianie. Dzięki temu od razu zauważysz literówki albo przypadkowo podwójnie utrzymywane nazwy. Jeśli usuwasz gracza, enforce-whitelist=true jest ważne, aby wykluczenie nie zaczęło mieć znaczenia dopiero przy następnej próbie połączenia.

whitelist.json

Whitelist jest zapisywana w whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "NazwaGracza"
  }
]

Edytuj ten plik tylko wtedy, gdy wiesz, co robisz. Do normalnej pracy bezpieczniejsze są komendy, bo serwer odpowiednio zarządza nazwami i UUID. Jeśli zmieniasz plik ręcznie, użyj potem /whitelist reload albo uruchom serwer ponownie.

Sprawdzanie wyniku

Najpierw sprawdź przez /whitelist list, czy znajdują się tam wszyscy wybrani gracze. Potem wpisany gracz powinien móc dołączyć. Konto, którego nie ma na liście, powinno zostać odrzucone. Dodatkowo sprawdź konsolę serwera: zobaczysz tam, czy próba dołączenia nie powiodła się przez whitelistę, błędną nazwę czy inny problem.

Przy prywatnych projektach warto mieć krótką rutynę: dodać gracza, przetestować dołączenie, wyświetlić listę, udokumentować zmianę. Szczególnie przy kilku adminach zapobiega to późniejszym niejasnym pytaniom do supportu.

Rozwiązywanie problemów

Gracz jest na liście, ale nie może dołączyć

Sprawdź dokładną nazwę, tryb gry i możliwe prefiksy przy Geyser. W razie wątpliwości usuń wpis przez /whitelist remove <name>, a potem dodaj go ponownie.

Usunięci gracze pozostają online

Ustaw enforce-whitelist=true i wczytaj listę ponownie przez /whitelist reload. Bez tego ustawienia usunięci gracze, zależnie od stanu serwera, mogą pozostać połączeni aż do rozłączenia.

Zmiany w pliku nie działają

Jeśli ręcznie zmieniłeś server.properties albo whitelist.json, wczytaj whitelistę ponownie albo kontrolowanie zrestartuj serwer. Sprawdź też, czy na pewno edytowałeś plik aktywnej instancji serwera.

Mylenie OP i whitelisty

Uprawnienia operatora to prawa administracyjne, a nie czysta lista dostępu. Ogranicz liczbę OP i utrzymuj whitelistę osobno. Dzięki temu pozostaje jasne, kto może administrować, a kto tylko grać.

Wskazówki

  • Enforce Whitelist: Włącz enforce-whitelist=true, aby gracze byli wyrzucani, gdy zostaną usunięci z listy
  • OPs: Operatorzy (OPs) mogą dołączać także bez whitelisty, jeśli enforce-whitelist jest wyłączone
  • Automatyzacja: Używaj pluginów takich jak EasyWhitelist do zarządzania przez WWW

Kontrola, ograniczenia i bezpieczny powrót

Instrukcja „Konfiguracja whitelisty serwera Minecraft – wpuszczaj tylko znajomych” dotyczy typu serwera opisanego w artykule oraz wersji widocznej w momencie sprawdzania. Nazwy menu, dostępne wersje, kompatybilność modów lub pluginów oraz wymagane zasoby mogą zmienić się po aktualizacjach. Dlatego nie przenoś żadnych wartości na inną wersję gry, loadera albo serwera bez sprawdzenia.

Przed zmianami w świecie, zapisie gry, konfiguracji albo rozszerzeniach utwórz backup odpowiednich plików. Następnie zmieniaj tylko jeden powiązany krok naraz i sprawdzaj go tą samą wersją klienta i serwera, na której później chcesz grać.

Punkt kontroli Oczekiwany wynik Przerwanie i powrót
Start serwera Serwer osiąga stan gotowy do pracy bez nowych komunikatów o błędach. Przy błędach startu cofnij zmianę i przywróć ostatni backup.
Test połączenia Konto testowe może połączyć się przez adres pokazany w panelu. Przy błędach wersji lub połączenia ponownie porównaj wersję, port i reguły dostępu.
Test funkcji Konkretnie zmieniona funkcja działa bez uszkadzania istniejącego świata lub danych gry. Przy skutkach ubocznych zatrzymaj serwer i przywróć zabezpieczone pliki.

Udany pojedynczy test nie jest gwarancją wydajności ani dostępności. Rozmiar świata, mody, pluginy, liczba graczy, trasa sieciowa i równoczesne obciążenie mogą zmienić wynik. Dokumentuj wersję, zmianę i rezultat testu, aby móc później odtworzyć przyczyny odchyleń.

FAQ

Czy po każdej zmianie potrzebuję restartu?

Niekoniecznie. Jeśli używasz komend takich jak /whitelist add, /whitelist remove albo /whitelist reload, możesz zarządzać listą podczas pracy serwera. Po ręcznych zmianach plików warto zrobić reload albo restart.

Czy whitelist jest lepszy niż hasło?

W Minecraft whitelist jest częściej stosowaną metodą, bo dopuszcza konkretne konta. Hasło nie chroni przed przekazanymi danymi dostępowymi, a whitelist jest powiązany z nazwami graczy lub kontami.

Czy zawsze warto włączyć enforce-whitelist=true?

Przy prywatnych serwerach najczęściej tak. To ustawienie sprawia, że usunięci gracze po reloadzie nie pozostają dalej online, mimo że nie są już na liście.

Czy whitelist działa z modami i pluginami?

Tak, podstawowy whitelist jest funkcją serwera. Pluginy mogą oferować dodatkowe zarządzanie, ale warto wybierać je świadomie i utrzymywać aktualne.

Co zrobić z graczami Bedrock przez Geyser?

Sprawdź, jak Twoja konfiguracja Geyser mapuje nazwy Bedrock. W przykładzie używane jest .<BedRockName>. Jeśli dołączenie się nie powiedzie, sprawdź faktycznie wyświetlaną nazwę w konsoli albo logach.