⚡ OptimizerX — The Ultimate Overdrive Performance Solution

OptimizerX is a next-generation, aggressive performance optimizer built from the ground up to eliminate server lag, micro-stutters, and high RAM usage. By utilizing ultra-lightweight, primitive-backed custom data structures like BlockKey and ChunkKey, it tracks redstone and hopper activity with absolute precision and a near-zero memory footprint.

Whether you run a heavy Towny, Factions, or massive Survival server, OptimizerX dynamically monitors your hardware resources and steps in with aggressive limits when your server needs it most—without breaking the core vanilla gameplay experience.

---

🚀 Key Features & Aggressive Modes

• 🔥 Emergency Overdrive Mode (/ox force): Instantly pushes the plugin into strict, hard performance limits. It slashes mob spawn caps down to absolute essentials per chunk to save your TPS during critical lag spikes or player rushes.
• 🧩 Custom Key Architecture (BlockKey & ChunkKey): Replaces heavy, memory-hogging Bukkit location objects with lightning-fast primitive caches. This completely immunizes your server against memory leaks and ensures maximum thread-safety.
• 🛑 Smart Hopper & Redstone Limiter: Blocks lag machines before they can choke the main thread. Empty hoppers are safely put into a 5-second deep sleep, and redstone ticks are capped dynamically per chunk.
• ⚙️ Asynchronous Map Pre-Loading (WarmupManager): Safely pre-loads your world spawn radius asynchronously on startup. It saves progress to disk across restarts so players won't experience chunk-generation lag while exploring.
• 💤 Dynamic View Distance (AFK Optimizer): Automatically detects idle players and drops their individual render distance down to 2 chunks, instantly recovering vast amounts of network and CPU bandwidth.
• 🧠 Intelligent Entity AI Throttling: If no players are within a tight 10-block radius, Villager and Mob AIs are completely frozen. No wasted CPU cycles on background entities!
• 📦 Next-Gen Item Stacking: Merges dropped ground items up to 256 per stack and attaches smooth, custom neon-green quantity holograms above them, massively lowering client and server entity rendering overhead.
• 💻 Hardware Auto-Tune: Automatically analyzes your server hardware (available CPU cores and allocated RAM) and dynamically configures server.properties on the fly for low-end environments.

---

💻 Commands & Permissions

All commands require the optimizerx.admin permission node.

Command	Description
/ox clean	Triggers a deep, lag-free smart purge on loaded chunks and safely invokes GC if required.
/ox usage	Displays real-time free RAM ratios and the exact number of active chunks loaded.
/ox force	Activates extreme Overdrive Mode to aggressively handle heavy server stress.
/ox gc	Forces the JVM garbage collector to run immediately with a before/after RAM comparison.
/ox purge	Aggressively clears ground items older than 60s, freezes distant mob AIs, and forces GC.
/ox chunks <radius>	Asynchronously pre-loads chunks within a block radius centered at world spawn.
/ox chunks status	Displays the live progress, percentage complete, and processed counts of the preloader.
/ox chunks cancel	Aborts the active chunk preloader task and clears the saved disk progress file.
/ox chunks resume	Resumes a previously stopped chunk preloader seamlessly from its last saved disk state.

---

⚙️ Configuration (config.yml)

OptimizerX comes pre-configured out of the box for immediate, peak performance results.

warmup:
  # Radius in blocks to pre-load
  preload-radius: 500
  # Loading speed (chunks per second)
  chunks-per-second: 5
  # Message shown to players while server is warming up
  kick-message: "&7Server is warming up, please wait..."

performance:
  # Seconds of inactivity before a player is considered AFK
  afk-threshold-seconds: 60
  # View distance to apply to AFK players
  reduced-view-distance: 2

performance-monitor:
  # Aims to keep at least 50% of RAM free at all times
  min-free-ram-percent: 0.50
  # How often to check resource usage (seconds)
  check-interval-seconds: 30
  # CPU usage threshold before alerting ops (0.85 = 85%)
  cpu-threshold: 0.85

security:
  # Redstone pulse limit per second per coordinate
  redstone-limit: 20

item-optimization:
  # Enable/disable item despawn optimization
  enabled: true
  # Time in seconds after which dropped items will be removed
  despawn-time-seconds: 60
  # Worlds where item despawn optimization should be active (empty for all worlds)
  worlds: []