Hytale Chapter 1 update: how to update your server safely
Hytale Chapter I: Out of the Breach released October 12, 2026. Existing worlds upgrade on first load and can't be opened by an older server afterwards, so back up first. Then update your mods, keep the release patchline, update the server, and match every player's game version.
Hytale Chapter I: Out of the Breach released on Monday, October 12, 2026 at 10:00 AM ET. It works in existing Exploration saves as well as new worlds. Your server still needs updating, because players on Chapter 1 can't join a server on the old version.
Back up your world, check your mods, then update.
Back up before the first Chapter 1 start. Hypixel's Chapter I notes confirm existing worlds upgrade automatically the first time they load, and the modder-facing notes say an upgraded world can't be opened by an older server. A backup taken after that first load captures the already upgraded world.
What Chapter 1 changes for servers
| Question | Answer |
|---|---|
| Released | Monday, October 12, 2026, 10:00 AM ET (2:00 PM UTC) |
| World reset? | No. Works in existing Exploration saves and new worlds |
| World upgrade | Automatic on first load. An upgraded world can't be opened by an older server |
| Server update required? | Yes. The protocol version changed, so client and server must match |
| Plugins and mods | Much of the plugin API was removed or replaced. Plugins need Chapter 1 rebuilds |
| View distance | MaxViewRadius above 32 is clamped to 32, with a warning in Console |
| World events | Toggle per world with /worldevent. Off by default in Creative worlds |
| Portal commands | Use /portal instead of /fragment. /leave is now /portal leave |
| Self-hosted install folder | The server exits with code 11 if its data is inside the launcher's install folder |
| Patchline | Chapter 1 is on release |
| Minigames | Listed as arriving shortly after Chapter I |
For what's new in the game itself, read Hytale Chapter 1 is live.
Before you update
Take a backup while the server is stopped
Ask players to log off, stop the server, and create a backup. A backup taken while the server is stopped captures a complete save. Keep it until Chapter 1 has been running well on your world for a while. See Hytale backups and restore for what a complete backup contains.
Write down your mods
In Files, open mods/ and note each file name and version. Keep copies of the mod
configs. Then check each author's page for a Chapter 1 build. Plugins built for the previous
version need a rebuild. Removing a mod that adds blocks or items can affect saved builds, so
test removals on a copy first.
Agree on how your group continues
Keep the existing world, or start a fresh one for Chapter 1 and keep the old one backed up. Both work. Decide before you update so nobody plays on the wrong world.
Plan a maintenance window
Updating takes a few minutes to download and start, plus time to test. Tell your group when the server will be down and when to come back.
Update on berrybyte
Chapter 1 is on the release patchline.
Stop the server and take a final backup
Tell players you're starting maintenance, stop the server, and wait for the backup to finish.
Check Auto Update and the patchline
Open Settings → Game Settings. Turn on Auto Update and confirm Patchline is
release. Auto Update checks the selected patchline each time the server starts.
Update your mods
Replace each mod in mods/ with its Chapter 1 build. If a mod has no compatible build yet,
test the world without it on a copy before you remove it from your main world.
Start the server and watch Console
Start the server and wait until the download and startup finish. If Hytale asks for
authentication, complete Hytale Link. If Console
warns that MaxViewRadius was clamped, set it to 32 or lower in config.json. The server
doesn't change the value in the file.
Test with one player first
Update one player's game, then join by address. Check the world, inventories, and important mod features before inviting everyone.
Update a self-hosted server
The Hytale Server Manual
documents a built-in updater. It needs the official layout: Assets.zip and
start.sh or start.bat in the parent folder, and the server started from
Server/. Installs made with the Hytale Downloader or --bootstrap already
use this layout.
/update status Show the current version and update status
/update check Check for an update
/update download Download the update to updater/staging/
/update apply --confirm Back up files, then shut down with exit code 8The wrapper script sees exit code 8, applies the staged files, and starts the new version. Your config, saves, and mods are kept.
To make the updater back up the world as well, run the server with a backup
directory configured (--backup --backup-dir backups). The default wrapper
scripts already do this. RunBackupBeforeUpdate in config.json then takes a
full backup before applying.
Chapter 1 servers refuse to start if their data would land inside the Hytale launcher's install
folder, for example a server run straight from the launcher's Server folder. The check covers
the working directory and the --universe, --prefab-cache, and --backup-dir paths. The server
exits with code 11 and prints steps for moving the data. Move the server to its own folder.
--allow-install-dir skips the check, but Hypixel warns that it risks data loss.
If the server crashes right after an update, the wrapper script points you to updater/backup/,
which holds the previous server files. Those files don't undo the world upgrade, so restore your
pre-update world backup at the same time.
If something goes wrong
| Symptom | What to do |
|---|---|
| Players can't join after updating | Check every player and the server are on the same patchline and version. See can't connect |
| A mod fails to load | Find the mod name in Console, then remove it or install a Chapter 1 build |
| Hytale asks the server to authenticate again | Complete Hytale Link |
| Self-hosted server exits with code 11 | Move the server data out of the launcher's install folder |
Console warns about MaxViewRadius | Values above 32 are clamped. Set 32 or lower in config.json |
/leave isn't recognized | Use /portal leave. /portal also works in place of /fragment |
| The world looks wrong or won't load | Stop the server, keep the current files, and don't keep restarting |
Restoring a world backup doesn't change the server version, and a world saved by Chapter 1 can't be opened by an older server. Your pre-update backup is the only way back to the old build. On berrybyte, contact support with the time of your backup and the startup log, and we'll work out the safest way back with you.
Related guides
Frequently asked questions
When did Hytale Chapter 1 release?
Chapter I: Out of the Breach released on Monday, October 12, 2026 at 10:00 AM Eastern Time, on the release patchline. The Minigames are listed as arriving shortly after Chapter I.
Will Hytale Chapter 1 wipe my server's world?
No. Chapter I works in existing Exploration saves as well as new worlds. Existing worlds upgrade automatically the first time they load on Chapter 1, and an upgraded world can't be opened by an older server. Back up before that first load.
Do I have to update my Hytale server for Chapter 1?
Yes. Chapter 1 changed the protocol version, and Hytale clients and servers must run the same one. Players on Chapter 1 can't join a server still running the previous version.
Will my Hytale mods work after Chapter 1?
Only once each mod's author ships a Chapter 1 build. Update 7 removed or replaced a large part of the server plugin API, so plugins built for the previous version need rebuilding. Check each author's page, and test on a copy of your world before you update the server everyone plays on.
Can I roll a Hytale server back after updating to Chapter 1?
Only with both the old server files and a world backup taken before the update. A world saved by Chapter 1 can't be opened by an older server. On berrybyte, contact support before attempting a downgrade. Self-hosted servers keep the previous files in updater/backup/.
Why does my self-hosted Hytale server exit with code 11 after Chapter 1?
The server now refuses to start if its data would land inside the Hytale launcher's install folder. Move the server to its own folder and follow the steps it prints. The --allow-install-dir flag skips the check, but Hypixel warns that it risks data loss.