Will this affect player experience?

The optimizer is designed to preserve player experience while improving performance. Changes are gradual and recover automatically when server load decreases.

Do I need to configure anything?

No, the mod works out of the box with sensible defaults. However, you can customize all thresholds and settings in the config file.

How do I check if it's working?

Use the /optimizer status command to see current effective settings and active optimization ranges.

Server Optimizer

Name: Server Optimizer
Author: 0x90sh

by 0x90sh

utility

Server Optimizer is a lightweight, automated performance plugin that dynamically adjusts view distance, simulation ranges, and NPC AI update rates based on real-time TPS and memory usage.

Running a Hytale server under heavy load? Server Optimizer is your solution for maintaining smooth gameplay even when things get busy. This lightweight plugin automatically adjusts performance settings in real-time, keeping your TPS stable without manual intervention.

What Does This Mod Do?

Server Optimizer continuously monitors your server’s TPS (ticks per second) and memory usage. When it detects performance drops, it automatically reduces view distance, simulation ranges, and NPC update rates. When performance recovers, it gradually restores quality settings.

Key Features

Dynamic View Distance

The optimizer scales global view distance based on TPS and heap pressure. When the server struggles, view distance decreases smoothly. When load drops, it recovers automatically with configurable cooldowns to prevent rapid oscillation.

Per-Player Simulation Control

Hotspot detection identifies areas with heavy load and reduces simulation radius for players in those zones. This targeted approach minimizes the impact on players in lighter areas while protecting server performance.

AI Level of Detail (LOD)

NPCs at different distances receive different tick rates. Near NPCs get full AI processing, while distant ones update less frequently. This dramatically reduces CPU load in NPC-heavy areas without players noticing the difference.

Idle Player Optimization

Players who haven’t moved or interacted recently get reduced view and simulation radii. This saves RAM and CPU for active players while idle ones are away from keyboard.

Built-in Profiler

Run performance profiles to generate detailed reports showing TPS, memory usage, entity counts, and optimizer impact. Reports are saved in both text and JSON formats for analysis.

Commands

/optimizer status - View current effective settings and active ranges
/optimizer reload - Reload config without server restart
/optimizer profile [duration] - Start a performance profiling session (20-60 seconds)

Configuration Overview

The mod creates a config.json file automatically with all settings documented. Key sections include:

ViewRadius Settings

Min/Max view distance bounds
TPS thresholds for reduction and recovery
Memory pressure thresholds
Adjustment cooldowns

Simulation Settings

Per-player simulation radius control
Decrease and recovery step sizes
TPS trigger thresholds

AI LOD Settings

Distance thresholds for near, mid, far NPCs
Tick intervals for each distance tier
Visibility-based full ticking option

IdlePlayer Settings

Idle timeout duration
Reduced radii for inactive players
World map cache clearing

How to Use

Drop the JAR into your server’s mods folder
Start the server once to generate the config
Optionally edit the config to match your server’s needs
Use /optimizer status to monitor active settings
Run /optimizer profile during peak times to analyze performance

Who Is This Mod For?

This mod is ideal for:

Server administrators managing public servers
Anyone hosting multiplayer games with variable player counts
Servers experiencing TPS drops during peak hours
Admins who want automated performance management

You might not need this if:

You run a small private server with few players
Your server hardware easily handles your player count
You prefer manual performance tuning

Compatibility

Hytale Version: Early Access and above
Type: Server-side only
Conflicts: May conflict with other view distance or chunk loading mods

About the Author

0x90sh developed Server Optimizer to provide automated, intelligent performance management for Hytale servers without requiring constant administrator attention.

Frequently Asked Questions

Does this work on singleplayer?

This is a server-side plugin designed for multiplayer servers. It has no effect in singleplayer.

Will players notice the view distance changes?

Changes are gradual and settings recover when performance improves. Most players won’t notice during normal gameplay.

Can I disable specific features?

Yes, each optimization system (ViewRadius, Simulation, AI LOD, IdlePlayer) can be individually enabled or disabled in the config.