Jak postawić serwer Hytale: Kompletny przewodnik instalacji i konfiguracji 2026

Gotowy, aby hostować własny serwer Hytale? Niezależnie od tego, czy tworzysz prywatny świat dla znajomych, czy uruchamiasz publiczny serwer społecznościowy, ten kompleksowy przewodnik przeprowadzi Cię przez każdy etap procesu — od instalacji Java po optymalizację wydajności dla setek graczy. Pod koniec tego przewodnika będziesz mieć w pełni funkcjonalny dedykowany serwer Hytale, gotowy na przyjęcie graczy. Zaczynajmy. Wymagania systemowe Przed rozpoczęciem instalacji upewnij się, że Twoja maszyna serwerowa spełnia minimalne wymagania: KomponentMinimumZalecane RAM4 GB8-16 GB CPU2 rdzenie4+ rdzenie Dysk10 GB SSD50+ GB NVMe SSD JavaJava 25Java 25 (zalecany Adoptium) ArchitekturaObsługiwane x64 i arm64 System operacyjnyWindows, Linux lub macOS Zrozumienie zużycia zasobów Zużycie zasobów serwera Hytale w dużej mierze zależy od zachowania graczy: Użycie CPU: Zależy od liczby graczy i encji (NPC, moby, aktywne stworzenia) Użycie RAM: Zależy od załadowanego obszaru świata — większy zasięg widzenia i gracze eksplorujący niezależnie zwiększają zapotrzebowanie na pamięć Wskazówka: Monitoruj zużycie RAM i CPU podczas gry, aby poznać typowe obciążenie serwera. Jeśli zauważysz wysokie użycie CPU, może to wskazywać na presję pamięci powodującą nadmierny garbage collection — spróbuj dostosować parametr -Xmx Java. Krok 1: Instalacja Java 25 Serwery Hytale wymagają Java 25. Zalecamy korzystanie z Adoptium (dawniej AdoptOpenJDK) dla niezawodnych, produkcyjnych buildów. Pobieranie Java 25 Odwiedź adoptium.net Pobierz instalator JDK 25 dla swojego systemu operacyjnego Uruchom instalator i postępuj zgodnie z instrukcjami Weryfikacja instalacji Otwórz terminal lub wiersz poleceń i uruchom: java --version Powinieneś zobaczyć wynik podobny do: openjdk 25.0.1 2025-10-21 LTS OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS) OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing) Jeśli widzisz inną wersję lub błąd, upewnij się, że Java 25 jest prawidłowo zainstalowana i dodana do zmiennej PATH systemu. Krok 2: Pobranie plików serwera Masz dwie opcje uzyskania plików serwera Hytale: Opcja A: Kopiowanie z instalacji gry (Szybki test) Najłatwiejsza metoda szybkiej konfiguracji — skopiuj pliki bezpośrednio z instalacji launchera Hytale: Lokalizacje plików: System operacyjnyŚcieżka Windows%appdata%\Hytale\install\release\package\game\latest Linux$XDG_DATA_HOME/Hytale/install/release/package/game/latest macOS~/Application Support/Hytale/install/release/package/game/latest Skopiuj folder Server i Assets.zip do lokalizacji dedykowanego serwera. Opcja B: Hytale Downloader CLI (Serwery produkcyjne) Dla środowisk produkcyjnych użyj oficjalnego narzędzia Hytale Downloader CLI. Ułatwia aktualizacje i wspiera automatyzację: Pobierz hytale-downloader.zip z oficjalnej strony wsparcia Hytale Rozpakuj i przeczytaj dołączony QUICKSTART.md Uruchom downloader, aby pobrać najnowsze pliki serwera Popularne komendy: KomendaOpis ./hytale-downloaderPobierz najnowsze wydanie ./hytale-downloader -print-versionPokaż wersję gry bez pobierania ./hytale-downloader -patchline pre-releasePobierz z kanału pre-release Krok 3: Uruchomienie serwera Przejdź do katalogu serwera i uruchom: java -XX:AOTCache=HytaleServer.aot -jar HytaleServer.jar --assets Assets.zip Flaga -XX:AOTCache wykorzystuje wstępnie wytrenowaną pamięć podręczną Ahead-Of-Time dostarczaną z serwerem, znacząco skracając czas uruchamiania. Pierwsze uwierzytelnienie Po pierwszym uruchomieniu musisz uwierzytelnić serwer. W konsoli serwera wykonaj: /auth login device Zobaczysz monit autoryzacji urządzenia: =================================================================== DEVICE AUTHORIZATION =================================================================== Visit: https://accounts.hytale.com/device Enter code: ABCD-1234 =================================================================== Waiting for authorization (expires in 900 seconds)... Odwiedź URL wyświetlony w przeglądarce Zaloguj się na swoje konto Hytale Wprowadź kod wyświetlony w konsoli Wróć do konsoli — powinieneś zobaczyć "Authentication successful!" Ważne: Każda licencja gry Hytale obsługuje do 100 serwerów. Dla większych wdrożeń kup dodatkowe licencje lub złóż wniosek o konto dostawcy serwerów. Krok 4: Konfiguracja portów i firewalla Hytale używa protokołu QUIC przez UDP (nie TCP). Jest to istotne dla konfiguracji firewalla i przekierowania portów. Domyślny port Domyślny port to 5520. Aby użyć innego portu: java -jar HytaleServer.jar --assets Assets.zip --bind 0.0.0.0:3500 Przekierowanie portów Jeśli hostujesz za routerem, przekieruj port UDP 5520 (lub Twój niestandardowy port) na maszynę serwera. Przekierowanie TCP nie jest wymagane. Konfiguracja firewalla Windows (PowerShell jako Administrator): New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow Linux (iptables): sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT Linux (ufw): sudo ufw allow 5520/udp Uwagi dotyczące NAT QUIC dobrze radzi sobie z przechodzeniem NAT w większości scenariuszy. Jeśli gracze mają problemy z połączeniem: Upewnij się, że przekierowanie portów jest ustawione dla UDP, nie TCP Konfiguracje symetrycznego NAT mogą powodować problemy — rozważ VPS lub serwer dedykowany Gracze za NAT operatorskim (częste na urządzeniach mobilnych) powinni łączyć się bez problemów jako klienci Struktura plików serwera Zrozumienie struktury plików serwera pomaga w zarządzaniu i rozwiązywaniu problemów: ŚcieżkaOpis .cache/Pamięć podręczna zoptymalizowanych plików logs/Pliki logów serwera mods/Zainstalowane mody universe/Dane zapisu świata i graczy bans.jsonLista zbanowanych graczy config.jsonKonfiguracja serwera permissions.jsonKonfiguracja uprawnień whitelist.jsonGracze na białej liście Struktura świata Światy są przechowywane w universe/worlds/. Każdy świat ma własny config.json z ustawieniami dla: Ziarna świata i typu generacji PvP włączone/wyłączone Ustawienia obrażeń od upadku Zachowanie spawnowania NPC Wymagane wtyczki Każdy świat działa we własnym głównym wątku, z pracą równoległą rozdzielaną na wspólną pulę wątków. Instalacja modów Dodawanie modów do serwera Hytale jest proste: Pobierz mody (pliki .zip lub .jar) z CurseForge lub innych zaufanych źródeł Umieść pliki modów w folderze mods/ serwera Uruchom ponownie serwer Uwaga: Wiele modów działa tylko po stronie serwera — gracze dołączający do Twojego serwera automatycznie otrzymają zawartość moda bez ręcznej instalacji. Optymalizacja wydajności Zasięg widzenia Zasięg widzenia jest głównym czynnikiem zużycia RAM. Domyślny zasięg widzenia 384 bloki (12 chunków) odpowiada około 24 chunkom Minecraft. Zalecenia: Dla małych serwerów (1-10 graczy): Domyślne ustawienia działają dobrze Dla średnich serwerów (10-50 graczy): Rozważ ograniczenie do 8-10 chunków Dla dużych serwerów (50+ graczy): Ogranicz do 6-8 chunków i monitoruj zasoby Zalecane wtyczki Główni dostawcy hostingu utrzymują przydatne wtyczki do zarządzania serwerem: WtyczkaOpis Nitrado:WebServerBazowa wtyczka dla aplikacji webowych i API Nitrado:QueryUdostępnia status serwera przez HTTP (liczba graczy itp.) Nitrado:PerformanceSaverDynamicznie ogranicza zasięg widzenia na podstawie zasobów ApexHosting:PrometheusExporterUdostępnia szczegółowe metryki serwera i JVM Wyłączenie Sentry podczas developmentu Jeśli tworzysz wtyczki, wyłącz raportowanie crashy, aby uniknąć wysyłania błędów deweloperskich: java -jar HytaleServer.jar --assets Assets.zip --disable-sentry Referencja komend serwera Wyświetl wszystkie dostępne argumenty serwera: java -jar HytaleServer.jar --help Popularne argumenty: ArgumentOpis --assets <path>Ścieżka do Assets.zip (domyślnie: ../HytaleAssets) --bind <address:port>Adres nasłuchiwania (domyślnie: 0.0.0.0:5520) --auth-mode <mode>Tryb uwierzytelniania: authenticated lub offline --backupWłącz automatyczne kopie zapasowe --backup-dir <path>Lokalizacja katalogu kopii zapasowych --backup-frequency <minutes>Interwał kopii zapasowych (domyślnie: 30) --disable-sentryWyłącz raportowanie crashy Architektura wieloserwerowa Hytale natywnie obsługuje routing graczy między serwerami — nie jest potrzebny odwrotny proxy jak BungeeCord. Transfer graczy Przenieś połączonych graczy na inne serwery z opcjonalnym ładunkiem danych: PlayerRef.referToServer(host, port, optionalData) Uwaga bezpieczeństwa: Ładunek przechodzi przez klienta i może zostać sfałszowany. Użyj podpisu kryptograficznego (np. HMAC ze wspólnym sekretem), aby zweryfikować autentyczność na serwerze odbierającym. Przekierowanie połączenia Podczas uzgadniania połączenia przekieruj graczy na różne serwery w celu równoważenia obciążenia lub routingu regionalnego. Fallback po rozłączeniu Gdy gracze nieoczekiwanie się rozłączą (awaria serwera, problemy z siecią), klient automatycznie łączy się ponownie ze wstępnie skonfigurowanym serwerem zapasowym zamiast wracać do menu głównego. Dodanie serwera na listę Gdy serwer działa, zaprezentuj go graczom: Zgłoś na HytaleCharts: Dodaj swój serwer do naszej listy serwerów za darmo Oficjalne wyszukiwanie serwerów: Dołącz do wbudowanej przeglądarki serwerów Hytale (wkrótce) Zbuduj swoją społeczność: Utwórz serwer Discord i obecność w mediach społecznościowych Wskazówki na lepszy ranking: Utrzymuj wysoki uptime (99%+) Aktualizuj serwer do najnowszej wersji Napisz przekonujący opis serwera z odpowiednimi słowami kluczowymi Zachęcaj graczy do głosowania na Twój serwer Rozwiązywanie typowych problemów Gracze nie mogą się połączyć Sprawdź, czy firewall zezwala na UDP na porcie 5520 Potwierdź, że przekierowanie portów jest ustawione na UDP (nie TCP) Sprawdź, czy serwer jest uwierzytelniony Upewnij się, że gracze mają tę samą wersję gry co serwer Wysokie zużycie pamięci Zmniejsz zasięg widzenia Ogranicz maksymalną liczbę graczy Sprawdź mody wymagające dużo pamięci Dostosuj odpowiednio parametr -Xmx Lag serwera Monitoruj liczbę encji (zbyt wiele mobów/NPC) Sprawdzaj użycie CPU w godzinach szczytu Używaj wtyczek monitorowania wydajności Rozważ aktualizację sprzętu, jeśli jest stale obciążony na maksa Problemy z uwierzytelnieniem Wykonaj ponownie /auth login device Upewnij się, że Twoje konto Hytale jest w dobrym stanie Sprawdź, czy nie przekroczyłeś limitu 100 serwerów na licencję Kluczowe wnioski Wymagana Java 25: Użyj Adoptium dla niezawodnych buildów Port UDP 5520: Protokół QUIC wymaga UDP, nie TCP Wymagane uwierzytelnienie: Wykonaj /auth login device po pierwszym uruchomieniu Zasięg widzenia = RAM: Zmniejsz zasięg widzenia, aby ograniczyć zużycie pamięci Pamięć podręczna AOT: Użyj -XX:AOTCache=HytaleServer.aot dla szybszego startu Folder modów: Wrzuć mody do mods/ i zrestartuj Natywna architektura wieloserwerowa: Proxy niepotrzebny do transferów między serwerami Twój serwer Hytale jest gotowy na graczy. Dodaj go na HytaleCharts, aby zacząć budować swoją społeczność!