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