⚡ OptimizationForLB (OFLB) — The Ultimate All-in-One Server Optimizer

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

Many plugins simply display lag warnings or wipe dropped items on a timer. OptimizationForLB redefines server optimization by delivering an active multi-tiered performance pipeline: intelligent mob stacking, redstone clock protection, smart chunk unloader algorithms, aggressive heap memory reduction, real-time health telemetry, and autonomous Auto-Fix incident recovery.

Whether managing an SMP, Survival, Skyblock, Factions, or Network hub, OFLB stabilizes your tick rate, stops memory leaks, and delivers a consistent 20.0 TPS gameplay experience.

---

🚀 Key Advantages & Philosophy

• Active Rather than Passive: OFLB actively mitigates causes of lag instead of just informing administrators that the server is lagging.
• Lightweight by Design: Zero bloated dependencies, zero reflection bottlenecks, and zero NMS locks. Compatible across modern Minecraft iterations (1.20 up to 26.3+).
• Zero False-Alarms: Smart filtering ensures alerts never trigger during ordinary server startup ticks or normal 19-20 TPS operations.
• Preserves Player Gameplay: Designed to eliminate performance overhead without disrupting vanilla mechanics, redstone builds, or named pets.

---

📦 In-Depth Feature Breakdown

1. 🧬 Smart Entity & Mob Stacking Engine

Entities are one of the primary sources of tick lag on Minecraft servers. When dozens of mobs spawn in farms or dungeons, entity pathfinding and physics calculations quickly drain server CPU time.

• Intelligent Grouping: Automatically merges nearby living entities of the identical type within a configurable block radius (default 6 blocks).
• Visual Name Tags: Displays an intuitive custom tag (e.g., &e5x &cZombie) indicating the stack multiplier.
• Full Safety Whitelist: Bosses (Wither, Ender Dragon), Villagers, and custom player-named pets with nametags are automatically exempted to protect player investments.
• Instant Manual Sweep: Run /opt stack anytime to force an immediate world-wide entity compaction.

2. ⚡ Redstone Clock Limiter & Anti-Lag Machine Defense

Rapidly pulsing redstone circuits (clocks) cause constant light, block, and physics recalculations that freeze main thread ticks.

• Per-Chunk Rate Limiting: Tracks redstone state transitions within each chunk over a 1-second rolling window.
• Smart Throttling: When a chunk exceeds the allowed threshold (default: 150 updates/sec), OFLB cancels excessive pulses, freezing abusive lag machines in their tracks.
• Admin Security Alerts: Automatically alerts server staff with the exact world name and chunk coordinates [X, Z] where the redstone clock is detected.

3. 🗺️ Smart Chunk Management & CPU Unloader

Leaving inactive chunks loaded in server RAM forces the server to process background block ticks, lighting updates, and passive mob spawns in empty regions.

• Player Buffer Calculation: Automatically scans all loaded chunks across all worlds.
• Aggressive Inactive Purging: Chunks outside the active player buffer radius (default: 3 chunks) are unloaded cleanly from memory.
• Fresh Chunk Restoration: Memory allocations return to clean baseline states as though players never ventured into those chunks.

4. 🚨 Autonomous TPS Auto-Fix (Emergency Recovery)

When sudden entity explosions or unexpected lag spikes hit, server administrators are rarely online fast enough to prevent a server crash.

• Autonomous Emergency Response: The moment TPS drops to or below your critical threshold (default: 15.0 TPS), OFLB executes a targeted recovery sequence:
  1. Sweeps all loose ground items across every world.
  2. Compresses all clumped mob groups via entity stacking.
  3. Evicts unattended chunks from memory.
  4. Forces an optimized JVM Garbage Collection pass to flush cleared heap allocations.
  5. Optionally executes your own custom console commands defined in config.yml.
• Integrated Cooldown Protection: Includes an automatic cooldown timer (default: 60s) to prevent cascading recovery loops.

5. 🧹 Automated Ground Item Sweeper

• Scheduled Sweeps: Automatically clears loose ground items across all dimensions every 60 seconds.
• Player Warning Countdown: Broadcasts a clear 5-second countdown notice so players can pick up dropped valuables before the sweep.
• Zero Entity Lag: Prevents mob grinder dumps and mining clutter from overloading the server.

6. 🧠 Aggressive ~1 GB RAM Trimmer & GC Optimizer

• Heap Recovery: Combines inactive chunk unloading, entity cleanup, and dual-pass JVM Garbage Collection.
• Saves Up to ~1 GB: Reclaims clogged memory footprint without requiring a server reboot.
• Admin Control: Execute /opt trimram or /opt gc on-demand or allow automatic interval passes.

