SimView

SimView is a Hytale server plugin that separates simulation distance chunks from view distance chunks.

It keeps a controlled simulation distance for gameplay while streaming additional distant chunks as view-only "cold" chunks. This lets players see farther with much lower server cost than simulating everything in full.

Configuration

On startup, SimView creates:

• SimView/config/simview.json

Default config

json { "core": { "enabled": true, "gui-enabled": true, "disable-join-hint-message": false, "target": { "view-distance-chunks": 32, "simulation-distance-chunks": 32 }, "limits": { "minimum": { "view-distance-chunks": 0, "simulation-distance-chunks": 0 }, "maximum": { "view-distance-chunks": 32, "simulation-distance-chunks": 32 } } }, "auto-adjustment": { "mode": { "view": "off", "simulation": "off" }, "cadence": { "ticks-per-check": 600, "startup-delay-ticks": 2400 }, "checks": { "view": { "for-increase": 10, "for-decrease": 1 }, "simulation": { "for-increase": 10, "for-decrease": 1 } }, "proactive": { "global-cold-chunk-count-target": 120000, "global-ticking-chunk-count-target": 0 }, "reactive": { "increase-mspt-threshold": 40.0, "decrease-mspt-threshold": 47.0, "mspt-collection-period-ticks": 1200, "use-mspt-prediction": true, "mspt-prediction-history-minutes": 30 } }, "cold-chunk-streaming": { "generate-missing": true, "cache-packets-in-memory": true, "despawn-entities": true, "budget": { "chunk-sends-per-second": 96, "chunk-sends-per-tick": 8, "cold-chunk-loads-in-flight": 64 } }, "speeding-adjustments": { "not-send-blocks-per-tick": 1.2, "cooldown-ticks": 40, "budget": { "chunk-sends-per-second": 24, "chunk-sends-per-tick": 2 } } }

Auto Mode

SimView tracks two active targets independently:

• active target simulation distance (ticking/hot chunks)
• active target view distance (cold + hot visible chunks)

Runtime constraints are always enforced:

• simulation distance target is clamped by simulation min/max.
• view distance target is clamped by view min/max.
• simulation distance target will never exceed view distance target.
• view distance target will never go below simulation distance target.

Both auto modes share check cadence:

• auto-adjustment.cadence.startup-delay-ticks
• auto-adjustment.cadence.ticks-per-check

Both auto modes also use consecutive-check gating before a change applies:

• view: auto-adjustment.checks.view.for-increase|for-decrease
• simulation: auto-adjustment.checks.simulation.for-increase|for-decrease

Mode behavior

• off
• Holds fixed configured targets.
• proactive
• View mode follows auto-adjustment.proactive.global-cold-chunk-count-target.
• Simulation mode follows auto-adjustment.proactive.global-ticking-chunk-count-target (disabled when target is 0).
• reactive
• Uses MSPT thresholds:
• <= auto-adjustment.reactive.increase-mspt-threshold: candidate increase
• >= auto-adjustment.reactive.decrease-mspt-threshold: candidate decrease
• in-between: stay
• Optional prediction (auto-adjustment.reactive.use-mspt-prediction) blocks risky increases using historical MSPT-per-chunk slopes.
• mixed
• Combines proactive and reactive checks (stronger signal wins).

Practical tuning guidance

• Keep auto-adjustment.reactive.decrease-mspt-threshold higher than auto-adjustment.reactive.increase-mspt-threshold.
• Keep simulation decrease checks low for faster overload shedding.
• Increase view increase checks if visible distance climbs too aggressively.
• Use different modes for each target to shape load behavior and hot:cold ratio dynamically.

Commands

• /simview
• Permission group: hytale:None
• Opens the full SimView GUI.
• On dedicated servers: requires admin permissions.
• On singleplayer worlds: owner can always open it.
• GUI edits save config and auto-reload SimView immediately.
• /simviewreload
• Permission group: hytale:Admin
• Reloads simview.json, reapplies caps, and resets tuner state.