⚡ OptimizationForLB v3.0.2

OptimizationForLB (OFLB) v3.0.2 is a comprehensive, enterprise-tier performance suite engineered specifically for Paper, Purpur, Pufferfish, and Folia servers.

Featuring native bStats metrics (ID: 34934), an interactive Chest GUI dashboard, live BossBar performance HUD, dynamic simulation distance auto-tuning, XP orb merging, villager brain optimization, and active lag-machine defenses.

---

🔥 Key Highlights in v3.0.2

• 📈 Official bStats Metrics (ID: 34934): Real-time anonymous global telemetry tracking active servers, players, and feature adoption with clean internal shaded packaging.
• 🔮 Experience Orb (XP) Stacker: Aggregates hundreds of floating XP orbs from mob/guardian/gold farms into dense composite orbs every 3 seconds, cutting entity tick overhead by up to 90%.
• 👨‍🌾 Smart Villager Brain Optimizer: Relieves CPU thread congestion in trading halls by disabling redundant pathfinding calculations for boxed villagers while keeping trading fully 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 command spam.
• 🖥️ Interactive GUI Dashboard (/opt gui): Clickable in-game chest control room featuring live TPS speedometer dials, RAM meters, entity census, and 1-click optimization switches.
• ⚡ Dynamic Auto-Tuner: Dynamically scales world simulation distance between 4 and 8 chunks depending on instantaneous tick latency, keeping TPS rock-solid at 20.0.
• 🛡️ Anti-Packet & Crash Shield: Blocks high-speed inventory click spamming and neutralizes malicious book crash exploits.
• 🎯 Accurate Mob Stacker Single-Kill Mode: Stacked mobs decrement one-by-one with 100% vanilla drops and experience rewards.

---

🛠️ Complete Command Reference

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

---

⚙️ Configuration Preview (config.yml)

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

xp-orb-optimizer:
  enabled: true
  interval-seconds: 3
  search-radius-blocks: 4.0
  max-orb-value: 2500

villager-optimizer:
  enabled: true
  interval-seconds: 30
  throttle-boxed-villagers: true

light-limiter:
  enabled: true
  max-piston-updates-per-sec: 80

bossbar-hud:
  enabled: true

auto-tuner:
  enabled: true
  min-simulation-distance: 4
  max-simulation-distance: 8

packet-limiter:
  enabled: true
  max-inventory-clicks-per-second: 30

mob-ai-throttler:
  enabled: true
  trigger-tps: 16.5
  restore-tps: 18.5

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