Notatki operatora

Serwer Hytale: jak postawić własny serwer (październik 2026)

Hytale ma oficjalny serwer dedykowany i dość szczegółowy podręcznik od Hypixel Studios. Ta strona zbiera z niego to, czego potrzebujesz, żeby serwer dla znajomych ruszył za pierwszym razem: wymagania, skąd wziąć pliki, logowanie serwera, port UDP, pamięć i aktualizacje, które w Hytale są ważniejsze niż w Minecrafcie.

Opublikowano 10 października 2026 · ~9 min czytania

W skrócie: serwer Hytale potrzebuje Javy 25 i co najmniej 4 GB pamięci, działa na procesorach x64 i arm64 i nasłuchuje na porcie 5520 UDP (protokół QUIC, TCP nie jest potrzebny). Po pierwszym starcie trzeba go zalogować komendą /auth login device, inaczej nikt nie wejdzie. Klient i serwer muszą mieć dokładnie tę samą wersję protokołu, więc po każdej łatce serwer trzeba zaktualizować od razu. Stan na październik 2026 według oficjalnego podręcznika serwera Hypixel Studios.

Wymagania serwera Hytale w liczbach

Parametr	Wartość	Uwagi
Java	25	Hypixel Studios poleca dystrybucję Adoptium (Temurin)
Pamięć	minimum 4 GB	realne zużycie zależy od zasięgu widzenia i rozproszenia graczy
Architektura	x64 i arm64	serwer ruszy też na tanich maszynach ARM
Port domyślny	5520	zmiana parametrem `--bind`
Protokół	QUIC po UDP	przekierowanie TCP nie jest wymagane
Logowanie serwera	`/auth login device`	kod urządzenia wygasa po 900 sekundach
Limit serwerów	500 na jedną licencję gry	większe potrzeby przez wsparcie Hypixel Studios
Automatyczne kopie	`--backup`, domyślnie co 30 min	skrypty startowe włączają je same
Zalecany maks. zasięg widzenia	12 chunków (384 bloki)	główny czynnik zużycia RAM

Wszystkie liczby pochodzą z „Hytale Server Manual”, czyli podręcznika serwera, który Hypixel Studios utrzymuje na swojej stronie wsparcia. Wersja, którą czytaliśmy 10 października 2026, była ostatnio aktualizowana 15 czerwca 2026.

Skąd wziąć pliki serwera

Są trzy drogi i każda pasuje do innej sytuacji.

1. Skopiowanie z instalacji launchera

Najszybciej, jeśli chcesz tylko sprawdzić, czy wszystko działa. Pliki leżą w folderze launchera:

Windows: %appdata%\Hytale\install\release\package\game\latest
Linux: $XDG_DATA_HOME/Hytale/install/release/package/game/latest
macOS: ~/Library/Application Support/Hytale/install/release/package/game/latest

Kopiujesz folder Server i plik Assets.zip do katalogu serwera. Wada jest jedna, ale poważna: przy każdej aktualizacji gry musisz to powtarzać ręcznie, a serwer w starej wersji nie wpuści graczy z nowym klientem.

2. Hytale Downloader CLI

Narzędzie wiersza poleceń dla Linuksa i Windowsa, które pobiera serwer i assety po zalogowaniu kontem (OAuth2). To droga zalecana na serwer, który ma działać miesiącami. Najważniejsze przełączniki: ./hytale-downloader pobiera najnowsze wydanie, -print-version pokazuje wersję gry bez pobierania, a -patchline pre-release sięga po kanał przedpremierowy. Downloader od razu układa pliki w strukturze, której wymaga wbudowany mechanizm aktualizacji.

3. Bootstrap z samego HytaleServer.jar

Wrzucasz HytaleServer.jar do pustego katalogu i uruchamiasz go z flagą --bootstrap. Serwer startuje w trybie minimalnym, prosi o zalogowanie, a po komendzie /update setup pobiera resztę: assety, skrypty start.sh i start.bat oraz właściwy plik serwera. Potem sam się wyłącza, a ty uruchamiasz go już skryptem startowym. Dane logowania przechodzą do nowej instalacji, więc pierwszy prawdziwy start jest od razu uwierzytelniony.

