OptimizerX

# ⚡ 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 ` | 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.

```yaml 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: []