Lazy Chunk Load Changelog

1.1.0 — 2026-06-17

🆕 New Features

• Stepped CPU Throttling: Main chunk loading now dynamically adjusts its frequency based on CPU usage. Full speed below 85% CPU, progressively slowing down between 85%~100%. At worst, chunks are processed every 0.2s — terrain never gets stuck.
• Preloading Enabled by Default: Background preloading is now on by default. Idle players will have surrounding chunks generated automatically.
• Priority-Based Preloading: Chunks are prioritized by three weighted scores — distance (closer first), look direction (ahead first), and aging (long-unloaded first). Chunks under your feet and in front of you load first.
• F3 Debug Overlay: Press F3 to see CPU usage, chunks loaded per tick, throttle status, and preload state at the bottom-left of the screen.
• Warmup Protection: No throttling for the first 10 seconds after joining a world, ensuring spawn chunks load quickly.
• Save Safety: Preloading and throttling are automatically paused during world saves to prevent conflicts.
• Emergency Pass-Through: If a player steps into an unloaded chunk, all limits are bypassed — the chunk loads immediately.
• VulkanMod Compatible: F3 overlay silenty disables itself when VulkanMod is present. Core functionality is unaffected.

🔧 Optimizations

• CPU polling uses a 1-second cache (down from once per tick), virtually zero overhead
• Preload queue periodically prunes already-loaded chunks to prevent memory bloat
• Preloading auto-pauses during player movement to avoid competing for CPU

❌ Removed

• Removed /lazychunkload commands to avoid server permission issues
• All settings now managed via config/lazychunkload.json and config/lazychunkload-runtime.json

📦 Supported Platforms

1.0.0 — 2026-06-14

• Initial release
• Basic CPU monitoring and throttling
• /lazychunkload status / tips commands