Seit dem Start von Chapter I (Update 7) am 12. Oktober 2026 haben sich alle Spiele-Clients automatisch aktualisiert, Ihr Server aber nicht: Solange er auf Update 6 läuft, kann niemand mehr beitreten. Gleichzeitig ist es das heikelste Update seit Beginn des Early Access, denn es konvertiert Ihre Welt ohne Rückweg und macht viele Mods unbrauchbar. Hier ist die Schritt-für-Schritt-Anleitung, geprüft mit Version 0.7.2, um einen bestehenden Server zu aktualisieren, ohne etwas zu verlieren.
Was Chapter I für einen bestehenden Server ändert
Wenn Sie bei null anfangen, erklärt unser Leitfaden zum Erstellen eines Hytale-Servers die komplette Installation. Hier geht es um einen Server, der bereits auf Update 6 läuft. Laut den offiziellen Patchnotes von Hypixel Studios betreffen Sie diese Änderungen direkt:
| Änderung | Folge für Sie |
|---|---|
| Neue Version des Netzwerkprotokolls | Ein aktueller Client kann keinem Server auf Update 6 beitreten und umgekehrt. |
| Neues Speicherformat für Blockabschnitte | Welten werden beim ersten Laden konvertiert. Sie brauchen weniger Speicherplatz, lassen sich aber nicht mehr mit einer älteren Version öffnen. |
| Viele Methoden der Modding-API entfernt oder ersetzt | Für Update 6 kompilierte .jar-Mods können den Serverstart verhindern. |
| Umbenannte Assets, neues Format für einige Audiofelder | Inhaltspakete, die die alten Namen verwenden, laden möglicherweise nicht mehr. |
| Prüfung des Launcher-Installationsordners | Der Server beendet sich mit Code 11, wenn Arbeitsverzeichnis, Welt oder Backups im Installationsordner des Launchers liegen. |
MaxViewRadius auf 32 begrenzt | Werte außerhalb von 1 bis 32 werden mit einer Warnung angepasst, statt den Start zu blockieren. |
| Umbenannte Befehle | /fragment wird zu /portal, /leave zu /portal leave und /cursethis zu /ephemeral. |
Welche Version: mindestens 0.7.2
Bleiben Sie nicht bei der Launch-Version 0.7.0 stehen. Zwei Hotfixes sind gefolgt, und beide sind für Server wichtig:
- 0.7.1 (13. Oktober): Verbindungen zu einer unter Windows gehosteten Welt laufen nicht mehr nach 30 Sekunden ab, und ein Spieler, dessen IP-Adresse sich während der Sitzung ändert, kann sich wieder verbinden, ohne als „bereits angemeldet“ abgewiesen zu werden.
- 0.7.2 (14. Oktober): behebt einen Absturz, der alle Spieler einer Welt trennte, sobald ein Höhlen-Chunk ein altes, unter Update 6 entstandenes Goblin-Spawn-Signal lud. Genau das betrifft konvertierte Welten. Außerdem behebt 0.7.2 einen Absturz unter Linux in Welten mit RocksDB-Chunk-Speicher.
Zum Zeitpunkt des Schreibens ist 0.7.2 der neueste Hotfix für Chapter I. Prüfen Sie vor dem Start die verfügbare Version mit /update check oder ./hytale-downloader -print-version.
Schritt 1: Wartung planen
Informieren Sie Ihre Spieler und planen Sie etwa eine Stunde für Backup, ersten Start und Tests ein. Notieren Sie dann in der Konsole Ihre aktuelle Version:
/update statusErstellen Sie zum Schluss eine Liste des Ordners mods/: Dateiname und Version jedes Mods und ob der Autor bereits eine Chapter-I-Version veröffentlicht hat. Diese Liste brauchen Sie in Schritt 3 und beim Wiedereinsetzen der Mods.
Schritt 2: die Welt sichern, Ihre einzige echte Absicherung
Der Ordner universe/ enthält Ihre Welten und die Spielerdaten. Da die Konvertierung nur in eine Richtung funktioniert, ist eine Kopie vor dem ersten Start unter 0.7.x Ihr einziger Weg zurück. Stoppen Sie den Server sauber mit /stop und archivieren Sie Welt, Konfigurationsdateien und Mods, am besten außerhalb des Serverordners:
# Linux, im Ordner Server/
tar -czf ~/hytale-update6-$(date +%F).tar.gz universe mods config.json permissions.json whitelist.json bans.json# Windows (PowerShell), im Ordner Server\
Compress-Archive -Path universe, mods, config.json, permissions.json, whitelist.json, bans.json -DestinationPath ..\hytale-update6.zipPrüfen Sie, dass das Archiv nicht leer ist und ungefähr so groß ist wie universe/. Fehlt bei Ihnen eine der genannten Dateien, entfernen Sie sie einfach aus dem Befehl.
Das eingebaute Update-System kann vor dem Anwenden einer neuen Version über die Option RunBackupBeforeUpdate ebenfalls ein vollständiges Backup anlegen, allerdings nur, wenn ein Backup-Ordner konfiguriert ist (--backup-dir). Betrachten Sie das als zusätzliches Netz, nicht als einzige Kopie.
Schritt 3: Mods beiseitelegen
Chapter I hat eine lange Liste von Methoden entfernt oder ersetzt, mit denen Mods auf Chunks, Blöcke und Welten zugreifen. Ein Mod, der eine nicht mehr vorhandene Methode aufruft, kann beim Laden scheitern oder sogar den ganzen Serverstart verhindern. Für ein vorhersehbares Update starten Sie die neue Version zunächst ganz ohne Mods:
mkdir mods-update6
mv mods/* mods-update6/Unter Windows verschieben Sie den Inhalt von mods einfach im Explorer in einen Ordner mods-update6.
Vorsicht bei Mods, die Blöcke oder Gegenstände hinzufügen. Lädt Ihre echte Welt ohne sie, können diese Blöcke verschwinden oder ersetzt werden. Machen Sie den ersten Start ohne Mods dann mit einer Kopie der Welt und öffnen Sie die Hauptwelt erst, wenn die Chapter-I-Versionen dieser Mods installiert sind.
Schritt 4: die neue Version installieren
Methode 1: der eingebaute Befehl /update
Das ist die offizielle Methode, sofern Ihr Server dem von Hypixel vorgesehenen Aufbau folgt: ein übergeordneter Ordner mit Assets.zip und dem Skript start.sh oder start.bat, und der Server läuft aus dem Unterordner Server/. Ohne diesen Aufbau deaktiviert sich das Update-System. Außerdem muss der Server mit /auth login device authentifiziert sein.
/update check # nach einer neuen Version suchen
/update download # nach updater/staging/ herunterladen
/update apply --confirm # sichern, dann Server beenden (Code 8)Der Server startet sich nicht selbst neu. Er beendet sich mit Exit-Code 8, und das Skript start.sh oder start.bat erkennt diesen Code, kopiert die neuen Dateien (HytaleServer.jar, Assets.zip und die Skripte), behält dabei Konfiguration, Welten und Mods und startet den Server neu. Starten Sie java direkt oder über einen Dienst ohne diese Skripte, endet das Update an dieser Stelle. Sie haben Ihre Dateien von Hand kopiert und keine Skripte? /update setup legt sie im übergeordneten Ordner an.
Wenn Sie es sich vor dem Anwenden anders überlegen, löscht /update cancel das heruntergeladene Update.
Methode 2: Hytale Downloader
Auf einem VPS ist das offizielle Kommandozeilen-Tool die berechenbarste Methode. Aktualisieren Sie zuerst das Tool selbst und laden Sie dann die neue Version in einen temporären Ordner:
./hytale-downloader -check-update # das Tool bei Bedarf aktualisieren
./hytale-downloader -print-version # verfügbare Version anzeigen
./hytale-downloader -download-path hytale-0.7.2.zip
unzip hytale-0.7.2.zip -d neue-versionKopieren Sie anschließend nur die Spieldateien an ihren Platz: Server/HytaleServer.jar (und HytaleServer.aot, falls vorhanden), Assets.zip sowie start.sh und start.bat. Überschreiben Sie niemals config.json, universe/ oder mods/ mit denen aus dem Archiv.
Methode 3: bei einem Hoster
Im Panel eines Hosters läuft das Update meist über eine Neuinstallation der Version oder eine eigene Schaltfläche. Erstellen Sie trotzdem das Backup aus Schritt 2 und laden Sie es auf Ihren eigenen Rechner herunter, bevor Sie beginnen.
Schritt 5: erster Start und Konvertierung der Welt
Starten Sie den Server und beobachten Sie die Konsole. Beim ersten Laden wird jede Welt in das neue Format konvertiert, was den Start bei großen Welten verlängern kann: Brechen Sie ihn nicht ab. Prüfen Sie danach:
- ob
/update statusdie neue Version anzeigt; - ob der Ordner
logs/keine Fehler enthält; - ob eine Warnung zu
MaxViewRadiuserscheint: In diesem Fall den Server stoppen und den Wert inconfig.jsonauf höchstens 32 setzen; - ob ein erster Spieler mit aktuellem Spiel beitreten kann, bevor Sie den Server für alle öffnen.
Beendet sich der Server sofort mit Code 11, liegen seine Daten im Installationsordner des Launchers: Verschieben Sie den Serverordner an einen anderen Ort. Die Option --allow-install-dir erzwingt den Start trotzdem, laut Hypixel jedoch mit dem Risiko von Datenverlust.
Passen Sie außerdem geplante Aufgaben und Admin-Skripte an, die noch /fragment, /leave oder /cursethis verwenden.
Schritt 6: Mods einzeln wieder hinzufügen
Holen Sie für jeden Mod auf Ihrer Liste die vom Autor als Chapter-I-kompatibel angegebene Version, legen Sie sie in mods/, starten Sie neu und lesen Sie die Logs. Immer nur ein Mod auf einmal: Startet der Server nicht, wissen Sie sofort, welcher schuld ist. Ein Mod ohne kompatible Version bleibt in mods-update6/, bis sein Autor ihn aktualisiert.
Häufige Fehler nach dem Update
| Symptom | Ursache | Lösung |
|---|---|---|
| Alle Spieler werden mit einer Meldung zu unterschiedlichen Versionen abgewiesen | Der Server läuft noch auf Update 6 | Server aktualisieren und neu starten |
| Nur ein Spieler wird abgewiesen | Sein Spiel ist veraltet oder er nutzt einen anderen Kanal (Pre-Release) | Launcher neu starten, Kanal release prüfen |
| Der Server beendet sich mit Code 8 | Normales Verhalten bei einem Update | Server mit start.sh oder start.bat starten |
| Der Server beendet sich mit Code 11 | Daten im Launcher-Ordner | Server in einen eigenen Ordner verschieben |
| Ein Mod lädt nicht | Mod für Update 6 kompiliert | Entfernen und auf eine Chapter-I-Version warten |
| Alle werden beim Erkunden von Höhlen getrennt | Altes Goblin-Spawn-Signal (behoben in 0.7.2) | 0.7.2 installieren |
| Eine Welt stürzt unter Linux ab | RocksDB-Chunk-Speicher (behoben in 0.7.2) | 0.7.2 installieren |
| Verbindungen brechen auf einem Windows-Server nach 30 Sekunden ab | Fehler behoben in 0.7.1 | 0.7.2 installieren |
/leave funktioniert nicht mehr | Befehl umbenannt | /portal leave verwenden |
Zurückrollen, wenn etwas schiefgeht
Nach einem Update über /update werden die bisherigen Serverdateien in updater/backup/ aufbewahrt. Das offizielle Skript beschreibt das Vorgehen: Server/ und Assets.zip löschen und die Dateien aus dem Backup-Ordner zurückverschieben. Diese Dateien enthalten nicht Ihre alte Welt: Da sie konvertiert wurde, müssen Sie auch universe/ durch die Kopie aus Schritt 2 ersetzen.
Bedenken Sie: Ein auf Update 6 zurückgesetzter Server nimmt keine Spieler an, deren Spiel bereits auf Chapter I läuft. Das Zurückrollen dient vor allem dazu, eine intakte Welt zu retten, nicht dazu, auf der alten Version weiterzuspielen. Meist ist es am besten, das Backup wiederherzustellen, den fehlerhaften Mod zu entfernen und das Update erneut durchzuführen.
Künftige Updates automatisieren
Solange Client und Server exakt dieselbe Protokollversion brauchen, müssen Sie bei jeder neuen Version schnell aktualisieren. Hypixel hat eine Toleranz von zwei Versionen zwischen Client und Server angekündigt, die aber noch nicht verfügbar ist. Bis dahin kann der Abschnitt Update in config.json die Arbeit übernehmen:
"Update": {
"Enabled": true,
"CheckIntervalSeconds": 3600,
"RunBackupBeforeUpdate": true,
"BackupConfigBeforeUpdate": true,
"AutoApplyMode": "WhenEmpty",
"AutoApplyDelayMinutes": 30
}Mit WhenEmpty wird das Update angewendet, sobald niemand mehr online ist. Scheduled wendet es nach der eingestellten Wartezeit an, auch wenn Spieler online sind, und warnt sie vorher. Der Standardwert Disabled wartet auf Ihr /update apply --confirm. Auf einem Server mit vielen Mods sollten Sie beim manuellen Modus bleiben: Ein automatisches Update könnte den Server mit nicht mehr funktionierenden Mods neu starten. Um das Update-System komplett abzuschalten, setzen Sie die Umgebungsvariable HYTALE_DISABLE_UPDATES.
Entspannte Updates beim Hoster
Bei OuiHeberg enthält jedes Hytale-taugliche OuiBox-Paket Backups, die Sie vor einem Update anlegen können: 5 beim OuiBox 8G für 9,98 € pro Monat, 10 beim OuiBox 12G für 16,79 € pro Monat und 15 beim OuiBox 16G für 21,59 € pro Monat. Backup im Panel anlegen, aktualisieren und bei Problemen wiederherstellen, ganz ohne Kommandozeile.
Häufige Fragen
Verliere ich meine Welt beim Wechsel auf Chapter I?
Nein. Die Welt wird automatisch konvertiert und behält Ihre Bauten. Die Konvertierung ist allerdings endgültig: Ohne eine Kopie von vor dem Update gibt es keinen Weg zurück zu Update 6.
Warum können meine Freunde seit dem 12. Oktober nicht mehr beitreten?
Ihr Spiel ist auf Chapter I umgestiegen, Ihr Server läuft noch auf Update 6. Beide müssen exakt dieselbe Protokollversion nutzen, also aktualisieren Sie den Server.
Funktionieren meine Mods noch mit Update 7?
Nicht unbedingt. Ein großer Teil der von Mods genutzten API hat sich geändert. Sicher sind nur Mods, die ihr Autor für Chapter I neu kompiliert hat.
Muss ich den Server nach dem Update neu authentifizieren?
Normalerweise nicht, da die Authentifizierungsdateien im Ordner Server/ bleiben. Falls der Server danach fragt, führen Sie erneut /auth login device aus: Seit Chapter I funktioniert das auch bei bereits aktiver Sitzung.
Wie finde ich die Version meines Servers heraus?
Geben Sie /update status in der Konsole ein. Für die neueste verfügbare Version nutzen Sie /update check oder ./hytale-downloader -print-version.