⚡ OptimizationForLB v3.0.1 (Hyper-Drive Edition)

OptimizationForLB (OFLB) v3.0.1 is the ultimate, enterprise-tier performance suite engineered specifically for Paper, Purpur, Pufferfish, and Folia servers.

Designed for massive servers with heavy farm automation and trading halls, v3.0.1 introduces Experience Orb stacking, Villager AI optimization, Live BossBar monitoring HUD, and hyper-speed piston/lighting lag throttlers.

---

🔥 What is New in v3.0.1 (Hyper-Drive Edition)

• 🔮 Experience Orb (XP) Stacker (XPOrbOptimizerManager): Groups hundreds of tiny XP orbs from mob/guardian/enderman farms into dense composite orbs every 3 seconds, slashing entity ticking overhead by up to 90%.
• 👨‍🌾 Smart Villager Brain Optimizer (VillagerOptimizerManager): Relieves CPU thread congestion in trading halls by disabling redundant pathfinding calculations for boxed/stationary villagers while keeping trades and restock mechanics 100% functional.
• 📊 Live Administrative BossBar HUD (/opt hud): Toggle a real-time, color-coded BossBar displaying live server TPS, RAM usage (GB & percentage), and instant health status without having to type commands.
• 💡 Hyper-Speed Piston & Lighting Limiter (LightLimiterManager): Throttles rapid flying piston machines and light update cascades before they freeze the lighting thread.
• 🧹 Enhanced All-in-One Deep Clean (/opt clean): Now clears ground drops, merges items, aggregates XP orbs, stacks mobs, purges chunks, frees armor stand gravity, and runs JVM Garbage Collection in one swift operation!

---

🛠️ Complete Feature Matrix

Engine	Description
Experience Orb Stacker	Merges floating XP orbs into single dense orbs to eradicate farm entity lag.
Villager Brain Optimizer	Optimizes pathfinding loops for trading hall villagers without affecting trades.
Live BossBar HUD	Real-time administrative performance monitor toggled via /opt hud.
Interactive GUI Dashboard	Clickable chest interface with visual gauges and instant optimization buttons (/opt gui).
Dynamic Auto-Tuner	Real-time simulation distance and tick stress scaling.
Anti-Packet Flood Shield	Blocks inventory click spamming and book exploit crashes.
Mob AI Throttler	Suspends pathfinding for distant mobs during lag spikes (< 16.5 TPS).
Farm & Breeding Limiter	Caps entity breeding and spawner overflows per chunk (default 35 mobs/chunk).
Armor Stand Optimizer	Disables gravity calculations on stationary decorative armor stands.
Water Flow Limiter	Throttles high-frequency fluid update cascades and water/lava lag machines.
Explosion Limiter	Restricts explosive density during lag and suspends block damage calculations.
Hopper Optimizer	Paces empty hopper inventory searches under server load.
Item Auto-Merger	Merges ground item drops within radius into single stacks every 5 seconds.
Entity (Mob) Stacker	Compacts same-type living entities with single-kill loot support.
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 gui	Open the interactive in-game Chest GUI dashboard.	optimizationforlb.admin
/opt hud	Toggle the live real-time BossBar performance HUD.	optimizationforlb.admin
/opt clean	All-in-one instant server cleanup sweep (items, XP, chunks, RAM, mobs).	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