Grupa docelowa:
Administratorzy serwerów oraz gracze hostujący własne serwery dedykowane.

---

Spis treści

Sekcja	Tematy
Konfiguracja serwera	Instalacja Javy, pliki serwera, wymagania systemowe
Uruchamianie serwera Hytale	Komendy startowe, autoryzacja, porty, firewall, struktura plików
Wskazówki i triki	Mody, cache AOT, Sentry, polecane pluginy, dystans widzenia
Architektura multiserwerowa	Przekierowania graczy, fallbacki, proxy
Różne informacje	Argumenty JVM, aktualizacje protokołu, pliki konfiguracyjne
Przyszłe dodatki	Odkrywanie serwerów, party, płatności, rekordy SRV, API

---

Konfiguracja serwera

Serwer Hytale może działać na dowolnym urządzeniu posiadającym minimum 4 GB RAM oraz Java 25. Obsługiwane są architektury x64 oraz arm64.

Zalecamy monitorowanie zużycia RAM i CPU podczas działania serwera, aby poznać typowe zapotrzebowanie przy danej liczbie graczy i stylu rozgrywki – zużycie zasobów silnie zależy od zachowania graczy.

Ogólne wskazówki

Zasób	Co go obciąża
CPU	Duża liczba graczy lub encji (NPC, moby)
RAM	Duży załadowany obszar świata (wysoki view distance, eksploracja)

Uwaga:
Bez specjalistycznych narzędzi trudno dokładnie określić, ile pamięci RAM faktycznie potrzebuje proces Java. Testuj różne wartości parametru -Xmx. Typowym objawem braku pamięci jest wzrost użycia CPU spowodowany częstym garbage collection.

---

Instalacja Java 25

Zainstaluj Java 25. Rekomendujemy dystrybucję Adoptium (Temurin).

Sprawdzenie instalacji

java --version

Oczekiwany wynik:

openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8
OpenJDK 64-Bit Server VM Temurin-25.0.1+8

---

Pliki serwera

Dostępne są dwie metody pozyskania plików serwera:

1. Ręczne kopiowanie z launchera

Najlepsze do: szybkich testów (trudne w utrzymaniu aktualności)

Ścieżki instalacji:

• 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

Zawartość katalogu:

Client/
Server/
Assets.zip

Skopiuj folder Server oraz Assets.zip do docelowego katalogu serwera.

---

2. Hytale Downloader CLI

Najlepsze do: serwerów produkcyjnych (łatwe aktualizacje)

Narzędzie CLI do pobierania plików serwera i assetów z użyciem OAuth2.
Szczegóły w pliku QUICKSTART.md.

Dostępne dla Linux i Windows.

Przykładowe komendy

Komenda	Opis
./hytale-downloader	Pobiera najnowszą wersję
-print-version	Wyświetla wersję gry
-check-update	Sprawdza aktualizacje
-patchline pre-release	Pobiera wersję pre-release

---

Uruchamianie serwera Hytale

java -jar HytaleServer.jar --assets PathToAssets.zip

---

Autoryzacja serwera

Przy pierwszym uruchomieniu należy uwierzytelnić serwer:

/auth login device

Otwórz stronę, wpisz kod i zatwierdź w przeglądarce.
Po pomyślnej autoryzacji serwer może przyjmować graczy.

Dodatkowe informacje

• Maksymalnie 100 serwerów na jedną licencję Hytale
• Dla większej skali wymagane są dodatkowe licencje lub konto Server Provider

---

Porty i sieć

• Domyślny port: 5520
• Protokół: QUIC (UDP, nie TCP)

Zmiana portu:

--bind 0.0.0.0:25565

Firewall

Windows:

New-NetFirewallRule -DisplayName "Hytale Server" -Direction Inbound -Protocol UDP -LocalPort 5520 -Action Allow

Linux (ufw):

sudo ufw allow 5520/udp

---

Struktura plików

Ścieżka	Opis
.cache/	Cache zoptymalizowanych plików
logs/	Logi serwera
mods/	Mody
universe/	Światy i dane graczy
config.json	Konfiguracja serwera
permissions.json	Uprawnienia
whitelist.json	Whitelist

Każdy świat działa na własnym wątku głównym, a zadania równoległe trafiają do wspólnej puli wątków.

---

Wskazówki i triki

Instalacja modów

Pobierz mody (.zip / .jar) i umieść je w folderze mods/.

Wyłączenie Sentry

Podczas tworzenia pluginów zalecane:

--disable-sentry

Cache AOT (Ahead-Of-Time)

Przyspiesza start serwera:

-XX:AOTCache=HytaleServer.aot

Zalecany dystans widzenia

• Maksymalnie 12 chunków (384 bloki)
• Domyślny Hytale = ~24 chunki Minecrafta
• Większy dystans = znacznie większe zużycie RAM

---

Architektura multiserwerowa

Hytale nie wymaga proxy typu BungeeCord.

Przekierowanie gracza

Serwer może odesłać gracza na inny serwer wraz z danymi sesji.

⚠️ Uwaga bezpieczeństwa:
Payload przechodzi przez klienta – należy go podpisywać kryptograficznie (np. HMAC).

---

Różne informacje

Aktualizacje protokołu

• Klient i serwer muszą mieć identyczną wersję protokołu
• W przyszłości: tolerancja ±2 wersje

Pliki konfiguracyjne

• Odczytywane przy starcie
• Zmiany podczas działania mogą zostać nadpisane

---

Przyszłe funkcje

Odkrywanie serwerów

Katalog serwerów dostępny z menu głównego gry.

Party

System drużyn pozwalający graczom poruszać się razem między serwerami.

Zintegrowane płatności

• Bez zewnętrznych stron
• Bezpieczne i śledzalne transakcje

Rekordy SRV

• Na razie nieobsługiwane
• W trakcie analizy

Oficjalne API

Planowane endpointy m.in.:
płatności
UUID ↔ nick
wersja gry
profil gracza
telemetryka serwera