Jak stworzyć serwer Hytale — poradnik użytkownika

W Hytale każdy gracz może postawić własny serwer, aby nie być zależnym od hosta i grać ze znajomymi bez przerw i w dowolnym składzie. Da się go „podnieść” na podstawie oficjalnej instrukcji od twórców, ale nie jest to najprostsze zadanie — nawet mimo tego, że sam proces opisano dość szczegółowo.

Wymagania serwera

Sprzęt

Zacznijmy od razu od wymagań sprzętowych potrzebnych do postawienia serwera. Oto one:

• Procesor (CPU) — procesor wielowątkowy. Im szybszy i im więcej rdzeni, tym lepiej.
• Pamięć operacyjna (RAM) — minimum 4 GB, ale lepiej założyć co najmniej 8 GB lub więcej. Im więcej graczy na serwerze, tym więcej pamięci będzie potrzebne.
• Dysk — SSD z 10 GB wolnego miejsca, jednak instalacja modyfikacji może wymagać więcej, dlatego radzimy zarezerwować 20 GB lub więcej.
• Sieć — stabilne połączenie z internetem i otwarty port UDP, by gracze mogli się połączyć. TCP nie nadaje się dla serwera Hytale. Gra używa protokołu QUIC przez UDP, więc samo otwarcie portu TCP nie wystarczy — do uruchomienia serwera potrzebny jest UDP.

Zwracamy uwagę, że obsługiwane są architektury „x64” i „arm64”. Nie zapomnij też sprawdzać obciążenia serwera, by ocenić, czy ma wystarczająco zasobów na daną liczbę graczy i ich działania. Do ustawienia limitów użyj w Javie parametru „-Xmx” bez cudzysłowu — -Xmx6G przydzieli 6 GB pamięci RAM. Podwyższone obciążenie procesora oznacza, że serwerowi brakuje pamięci operacyjnej.

Oprogramowanie

Wymagań dotyczących oprogramowania nie ma wiele, ale je również trzeba uwzględnić przy uruchamianiu serwera Hytale. Poniżej to, co jest tu istotne:

• Java 25 — aktualna wersja z zestawem deweloperskim JDK (Java Development Kit) oraz środowiskiem uruchomieniowym aplikacji Java JRE (Java Runtime Environment).
• Hytale musi być zainstalowana na serwerze.

Dalej przedstawiamy szczegółową instrukcję uruchomienia serwera Hytale.

Krok 1. Instalacja Java 25

Jak zainstalować Java 25 na Windows, Linux i macOS

• Pobierz Eclipse Temurin 25 z oficjalnej strony Adoptium pod podanym linkiem.
• Zainstaluj Javę.
• Otwórz terminal lub wiersz poleceń i sprawdź instalację komendą „java --version”. Wpisz ją bez cudzysłowu.

Jeśli wszystko zrobiono poprawnie, pojawi się następujący tekst:

• 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)

Krok 2. Pobranie plików serwera

Są dwa sposoby, by zdobyć pliki serwera:

• Ręczne skopiowanie z launchera — wygodne do testów, trudne w aktualizacji.
• Użycie Hytale Downloader — pasuje do dużych serwerów, łatwo się aktualizuje.

Poniżej szczegółowo opisujemy każdą z opcji.

Ręczne skopiowanie z launchera

Jeśli gracz ma już zainstalowaną grę Hytale, wystarczy wykonać kilka prostych czynności.

Przejdź do folderu, w którym zainstalowana jest gra.

Przykładowe ścieżki do folderu z grą:

• 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 archiwum „Assets.zip” do osobnego folderu serwera, np. pod ścieżkę „C:\HytaleServer\” na Windows albo „/home/youruser” na Linuksie.

Przykładowa struktura folderów powinna wyglądać tak:

• HytaleServer/

•   |— Server/
  

•       |— HytaleServer.jar
  

•   |— Assets.zip
  

Aby sprawdzić poprawność struktury, wpisz „ls” w terminalu lub wierszu poleceń. Wynik będzie następujący:

Directory: C:\Users…\Hytale\install\release\package\game\latest

Mode LastWriteTime Length Name

d----- 12/25/2025 9:25 PM Client

d----- 12/25/2025 9:25 PM Server

-a---- 12/25/2025 9:04 PM 3298097359 Assets.zip

Użycie Hytale Downloader

