# NebulaBooster<\/p>\n
<\/p>\n
**Advanced Server Performance Optimization Plugin for PaperMC**<\/p>\n
\n
\n<\/p>\n
[Features](#-features) \u2022 [Installation](#-installation) \u2022 [Commands](#-commands) \u2022 [Configuration](#%EF%B8%8F-configuration) \u2022 [Support](#-support)<\/p>\n<\/div>\n
—<\/p>\n
## Overview<\/p>\n
**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.<\/p>\n
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.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### Entity Management System
\n– **Smart Spawn Limiting** – Per-chunk and per-world entity limits
\n– **Hostile Mob Optimization** – AI reduction based on distance from players
\n– **Spawner Optimization** – Dynamic delay adjustment and nearby entity limits
\n– **Entity Culling** – Intelligent removal of excess entities (oldest-first strategy)
\n– **XP Farm Detection** – Automatic detection and throttling of intensive farms
\n– **Protected Entities** – Never removes named mobs, pets, leashed entities, or bosses<\/p>\n
### Chunk Management System
\n– **Load Optimization** – Controls chunks loaded per tick
\n– **Async Pre-generation** – Pre-loads chunks ahead of flying players
\n– **Activity Tracking** – Monitors chunk activity levels (LOW\/MEDIUM\/HIGH\/CRITICAL)
\n– **Smart Unloading** – Automatically unloads inactive chunks
\n– **Spawn Protection** – Keeps spawn chunks always loaded<\/p>\n
### Redstone Optimization System
\n– **Update Throttling** – Limits redstone updates per chunk\/world
\n– **Hopper Optimization** – Transfer cooldowns and idle detection
\n– **Clock Detection** – Identifies and throttles redstone clocks
\n– **Piston Limiting** – Controls piston extensions per chunk
\n– **Machine Detection** – Alerts admins about lag-causing contraptions<\/p>\n
### Item Optimization System
\n– **Smart Merging** – Automatically merges nearby item stacks
\n– **Scheduled Cleanup** – Configurable cleanup intervals with warnings
\n– **Projectile Limits** – Per-player limits for snowballs, eggs, ender pearls
\n– **Dupe Detection** – Identifies suspicious item drop patterns
\n– **Protected Items** – Excludes valuable items from cleanup<\/p>\n
### Performance Monitoring
\n– **Real-time TPS Tracking** – Monitors server performance
\n– **Memory Monitoring** – Tracks RAM usage with alerts
\n– **Emergency Mode** – Automatic aggressive cleanup when TPS is critical
\n– **Admin Alerts** – Notifies staff of performance issues
\n– **Detailed Statistics** – View all metrics with `\/nebula stats`<\/p>\n
—<\/p>\n
## Optimization Details<\/p>\n
### Entity Optimization<\/p>\n
| Feature | Description | Default |
\n|———|————-|———|
\n| Hostile per chunk | Maximum hostile mobs per chunk | 25 |
\n| Passive per chunk | Maximum passive mobs per chunk | 15 |
\n| AI reduction distance | Distance to reduce mob AI | 32 blocks |
\n| AI disable distance | Distance to disable mob AI | 64 blocks |
\n| No-target despawn | Time before idle hostile despawns | 60 seconds |<\/p>\n
### Spawner Optimization<\/p>\n
| Feature | Description | Default |
\n|———|————-|———|
\n| Max nearby entities | Entities before spawner pauses | 12 |
\n| Radius check | Area to check for entities | 16 blocks |
\n| Min spawn delay | Minimum ticks between spawns | 200 ticks |
\n| Max spawn delay | Maximum ticks between spawns | 800 ticks |
\n| Player activation range | Range for spawner activation | 16 blocks |<\/p>\n
### Chunk Optimization<\/p>\n
| Feature | Description | Default |
\n|———|————-|———|
\n| Max chunks per tick | Chunk loads per tick | 4 |
\n| Inactive timeout | Time before unloading | 300 seconds |
\n| Pre-generation | Chunks ahead for flyers | 3 chunks |
\n| Min unload distance | Minimum distance from players | 10 chunks |<\/p>\n
### Redstone Optimization<\/p>\n
| Feature | Description | Default |
\n|———|————-|———|
\n| Max updates per chunk | Redstone updates limit | 100\/tick |
\n| Max updates per world | World-wide limit | 2000\/tick |
\n| Hopper transfer cooldown | Ticks between transfers | 16 ticks |
\n| Max hoppers per chunk | Hopper limit per chunk | 32 |
\n| Clock detection | Minimum frequency to detect | 4 ticks |<\/p>\n
### Item Optimization<\/p>\n
| Feature | Description | Default |
\n|———|————-|———|
\n| Merge radius | Distance for item merging | 2.5 blocks |
\n| Cleanup interval | Time between cleanups | 300 seconds |
\n| Max item age | Item lifetime on ground | 180 seconds |
\n| Warning times | Countdown warnings | 60, 30, 10, 5s |<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | ### Detection Commands<\/p>\n | Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Installation<\/p>\n 1. Download the latest version of NebulaBooster —<\/p>\n ## Configuration<\/p>\n ### Module Toggles<\/p>\n “`yaml ### Language Support<\/p>\n “`yaml ### World Exclusions<\/p>\n “`yaml —<\/p>\n ## Protected Entities<\/p>\n NebulaBooster will **never remove** these entities:<\/p>\n – **Named entities** (with custom names) —<\/p>\n ## Server Recommendations<\/p>\n ### Small Servers (1-30 players) ### Medium Servers (30-80 players) ### Large Servers (80+ players) ### Technical\/Redstone Servers —<\/p>\n ## Performance Impact<\/p>\n | Scenario | Without NebulaBooster | With NebulaBooster | *Results may vary based on server hardware and configuration*<\/p>\n —<\/p>\n ## Compatibility<\/p>\n ### Supported Versions ### Dependencies ### Known Compatibility —<\/p>\n ## Technical Details<\/p>\n – **Language:** Kotlin —<\/p>\n ## Support<\/p>\n – **Issues:** Report bugs on GitHub —<\/p>\n ## Credits<\/p>\n **Author:** SrCodexStudio —<\/p>\n **Made with love for the Minecraft community**<\/p>\n  Say goodbye to lag! Boost your server’s TPS with smart entity culling, chunk optimization, redstone throttling & automatic cleanup. Your pets and builds stay safe.<\/p>\n","protected":false},"featured_media":109258,"template":"","meta":{"_minecraft_slug":"nebulabooster","_minecraft_project_id":"9ZlvaozE","_minecraft_author":"srcodex","_minecraft_license":"Apache-2.0","_minecraft_downloads":1577,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nebulabooster.zip","_minecraft_size_bytes":2916737,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T07:03:51.800353Z","_minecraft_date_created":"2023-09-12T17:26:11.986914Z","_minecraft_date_modified":"2026-01-12T03:17:01.252077Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nebulabooster","_minecraft_icon_attachment_id":109258,"_minecraft_imported_at":"2026-06-06T10:12:20+00:00","_minecraft_import_hash":"653e933adeca05ad59ef4175659c1b53","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,90,127,128,129,92,159],"mod_loader":[130,132,133,134],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-109257","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-worldgen","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/nebula` or `\/nb` | Main command | `nebulabooster.use` |
\n| `\/nebula stats` | View server statistics | `nebulabooster.stats` |
\n| `\/nebula reload` | Reload configuration | `nebulabooster.reload` |
\n| `\/nebula toggle
\n| `\/nebula monitor` | Real-time performance monitor | `nebulabooster.monitor` |
\n| `\/nebula cleanup` | Manual item cleanup | `nebulabooster.cleanup` |
\n| `\/nebula chunk` | Current chunk information | `nebulabooster.chunk` |
\n| `\/nebula detect` | Detect lag sources | `nebulabooster.detect` |
\n| `\/nebula emergency` | Force emergency cleanup | `nebulabooster.emergency` |<\/p>\n
\n|———|————-|
\n| `\/nebula detect spawners [radius] [type]` | Find spawners near all players |
\n| `\/nebula detect hoppers [radius]` | Find hopper clusters |
\n| `\/nebula detect redstone [radius]` | Find redstone mechanisms |
\n| `\/nebula detect report [radius]` | Full detection report |<\/p>\n
\n|————|————-|———|
\n| `nebulabooster.use` | Basic command access | op |
\n| `nebulabooster.admin` | All permissions | op |
\n| `nebulabooster.stats` | View statistics | op |
\n| `nebulabooster.reload` | Reload config | op |
\n| `nebulabooster.toggle` | Toggle modules | op |
\n| `nebulabooster.monitor` | Performance monitor | op |
\n| `nebulabooster.cleanup` | Manual cleanup | op |
\n| `nebulabooster.chunk` | Chunk info | op |
\n| `nebulabooster.detect` | Detection commands | op |
\n| `nebulabooster.emergency` | Emergency mode | op |
\n| `nebulabooster.alerts` | Receive alerts | op |
\n| `nebulabooster.bypass` | Bypass all limits | false |<\/p>\n
\n2. Place the `.jar` file in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure settings in `plugins\/NebulaBooster\/config.yml`
\n5. Use `\/nebula reload` to apply changes<\/p>\n
\nmodules:
\n entity-optimizer: true # Entity management system
\n chunk-optimizer: true # Chunk management system
\n redstone-optimizer: true # Redstone throttling
\n item-optimizer: true # Item merging & cleanup
\n performance-monitor: true # TPS\/memory monitoring
\n“`<\/p>\n
\ngeneral:
\n language: “en” # “en” for English, “es” for Spanish
\n“`<\/p>\n
\ngeneral:
\n excluded-worlds:
\n – “world_lobby”
\n – “creative_world”
\n“`<\/p>\n
\n– **Tamed animals** (pets)
\n– **Leashed entities**
\n– **Boss mobs** (Wither, Ender Dragon, Elder Guardian, Warden)
\n– **Villagers and Iron Golems**
\n– **Armor Stands, Item Frames, Paintings**<\/p>\n
\n– Use default settings
\n– Enable all modules
\n– Aggressive entity culling<\/p>\n
\n– Increase entity limits slightly
\n– Pre-generation for flying players
\n– Moderate redstone limits<\/p>\n
\n– Lower entity limits
\n– Aggressive chunk unloading
\n– Strict redstone throttling
\n– Enable emergency mode<\/p>\n
\n– Increase redstone limits
\n– Disable clock detection
\n– Higher hopper limits
\n– Careful with piston limits<\/p>\n
\n|———-|———————-|——————-|
\n| 100 players, vanilla | ~12 TPS | ~19 TPS |
\n| Large mob farm active | ~8 TPS | ~17 TPS |
\n| Redstone contraption spam | ~10 TPS | ~18 TPS |
\n| 500+ ground items | ~14 TPS | ~20 TPS |<\/p>\n
\n– **Minecraft:** 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x
\n– **Server Software:** PaperMC, Purpur, Pufferfish
\n– **Java:** 17 or higher<\/p>\n
\n– **Required:** PaperMC (or fork)
\n– **Optional:** None<\/p>\n
\n– Works with most economy plugins
\n– Compatible with world management plugins
\n– Works alongside other optimization plugins<\/p>\n
\n– **Async Operations:** MCCoroutine for non-blocking tasks
\n– **Thread Safety:** ConcurrentHashMap for data structures
\n– **API:** Paper API with async chunk loading
\n– **Memory Efficient:** Lazy sequences and object pooling<\/p>\n
\n– **Discord:** Join our community server
\n– **Wiki:** Detailed documentation available<\/p>\n
\n**Website:** hidencloud.com<\/p>\n
\n<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"