🧠 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