Alternatywnie można skorzystać z oficjalnego narzędzia Hytale Downloader CLI. Pozwala ono automatycznie pobrać potrzebne pliki i aktualizować je w razie potrzeby. Obsługuje także protokół autoryzacji OAuth2, który przyda się na serwerze z dużą liczbą graczy.

Pobierz Hytale Downloader dla Windows i Linux

Poniżej przydatne komendy wiersza poleceń:

• ./hytale-downloader — pobiera najnowszą wersję.
• ./hytale-downloader -print-version — pokazuje wersję gry bez pobierania.
• ./hytale-downloader -version — pokazuje wersję Hytale Downloader.
• ./hytale-downloader -check-update — sprawdza dostępność aktualizacji Hytale Downloader.
• ./hytale-downloader -download-path game.zip — pobiera dane do wskazanego pliku.
• ./hytale-downloader -patchline pre-release — pobiera wersję przedpremierową z kanału pre-release.
• ./hytale-downloader -skip-update-check — pomija automatyczne sprawdzanie aktualizacji.

Zwracamy uwagę, że szczegółowa instrukcja obsługi Hytale Downloader znajduje się w archiwum, w pliku „QUICKSTART.md”.

Krok 3. Uruchomienie serwera

W wierszu poleceń przejdź do folderu serwera komendą „cd” (wpisz ją bez cudzysłowu) i po spacji podaj lokalizację folderu z serwerem. Przykładowa komenda: „cd C:\HytaleServer\”. Następnie wpisz komendę:

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

Flaga „-XX:AOTCache” jest potrzebna, by przyspieszyć ładowanie serwera.

Krok 4. Uwierzytelnienie serwera

Po pierwszym uruchomieniu w konsoli pojawi się prośba o autoryzację przez przeglądarkę. Należy:

• Otworzyć wskazany link.
• Wpisać kod wyświetlony w konsoli.
• Poczekać, aż w konsoli pojawi się komunikat „Authentication successful”.

Tak to wygląda w konsoli:

• > /auth login device
• ===================================================================
• DEVICE AUTHORIZATION
• ===================================================================
• Visit: https://accounts.hytale.com/device
• Enter code: ABCD-1234
• Or visit: https://accounts.hytale.com/device?user_code=ABCD-1234
• ===================================================================
• Waiting for authorization (expires in 900 seconds)…
• [User completes authorization in browser]
• > Authentication successful! Mode: OAUTH_DEVICE

Aby zapobiec nadużyciom, na jedną licencję gry przypada maksymalnie 100 serwerów. Jeśli potrzebujesz więcej, trzeba będzie kupić grę ponownie.

Krok 5. Konfiguracja sieci i portów

Hytale domyślnie używa portu UDP 5520. Aby go otworzyć w Windows, wpisz komendę:

New‑NetFirewallRule ‑DisplayName “Hytale Server” ‑Direction Inbound ‑Protocol UDP ‑LocalPort 5520 ‑Action Allow

Aby go otworzyć w Linuksie (UFW), wpisz komendę:

• sudo ufw allow 5520/udp
• sudo ufw reload
• sudo ufw status

Komenda „reload” przeładuje port, a „status” sprawdzi jego stan. Aby go otworzyć w Linuksie (iptables), wpisz komendę:

sudo iptables -A INPUT -p udp --dport 5520 -j ACCEPT

Na macOS wystarczy zezwolić na wszystkie połączenia przychodzące i otworzyć port na routerze. Takie przekierowanie portu z routera na komputer jest konieczne, jeśli serwer ma być dostępny z internetu. W tym celu w ustawieniach routera podaje się UDP 5520 oraz IP serwera. Pamiętaj o tym szczególe — to on najczęściej powoduje błędy połączenia graczy z serwerami Hytale.

Krok 6. Podstawowe pliki i struktura serwera

Po uruchomieniu serwera pojawią się pliki i foldery:

• config.json — główne ustawienia serwera (każdy świat dostaje osobny plik konfiguracyjny).
• permissions.json — role i uprawnienia użytkowników.
• whitelist.json — lista dopuszczonych graczy.
• bans.json — zablokowani gracze.
• logs/ — folder z logami serwera.
• mods/ — folder na mody.
• universe/ — folder ze światami i danymi graczy.

