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