Hytale Server Manual Downloaden

Dieses Handbuch beschreibt Einrichtung, Konfiguration und Betrieb eines dedizierten Hytale-Servers.

Es basiert vollständig auf der offiziellen Dokumentation von Hypixel Studios und richtet sich sowohl an private Hosts als auch an professionelle Serverbetreiber.

Inhaltsverzeichnis

Server Setup
Java 25 installieren
Server-Dateien
Einen Hytale Server starten
Authentifizierung
Ports, Firewall & Netzwerk
Dateistruktur
Universum & Welten
Tipps & Tricks
Multiserver-Architektur
Sonstige Details
Zukünftige Erweiterungen

1. Server Setup

Ein Hytale-Server kann auf jedem System betrieben werden, das folgende Mindestanforderungen erfüllt:

Mindestens 4 GB RAM
Java 25
Unterstützte Architekturen:
- x64
- arm64

Ressourcenverbrauch

Der tatsächliche Ressourcenbedarf hängt stark vom Spielstil ab:

Ressource	Hauptverursacher
CPU	Viele Spieler, viele Entitäten (NPCs, Mobs)
RAM	Große geladene Weltbereiche, hohe Sichtweite

⚠️ Hinweis:
Ohne spezielle Analyse-Tools ist es schwer, den optimalen RAM-Wert zu bestimmen.
Experimentiere mit dem JVM-Parameter -Xmx, um ein sinnvolles RAM-Limit zu setzen.

Typisches Warnsignal für RAM-Mangel:
➡️ Stark erhöhte CPU-Last durch häufige Garbage-Collection.

2. Java 25 installieren

Für den Betrieb eines Hytale-Servers ist Java 25 zwingend erforderlich.

Empfehlung

Adoptium (Temurin Build)

Installation überprüfen

java --version

Erwartete Ausgabe (Beispiel):

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

3. Server-Dateien

Es gibt zwei Möglichkeiten, die Server-Dateien zu erhalten.

Option A: Manuell aus dem Launcher kopieren

Geeignet für: Schnelle Tests
Nachteil: Updates müssen manuell durchgeführt werden

Pfad je nach Betriebssystem:

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

Typischer Inhalt:

Client/
Server/
Assets.zip

➡️ Kopiere den Ordner Server/ und die Datei Assets.zip in dein Server-Verzeichnis.

Option B: Hytale Downloader CLI (empfohlen)

Geeignet für: Produktionsserver
Vorteil: Automatische Updates, OAuth-Authentifizierung

Der Downloader lädt Server- und Asset-Dateien automatisiert herunter.

Download: https://downloader.hytale.com/hytale-downloader.zip

Wichtige Befehle

Befehl	Beschreibung
`./hytale-downloader`	Neueste Version herunterladen
`-print-version`	Aktuelle Spielversion anzeigen
`-version`	Version des Downloaders
`-check-update`	Updateprüfung
`-download-path game.zip`	Zielpfad festlegen
`-patchline pre-release`	Pre-Release laden
`-skip-update-check`	Updateprüfung überspringen

4. Einen Hytale Server starten

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

HytaleServer.jar → Server-Executable
Assets.zip → Spielressourcen

5. Authentifizierung

Beim ersten Start muss der Server authentifiziert werden.

Beispiel:

/auth login device
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234

Nach erfolgreicher Anmeldung:

Authentication successful! Mode: OAUTH_DEVICE

Wichtige Hinweise

Jeder Hytale-Account darf maximal 100 Server betreiben
Für größere Netzwerke:
- Zusätzliche Lizenzen kaufen oder
- Server Provider Account beantragen
Für automatisierte Authentifizierung mehrerer Server:
➜ Server Provider Authentication Guide

6. Ports, Firewall & Netzwerk

Standard-Port

UDP 5520

Port ändern:

--bind 0.0.0.0:25565

Wichtig

Hytale nutzt QUIC über UDP, nicht TCP.

Firewall-Beispiele

Windows (PowerShell):

New-NetFirewallRule -DisplayName "Hytale Server" -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

NAT-Hinweise

