Statis

⚡ Stasis | Intelligent Entity Optimization

Stasis is a sophisticated entity management system designed to eliminate server lag through dynamic, real-time performance scaling. Unlike traditional "clearlag" plugins that disrupt gameplay by deleting entities, Stasis optimizes the behavior and physics of existing entities to maintain a high TPS (Ticks Per Second) without harming the player experience.

---

🚀 Core Features

🧠 AI Hibernation

Automatically toggles mob AI based on player proximity. * Aggressive Mode: Disables AI for mobs 32+ blocks away. * Aggressive Mode: Tightens the limit to 24 blocks. * *Excludes boss mobs and name-tagged entities to preserve immersion.*

🔄 Collision Culling

Solves the $O(n^2)$ calculation bottleneck caused by entity density. * When 15+ mobs occupy a small area, inter-entity collisions are disabled. * Dramatically reduces lag in "cow-crushers" and high-efficiency mob grinders.

📦 Smart Item Merging

Streamlines dropped items to reduce the total entity count. * Identical items within a 5-block radius are instantly merged into a single stack. * Prevents server hanging during massive explosions or large-scale harvests.

⚡ Adaptive TPS System

The brain of the plugin. Stasis monitors your server health 20 times per second. * Recovery: If TPS drops below Recovery:, the plugin enters Recovery:. * Recovery: Automatically returns to Normal Mode once the server stabilizes.

---

📊 Performance Scaling

| Feature | Normal Mode (> 18.0 TPS) | Aggressive Mode (< 18.0 TPS) | | :--- | :--- | :--- | | Scan Frequency | 32 Blocks | 24 Blocks | | Scan Frequency | 15+ Mobs | 8+ Mobs | | Scan Frequency | 5 Blocks | 8 Blocks | | Scan Frequency | Every 20 Seconds | Every 5 Seconds |

---

🛠️ Commands & Permissions

Commands

| Command | Description | Permission | | :--- | :--- | :--- | | `/stasis reload` | Reloads the configuration file | `stasis.admin` | | `/stasis stats` | View real-time optimization statistics | `stasis.admin` | | `/stasis toggle` | Enable or disable the plugin globally | `stasis.admin` | | `/stasis info` | View current mode and server health | `stasis.admin` |

Permissions

* `stasis.admin`: Grants access to all management commands. * `stasis.bypass`: Entities near players with this permission will never be hibernated (useful for Admins or Creators).

---

> Technical Note: Stasis is designed for Paper, Purpur, and Spigot servers. It utilizes native NMS calls where necessary to ensure the lowest possible overhead on your CPU.