Whitelista, operatorzy i bany na serwerze Minecraft

O tym, kto może dołączyć do Twojego serwera i co może na nim robić, decydują trzy podstawowe narzędzia: whitelista wpuszcza tylko wybranych graczy, operatorzy dostają wszystkie polecenia, a ban blokuje każdego, kto łamie zasady. Wszystko zrobisz z konsoli w strefie klienta albo w grze.

Whitelistą, operatorami i banami możesz zarządzać także bez poleceń w zakładce Gracze: przy działającym serwerze strefa klienta wysyła polecenie do konsoli, przy zatrzymanym edytuje bezpośrednio pliki. Niedomyślny poziom operatora da się ustawić tylko przy zatrzymanym serwerze.

Whitelista#

Whitelista to lista graczy, którzy mogą dołączyć. Gdy jest włączona, serwer odprawia wszystkich pozostałych komunikatem You are not white-listed on this server! (Paper i Purpur wysyłają zawsze po angielsku You are not whitelisted on this server!). Przydaje się na prywatnych serwerach ze znajomymi, do testów albo zamkniętych wydarzeń.

Włączenie whitelisty#

1. Najpierw dodaj siebie, aby się nie zablokować (operatorzy mogą jednak dołączyć zawsze):

   whitelist add <NICK>

   • whitelist add – dodaje gracza do whitelisty. Gracz nie musi być online ani nigdy wcześniej się łączyć. Serwer sam wyszuka jego konto.
   • <NICK> – nick gracza w grze, na przykład Steve.

   [12:00:01 INFO]: Added Steve to the whitelist

2. Tym samym poleceniem dodaj wszystkich pozostałych graczy.

3. Włącz whitelistę:

   whitelist on

   [12:00:05 INFO]: Whitelist is now turned on

   Whitelista działa od razu, a serwer zapisze też do server.properties wartość white-list=true, więc przetrwa restart.

Ten sam efekt da ustawienie w strefie klienta: zakładka Ustawienia serwera › grupa Gracze › włącz Whitelista › Zapisz i uruchom ponownie.

Wymuszenie whitelisty#

Gdy włączasz whitelistę, aktualnie połączeni gracze, których nie ma na liście, zostają na serwerze. Opcja Wymuś whitelistę (enforce-whitelist w server.properties) wyrzuci ich przy przeładowaniu whitelisty. Włączysz ją w zakładce Ustawienia serwera w grupie Gracze.

Polecenia whitelisty#

Lista jest zapisana w whitelist.json w katalogu głównym serwera. Każdy gracz ma w pliku UUID (unikalny identyfikator konta) i nick. Ręcznej edycji nie zalecamy; polecenia są bezpieczniejsze.

Gracze Bedrocka (Geyser i Floodgate)#

Graczy Bedrock Edition dodasz poleceniem dodatku Floodgate. Nick wpisz bez prefiksu:

fwhitelist add <NICK>

Floodgate dodaje do nicków graczy Bedrocka w grze prefiks (domyślnie kropkę, na przykład .Steve), aby ich nicki nie kolidowały z graczami Java. Polecenie fwhitelist doda prefiks za Ciebie. Więcej w artykule Crossplay z Bedrockiem.

Operatorzy#

Operator (op) może używać poleceń serwera według swojego poziomu uprawnień. Domyślny poziom to 4, czyli absolutnie wszystkie polecenia.

op <NICK>

[12:01:10 INFO]: Made Steve a server operator

deop <NICK>

[12:01:30 INFO]: Made Steve no longer a server operator

• op nadaje graczowi uprawnienia operatora, deop je odbiera. Zmiana działa od razu.

Poziomy uprawnień operatorów#

Poziom dla nowych operatorów ustawisz w zakładce Ustawienia serwera › Gracze › Uprawnienia operatorów (op-permission-level, wartość 1–⁠4, domyślnie 4). Poziom konkretnego operatora jest w pliku ops.json:

[
  {
    "uuid": "<PLAYER_UUID>",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": false
  }
]