UDP-Weiterleitung ist Pflicht
Symmetrisches NAT kann Probleme verursachen
Mobile Clients (Carrier-Grade NAT) funktionieren in der Regel problemlos

7. Dateistruktur

Pfad	Beschreibung
`.cache/`	Optimierte Cache-Dateien
`logs/`	Server-Logs
`mods/`	Mods & Plugins
`universe/`	Welten & Spielerdaten
`bans.json`	Gebannte Spieler
`config.json`	Server-Konfiguration
`permissions.json`	Rechte
`whitelist.json`	Whitelist

8. Universum & Welten

Alle Welten liegen unter:

universe/worlds/

Jede Welt besitzt eine eigene config.json, z. B.:

Seed
PvP
Fall Damage
NPC-Spawning
Chunk-Speicherung
Spielzeit
Plugin-Abhängigkeiten

🔧 Technisch wichtig:
Jede Welt läuft auf einem eigenen Main-Thread und nutzt parallel einen gemeinsamen Thread-Pool.

9. Tipps & Tricks

Mods installieren

.zip oder .jar in mods/ ablegen
Server neu starten

Sentry deaktivieren (wichtig für Entwickler)

--disable-sentry

➡️ Verhindert das Senden von Crash-Reports während Plugin-Entwicklung.

Ahead-Of-Time (AOT) Cache nutzen

Verbessert Startzeiten erheblich:

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

Empfohlene Plugins

Plugin	Zweck
Nitrado:WebServer	Web-APIs
Nitrado:Query	Serverstatus via HTTP
Nitrado:PerformanceSaver	Dynamische Sichtweite
Apex:PrometheusExporter	JVM & Server-Metriken

Sichtweite (View Distance)

Größter RAM-Verbrauchsfaktor
Empfehlung: max. 12 Chunks (384 Blöcke)

📊 Vergleich:

Minecraft: 10 Chunks ≈ 160 Blöcke
Hytale: 384 Blöcke ≈ 24 Minecraft-Chunks

➡️ Standardwert ist hoch – unbedingt anpassen!

10. Multiserver-Architektur

Hytale benötigt keinen Proxy wie BungeeCord.

Player Referral

Spieler werden aktiv an andere Server weitergeleitet.

⚠️ Payload kann manipuliert werden → HMAC-Signatur empfohlen

Connection Redirect

Server lehnt Verbindung ab und leitet Client automatisch weiter.

Use-Cases:

Load-Balancing
Lobby-Zwang
Regionale Server

Disconnect Fallback

Bei Abstürzen werden Spieler automatisch zu einem Fallback-Server verbunden.

➡️ Kommt kurz nach Early-Access

Eigene Proxies bauen

Netzwerk basiert vollständig auf QUIC
Packet-Definitionen in:
```
com.hypixel.hytale.protocol.packets
```

11. Sonstige Details

JVM-Argumente

-Xms, -Xmx zur RAM-Steuerung
Heap-Größe sauber limitieren

Protokoll-Versionen

Client & Server müssen exakt dieselbe Version nutzen
Zukunft: ±2 Versionen Toleranz geplant

Konfigurationsdateien

Werden beim Start geladen
Änderungen während Laufzeit können überschrieben werden

Maven-Artifact (Modding)

<dependency>
  <groupId>com.hypixel.hytale</groupId>
  <artifactId>Server</artifactId>
</dependency>

12. Zukünftige Erweiterungen

Server & Minigame Discovery

Ingame-Serverkatalog
Sichtbarkeit direkt im Hauptmenü
Verifizierte Spielerzahlen (Client-Telemetry)

Parties

Spieler bleiben über Serverwechsel hinweg zusammen
Party-Kompatibilität vor Join sichtbar

Integriertes Bezahlsystem

Zahlungen direkt im Client
Keine externen Shops nötig
Sicher & nachvollziehbar

SRV-Records

Noch nicht unterstützt
Technische Evaluierung läuft

First-Party APIs (geplant)

UUID ↔ Name
Version-Abfragen
Spielerprofile
Server-Telemetry
Reports
Payments

#server #download #manuel #dediziert #hytale