Wie man einen Hytale Server einrichtet

Deine vollständige Anleitung zum Erstellen, Konfigurieren und Betreiben eines dedizierten Hytale Servers.

Was du lernen wirst

Systemanforderungen und Java-Installation
Server-Dateien beschaffen und ausführen
Authentifizierung und Firewall-Konfiguration
Konfiguration und empfohlene Plugins

Systemanforderungen

Mindestanforderungen

  • 4GB RAM Minimum
  • Java 25 (wir empfehlen Adoptium)
  • x64 oder arm64 Architektur unterstützt

Ressourcentreiber

  • CPU: Hohe Spieler-/Entity-Anzahlen
  • RAM: Großer geladener Weltbereich, hohe Sichtweite

Tip: Überwache RAM- und CPU-Nutzung während der Server läuft. Die Ressourcennutzung hängt stark vom Spielerverhalten ab. Experimentiere mit Javas -Xmx Parameter um Speicherlimits festzulegen.

Schritt 1: Java 25 installieren

Java 25 herunterladen

Lade Java 25 von Adoptium herunter und installiere es (empfohlen).

Installation überprüfen

Führe diesen Befehl aus um zu bestätigen, dass Java installiert ist:

java --version

Erwartete Ausgabe:

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)

Schritt 2: Server-Dateien beschaffen

Es gibt zwei Möglichkeiten, die Server-Dateien zu beschaffen:

Option A: Vom Launcher kopieren

Am besten für schnelles Testen. Finde die Dateien in deinem Launcher-Installationsordner:

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

Kopiere den Server Ordner und Assets.zip in dein Server-Verzeichnis.

Empfohlen

Option B: Hytale Downloader CLI

Am besten für Produktionsserver. Einfach aktuell zu halten. Lade das CLI-Tool herunter und führe aus:

./hytale-downloader # Neueste Version herunterladen

./hytale-downloader -print-version # Version anzeigen

./hytale-downloader -check-update # Nach Updates suchen

Schritt 3: Server starten

Startbefehl

Starte den Server mit:

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

Das -XX:AOTCache Flag nutzt den vortrainierten AOT-Cache für schnellere Startzeiten.

Server authentifizieren

Nach dem ersten Start, authentifiziere deinen Server um Spielerverbindungen zu ermöglichen:

> /auth login device
===================================================================
DEVICE AUTHORIZATION
===================================================================
Visit: https://accounts.hytale.com/device
Enter code: ABCD-1234
===================================================================
Waiting for authorization...

[Complete authorization in browser]

> Authentication successful! Mode: OAUTH_DEVICE

Note: Es gibt ein Limit von 100 Servern pro Hytale-Spiellizenz.

Port ändern

Standardport ist 5520. Ändere ihn mit dem --bind Argument:

java -jar HytaleServer.jar --assets Assets.zip --bind 3500

Schritt 4: Firewall konfigurieren

Important: Hytale verwendet das QUIC-Protokoll über UDP (nicht TCP). Konfiguriere deine Firewall und Portweiterleitung nur für UDP.

Windows Firewall

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

Linux (ufw)

sudo ufw allow 5520/udp

Portweiterleitung

Wenn du hinter einem Router hostest, leite UDP Port 5520 (oder deinen benutzerdefinierten Port) an deinen Server-Rechner weiter. TCP-Weiterleitung ist nicht erforderlich.

Server-Dateistruktur

Verzeichnislayout

Verzeichnisse

  • .cache/ - Cache für optimierte Dateien
  • logs/ - Server-Logdateien
  • mods/ - Installierte Mods
  • universe/ - Welt- und Spieler-Speicherdaten

Konfigurationsdateien

  • config.json - Server-Konfiguration
  • permissions.json - Berechtigungskonfiguration
  • bans.json - Gebannte Spieler
  • whitelist.json - Whitelist-Spieler

Empfohlene Plugins

Installiere Mods, indem du .zip oder .jar Dateien herunterlädst und in den mods/ Ordner legst.

Nitrado:WebServer

Basis-Plugin für Web-Anwendungen und APIs.

Nitrado:Query

Macht Server-Status (Spielerzahlen, etc.) über HTTP verfügbar.

Nitrado:PerformanceSaver

Begrenzt Sichtweite dynamisch basierend auf Ressourcennutzung.

ApexHosting:PrometheusExporter

Macht detaillierte Server- und JVM-Metriken verfügbar.

Tipps & Tricks

Sichtweite

Sichtweite ist der Haupttreiber für RAM-Nutzung. Wir empfehlen, die maximale Sichtweite auf 12 Chunks (384 Blöcke) zu begrenzen, sowohl für Performance als auch Gameplay. Hytales Standard von 384 Blöcken entspricht ungefähr 24 Minecraft Chunks.

Automatische Backups

Aktiviere automatische Backups mit Kommandozeilen-Argumenten:

java -jar HytaleServer.jar --assets Assets.zip --backup --backup-frequency 30

Sentry deaktivieren (Entwicklung)

Bei der Plugin-Entwicklung, deaktiviere Sentry Crash-Reporting um zu vermeiden, dass deine Entwicklungsfehler übermittelt werden:

java -jar HytaleServer.jar --assets Assets.zip --disable-sentry

Befehlsreferenz

Zeige alle verfügbaren Argumente an:

java -jar HytaleServer.jar --help

Häufige Argumente

ArgumentBeschreibung
--assets <Path>Asset-Verzeichnis (Standard: ../HytaleAssets)
-b, --bind <Address>Adresse zum Lauschen (Standard: 0.0.0.0:5520)
--auth-modeAuthentifizierungsmodus: authenticated oder offline
--backupAutomatische Backups aktivieren
--backup-frequency <Int>Backup-Intervall in Minuten (Standard: 30)
--allow-opOperator-Befehle erlauben

Nächste Schritte

Tritt der Community bei

Sobald dein Server bereit ist, tritt diesen Servern in der Rangliste bei.