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.
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 dashboard. -
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 and maximum - high server load 16 Good balance between visibility and performance 12 Recommended by Hytale for performance and gameplay (384 blocks) 10 Low - for servers with many players or limited RAM -
Start the server
Start your server for the changes to take effect.
How to Adjust Startup Parameters on a Hytale Server
Via the dashboard, 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 Dashboard
Open the dashboard 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 -
Restart 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 |
Recommended Performance Plugin for Hytale Servers
To stabilize your server, we recommend the Nitrado PerformanceSaver plugin. It is also recommended in Hytale's official server manual.
Download
The plugin can be downloaded here: Performance Saver on CurseForge
Installing the Performance Plugin
-
Stop the Server
Stop your server via the dashboard. -
Download the Plugin
Download the .jar file of the 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.
Performance Saver
The Performance Saver Plugin provides the following benefits:
- TPS Limiting - Intelligently limits ticks per second (20 TPS with players, 5 TPS without)
- Dynamic View Radius Adjustment - Automatically reduces view distance under high load
- Automatic Garbage Collection - Triggers memory cleanup on chunk unloads
After the first start, you can find the plugin's settings in the mods/Nitrado_PerformanceSaver/config.json file.
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
Installing Spark
-
Stop the Server
Stop your server via the dashboard. -
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. In the console of the dashboard, enter them without the /:
| 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.
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:
