NebulaBooster

NebulaBooster

---

Overview

NebulaBooster is a comprehensive server optimization plugin designed to dramatically improve your Minecraft server's performance. It intelligently manages entities, chunks, redstone mechanics, and items to maintain smooth gameplay even under heavy load.

Whether you're running a small survival server or a large network with hundreds of players, NebulaBooster adapts to your needs with highly configurable optimization systems.

---

Key Features

Entity Management System

- Protected Entities - Per-chunk and per-world entity limits - Protected Entities - AI reduction based on distance from players - Protected Entities - Dynamic delay adjustment and nearby entity limits - Protected Entities - Intelligent removal of excess entities (oldest-first strategy) - Protected Entities - Automatic detection and throttling of intensive farms - Protected Entities - Never removes named mobs, pets, leashed entities, or bosses

Chunk Management System

- Spawn Protection - Controls chunks loaded per tick - Spawn Protection - Pre-loads chunks ahead of flying players - Spawn Protection - Monitors chunk activity levels (LOW/MEDIUM/HIGH/CRITICAL) - Spawn Protection - Automatically unloads inactive chunks - Spawn Protection - Keeps spawn chunks always loaded

Redstone Optimization System

- Machine Detection - Limits redstone updates per chunk/world - Machine Detection - Transfer cooldowns and idle detection - Machine Detection - Identifies and throttles redstone clocks - Machine Detection - Controls piston extensions per chunk - Machine Detection - Alerts admins about lag-causing contraptions

Item Optimization System

- Protected Items - Automatically merges nearby item stacks - Protected Items - Configurable cleanup intervals with warnings - Protected Items - Per-player limits for snowballs, eggs, ender pearls - Protected Items - Identifies suspicious item drop patterns - Protected Items - Excludes valuable items from cleanup

Performance Monitoring

- Detailed Statistics - Monitors server performance - Detailed Statistics - Tracks RAM usage with alerts - Detailed Statistics - Automatic aggressive cleanup when TPS is critical - Detailed Statistics - Notifies staff of performance issues - Detailed Statistics - View all metrics with `/nebula stats`

---

Optimization Details

Entity Optimization

| Feature | Description | Default | |---------|-------------|---------| | Hostile per chunk | Maximum hostile mobs per chunk | 25 | | Passive per chunk | Maximum passive mobs per chunk | 15 | | AI reduction distance | Distance to reduce mob AI | 32 blocks | | AI disable distance | Distance to disable mob AI | 64 blocks | | No-target despawn | Time before idle hostile despawns | 60 seconds |

Spawner Optimization

| Feature | Description | Default | |---------|-------------|---------| | Max nearby entities | Entities before spawner pauses | 12 | | Radius check | Area to check for entities | 16 blocks | | Min spawn delay | Minimum ticks between spawns | 200 ticks | | Max spawn delay | Maximum ticks between spawns | 800 ticks | | Player activation range | Range for spawner activation | 16 blocks |

Chunk Optimization

| Feature | Description | Default | |---------|-------------|---------| | Max chunks per tick | Chunk loads per tick | 4 | | Inactive timeout | Time before unloading | 300 seconds | | Pre-generation | Chunks ahead for flyers | 3 chunks | | Min unload distance | Minimum distance from players | 10 chunks |

Redstone Optimization

| Feature | Description | Default | |---------|-------------|---------| | Max updates per chunk | Redstone updates limit | 100/tick | | Max updates per world | World-wide limit | 2000/tick | | Hopper transfer cooldown | Ticks between transfers | 16 ticks | | Max hoppers per chunk | Hopper limit per chunk | 32 | | Clock detection | Minimum frequency to detect | 4 ticks |

Item Optimization

| Feature | Description | Default | |---------|-------------|---------| | Merge radius | Distance for item merging | 2.5 blocks | | Cleanup interval | Time between cleanups | 300 seconds | | Max item age | Item lifetime on ground | 180 seconds | | Warning times | Countdown warnings | 60, 30, 10, 5s |

---

Commands