• uuid – unikalny identyfikator konta. Serwer uzupełni go sam przy op.
• name – nick w grze (tylko informacyjnie; liczy się UUID).
• level – poziom 1–⁠4 według tabeli wyżej.
• bypassesPlayerLimit – true oznacza, że operator dołączy nawet do pełnego serwera.

Plik edytuj tylko przy zatrzymanym serwerze, inaczej serwer nadpisze go przy zapisie.

Bany#

Przykład:

ban Griefer123 Niszczenie budowli na spawnie

[12:02:00 INFO]: Banned Griefer123: Niszczenie budowli na spawnie

Gdy zbanowany gracz spróbuje dołączyć, zobaczy You are banned from this server i powód. Bany są zapisane w plikach banned-players.json i banned-ips.json.

Ban czasowy#

Vanilla Minecraft nie obsługuje banów czasowych. Z pluginem EssentialsX (Paper, Purpur) użyj:

tempban <NICK> <czas> [powód]

• <czas> – na przykład 30m (minuty), 12h (godziny), 3d (dni), 1w (tydzień), 1mo (miesiąc). Działają też kombinacje, np. 1d12h.
• Przykład: tempban Steve 3d Spam na czacie.

Instalację EssentialsX opisuje artykuł Polecane pluginy.

Wyrzucenie (kick)#

kick <NICK> [powód]

Rozłącza gracza, ale może on od razu wrócić. Przydaje się jako ostrzeżenie. Wynik: Kicked Steve: powód.

Online mode i bezpieczeństwo#

Opcja Weryfikacja kont (online-mode) w zakładce Ustawienia serwera decyduje, czy serwer sprawdza w Mojangu, czy gracz ma oryginalne konto.

• Włączona (zalecane): każdy nick należy do prawdziwego konta. Whitelista, op i bany działają niezawodnie.
• Wyłączona: każdy może dołączyć pod dowolnym nickiem, także pod nickami operatorów. Strefa klienta Cię przed tym ostrzega: „Przy wyłączonej weryfikacji może dołączyć każdy pod dowolną nazwą, także nazwą operatora.” Wyłączenie ma sens tylko za proxy (Velocity), które samo weryfikuje graczy, zobacz Sieć serwerów z Velocity.

Sprawdzenie, czy działa#

• whitelist list wypisze graczy na whiteliście.
• banlist wypisze bany.
• Gracz, którego nie ma na whiteliście, przy próbie dołączenia dostanie komunikat o whiteliście.

Rozwiązywanie problemów#

Gracz jest na whiteliście, ale serwer go nie wpuszcza#

• Nick ma literówkę albo gracz zmienił nick. Sprawdź whitelist list i dodaj go ponownie.
• Gracza Bedrocka trzeba dodać poleceniem fwhitelist add.
• Serwer działa z wyłączonym online-mode, a whitelista zawiera UUID oryginalnego konta. Przy wyłączonej weryfikacji gracz ma inne UUID. Dodaj go ponownie.

That player does not exist#

Serwer nie znalazł w Mojangu konta o tym nicku. Sprawdź dokładną pisownię nicku.

Nothing changed. The player is already an operator#

Gracz już jest operatorem. Jeśli chcesz zmienić jego poziom, edytuj level w ops.json przy zatrzymanym serwerze.

Whitelista wyłączyła się po restarcie#

Prawdopodobnie włączyłeś ją w zakładce Ustawienia serwera, ale nie zapisałeś, albo jednocześnie edytowałeś server.properties i serwer nadpisał go przy starcie. Włącz ją ponownie poleceniem whitelist on i sprawdź, czy w Ustawieniach serwera jest włączona Whitelista.

Odbanowany gracz nadal nie może dołączyć#

Prawdopodobnie ma też ban IP. Sprawdź banlist ips i zdejmij go poleceniem pardon-ip <IP>. Bany czasowe z EssentialsX zdejmuje się poleceniem unban <NICK>.

Dalsza lektura#

• Minecraft Wiki: whitelist (otwiera się w nowym oknie)
• Minecraft Wiki: ban (otwiera się w nowym oknie)
• Minecraft Wiki: poziomy uprawnień (otwiera się w nowym oknie)
• Floodgate: funkcje i fwhitelist (otwiera się w nowym oknie)