Hytale server optimization

The best settings for your Hytale server

Three knobs decide almost everything: view distance, player count and the mods you run. The rest is measuring.

Start with MaxViewRadius in config.json. In the server manual Hypixel Studios recommends at most 12 chunks (384 blocks), and view distance is what eats the most memory on a Hytale server. If memory fills up, go down in steps.

Set MaxPlayers to what you actually expect, remove the mods nobody uses and update the server as soon as Hytale ships an update. Still stuttering? Check whether the CPU or the memory is full before you buy anything.

How do you set up a Hytale server properly?

In this order. Every step can be checked in the console or in your panel's statistics.

  1. Keep MaxViewRadius at 12 or lower

    The setting lives in config.json next to HytaleServer.jar. The manual recommends at most 12 chunks; since Update 7 the server accepts values from 1 to 32. If memory fills up, go down in steps of two. Seeing twice as far means four times as many chunks.

  2. Make MaxPlayers honest

    A limit of 100 on a server for eight friends costs nothing as long as nobody shows up, but on a public server it sets your peak load. Pick what the memory can carry; the RAM guideline is on the requirements page.

  3. Stop the server before you change anything

    The server reads config.json at startup and writes the file back itself. According to the manual, changes made while it runs are likely to be overwritten. Stop the server, edit the file and start it again.

  4. Clean up your mods

    Mods run server-side and load at start, even if nobody uses them. Remove what you do not need and test after a Hytale update whether everything still works before letting players in.

  5. Update after every release

    Client and server must run the exact same protocol version; a newer client cannot join an old server. Update the server as soon as an update is out. Update 7 converted existing worlds the first time they loaded, so make a backup first.

  6. Measure before you buy

    CPU full while memory is free? Then only less view distance, fewer creatures or fewer mods will help. Memory full? Then a bigger plan is the answer. A memory shortage often shows up first as high CPU load, because Java keeps cleaning up memory.

Which settings decide how a Hytale server performs?

Why view distance weighs so heavily and why more memory does not give you a faster server.

MaxViewRadius

Decides how many chunks around each player are loaded and generated. According to the manual the biggest factor in memory use. Twice as far is four times as many chunks. This is the setting to lower first when lag hits.

MaxPlayers

Every player loads their own piece of world. Ten players exploring in different directions need more memory than ten players building together.

Mods and plugins

Server-side, so memory and CPU time on the server. Plugins that do work every tick weigh more than an asset pack with new blocks.

Players and creatures

The manual names the number of players and entities (NPCs and mobs) as the biggest CPU load. Each world runs on its own main thread, so one fast core helps more than many cores. Our Hytale servers run on AMD Ryzen and EPYC.

Storage

World generation and chunk loading are disk work. On NVMe a player who explores fast waits less for new chunks.

Memory

Decides how much world fits in memory at once. Full memory gives stutter and eventually a crash; free memory makes nothing faster.

What does not help against lag on a Hytale server?

More RAM against CPU lag

If memory is not full, a bigger plan changes nothing about a tick that takes too long.

Opening a TCP port

Hytale uses UDP 5520 (QUIC). A TCP rule does nothing for reachability or speed.

Hosting from a laptop on Wi-Fi

The server keeps sending world data to every player who explores. Wi-Fi and a power-saving laptop CPU give lag that no setting fixes.

How our servers are set up

At delivery Java 25 is ready, UDP 5520 is open and you manage config.json through the Pterodactyl panel's file manager or SFTP. The panel statistics show CPU and memory separately, so measuring is one glance.

  • 4, 6, 8 or 10 GB of memory
  • AMD Ryzen and EPYC, two CPU threads per server
  • 25 GB NVMe storage for world generation without waiting
  • config.json and the mods folder editable right in the panel
  • Console and logs live in the panel
  • Hosted in the Netherlands on our own network (AS211588)

Choose your package

From 4 to 10 GB. Unsure about the size? The RAM guideline is on the requirements page.

Zombie

Minimum memory for Hytale

  • 4096 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€5.95p/m

Cancel monthly

Order

Cattle

  • 6144 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€8.95p/m

Cancel monthly

Order

Deer

  • 8192 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€11.95p/m

Cancel monthly

Order

Warthog

  • 10240 MB RAM
  • 2 CPU threads
  • 25 GB NVMe storage

€14.95p/m

Cancel monthly

Order

Unsure about memory? The RAM guideline per player count is on the requirements page. Players cannot get on? See fixing connection problems.

Sources

The official Hypixel Studios documentation and patch notes this page is based on.

Frequently asked questions

What is the best view distance for a Hytale server?
Hypixel Studios recommends at most 12 chunks (384 blocks), for performance and for gameplay. If memory fills up, go lower. Since Update 7, 32 chunks is the upper limit.
Where are the settings of a Hytale server?
In config.json, in the same folder as HytaleServer.jar. It holds ServerName, MaxPlayers and MaxViewRadius among others. Stop the server before you edit the file: it writes config.json back itself and overwrites what you change while it runs. With us you edit the file in the panel or over SFTP.
My Hytale server lags while memory is not full. What now?
Then the CPU is full. Lower MaxViewRadius, remove plugins that do work every tick and check whether one player far from the rest is generating new world. Buying more memory does not help here.
How often should I restart my Hytale server?
After every Hytale update at least, because client and server must run the exact same protocol version. Beyond that, a fixed restart at a quiet hour is a good habit during early access, not a requirement.
Do mods help with performance?
There are plugins that lower the view distance automatically when it gets busy, and the manual names one itself. But every mod costs memory and CPU time first. Start with fewer mods, not more.
Which Java settings should I use?
On a hosted server you do nothing: the memory of your plan is the memory of the server. Running it yourself, give Java slightly less than the machine's total memory with -Xmx, so the operating system keeps room. An -Xmx that is too tight shows up as high CPU load from garbage collection.