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

---