Hytale Server List Background

Instrukcja Serwera Hytale

Kompletny przewodnik po konfiguracji, instalacji i zarządzaniu dedykowanym serwerem Hytale.

Odbiorcy: Administratorzy serwerów i gracze hostujący serwery dedykowane.

Spis Treści

Konfiguracja Serwera
Uruchamianie Serwera
Wskazówki i Triki
Architektura Wieloserwerowa
Inne Szczegóły
Przyszłe Dodatki

Wstęp

Ten artykuł obejmuje konfigurację, instalację i obsługę dedykowanych serwerów Hytale. Jest przeznaczony dla administratorów serwerów i graczy chcących hostować własne światy.

Konfiguracja Serwera

Serwer Hytale może działać na dowolnym urządzeniu z co najmniej 4GB pamięci RAM i zainstalowaną Javą 25. Obsługiwane są architektury x64 oraz arm64.

ZasóbZależność
CPUWysoka liczba graczy lub jednostek (NPC, moby)
RAMDuży obszar załadowanego świata (wysoki zasięg widzenia, niezależna eksploracja)

Note: Bez specjalistycznych narzędzi trudno określić, ile RAMu faktycznie potrzebuje proces Java. Eksperymentuj z parametrem `-Xmx` Javy. Typowym objawem braku pamięci jest zwiększone zużycie CPU przez Garbage Collection.

Instalacja Java 25

Zainstaluj Java 25. Zalecamy Adoptium.

Sprawdź instalację

java --version
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 Serwerowe

1. Kopiuj z Launchera

Dobre do testów. Uciążliwe przy aktualizacjach.

%appdata%\\Hytale\\install\\release\\package\\game\\latest

Skopiuj folder `Server` i `Assets.zip`.

2. Hytale Downloader CLI

Zalecane na produkcję. Łatwe aktualizacje.

Pobierz CLI

Uruchamianie Serwera

Komenda Startowa

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

Uwierzytelnianie

> /auth login device

DEVICE AUTHORIZATION

Visit: https://accounts.hytale.com/device

Enter code: ABCD-1234

> Authentication successful!

Wymagane, aby serwer mógł komunikować się z API Hytale. Limit 100 serwerów na licencję.

Konfiguracja Sieci

  • Port5520 UDP
  • ProtocolQUIC
Pamiętaj: Tylko UDP. TCP nie jest wymagane.

Firewall

# Windows PowerShell

New-NetFirewallRule ... -Protocol UDP -LocalPort 5520 ...

# Linux (ufw)

sudo ufw allow 5520/udp

Struktura Plików

config.jsonKonfiguracja serwera
universe/Światy i dane graczy
mods/Zainstalowane Mody
logs/Logi systemowe
whitelist.jsonLista dostępu
permissions.jsonUprawnienia

Wskazówki i Triki

Mods & Plugins

Pobieraj mody z CurseForge i wrzucaj do folderu `mods/`.

Polecane Pluginy

AOT Cachejava -XX:AOTCache=HytaleServer.aot ...

Przyspiesza uruchamianie serwera.

Zasięg Widzenia (View Distance)

Zalecane: 12 chunks (384 blocks).

Domyślne ustawienie Hytale (384) to ~24 chunki Minecrafta. Ogranicz, aby zaoszczędzić RAM.

Architektura Wieloserwerowa

Hytale posiada wbudowane mechanizmy przekierowywania graczy między serwerami. Proxy typu BungeeCord nie jest wymagane.

Przekierowania (Player Referral)

Przenosi podłączonego gracza na inny serwer. Klient otwiera nowe połączenie.

WARNING: Podpisuj payload kryptograficznie, aby zapobiec manipulacji.

Fallback przy rozłączeniu

Gdy serwer upadnie, klient automatycznie łączy się z serwerem zapasowym zamiast wracać do menu.

Soon

Inne Szczegóły

  • JVM ArgumentsUżyj standardowych flag jak -Xmx do kontroli pamięci.
  • Protocol UpdatesWiersja protokołu musi się zgadzać. W przyszłości tolerancja ±2 wersji.
  • Maven Artifactscom.hypixel.hytale:Server

Przyszłe Dodatki

  • Server Discovery: Katalog serwerów w grze z weryfikacją liczby graczy.
  • Parties: Grupowe dołączanie do serwerów.
  • Payments: Wbudowana bramka płatności.
  • API: Oficjalne endpointy do danych graczy i telemetrii.
Źródło: Oficjalna Dokumentacja Hytale