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

• Smart Spawn Limiting - Per-chunk and per-world entity limits
• Hostile Mob Optimization - AI reduction based on distance from players
• Spawner Optimization - Dynamic delay adjustment and nearby entity limits
• Entity Culling - Intelligent removal of excess entities (oldest-first strategy)
• XP Farm Detection - Automatic detection and throttling of intensive farms
• Protected Entities - Never removes named mobs, pets, leashed entities, or bosses

Chunk Management System

• Load Optimization - Controls chunks loaded per tick
• Async Pre-generation - Pre-loads chunks ahead of flying players
• Activity Tracking - Monitors chunk activity levels (LOW/MEDIUM/HIGH/CRITICAL)
• Smart Unloading - Automatically unloads inactive chunks
• Spawn Protection - Keeps spawn chunks always loaded

Redstone Optimization System

• Update Throttling - Limits redstone updates per chunk/world
• Hopper Optimization - Transfer cooldowns and idle detection
• Clock Detection - Identifies and throttles redstone clocks
• Piston Limiting - Controls piston extensions per chunk
• Machine Detection - Alerts admins about lag-causing contraptions

Item Optimization System

• Smart Merging - Automatically merges nearby item stacks
• Scheduled Cleanup - Configurable cleanup intervals with warnings
• Projectile Limits - Per-player limits for snowballs, eggs, ender pearls
• Dupe Detection - Identifies suspicious item drop patterns
• Protected Items - Excludes valuable items from cleanup

Performance Monitoring

• Real-time TPS Tracking - Monitors server performance
• Memory Monitoring - Tracks RAM usage with alerts
• Emergency Mode - Automatic aggressive cleanup when TPS is critical
• Admin Alerts - 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

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

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

World Exclusions

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

Protected Entities

NebulaBooster will never remove these entities:

• Named entities (with custom names)
• Tamed animals (pets)
• Leashed entities
• Boss mobs (Wither, Ender Dragon, Elder Guardian, Warden)
• Villagers and Iron Golems
• 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

• Minecraft: 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x
• Server Software: PaperMC, Purpur, Pufferfish
• Java: 17 or higher

Dependencies

• Required: PaperMC (or fork)
• Optional: None

Known Compatibility

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

Technical Details

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

Support

• Issues: Report bugs on GitHub
• Discord: Join our community server
• Wiki: Detailed documentation available

Credits

Author: SrCodexStudio
Website: hidencloud.com