ChunkSense

🧠 ChunkSense

Smart chunk loading + memory watchdog for Minecraft Forge 1.20.1

ChunkSense does two things that no other mod does:

1. Smart Chunk Prioritizer — chunks are loaded not in a circle, but along the vector of view and movement. Looking north — northern chunks load first. Running east — chunks ahead pre-load.

2. Memory Watchdog — monitors RAM in real time. If there’s not enough memory, it automatically unloads distant chunks, reduces render distance, and clears the cache. The HUD overlay shows real-time status.

⚡ Features

• 🎯 View-direction priority — Chunks in camera direction load first
• 🏃 Movement prediction — Pre-loads chunks along player velocity vector
• 📊 RAM monitoring — Tracks memory usage every second
• 🚨 Auto-unload — Unloads far chunks when memory is low
• 🔭 Dynamic render distance — Auto-adjusts render distance based on RAM
• 📟 HUD overlay — Shows RAM %, FPS, render distance on screen
• ⚙️ Fully configurable — All thresholds and features toggleable

⚙️ Configuration

All settings in config/chunksense-common.toml:

• viewAnglePriority (true) — View-direction loading priority
• predictMovement (true) — Predictive chunk loading
• predictionTicks (40) — Ticks ahead to predict
• memoryThreshold (85) — RAM % to start unloading
• criticalMemory (95) — Critical threshold for aggressive cleanup
• autoRenderDistance (true) — Auto-adjust render distance
• minRenderDistance (4) — Minimum render distance
• maxRenderDistance (16) — Maximum render distance
• showHud (true) — HUD overlay
• checkIntervalTicks (20) — Memory check interval

🔧 Compatibility

• Minecraft 1.20.1 / Forge 47.2.0+
• ✅ Compatible with OptiFine, Sodium, Embeddium
• ✅ Client + Server
• ✅ Does not conflict with other optimization mods

📄 License

MIT