Pierwsze uruchomienie i logowanie serwera

Ręczny start wygląda tak:

java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip

Flaga -XX:AOTCache korzysta z dołączonej do serwera pamięci podręcznej kompilacji z wyprzedzeniem (mechanizm JEP 514 z Javy 25), dzięki czemu serwer wstaje szybciej. Nie jest obowiązkowa, ale nie ma powodu z niej rezygnować.

Zaraz po starcie w konsoli wpisz /auth login device. Serwer wypisze adres strony kont Hytale i krótki kod. Otwierasz stronę w przeglądarce, wpisujesz kod, potwierdzasz kontem z licencją gry i w konsoli pojawia się komunikat o udanym uwierzytelnieniu. Kod jest ważny 900 sekund, czyli kwadrans. Bez tego kroku serwer działa, ale nie przyjmie żadnego gracza: Hypixel Studios wymaga logowania, żeby serwery mogły rozmawiać z usługami gry i żeby ograniczyć nadużycia. Na jedną licencję można w ten sposób podpiąć 500 serwerów. Limit ma ograniczać nadużycia we wczesnej fazie gry; dla prywatnego serwera nie ma znaczenia, a większe sieci mogą poprosić wsparcie Hypixel Studios o więcej.

Port 5520 UDP, firewall i router

Hytale używa protokołu QUIC, który działa po UDP. To najczęstsze źródło problemów u osób przyzwyczajonych do Minecrafta, gdzie wystarczał port TCP. Tu przekierowujesz wyłącznie UDP: port 5520 albo ten, który ustawisz flagą --bind (na przykład --bind 3500).

Reguły zapory z podręcznika:

Windows (PowerShell): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow
Linux z ufw: sudo ufw allow 5520/udp
Linux z iptables: sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Na routerze domowym ustawiasz przekierowanie UDP na adres komputera z serwerem. Jak to zrobić krok po kroku i jak sprawdzić, czy port jest naprawdę otwarty, opisujemy w poradniku o przekierowaniu portów. Podręcznik zwraca uwagę na dwie rzeczy. Po pierwsze, przekierowanie musi być ustawione dla UDP, a nie TCP. Po drugie, symetryczny NAT potrafi zablokować połączenia mimo poprawnej konfiguracji, i wtedy rozsądniej postawić serwer na VPS albo serwerze dedykowanym. Gracze za CGNAT, typowym dla internetu mobilnego, łączą się jako klienci bez problemu, ale serwer za takim łączem nie będzie osiągalny z zewnątrz.

Jeszcze jedna praktyczna uwaga: Hytale na razie nie obsługuje rekordów SRV. Jeśli zmienisz port z domyślnego, gracze muszą go wpisać przy adresie serwera. Hypixel Studios pisze, że funkcja jest „w ocenie”, bez daty.

Co jest w katalogu serwera

Ścieżka	Zawartość
`universe/`	światy i dane graczy, każdy świat w `universe/worlds/` z własnym `config.json`
`mods/`	zainstalowane mody (pliki .zip lub .jar)
`logs/`	logi serwera
`config.json`	główna konfiguracja serwera
`permissions.json`	uprawnienia
`whitelist.json`	biała lista graczy
`bans.json`	bany
`.cache/`	zoptymalizowane pliki pomocnicze

W config.json każdego świata znajdziesz między innymi przełączniki IsPvpEnabled, IsFallDamageEnabled i IsSpawningNPC. Ważna pułapka: pliki konfiguracyjne są czytane przy starcie i zapisywane przez serwer, gdy coś zmienia się w grze (na przykład nadajesz uprawnienia komendą). Edycja na działającym serwerze zwykle zostanie nadpisana. Zatrzymaj serwer, popraw plik, uruchom ponownie.

