🚀 OptimizerBoostTPS | Your TPS Guardian!

OptimizerBoostTPS is a versatile, advanced plugin for Minecraft servers, created with one main goal: the complete elimination of server lag (TPS drops) caused by an excess of mobs and malicious redstone lag machines.

Thanks to an intelligent AI management system and real-time redstone pulse analysis, the plugin reacts to threats before the server even experiences a performance drop. It was written specifically for the latest Paper versions (1.21+) using Java 21.

---

✨ Main Features

🧟‍♂️ Intelligent Mob Management (Culling & Throttling)

• Dynamic AI Freezing: Mobs located outside a configurable radius from the player lose their Artificial Intelligence (AI). They stop pathfinding and moving, reducing the CPU load caused by these entities to almost zero. They "come alive" the moment a player gets close.
• Chunk Limiting (Culling): Prevents the creation of massive farms and lag. Any mob exceeding the set limit within a single chunk is automatically removed.
• Smart Protection Filters: The plugin ensures gameplay isn't ruined. The system automatically protects mobs from removal and freezing if they:
• Have a NameTag (named by a player).
• Are tamed (e.g., dogs, cats).
• Are on a lead.
• Have picked up items or are wearing armor (optional).
• Come from spawn eggs (optional).
• Are on a configurable blacklist (e.g., Villagers, Wither, Ender Dragon, Warden).

⚡ Ruthless Lag Machine Blocker (Redstone Limiter)

• Fast Clock Detection: The system analyzes signal change frequencies for components like Observers, Repeaters, and Comparators.
• Instant Power Cut: Exceeding the pulses-per-second limit automatically cuts the power in the mechanism, neutralizing the lag.
• Warnings and Wire Destruction: In critical situations, an overloaded redstone wire is destroyed, and a sign with the warning "Server redstone TICK LIMIT" appears in its place, clearly informing the player about the system's intervention. The safeguard limits destruction to a maximum of 3 wires per second, preventing excessive block updates.

---

📜 Commands and Permissions

All system messages use modern MiniMessage formatting.

• /optimizer reload (aliases: /opt reload, /LAJCIORCODE-optimizer reload) – Safely reloads the entire configuration without needing a server restart.

Required permission: optimizerbylajcior.admin (Default for OP). Allows using the reload command and grants access to command auto-completion (TabCompleter).

---

🛠️ Configuration (config.yml)

Complete freedom to adjust the plugin to your server's needs:

⚙️ Mobs Section (mobs)

• task-interval: Frequency (in ticks) of scanning the world (default is 20 - a great balance).
• active-radius: Radius of active chunks around the player. Outside of it, mobs are put to sleep.
• max-per-chunk: Absolute limit of regular mobs per chunk (default is 25).
• ignore-persistent-mobs: Protection for mobs from commands and spawn eggs.
• ignore-equipped-mobs: Protection for mobs with armor/items in hand.
• ignored-types: List of entities excluded from optimization (e.g., bosses).

⚙️ Redstone Section (redstone)

• enabled: Main toggle for circuit protection.
• max-updates-per-second: Allowable number of signal changes per block in a second (default is 6 - effectively blocks lag machines).

---

📥 Technical Information

• Minecraft Version: 1.21+
• Required Java: 21
• Engine: Paper, Purpur