📖About 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.