Ile RAM i CPU naprawdę potrzeba

Oficjalna podłoga to 4 GB, ale podręcznik uczciwie mówi, że zużycie mocno zależy od zachowania graczy. Rozkłada to na dwa czynniki:

Procesor obciąża liczba graczy i istot (NPC, mobów).
Pamięć zjada załadowany obszar świata, czyli wysoki zasięg widzenia i gracze, którzy rozchodzą się w różne strony.

Zasięg widzenia to główna dźwignia. Hypixel Studios zaleca ograniczenie maksymalnego zasięgu do 12 chunków, czyli 384 bloków. Dla porównania serwer Minecrafta domyślnie wysyła 10 chunków (160 bloków), a 384 bloki w Hytale to mniej więcej odpowiednik 24 chunków Minecrafta. Kto przenosi nawyki z Minecrafta i zostawia wysoki zasięg „bo i tak jest szybki komputer”, szybko zobaczy rosnące zużycie RAM.

Limit pamięci ustawiasz w pliku jvm.options obok skryptu startowego, po jednym argumencie w linii, na przykład -Xms2G i -Xmx4G. Typowy objaw za małej sterty to rosnące zużycie procesora przez odśmiecanie pamięci, a nie od razu awaria. Jeśli serwer „mieli” CPU przy kilku osobach, sprawdź najpierw RAM. Ogólne zasady doboru sprzętu pod serwer gry zebraliśmy w tekście o doborze RAM i CPU.

Na start dla grupy znajomych sensowne jest więc: 4 GB jako minimum, zasięg nie większy niż zalecane 12 chunków, obserwacja zużycia przez pierwsze wieczory i dopiero potem korekta. Podręcznik wymienia też wtyczkę Nitrado:PerformanceSaver, która dynamicznie obniża zasięg widzenia, gdy brakuje zasobów.

Aktualizacje: dlaczego serwer musi nadążać za klientem

To najważniejsza różnica w codziennej obsłudze. Hytale sprawdza zgodność klienta i serwera przez skrót (hash) protokołu i przy różnicy odrzuca połączenie. Na październik 2026 obowiązuje zasada „dokładnie ta sama wersja”: gdy wychodzi łatka, launchery graczy aktualizują się od razu, a serwer, który nie został zrestartowany z nową wersją, przestaje ich wpuszczać. Hypixel Studios zapowiada tolerancję plus minus dwóch wersji protokołu, ale na razie to zapowiedź.

Serwer ma wbudowany mechanizm aktualizacji:

Komenda	Działanie
`/update check`	sprawdza, czy jest nowa wersja
`/update download`	pobiera aktualizację do katalogu `updater/staging/`
`/update apply --confirm`	robi kopię i wyłącza serwer z kodem 8, skrypt startowy wgrywa nowe pliki
`/update status`	pokazuje bieżącą wersję i stan aktualizacji
`/update cancel`	usuwa pobraną, niezastosowaną aktualizację

Domyślnie serwer sprawdza dostępność aktualizacji co 3600 sekund, ale sam jej nie instaluje. W config.json, w sekcji Update, ustawienie AutoApplyMode przyjmuje trzy wartości: Disabled (domyślnie, czekasz na ręczne /update apply --confirm), WhenEmpty (instaluje, gdy nikt nie gra) i Scheduled (instaluje po AutoApplyDelayMinutes, domyślnie 30 minutach, ostrzegając graczy). Dla prywatnego serwera WhenEmpty to rozsądny kompromis.

Warunek konieczny: serwer musi stać w układzie z folderem Server/, a w katalogu nadrzędnym muszą leżeć Assets.zip i skrypt startowy. Jeśli skopiowałeś pliki ręcznie z launchera, komenda /update setup dopisze brakujące skrypty. Bez tego układu sprawdzanie aktualizacji jest wyłączone. Skrypty przy okazji pilnują kopii zapasowych (--backup --backup-dir backups --backup-frequency 30) i gdy serwer wywali się w ciągu 30 sekund od aktualizacji, podpowiadają, jak wrócić do plików z updater/backup/.

