Server Optimizer
Optimizer is a lightweight, fully automated performance plugin that keeps your server running smooth under all conditions.
It continuously adapts view distance and per-player simulation ranges in real time based on TPS and memory pressure, reducing lag during peak load and restoring quality when performance stabilizes.
No manual tuning required, the plugin reacts instantly to player activity, improves scalability, and helps maintain consistent tick rates on both small and large servers.
Features
Short installation guide
Place Optimizer.jar into the server /mods directory
Create the folder /mods/Optimizer
Place config.json inside /mods/Optimizer
Start the server, the plugin loads automatically and begins optimizing
No commands or permissions required.
Example Config
Optimizer is a lightweight, fully automated performance plugin that keeps your server running smooth under all conditions.
It continuously adapts view distance and per-player simulation ranges in real time based on TPS and memory pressure, reducing lag during peak load and restoring quality when performance stabilizes.
No manual tuning required, the plugin reacts instantly to player activity, improves scalability, and helps maintain consistent tick rates on both small and large servers.
Features
- Dynamic global view distance scaling – lowers render load instantly when TPS drops
- Per-player simulation (HOT) radius control – reduces costly entity updates near overloaded players
- Real-time TPS monitoring – reacts within seconds to performance degradation
- Memory pressure awareness – prevents lag caused by high heap usage and GC spikes
- Automatic recovery logic – restores view distance and simulation range once performance stabilizes
- Hotspot detection – targets only problematic areas instead of penalizing all players
- Cooldown-based adjustments – avoids oscillation and micro-stutter from constant changes
- Fully autonomous operation – no commands, schedules, or manual tuning required
Short installation guide
Place Optimizer.jar into the server /mods directory
Create the folder /mods/Optimizer
Place config.json inside /mods/Optimizer
Start the server, the plugin loads automatically and begins optimizing
No commands or permissions required.
Example Config
JSON:
{
"LoopIntervalSeconds": 1,
// How often (in seconds) the optimizer evaluates TPS and memory pressure
"ViewRadius": {
"Enabled": true,
// Enables automatic global view radius scaling
"BroadcastChanges": true,
// Broadcasts a chat message when the global view radius changes
"Min": 5,
// Minimum allowed global view radius
"Max": 14,
// Maximum allowed global view radius
"DecreaseFactor": 0.75,
// Multiplier applied when reducing view radius under heavy load (e.g. 14 -> 10)
"RecoveryStep": 1,
// Amount of view radius restored per recovery step when performance improves
"AdjustmentCooldownSeconds": 6,
// Minimum time between consecutive global view radius changes
"TpsLow": 18.2,
// TPS threshold below which the view radius is reduced
"TpsHigh": 19.4,
// TPS threshold above which the view radius may recover
"HeapPressureHigh": 0.80,
// Memory usage ratio that triggers view radius reduction
"HeapPressureLow": 0.65
// Memory usage ratio below which recovery is allowed
},
"Simulation": {
"Enabled": true,
// Enables per-player simulation (HOT) radius tuning
"Min": 5,
// Minimum allowed per-player simulation radius
"Max": 11,
// Maximum allowed per-player simulation radius
"DecreaseStep": 2,
// Amount the simulation radius is reduced when TPS is too low
"RecoveryStep": 1,
// Amount the simulation radius is restored when TPS stabilizes
"TpsLow": 18.0,
// TPS threshold that triggers simulation radius reduction
"TpsHigh": 19.3
// TPS threshold that allows simulation radius recovery
},
"PerPlayerDistance": {
"Enabled": true,
// Enables hotspot-based per-player distance reduction
"Min": 5,
// Minimum hotspot-adjusted distance for affected players
"Max": 11,
// Maximum hotspot-adjusted distance for affected players
"HotspotTpsLow": 18.5,
// TPS threshold that activates hotspot detection logic
"HotspotReduceBy": 2,
// How much to reduce distance for players in performance hotspots
"CooldownSeconds": 5
// Minimum time between hotspot-based adjustments per player
}
}
