Ensures stability of a Hytale server by lowering the resource consumption of the server when it is under resource pressure.
This plugin ensures stability of a Hytale server by lowering the resource consumption of the server when it is under resource pressure.
The resource usage of a Hytale server, even without mods, can fluctuate heavily based on player behavior. For example, a large group of players in a small area has a relatively small resource footprint, whereas a small amount of players each independently exploring the world can cause a significant amount of CPU load and RAM consumption.
It is not always reasonable or cost-effective to run a Hytale game server on the hardware specifications it might need when players do unexpected things, since that means that those hardware resources will remain unused for the vast majority of time. However, simply running a game server on limited resources may lead to bad performance or server crashes in these rare high load scenarios.
This plugin's primary goal is to handle resource pressure in an intelligent manner that keeps the game enjoyable for players.
The plugin takes the following measures to optimize resource usage:
Based on how networking and client prediction work, lower, but stable TPS is generally better for the player experience than high, but fluctuating TPS. The plugin allows to limit the server TPS to a configurable amount (default: 20 TPS).
The plugin also limits the TPS of a server that is empty (default: 5).
The plugin detects CPU pressure through low TPS, and RAM pressure by observing the JVM's garbage collection attempts. If either resource is under pressure, the view radius is dynamically adjusted to free up those resources again. When the resources recover, the view radius is gradually increased again. This measure is able to prevent resource-related server crashes even under stress test scenarios.
Java generally does not free up unused memory on its own. This plugin therefore observes the number of loaded chunks and explicitly triggers an additional garbage collection if it is highly likely that memory can be freed up.
Place the plugin JAR into your server's `mods/` folder.
Below is a complete `mods/Nitrado_PerformanceSaver/config.json` file with all default values:
{
"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,
"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
}
}For an explanation of the configuration values please refer to the README on GitHub.
Community contributions are welcome and encouraged.
If you believe to have found a security vulnerability, please report your findings via security@nitrado.net.
0 Comments