⚡ OptimizationForLB v2.0.2

OptimizationForLB (OFLB) v2.0.2 is a comprehensive, next-generation server optimization engine engineered specifically for Paper, Purpur, Pufferfish, and Folia servers.

It delivers active multi-tiered performance defenses: water flooding machine blockers, explosion and TNT lag limiters, smart hopper transfer optimization, continuous ground item auto-merging, intelligent mob stacking, redstone clock protection, smart chunk unloader algorithms, aggressive heap memory reduction, real-time health telemetry, and autonomous Auto-Fix incident recovery.

---

🚀 Key Features in v2.0.2

• 💧 Water Flooding Machine Blocker: Detects and throttles abusive water/lava flooding machines and high-frequency fluid update cascades before they crash or freeze the server.
• 💥 Explosion & TNT Density Safeguards: Throttles mass-chain TNT cannons and crystal bomb spam; automatically suppresses block damage calculations when TPS is degraded to keep gameplay smooth.
• 📦 Hopper & Item Transfer Throttler: Dynamically throttles empty hopper search checks during low TPS without breaking player sorting systems.
• 🧲 Continuous Item Auto-Merger: Continuously merges nearby dropped items into larger single stacks every 5 seconds to minimize ground entities at all times.
• 🧹 /opt clean Command: All-in-one instant purge: ground items, empty chunks, excess mobs, and JVM memory in a single command.
• 📊 /opt benchmark Command: Deep diagnostic hardware performance grade (A+, A, B, C) and active defense status.
• 🧬 Mob Stacker 2.0: Compacts nearby living entities into stacked units with custom tags.
• ⚡ Redstone Clock Throttler 2.0: Halts abusive rapid redstone clocks per chunk and notifies staff.
• 🗺️ Smart Chunk Manager: Automatically unloads unoccupied chunks outside player view buffers.
• 🚨 Autonomous TPS Auto-Fix 2.0: Automatically triggers full emergency recovery when TPS drops below 15.0.

---

🛠️ Complete Command Reference

Command	Description	Permission
/opt clean	All-in-one instant server cleanup sweep (items, chunks, RAM, mobs).	optimizationforlb.admin
/opt benchmark	Run deep diagnostic hardware health audit.	optimizationforlb.admin
/opt status	Show visual TPS, RAM HUD progress bars, and player ping.	optimizationforlb.admin
/opt autofix	Manually trigger the automated emergency TPS recovery sequence.	optimizationforlb.admin
/opt stack	Manually trigger a world-wide mob stacking sweep.	optimizationforlb.admin
/opt health	Broadcast the 1-minute server health telemetry summary.	optimizationforlb.admin
/opt trimram	Trigger aggressive ~1 GB RAM reduction.	optimizationforlb.admin
/opt clearitems	Clear dropped items across all worlds.	optimizationforlb.admin
/opt purgechunks	Unload inactive, unoccupied chunks to reclaim CPU/RAM.	optimizationforlb.admin
/opt gc	Request manual JVM Garbage Collection pass and report freed MB.	optimizationforlb.admin
/opt ping	Check player connection latency and quality badge.	optimizationforlb.admin
/opt reload	Reload configuration and restart background timers.	optimizationforlb.admin
/opt help	Display complete in-game command assistance menu.	optimizationforlb.admin

---

⚙️ Configuration Preview (config.yml)

plugin:
  prefix: "&8[&cOptimizationForLB&8] "

water-flow-limiter:
  enabled: true
  max-flow-updates-per-second-per-chunk: 120
  notify-admins: true

explosion-limiter:
  enabled: true
  max-explosions-per-second: 30
  disable-block-damage-under-tps: 16.0

hopper-optimizer:
  enabled: true

item-merger:
  enabled: true
  interval-seconds: 5
  search-radius-blocks: 3.5

entity-stacker:
  enabled: true
  search-radius-blocks: 6.0
  max-stack-size: 50

redstone-limiter:
  enabled: true
  max-updates-per-second-per-chunk: 150

smart-chunk-manager:
  enabled: true
  player-buffer-radius-chunks: 3

auto-fix:
  enabled: true
  trigger-tps: 15.0
  cooldown-seconds: 60