7. ⏱️ 1-Minute Automated Server Health Telemetry

• Auditing Every 60 Seconds: Generates a clean 1-minute server performance report.
• Comprehensive Metrics: Outputs live TPS, RAM usage (GB & percentage), mob entity totals, ground item counts, loaded chunk counts, and an Overall Health Score (0% - 100%).
• Flexible Broadcasts: Route reports exclusively to server administrators or broadcast server-wide.

8. 📶 Player Latency (Ping) Quality Badges

• Real-Time Latency Tracking: Continuously monitors player ping.
• Connection Badges: Categorizes player connections via visual quality badges:
  • 🟢 Excellent (< 50 ms)
  • 🟡 Good (50 - 120 ms)
  • 🟠 Moderate (120 - 200 ms)
  • 🔴 High Latency (> 200 ms)
• Targeted Notices: Informs lagging players directly to eliminate confusion over whether latency is client-side or server-side.

9. 🎨 Visual HUD & Clean Chat Experience

• Progress Bar HUD: /opt status displays colored visual progress bars for TPS and RAM usage:
  • TPS: 19.95 [██████████]
  • RAM: 4.10 / 8.00 GB (51.2%) [█████░░░░░]
• No Intrusive Prefixes: Warning alerts omit distracting plugin tags, displaying clean, professional red alerts (WARNING: ...).
• Sound & Action Bar Support: Configurable notification sounds and Action Bar display toggles.

---

🛠️ Complete Command Reference

Command	Description	Permission
/opt status	Shows visual TPS, RAM HUD progress bars, and player ping.	optimizationforlb.admin
/opt autofix	Manually triggers the automated emergency TPS recovery sequence.	optimizationforlb.admin
/opt stack	Manually triggers a world-wide mob stacking pass.	optimizationforlb.admin
/opt health	Broadcasts the 1-minute server health telemetry summary.	optimizationforlb.admin
/opt trimram	Executes aggressive ~1 GB RAM reduction.	optimizationforlb.admin
/opt clearitems	Clears all dropped ground items across all dimensions.	optimizationforlb.admin
/opt purgechunks	Unloads inactive, unoccupied chunks to reclaim CPU/RAM.	optimizationforlb.admin
/opt gc	Requests a manual JVM Garbage Collection pass and reports freed MB.	optimizationforlb.admin
/opt ping	Displays the player's connection latency and quality badge.	optimizationforlb.admin
/opt reload	Reloads config.yml settings, tasks, and thresholds without rebooting.	optimizationforlb.admin
/opt help	Displays the complete in-game command assistance menu.	optimizationforlb.admin

---

⚙️ Fully Configurable Configuration (config.yml)

Every single message, numerical threshold, interval timer, and feature toggle can be customized in the 100% English config.yml:

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

alerts:
  display-mode: "CHAT" # Options: CHAT, ACTION_BAR, BOTH
  sound-effects:
    enabled: true
    sound: "BLOCK_NOTE_BLOCK_BASS"
    volume: 1.0
    pitch: 0.5

# Active Entity (Mob) Stacking
entity-stacker:
  enabled: true
  interval-seconds: 15
  search-radius-blocks: 6.0
  max-stack-size: 50
  name-format: "&e{count}x &c{type}"
  whitelist-exemptions:
    - "WITHER"
    - "ENDER_DRAGON"
    - "VILLAGER"

# Active Redstone Rate-Limiter
redstone-limiter:
  enabled: true
  max-updates-per-second-per-chunk: 150
  notify-admins: true
  warning-message: "&c[REDSTONE LIMITER] Excessive redstone activity throttled in world &e{world} &cat chunk &e[{x}, {z}]&c!"

# Smart Chunk Management
smart-chunk-manager:
  enabled: true
  interval-seconds: 30
  player-buffer-radius-chunks: 3
  unload-unoccupied: true
  notify-log: true

# Autonomous TPS Auto-Fix
auto-fix:
  enabled: true
  trigger-tps: 15.0
  cooldown-seconds: 60
  notify-broadcast: true
  actions:
    clear-ground-items: true
    stack-entities-pass: true
    purge-inactive-chunks: true
    trigger-jvm-gc: true
    custom-commands:
      enabled: false
      commands:
        - "say [Server] Automatic performance recovery completed."

# 1-Minute Health Telemetry
health-report:
  enabled: true
  interval-seconds: 60
  broadcast-to-all: false

# 1-Minute Ground Item Cleaner
item-cleaner:
  enabled: true
  interval-seconds: 60
  warning-countdown-seconds: 5

# Aggressive RAM Trimmer
ram-trimmer:
  enabled: true
  auto-trim-interval-seconds: 300