Whitelist je funkce, která omezuje přístup na váš Minecraft server pouze na schválené hráče. Každý, kdo není na whitelistu, se na server jednoduše nepřipojí. Whitelist se hodí pro privátní servery, testovací prostředí nebo servery, kde chcete mít plnou kontrolu nad tím, kdo hraje.

Rychlý přehled

Zapnout whitelist příkazem /whitelist on
Přidat hráče příkazem /whitelist add <nick>
Volitelně spravovat whitelist přes soubor whitelist.json

Zapnutí a vypnutí whitelistu

Whitelist zapnete nebo vypnete přímo za běhu serveru bez nutnosti restartu.

Zapnutí whitelistu:

/whitelist on

Vypnutí whitelistu:

/whitelist off

Whitelist lze také zapnout trvale v souboru server.properties nastavením hodnoty white-list=true. Tato hodnota se automaticky aktualizuje při použití příkazů výše.

Přidání hráče na whitelist

Hráče přidáte příkazem:

/whitelist add <nick>

Příklad pro přidání hráče s nickem Notch:

/whitelist add Notch

Hráč se může připojit ihned po přidání, restart ani reload není potřeba.

Odebrání hráče z whitelistu

Hráče odeberete příkazem:

/whitelist remove <nick>

Příklad:

/whitelist remove Notch

Pokud je hráč v době odebrání připojen, ze serveru odpojen nebude. Při příštím pokusu o připojení mu ale přístup zamítnut bude.

Whitelist na warez (offline) serveru

Pokud provozujete server v offline módu, narazíte na jeden zásadní rozdíl. Whitelist na offline serveru funguje na základě nicku, ne UUID. To znamená, že stačí zadat přesný nick hráče a příkaz /whitelist add <nick> funguje stejně jako na premium serveru.

Pozor ale na jednu věc. Pokud hráč ještě nikdy na server nebyl a vy si nejste jistí přesným nickem, musíte ho nejprve na server pustit, aby se zaregistroval, a teprve poté whitelist zapnout nebo ho přidat na seznam. Na offline serveru totiž neexistuje centrální databáze hráčů, ze které by server mohl nick ověřit.

Doporučený postup při prvním nastavení whitelistu na warez serveru:

Nechte whitelist dočasně vypnutý
Požádejte všechny hráče, aby se připojili
Jakmile se všichni hráči připojí, přidejte je na whitelist příkazem /whitelist add <nick>
Zapněte whitelist příkazem /whitelist on

Zobrazení seznamu hráčů na whitelistu

Pro zobrazení všech hráčů aktuálně na whitelistu použijte:

/whitelist list

Správa whitelistu přes soubor whitelist.json

Whitelist je uložen v souboru whitelist.json v kořenovém adresáři serveru. Soubor lze editovat ručně, což se hodí například při hromadném přidávání hráčů.

Struktura souboru vypadá takto:

[
  {
    "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "name": "Notch"
  },
  {
    "uuid": "853c80ef-3c37-49fd-aa49-938b674adae6",
    "name": "Dinnerbone"
  }
]

Po ruční úpravě souboru je nutné změny načíst příkazem:

/whitelist reload

Bez tohoto příkazu server změny v souboru nerozpozná.

Časté chyby při nastavování whitelistu

Hráč je na whitelistu, ale nemůže se připojit

Zkontrolujte, zda je whitelist skutečně zapnutý příkazem /whitelist list. Ověřte také, zda je nick hráče zadán správně včetně velkých a malých písmen. Na Paper serverech závisí whitelist na přesném UUID hráče, ne pouze na nicku.

Po ruční úpravě whitelist.json se změny neprojevily

Zapomněli jste zadat příkaz /whitelist reload. Bez něj server pracuje se starou verzí souboru až do restartu.

Whitelist je zapnutý, ale připojí se i hráči, kteří na něm nejsou

Operátoři serveru (hráči v souboru ops.json) mohou whitelist obejít. Toto chování je záměrné a nelze ho ve vanilla Minecraftu vypnout. Pokud chcete striktní kontrolu přístupu, zvažte použití permission pluginu jako LuckPerms.

Whitelist se po restartu vypíná

Zkontrolujte hodnotu white-list v souboru server.properties. Musí být nastavena na true, jinak se whitelist po každém restartu vypne.

Často kladené otázky (FAQ)

Funguje whitelist i na BungeeCord nebo Velocity?

Whitelist nastavený na jednotlivých backend serverech funguje, ale pro plnou ochranu doporučujeme whitelist řešit na úrovni proxy. BungeeCord ani Velocity nemají nativní whitelist, ale existují pluginy jako BungeeWhitelist nebo BungeeGuard, které tuto funkci přidají.

Mohu hráče přidat na whitelist, i když je server offline?

Ano. Soubor whitelist.json lze editovat i při vypnutém serveru. Po spuštění serveru se změny načtou automaticky.

Ovlivní zapnutí whitelistu výkon serveru?

Ne. Whitelist je jednoduchá kontrola při připojování a na výkon ani stabilitu serveru nemá žádný vliv.

Musím restartovat server po každé změně whitelistu?

Ne. Přidávání a odebírání hráčů příkazy funguje okamžitě za běhu serveru. Restart je potřeba pouze pokud měníte hodnotu white-list přímo v souboru server.properties bez použití příkazů.

Jak nastavit whitelist na Minecraft serveru