Hytale liefert einen offiziellen Dedicated Server als HytaleServer.jar (Java 25, mindestens 4 GB Speicher, UDP 5520 über QUIC), der mit einem Hytale-Konto authentifiziert werden muss. Da sich das Spiel im Early Access befindet, prüfen Sie das offizielle Hytale-Support-Handbuch; die Angaben unten gleichen Support und Hoster-Anleitungen ab.
Installation Schritt für Schritt
Prüfen Sie die Maschine: Java 25 (x64/arm64), 4 GB RAM min..
Beschaffen Sie die Serverdateien: den Ordner Server (mit HytaleServer.jar) und Assets.zip aus der Spielinstallation oder über den offiziellen Hytale Downloader (Code-Login).
Installieren Sie Java 25 und prüfen Sie mit java -version.
Starten Sie java -jar HytaleServer.jar --assets Assets.zip; config.json, logs/ und universe/ entstehen beim ersten Start.
Führen Sie in der Konsole /auth login device aus, bestätigen Sie den Code auf accounts.hytale.com/device und dann /auth persistence Encrypted.
Bearbeiten Sie config.json bei gestopptem Server (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius).
Öffnen Sie die Ports 5520/UDP in Firewall und Router.
Treten Sie mit der oben in der Konsole angezeigten Adresse bei (IP:5520); DNS-SRV-Einträge werden noch nicht unterstützt, nutzen Sie einen A-Record.
Richten Sie den Autostart ein (geplante Aufgabe oder systemd-Dienst).
Planen Sie Backups von universe/ und Updates.
Voraussetzungen
- Java 25 (x64 oder arm64); mindestens 4 GB Speicher, die Sichtweite (MaxViewRadius, empfohlen höchstens 12 Chunks) bestimmt den RAM-Bedarf
- Ein Hytale-Konto mit dem Spiel; eine Lizenz ist auf 500 Server begrenzt
- Client und Server müssen dieselbe Protokollversion nutzen
Lokale Installation (Windows)
Legen Sie einen Ordner an (z. B. C:\HytaleServer), kopieren Sie den Ordner Server und Assets.zip aus %appdata%\Hytale\install\release\package\game\latest und starten Sie den Befehl. Ein Server auf demselben PC wie das Spiel braucht insgesamt mindestens 16 GB RAM.
cd C:\HytaleServer
java -Xms4G -Xmx4G -jar HytaleServer.jar --assets Assets.zipInstallation auf Linux-VPS / dediziertem Server
Unter Ubuntu/Debian: ein Nicht-Root-Benutzer, Java 25 (z. B. Eclipse Temurin 25), dann der Hytale Downloader zum Laden des Servers (Code-Login, Token in .hytale-downloader-credentials.json; bei Authentifizierungsfehlern diese Datei löschen). Die genauen Downloader-Optionen sind hier nicht aufgeführt: lesen Sie dessen Hilfe.
sudo adduser --disabled-password --gecos "" hytale
sudo -iu hytale
mkdir -p ~/hytale-server && cd ~/hytale-server
java -version # doit afficher 25 / must show 25
java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zipZu öffnende Ports
- 5520/UDP: Standard-Spielport (QUIC), mit --bind änderbar; kein TCP nötig
Linux-Firewall (ufw)
Unter Ubuntu/Debian erlauben Sie zuerst SSH, um sich nicht auszusperren, dann die Spielports.
sudo ufw allow OpenSSH
sudo ufw allow 5520/udp
sudo ufw enable
sudo ufw statusWindows-Firewall (netsh)
In einer PowerShell mit Administratorrechten (oder Administrator-„cmd“):
netsh advfirewall firewall add rule name="Hytale 5520/UDP" dir=in action=allow protocol=UDP localport=5520Provider-Firewall und Portweiterleitung (NAT)
Steht der Server bei einem Provider (OVH, Hetzner, Scaleway …), öffnen Sie dieselben Ports in dessen Netzwerk-Firewall („Security Group“). Beim Heimbetrieb leiten Sie die Ports (NAT) vom Router auf die feste lokale IP des Rechners weiter. Testen Sie von außen (Mobilfunk oder ein Freund): Ein Test aus dem eigenen Netz beweist nichts.
Autostart und Überwachung
Legen Sie /etc/systemd/system/<name>.service an und führen Sie aus: sudo systemctl daemon-reload && sudo systemctl enable --now <name>. Logs: journalctl -u <name> -f.
[Unit]
Description=Hytale server
After=network-online.target
Wants=network-online.target
[Service]
User=hytale
WorkingDirectory=/home/hytale/hytale-server
ExecStart=/usr/bin/java -Xms4G -Xmx4G -jar Server/HytaleServer.jar --assets Assets.zip
Restart=on-failure
RestartSec=15
[Install]
WantedBy=multi-user.targetAutostart unter Windows (geplante Aufgabe)
Erstellen Sie eine geplante Aufgabe „Beim Systemstart“, die das Startskript ausführt, mit höchsten Rechten und „Unabhängig von der Benutzeranmeldung ausführen“.
Updates, Backups und Neustarts
Stoppen Sie den Server, führen Sie Hytale Downloader erneut aus und starten Sie neu. Sichern Sie universe/ vor größeren Updates. Der Server prüft bei jedem Start auf eine neue Version: meist genügt ein Neustart. Sichern Sie vor einem Patchline-Wechsel (release/pre-release): Welten einer Vorabversion lassen sich evtl. in älteren Builds nicht öffnen.
# backup
tar czf ~/backup-$(date +%F).tar.gz -C ~/server universe/Server eintragen und finden
Sobald der Server öffentlich ist, tragen Sie ihn auf https://game-rank.com/jeux/hytale ein (Seite des Betreibers dieses Tools), damit Spieler ihn finden, verfolgen und dafür abstimmen können.
Fehlerbehebung
- Von außen nicht erreichbar, aber lokal OK: Es fehlt die System-Firewall-Regel, die Provider-Firewall oder die NAT-Weiterleitung, oder das Protokoll (UDP/TCP) stimmt nicht. Prüfen Sie jede Ebene einzeln.
- Verbindung nach einem Spiel-Update abgelehnt: Client und Server müssen dieselbe Version haben. Server erneut aktualisieren und neu starten.
- Der Server beendet sich sofort: Starten Sie ihn in einer Konsole, um den Fehler zu lesen, und prüfen Sie freien RAM, Speicherplatz und Software-Voraussetzungen.
- „Authentifizierung erforderlich“ oder Login nach Neustart weg: /auth login device wiederholen und /auth persistence prüfen (Memory = geht beim Neustart verloren; Encrypted wählen).
- Speichermangel oder Lag: Senken Sie MaxViewRadius (/maxviewradius <Radius>), bevor Sie RAM erhöhen.
Häufige Fragen
- Hat Hytale einen offiziellen Dedicated Server?
- Ja: HytaleServer.jar, vom Hytale-Support dokumentiert. Das Spiel ist im Early Access, Optionen und Formate (config.json …) können sich ändern.
- Warum kein config.json-Generator?
- Nur wenige Felder (ServerName, MOTD, Password, MaxPlayers, MaxViewRadius, Backups) sind von Dritten dokumentiert, ohne offizielles Schema: Wir erfinden keines. Bearbeiten Sie die erzeugte Datei bei gestopptem Server.
- Was soll ich sichern?
- Den Ordner universe/ (Welten und Spielerdaten) sowie config.json und permissions.json.
- Geht es ohne Konto (Offline-Modus)?
- Anleitungen erwähnen --auth-mode offline für die Entwicklung; für öffentliche Server ist das nicht der normale Weg. Mit --help prüfen.
