Skip to content

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.

  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:

    ValueRecommendation
    32Default - high server load
    16Recommended - good balance
    10Low - best performance
    8Minimal - 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:

ParameterDescription
-XX:+UseG1GCEnables the G1 Garbage Collector, optimized for servers with large RAM
-XX:+ParallelRefProcEnabledSpeeds up reference processing through parallelization
-XX:MaxGCPauseMillis=200Limits 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 ​

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

  2. Download the Plugin
    Download the .jar file of the Performance Saver Plugin from GitHub.

  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.

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 ​

  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:

CommandDescription
/spark profiler startStart profiling
/spark profiler stopStop profiling and create report
/spark tpsShow current TPS
/spark healthShow 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:

Send Feedback