Pamiętaj, że pod ścieżką „\universe\worlds\” leżą wszystkie światy Hytale — każdy z nich ma własny config.json. Przy okazji: pliki z rozszerzeniem „.json” można edytować dowolnym edytorem tekstu, np. Notatnikiem.

Konfiguracja świata

Podstawowy config świata, który można zmieniać ręcznie, by modyfikować spawn potworów, PvP, upływ czasu itd.:

• {

• "Version": 4,
  

• "UUID": {
  

•   "$binary": "j2x/idwTQpen24CDfH1+OQ==",
  

•   "$type": "04"
  

• },
  

• "Seed": 1767292261384,
  

• "WorldGen": {
  

•   "Type": "Hytale",
  

•   "Name": "Default"
  

• },
  

• "WorldMap": {
  

•   "Type": "WorldGen"
  

• },
  

• "ChunkStorage": {
  

•   "Type": "Hytale"
  

• },
  

• "ChunkConfig": {},
  

• "IsTicking": true,
  

• "IsBlockTicking": true,
  

• "IsPvpEnabled": false,
  

• "IsFallDamageEnabled": true,
  

• "IsGameTimePaused": false,
  

• "GameTime": "0001-01-01T08:26:59.761606129Z",
  

• "RequiredPlugins": {},
  

• "IsSpawningNPC": true,
  

• "IsSpawnMarkersEnabled": true,
  

• "IsAllNPCFrozen": false,
  

• "GameplayConfig": "Default",
  

• "IsCompassUpdating": true,
  

• "IsSavingPlayers": true,
  

• "IsSavingChunks": true,
  

• "IsUnloadingChunks": true,
  

• "IsObjectiveMarkersEnabled": true,
  

• "DeleteOnUniverseStart": false,
  

• "DeleteOnRemove": false,
  

• "ResourceStorage": {
  

•   "Type": "Hytale"
  

• },
  

• "Plugin": {}
  

• }

Mody

Serwery Hytale obsługują modyfikacje, tak samo jak zwykła gra. Aby je zainstalować, wykonaj następujące czynności:

• Pobierz mod ze sprawdzonego źródła, np. z CurseForge, w formacie „.zip” lub „.jar”.
• Umieść go w folderze serwera „mods”.
• Zrestartuj serwer.
• Sprawdź w logach, czy mod załadował się poprawnie.

Pluginy

Twórcy polecają kilka rodzajów pluginów (dla zaawansowanych użytkowników):

• Nitrado:WebServer — podstawowa opcja dla aplikacji webowych i API.
• Nitrado:Query — pokazuje informacje o stanie serwera przez HTTP.
• Nitrado:PerformanceSaver — ogranicza zasięg widzenia w zależności od użycia zasobów.
• ApexHosting:PrometheusExporter — wyświetla szczegółowe metryki serwera i JVM (Java Virtual Machine).

W razie potrzeby można dodać „–disable-sentry”, aby wyłączyć automatyczne wysyłanie raportów o błędach podczas pracy nad pluginami. Oto przykładowa komenda do wykonania tej czynności:

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

Optymalizacja serwera

Kilka porad dotyczących optymalizacji serwera:

• Zasięg renderowania — główna przyczyna wysokiego zużycia RAM. Przy braku pamięci zalecamy obniżyć ten parametr.
• Zarządzanie pamięcią Javy — wpisz w konsoli parametr „-Xmx” bez cudzysłowu, aby określić maksymalną ilość pamięci, np. dla 6 GB podaj „-Xmx6G”.

Przydatne porady i częste problemy

Trzy najczęstsze problemy z uruchomieniem własnego serwera Hytale:

• Nie da się połączyć — sprawdź port UDP 5520.
• Serwer się zawiesza — obniż zasięg renderowania albo zwiększ ilość pamięci RAM serwera.
• Nie da się przekierować portów — skorzystaj z Hamachi lub Radmin, by stworzyć wirtualną sieć lokalną (dla zaawansowanych użytkowników).

Podsumowanie

Stworzenie własnego serwera Hytale nie należy do najprostszych zadań, ale gdy wykonasz wszystkie czynności według instrukcji, staje się znacznie łatwiejsze i bardziej zrozumiałe. Trzymaj się każdego kroku oficjalnej instrukcji lub naszego poradnika — a otrzymasz wyczerpujące informacje potrzebne do konfiguracji serwera.