# 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
| Platform | Version |
|---|---|
| Fabric | 1.21.x |
| Forge | 1.20.1 |
---
## 1.0.0 — 2026-06-14
- Initial release
- Basic CPU monitoring and throttling
- `/lazychunkload status` / `tips` commands
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }