LeanCore

LeanCore is server-side memory governor for Hytale. Unloads idle map regions, trims view radius under heap pressure, and learns which zones get revisited so it keeps the ones you actually use.
Back to Files

LeanCore-1.1.0.jar

File nameLeanCore-1.1.0.jar
Uploader
DurkzPRGDurkzPRG
Uploaded
Jun 8, 2026
Downloads
18
Size
157.3 KB
File ID
8217747
Type
R
Release
Supported game versions
  • 0.5

What's new

Changelog (1.1.0)

Added

  • Scaled runtime profiles on embedded hosts: LITE (solo), STANDARD (friends), FULL (dedicated)
  • localHostMode AUTO (default): dormancy on solo with a 30s tick; ramps up when friends join
  • Regional entity counts per zone in /leancore probe (S4 via EntityChunk)
  • Unload counters in /leancore learn: policy sweeps vs engine unloads (ChunkUnloadEvent, opt-in)
  • OnlineLinearDemandModel for retention weights (feature schema v1)
  • LeanCoreAPI for other mods: tier query, zone pin, player snapshot
  • 10% holdout cohort: bandit learns on treatment players; holdout skips view-radius cuts
  • Unit tests for runtime profiles, activation policy, feature normalization, and demand model

Changed

  • Runtime uses HytaleServer.SCHEDULED_EXECUTOR with 30s initial delay (lighter on local solo)
  • Safer defaults: governEnabled=false, viewRadiusGovernanceEnabled=false, hudFeatureEnabled=false, learningEnabled=false
  • View-radius governance disabled on embedded solo (1 player + not dedicated) even when governor is on
  • Policy applier only pushes view-radius when policy actually changes (throttled)
  • /leancore status shows active runtime profile (LITE / STANDARD / FULL)
  • /leancore learn shows featureSchema=v1, demand model status, and unload stats

Fixed

  • Embedded local worlds no longer stutter from a heavy 5s background tick + HUD + learning loop
  • Chunk-unload event tracking off by default (avoids engine thread assert on some worlds)

Notes

  • Solo: keep localHostMode: AUTO. Dedicated: dedicatedServerMode: true then tune governor

This mod has no additional files