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

{
  "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.