How to Improve Performance on a Hytale Server ​
Overview ​
The performance of a Hytale server can be influenced by various factors, including the number of players, the size of the loaded world, and the server configuration. In this article, we'll show you how to optimize the performance of your Hytale server.
Note
Stop your server before making changes to configuration files, otherwise they will be overwritten by the server.
How to Optimize the Configuration on a Hytale Server ​
If you don't want to install a plugin, you can also improve server performance by adjusting the configuration file. The most important setting for this is MaxViewRadius. The view radius determines how many chunks are loaded around a player. A smaller value significantly reduces server load.
Stop the server
Stop your server via the management panel.Open the configuration file
Connect to your server via SFTP and open theconfig.jsonfile in the root directory.Find MaxViewRadius
Look for theMaxViewRadiussetting in theconfig.json.Adjust the value
Reduce the value to improve performance:Value Recommendation 32 Default - high server load 16 Recommended - good balance 10 Low - best performance 8 Minimal - for weaker servers Start the server
Start your server for the changes to take effect.
How to Adjust Startup Parameters on a Hytale Server ​
Via the management panel, you can add additional startup parameters in the settings. This allows you to add custom Garbage Collector parameters to further optimize the server.
Open the Management Panel
Open the management panel of your server.Open Settings
Navigate to Settings.Adjust Startup Parameters
Add your desired parameters in the Additional Startup Parameters field.-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200-XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200Restart the Server
Restart your server for the changes to take effect.
Default Garbage Collector Parameters ​
The following parameters are already configured by default:
| Parameter | Description |
|---|---|
-XX:+UseG1GC | Enables the G1 Garbage Collector, optimized for servers with large RAM |
-XX:+ParallelRefProcEnabled | Speeds up reference processing through parallelization |
-XX:MaxGCPauseMillis=200 | Limits Garbage Collection pauses to a maximum of 200ms |
Tip
The default values are already optimal for most servers. Only change these if you know what you're doing.
How to Install the Performance Saver Plugin on a Hytale Server ​
The Performance Saver Plugin by Nitrado is an effective tool for stabilizing your Hytale server. It optimizes resource usage under load and prevents server crashes during high traffic.
Download ​
The plugin can be downloaded here: Performance Saver Plugin on GitHub
Installation ​
Stop the Server
Stop your server via the management panel.Download the Plugin
Download the .jar file of the Performance Saver Plugin from GitHub.Upload the Plugin
Connect to your server via SFTP and upload the .jar file to themods/folder.Start the Server
Start your server.
Features of the Performance Saver Plugin ​
TPS Limiting ​
The plugin intelligently limits ticks per second (TPS) to save resources. Based on network and client prediction mechanics, a lower but stable TPS is better for the player experience than fluctuating values.
- Default with players: 20 TPS
- Default without players: 5 TPS
Dynamic View Radius Adjustment ​
The plugin continuously monitors CPU usage (via TPS) and RAM consumption (via Garbage Collection). Under high load, the view radius is automatically reduced to free up resources. Once the load decreases, the view radius is increased again.
Automatic Garbage Collection ​
The plugin automatically triggers JVM garbage collection when chunk unloads indicate that memory can be freed. This prevents memory issues and ensures more stable performance.
How to Install the Spark Plugin on a Hytale Server ​
The Spark Plugin is a performance profiler that allows you to analyze lag causes on your server. It shows you exactly which processes are consuming the most resources.
Download ​
The plugin can be downloaded here: Spark on CurseForge
Installation ​
Stop the Server
Stop your server via the management panel.Download the Plugin
Download the .jar file of the Spark Plugin from CurseForge.Upload the Plugin
Connect to your server via SFTP and upload the .jar file to themods/folder.Start the Server
Start your server.
Using Spark ​
With Spark, you can use the following commands in-game as admin:
| Command | Description |
|---|---|
/spark profiler start | Start profiling |
/spark profiler stop | Stop profiling and create report |
/spark tps | Show current TPS |
/spark health | Show server health |
Daily Restarts ​
A daily restart of your server can fix memory leaks (RAM leaks) and keep performance stable.
Info
Automatic restarts and backups can be requested for free via a support ticket. The "Scheduled Tasks" feature is currently in development and will be released this year.
Feedback to the Hytale Team ​
Have you discovered performance issues or bugs with the server software? You can send direct feedback to the Hytale development team: