Where's my Brain (WMB)

Fixes a crash

1.2 (2025-09-04)

• New — Regional/Chunk-based TPS Manager (R‑TPS)

  • Per‑region load tracking (avg AI ms, memory MB, players, redstone updates, BE/scheduled ticks, activity).
  • Named scaling levels (e.g., normal=1, warning=2, critical=4) applied as tick multipliers per region.
  • Hysteresis via regionalTPS.hysteresisPct (default 0.15) to stabilize level transitions.
  • Static region overrides to pin hotspots to specific levels.
  • Integrates with chunk random/scheduled tick gating; invisible near players.

• New — Heatmap UI for Regional TPS

  • Request with /wmb heatmap [radius]; reopen last heatmap with the H key.
  • Mouse wheel zoom; right‑click drag to pan; live window requests while panning/zooming.
  • Modes: AI ms, Mem MB, Players, Priority; LOD toggle (merged vs per‑region tiles).
  • Tooltips and a detailed side panel (emergency state, target multiplier, consecutive good/bad ticks, histories).
  • Global TPS display in the header.

• Improvements — Global TPS measurement and safety

  • Lazy‑init tick timing; compute TPS only after 5+ samples; clamp to [0..20].
  • Gate emergency triggers until warm‑up (≥200 ticks) and require ≥20 samples; add cooldown to avoid log spam.

• Improvements — Regional decisions and sampling

  • Applied hysteresis to regional scaling decisions; introduced levelIndex to track transitions.
  • Normalized Y sampling for region gating to level.getMinBuildHeight() + 1.

• Networking & Client

  • Updated heatmap/detail serialization to include memory, player counts, priority, global TPS, target multiplier, and histories.
  • Client can refresh the existing screen (setHeatmap) without reopening; remembers last heatmap for the H key.

• Fixes

  • Heatmap tooltip compile error fixed by initializing local variables.
  • Eliminated false global TPS emergencies at startup or sporadic spikes; reduced warning spam.

• Config

  • Config schema bumped to 5; added regionalTPS.* keys including hysteresisPct.
  • Defaults and inline comments updated in wmb.toml.

• Migration Notes

  • Existing configs auto‑merge new keys and bump configVersion safely. Review regionalTPS.thresholds and regionalTPS.scaling.levels for your pack.

This update adds async entity tracking.