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.

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.

1. Stop the server
   Stop your server via the management panel.

2. Open the configuration file
   Connect to your server via SFTP and open the config.json file in the root directory.

3. Find MaxViewRadius
   Look for the MaxViewRadius setting in the config.json.

4. 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

5. 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.

1. Open the Management Panel
   Open the management panel of your server.

2. Open Settings
   Navigate to Settings.

3. 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=200

4. Restart the Server
   Restart your server for the changes to take effect.

Default Garbage Collector Parameters ​

The following parameters are already configured by default:

Recommended Performance Plugins for Hytale Servers ​

To stabilize your server, we recommend the following plugins:

Downloads ​

• Server Optimizer on CurseForge
• Hyfixes on CurseForge
• Performance Saver on CurseForge

Installation ​

1. Stop the Server
   Stop your server via the management panel.

2. Download the Plugins
   Download the .jar files of the desired plugins from CurseForge.

3. Upload the Plugins
   Connect to your server via SFTP and upload the .jar files to the mods/ folder.

4. Start the Server
   Start your server.

Server Optimizer ​

The Server Optimizer Plugin provides the following benefits:

• View Distance Management - Lowers view distance on low TPS or high RAM usage
• Per-Player Simulation Range - Reduces simulation range per player during TPS drops
• NPC AI Optimization - Adjusts NPC tick rates based on distance and visibility
• Self-Healing Config - Missing settings are automatically added
• Profiling - Creates detailed performance reports

Hyfixes ​

The Hyfixes Plugin provides the following benefits:

• Crash Prevention - Fixes server crashes from null references and iterator errors
• Timeout Fixes - Prevents player kicks during network lag in interactions
• RAM Optimization - Improved chunk cleanup (up to 77% RAM reduction)
• Interaction Chain Fixes - Removes corrupted interaction chains before crashes

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

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 ​

1. Stop the Server
   Stop your server via the management panel.

2. Download the Plugin
   Download the .jar file of the Spark Plugin from CurseForge.

3. Upload the Plugin
   Connect to your server via SFTP and upload the .jar file to the mods/ folder.

4. Start the Server
   Start your server.

Using Spark ​

With Spark, you can use the following commands in-game as admin:

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:

Send Feedback