MCTOOLBOX
MC ToolboxMC TOOLBOX

Server a soubory

Generátor whitelist.json

Vytvořte pole whitelist.json pro Java Edition s jmény hráčů a UUID. Vyřešte profily Mojang pro online režim nebo vygenerujte oficiální UUID OfflinePlayer.

Hráči

Povolte white-list=true v server.properties, umístěte whitelist.json do kořenového adresáře serveru a poté restartujte nebo spusťte /whitelist reload.

Vygenerovaný whitelist.json

[
  {
    "name": "Steve",
    "uuid": "5627dd98-e6be-3c21-b8a8-e92344183641"
  },
  {
    "name": "Alex",
    "uuid": "36532b5e-c442-3dbb-a24c-c7e55d0f979a"
  },
  {
    "name": "Notch",
    "uuid": "b50ad385-829d-3141-a216-7e7d7539ba7f"
  }
]

Jak používat generátor whitelistu pro Minecraft

Generátor whitelist.json je jednoduchý nástroj, který převede seznam uživatelských jmen Minecraftu na správně formátovaný soubor whitelist.json. Můžete vložit uživatelská jména, každé na nový řádek nebo oddělená čárkami. Nástroj automaticky odstraní duplicity a ořízne přebytečné mezery. Po vygenerování můžete JSON zkopírovat nebo si ho přímo stáhnout. Tento soubor je nezbytný pro vlastníky serverů, kteří chtějí omezit přístup pouze na schválené hráče.Pro servery v offline režimu (cracked nebo non-premium) nástroj používá oficiální algoritmus UUID pro offline hráče. Tento UUID je odvozen z uživatelského jména pomocí metody Java UUID.nameUUIDFromBytes. Je důležité použít přesně tento formát, protože server očekává offline UUID v souboru whitelist.json. Pokud použijete online UUID na offline serveru, whitelist nebude odpovídat UUID hráčů ve hře a budou vyhozeni.Pro servery v online režimu (premium nebo ověřené přes Mojang) může nástroj převést každé uživatelské jméno na aktuální UUID profilu Mojang. To vyžaduje připojení k internetu a používá API Mojang. Nástroj načte UUID pro každé jméno a vygeneruje whitelist.json se správnými online UUID. Poznámka: pokud bylo uživatelské jméno změněno, UUID bude odrážet aktuální profil, ne staré jméno. Vždy používejte aktuální uživatelské jméno pro online režim.Rozdíly ve verzích záleží: V Minecraftu 1.7.9 a starších byl formát whitelist.json jednoduché pole uživatelských jmen. Od verze 1.8 se formát změnil na pole objektů s poli 'uuid' a 'name'. Tento generátor vždy vytváří moderní formát, který funguje pro všechny verze od 1.8 po nejnovější. Pokud provozujete starší server, možná budete muset soubor převést ručně, ale většina moderních serverů používá formát objektů.Praktické tipy: Vždy si zálohujte stávající whitelist.json před jeho nahrazením. Po vygenerování umístěte soubor do kořenového adresáře serveru (kde se nachází server.properties). Poté spusťte příkaz 'whitelist reload' v konzoli serveru nebo použijte příkaz ve hře '/whitelist reload', pokud máte oprávnění operátora. Otestujte s účtem, který není na whitelistu, abyste se ujistili, že je whitelist aktivní. Nezapomeňte nastavit 'white-list=true' v server.properties, aby whitelist začal platit.

Online UUID a offline UUID nejsou zaměnitelné

Server Java v online režimu identifikuje placený účet pomocí UUID vráceného službami Mojang. Server v offline režimu odvozuje jiné UUID založené na jménu, takže kopírování offline whitelistu na online server může selhat, i když uživatelské jméno vypadá správně. Přizpůsobte metodu UUID režimu autentizace serveru a pokud se tento režim změní, vygenerujte soubor znovu.

Nainstalujte soubor bez ztráty stávajících hráčů

Zastavte server nebo použijte jeho whitelist příkazy před nahrazením whitelist.json. Pokud server již obsahuje schválené hráče, slučte tyto záznamy místo slepého přepisování souboru. Udržujte platný JSON s jedinečným jménem a UUID pro každý záznam, poté spusťte server a spusťte /whitelist reload, pokud to váš serverový software podporuje. Před úpravou produkčního serveru si uložte zálohu.

Časté dotazy

Jaký je rozdíl mezi offline a online UUID?

Offline UUID jsou generovány z uživatelského jména pomocí pevného algoritmu, takže jsou pro dané jméno vždy stejné. Online UUID jsou přiřazeny společností Mojang každému prémiovému účtu a jsou jedinečné pro účet, ne pro uživatelské jméno. Pokud hráč změní své jméno, jeho online UUID zůstává stejné, ale offline UUID se změní, protože je založeno na jméně. Pro offline servery musíte použít offline UUID; pro online servery použijte online UUID.

Mohu použít tento generátor pro server s online i offline hráči?

Ne, server běží buď v online režimu, nebo v offline režimu, ne v obou. Pokud nastavíte online-mode=true v server.properties, všichni hráči musí mít prémiové účty a musíte použít online UUID. Pokud je online-mode=false, všichni hráči jsou považováni za offline a musíte použít offline UUID. Míchání typů UUID v whitelist.json způsobí, že hráči budou vyhozeni, protože jejich UUID ve hře nebude odpovídat záznamu na whitelistu.

Proč můj whitelist nefunguje po vložení vygenerovaného JSON?

Časté důvody zahrnují: zapomněli jste nastavit white-list=true v server.properties, umístili jste soubor do špatné složky (musí být ve stejném adresáři jako server.properties), nespustili jste 'whitelist reload' po nahrazení souboru, nebo jste použili špatný režim UUID (offline vs online). Také se ujistěte, že je JSON platný, bez čárek na konci nebo chybějících závorek. Generátor vytváří platný JSON, ale pokud ho upravíte ručně, zkontrolujte syntaxi.

Podporuje generátor uživatelská jména se speciálními znaky nebo čísly?

Ano, uživatelská jména Minecraftu mohou obsahovat písmena, čísla a podtržítka. Generátor přijímá jakýkoli platný formát uživatelského jména. Pro offline režim algoritmus UUID funguje s jakýmkoli řetězcem, takže i neobvyklá jména vytvoří konzistentní UUID. Pro online režim API Mojang vrátí chybu, pokud uživatelské jméno neexistuje nebo je neplatné. Nástroj přeskočí neplatná jména a zobrazí varování, takže je můžete opravit.

Mohu použít tento nástroj k přidání hráčů do existujícího whitelist.json?

Generátor vytváří nový whitelist.json od začátku. Pokud chcete přidat hráče do existujícího whitelistu, můžete zkopírovat stávající záznamy a vložit je spolu s novými uživatelskými jmény do vstupního pole. Nástroj je sloučí a odstraní duplicity. Buďte však opatrní: pokud používáte online režim, nástroj znovu načte UUID pro všechna jména, což může aktualizovat záznamy, pokud hráč změnil své jméno. Pro offline režim jsou UUID deterministické, takže sloučení je bezpečné.