⚡ OptimizationForLB v2.0.3

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

It delivers active multi-tiered performance defenses: dynamic mob AI throttling during lag, chunk farm entity breeding caps, armor stand gravity physics stripping, 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.

---

🚀 What is New in v2.0.3

• 🧠 Dynamic Mob AI Throttler (/opt ai): When server TPS falls below 16.5, the plugin dynamically suspends the pathfinding AI of living mobs far away from players (default: 24+ blocks away), restoring it instantly when TPS recovers above 18.5. This frees enormous CPU main-thread budget.
• 🚜 Farm & Breeding Density Limiter: Enforces a configurable living mob ceiling per chunk (default: 35 mobs) against spawner over-stacking, egg spam, and mass animal breeding.
• 🛡️ Armor Stand Gravity & Physics Optimizer: Automatically freezes gravity calculations on static ground armor stands, eliminating continuous physics tick overhead.
• 🧹 Enhanced All-in-One Sweep (/opt clean): Now clears ground items, merges nearby drops, compacts mob stacks, purges inactive chunks, strips armor stand physics, and trims heap RAM.

---

🛠️ Complete Feature Matrix

Module	Purpose
Mob AI Throttler	Suspends pathfinding for distant mobs during lag spikes (< 16.5 TPS).
Farm Limiter	Caps breeding and spawner mob overload per chunk (default 35 mobs/chunk).
Armor Stand Optimizer	Disables gravity ticking on grounded decorative armor stands.
Water Flow Limiter	Throttles excessive fluid updates to eliminate water/lava lag machines.
Explosion Limiter	Throttles TNT cannon density and crystal explosions during lag.
Hopper Optimizer	Paces empty hopper inventory scans under server load.
Item Auto-Merger	Merges dropped items within radius into single stacks every 5 seconds.
Entity (Mob) Stacker	Compacts same-type living entities into stacked units with custom tags.
Redstone Clock Throttler	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	Automatically triggers full emergency recovery when TPS drops below 15.0.
1-Minute Health Telemetry	Broadcasts comprehensive performance audits every 60 seconds with health scores.
Aggressive ~1 GB RAM Trimmer	Frees clogged JVM heap memory without requiring a server reboot.

---

💻 Commands & Permissions

Command	Description	Permission
/opt clean	All-in-one instant server cleanup sweep (items, chunks, RAM, mobs, armor stands).	optimizationforlb.admin
/opt ai	Toggle or force-trigger dynamic mob AI throttling.	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] "

mob-ai-throttler:
  enabled: true
  interval-seconds: 10
  trigger-tps: 16.5
  restore-tps: 18.5
  distance-from-players: 24.0

farm-limiter:
  enabled: true
  max-mobs-per-chunk: 35

armorstand-optimizer:
  enabled: true
  disable-gravity: true

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

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

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

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

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