Optimize Your Server with the Hytale Performance Saver Plugin

Managing a Hytale server is a bit like juggling: you have to maintain stable performance to ensure gameplay enjoyment, while managing resource consumption that can skyrocket at any moment.

A small group of explorers scattered across the map can bring your server to its knees faster than an army of players in the same spot. Faced with these unpredictable load spikes, the risk of lag, TPS (Ticks Per Second) drops, or even crashes becomes a reality.

This is precisely where the Hytale Performance Saver Plugin comes in—a smartly designed plugin to ensure your Hytale server’s stability. Its goal isn’t to restrict your server, but to intelligently manage resource pressure to maintain a pleasant gaming experience, even during the most intense moments.

Main Features

This plugin acts as a vigilant guardian for your server. It uses several optimization measures to manage resource consumption dynamically.

TPS Limiting (Ticks Per Second)

For the player experience, it is much more pleasant to have stable TPS, even if slightly lower, than high but highly fluctuating TPS. The plugin allows you to cap the TPS at a configurable value (20 by default) to ensure constant fluidity. Even better, it intelligently reduces TPS when the server is empty (5 by default), saving valuable resources when no one is connected.

Dynamic View Radius Adjustment

This is the most powerful feature of this plugin. The view radius (draw distance) is one of the biggest consumers of memory and CPU. The plugin constantly monitors your server’s health:

• CPU Pressure: Detected by a drop in TPS.
• RAM Pressure: Detected by observing memory cleanup attempts by Java (the famous “Garbage Collection”).

If pressure is detected, the plugin will automatically and dynamically lower the view radius to free up resources. Once the server stabilizes, it progressively increases the display distance again. This measure is incredibly effective at preventing resource-related crashes.

Garbage Collector

Java tends to hold onto memory even if it is no longer being used. This plugin observes the number of loaded chunks on your server. If it detects a sharp drop (for example, players disconnecting or grouping up), it triggers an extra memory cleanup, ensuring that unused resources are properly released.

Plugin Installation

Installation is a breeze. Simply place the plugin’s JAR file, once downloaded, into your Hytale server’s mods/ folder. Restart the server, and the plugin will be active.

Plugin Configuration

The plugin is configured via a single file that you must create: config.json.
This file must be placed in a specific folder.

Configuration file path: mods/Nitrado_PerformanceSaver/config.json

TPS Adjustment (Tps)

This section controls the behavior of the TPS limiting.

View Radius Adjustment (ViewRadius)

Controls the dynamic adjustment of the display distance based on server load.

Memory Monitor (GcMonitor)

Monitors RAM to detect pressure.

TPS Monitor (TpsMonitor)

Monitors TPS to detect processor (CPU) pressure.

Chunk Collection (ChunkGarbageCollection)

Triggers memory cleanup when chunk unloading suggests that RAM can be freed.

Complete Configuration Example

Here is an example of the complete config.json file with all default values. You can copy and paste this content and adapt it to your needs.

{
  "Tps": {
    "Enabled": true,
    "TpsLimit": 20,
    "TpsLimitEmpty": 5,
    "OnlyWorlds": [],
    "InitialDelaySeconds": 30,
    "CheckIntervalSeconds": 5,
    "EmptyLimitDelaySeconds": 300
  },
  "ViewRadius": {
    "Enabled": true,
    "MinViewRadius": 2,
    "DecreaseFactor": 0.75,
    "IncreaseValue": 1,
    "InitialDelaySeconds": 30,
    "CheckIntervalSeconds": 5,
    "RecoveryWaitTimeSeconds": 60,
    "RequireNotifyPermission": false,
    "GcMonitor": {
      "Enabled": true,
      "HeapThresholdRatio": 0.85,
      "TriggerSequenceLength": 3,
      "WindowSeconds": 60
    },
    "TpsMonitor": {
      "Enabled": true,
      "TpsWaterMarkHigh": 0.75,
      "TpsWaterMarkLow": 0.6,
      "OnlyWorlds": [],
      "AdjustmentDelaySeconds": 20
    }
  },
  "ChunkGarbageCollection": {
    "Enabled": true,
    "MinChunkCount": 128,
    "ChunkDropRatioThreshold": 0.8,
    "GarbageCollectionDelaySeconds": 300,
    "InitialDelaySeconds": 5,
    "CheckIntervalSeconds": 5
  }
}