| Command | Description | Permission | |---------|-------------|------------| | `/nebula` or `/nb` | Main command | `nebulabooster.use` | | `/nebula stats` | View server statistics | `nebulabooster.stats` | | `/nebula reload` | Reload configuration | `nebulabooster.reload` | | `/nebula toggle <module>` | Enable/disable modules | `nebulabooster.toggle` | | `/nebula monitor` | Real-time performance monitor | `nebulabooster.monitor` | | `/nebula cleanup` | Manual item cleanup | `nebulabooster.cleanup` | | `/nebula chunk` | Current chunk information | `nebulabooster.chunk` | | `/nebula detect` | Detect lag sources | `nebulabooster.detect` | | `/nebula emergency` | Force emergency cleanup | `nebulabooster.emergency` |

Detection Commands

| Command | Description | |---------|-------------| | `/nebula detect spawners [radius] [type]` | Find spawners near all players | | `/nebula detect hoppers [radius]` | Find hopper clusters | | `/nebula detect redstone [radius]` | Find redstone mechanisms | | `/nebula detect report [radius]` | Full detection report |

---

Permissions

| Permission | Description | Default | |------------|-------------|---------| | `nebulabooster.use` | Basic command access | op | | `nebulabooster.admin` | All permissions | op | | `nebulabooster.stats` | View statistics | op | | `nebulabooster.reload` | Reload config | op | | `nebulabooster.toggle` | Toggle modules | op | | `nebulabooster.monitor` | Performance monitor | op | | `nebulabooster.cleanup` | Manual cleanup | op | | `nebulabooster.chunk` | Chunk info | op | | `nebulabooster.detect` | Detection commands | op | | `nebulabooster.emergency` | Emergency mode | op | | `nebulabooster.alerts` | Receive alerts | op | | `nebulabooster.bypass` | Bypass all limits | false |

---

Installation

1. Download the latest version of NebulaBooster 2. Place the `.jar` file in your server's `plugins` folder 3. Restart your server 4. Configure settings in `plugins/NebulaBooster/config.yml` 5. Use `/nebula reload` to apply changes

---

Configuration

Module Toggles

```yaml modules: entity-optimizer: true # Entity management system chunk-optimizer: true # Chunk management system redstone-optimizer: true # Redstone throttling item-optimizer: true # Item merging & cleanup performance-monitor: true # TPS/memory monitoring ```

Language Support

```yaml general: language: "en" # "en" for English, "es" for Spanish ```

World Exclusions

```yaml general: excluded-worlds: - "world_lobby" - "creative_world" ```

---

Protected Entities

NebulaBooster will never remove these entities:

- Armor Stands, Item Frames, Paintings (with custom names) - Armor Stands, Item Frames, Paintings (pets) - Armor Stands, Item Frames, Paintings - Armor Stands, Item Frames, Paintings (Wither, Ender Dragon, Elder Guardian, Warden) - Armor Stands, Item Frames, Paintings - Armor Stands, Item Frames, Paintings

---

Server Recommendations

Small Servers (1-30 players)

- Use default settings - Enable all modules - Aggressive entity culling

Medium Servers (30-80 players)

- Increase entity limits slightly - Pre-generation for flying players - Moderate redstone limits

Large Servers (80+ players)

- Lower entity limits - Aggressive chunk unloading - Strict redstone throttling - Enable emergency mode

Technical/Redstone Servers

- Increase redstone limits - Disable clock detection - Higher hopper limits - Careful with piston limits

---

Performance Impact

| Scenario | Without NebulaBooster | With NebulaBooster | |----------|----------------------|-------------------| | 100 players, vanilla | ~12 TPS | ~19 TPS | | Large mob farm active | ~8 TPS | ~17 TPS | | Redstone contraption spam | ~10 TPS | ~18 TPS | | 500+ ground items | ~14 TPS | ~20 TPS |

*Results may vary based on server hardware and configuration*

---

Compatibility

Supported Versions

- Java: 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x - Java: PaperMC, Purpur, Pufferfish - Java: 17 or higher

Dependencies

- Optional: PaperMC (or fork) - Optional: None

Known Compatibility

- Works with most economy plugins - Compatible with world management plugins - Works alongside other optimization plugins

---

Technical Details

- Memory Efficient: Kotlin - Memory Efficient: MCCoroutine for non-blocking tasks - Memory Efficient: ConcurrentHashMap for data structures - Memory Efficient: Paper API with async chunk loading - Memory Efficient: Lazy sequences and object pooling

---

Support

- Wiki: Report bugs on GitHub - Wiki: Join our community server - Wiki: Detailed documentation available

---

Credits

Website: SrCodexStudio Website: Website:

---