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. * **Normal 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. * **Threshold:** If TPS drops below **18.0**, the plugin enters **Aggressive Mode**. * **Recovery:** Automatically returns to Normal Mode once the server stabilizes. --- ## 📊 Performance Scaling | Feature | Normal Mode (> 18.0 TPS) | Aggressive Mode (< 18.0 TPS) | | :--- | :--- | :--- | | **Hibernation Range** | 32 Blocks | 24 Blocks | | **Collision Limit** | 15+ Mobs | 8+ Mobs | | **Item Merge Radius** | 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.