Mody i wiele serwerów

Mody w formacie .zip lub .jar wrzucasz do folderu mods/. Jeśli sam piszesz wtyczki, uruchamiaj serwer z flagą --disable-sentry, żeby błędy z twojego kodu nie trafiały do systemu raportowania awarii studia.

Ciekawostka dla osób z doświadczeniem w sieciach Minecrafta: do prostego przenoszenia graczy między serwerami Hytale nie trzeba stawiać proxy w stylu BungeeCord. Serwer potrafi natywnie przekazać gracza na inny serwer (referral z ładunkiem do 4 KB, który warto podpisać, bo przechodzi przez klienta) albo przekierować go już przy łączeniu. Automatyczny powrót do lobby po awarii serwera podręcznik wciąż opisuje jako funkcję, która dopiero ma się pojawić. Kto potrzebuje czegoś więcej, może zbudować własne proxy na bibliotece Netty QUIC, bo Hytale komunikuje się wyłącznie przez QUIC.

Własny komputer czy hosting

Dla dwóch, trzech osób na jeden wieczór serwer na domowym komputerze wystarczy, o ile masz publiczny adres i otworzysz UDP. Problem zaczyna się przy serwerze, który ma działać cały czas: komputer musi być włączony, każda łatka gry wymaga natychmiastowej aktualizacji serwera, a symetryczny NAT albo CGNAT potrafią zablokować wszystko mimo poprawnych ustawień. Wtedy prościej oddać to komuś, kto ma stały adres, otwarte porty i panel z aktualizacją. Gotowy serwer z panelem znajdziesz w hostingu Hytale na Supercraft, a ogólne porównanie obu dróg w tekście własny serwer czy hosting zarządzany.

Źródło wszystkich parametrów technicznych: Hytale Server Manual na stronie wsparcia Hypixel Studios.

Najczęstsze pytania

Jakie są wymagania serwera Hytale? Według oficjalnego podręcznika serwer Hytale wymaga Javy 25 i co najmniej 4 GB pamięci. Działa na procesorach x64 i arm64. Realne zużycie RAM zależy głównie od zasięgu widzenia i tego, jak bardzo gracze rozchodzą się po świecie, a obciążenie procesora od liczby graczy i istot.

Jaki port ma serwer Hytale? Domyślnie 5520, protokół UDP. Hytale używa QUIC, więc na routerze i w zaporze otwierasz wyłącznie UDP, przekierowanie TCP nie jest potrzebne. Port zmienisz parametrem startowym bind, opisanym w podręczniku serwera.

Dlaczego nikt nie może wejść na mój serwer Hytale? Najczęstsze przyczyny to brak zalogowania serwera komendą /auth login device, przekierowanie portu ustawione dla TCP zamiast UDP oraz różnica wersji: klient i serwer muszą mieć dokładnie tę samą wersję protokołu, więc po łatce gry serwer trzeba od razu zaktualizować.

Ile RAM potrzebuje serwer Hytale? Minimum to 4 GB. Największy wpływ na pamięć ma zasięg widzenia: Hypixel Studios zaleca ograniczenie go do 12 chunków, czyli 384 bloków. Limit pamięci ustawisz w pliku jvm.options, na przykład -Xmx4G, a objawem za małej sterty jest rosnące zużycie procesora przez odśmiecanie.

Czy serwer Hytale aktualizuje się sam? Sam sprawdza aktualizacje, domyślnie co godzinę, i może je pobrać, ale domyślnie nie instaluje ich bez twojej zgody. W config.json ustawienie AutoApplyMode na WhenEmpty pozwala instalować aktualizacje, gdy na serwerze nikogo nie ma. Wymaga to układu katalogów ze skryptem startowym, który tworzy Hytale Downloader albo tryb bootstrap.