PerfoBooster

**PerfoBooster** delivers powerful server optimization through intelligent resource management, helping administrators maintain smooth gameplay even under heavy load. ### Key Features: - **Aggressive Despawning**: Automatically despawn configurable entity types (e.g., bats, experience orbs) far from players to reduce entity load, while protecting named entities. - **Farm Rate Limiter**: Control animal breeding and mob spawner output per chunk to prevent entity overload from farms. - **Disable Mob AI**: Freezes specified mob types in place by disabling their movement and behavior to reduce CPU usage while keeping them visually present. - **Inactive Chunk Unloader**: Intelligently unloads chunks that are far from players and not actively used, freeing up server memory. - **Chunk Load Controller**: Restricts plugins from loading new chunks synchronously, preventing potential lag spikes (configurable whitelist). - **Laggy Chunk Unloader**: Identifies and unloads chunks exhibiting excessive tile entity update activity if no players are nearby. - **Hopper Optimizer**: Fine-tunes hopper behavior with smart throttling for empty/full hoppers, global transfer-per-tick limits, and optional per-chunk hopper count limits. - **Adjust Spawner**: Dynamically adjusts mob spawner settings (spawn count, delay, activation range, max nearby entities) based on TPS, light levels, and player proximity. - **Instant Leaf Decay**: Accelerates leaf block removal when logs are broken or leaves naturally decay, preventing floating leaf blocks and reducing world clutter for improved performance. - **Max Explosion Yield**: Limits the maximum yield/radius of explosions to prevent excessive damage, with entity-specific limits for TNT, Creepers, Fireballs, Wither Skulls, and End Crystals. - **Anti-Chain Explosions**: Prevents chain reactions where explosions trigger other nearby explosions, with configurable radius and cooldown settings to stop TNT chains and block ignition. - **Deactivate Explosions**: Completely disables explosions based on server performance or configuration, with TPS-based automatic deactivation and entity-specific controls. - **Player Redstone Anti-Spam**: Prevents players from spamming redstone-interactive blocks, with configurable interaction limits and temporary blacklisting. - **Redstone Limiter**: Prevents lag by limiting the total number of redstone components allowed within a radius, blocking placement and interactions when limits are exceeded. - **Automated Redstone Deactivation**: Automatically disables all redstone activity server-wide when TPS drops below a threshold, then re-enables it when TPS recovers, with circuit breaker protection to prevent rapid on/off cycling. - **Automatic Garbage Collection**: Triggers Java's garbage collection intelligently when memory usage exceeds configurable thresholds, helping to maintain stable memory. - **Dynamic View Distance Scaler**: Automatically adjusts players' view distance based on current server TPS, reducing network and client-side load during lag. - **Idle Simulation Distance:** Reduces simulation distance for idle players to lower server load while maintaining normal distance for active players. - **Software Optimizer (Experimental)**: Simple and powerful server configuration optimizer with three optimization levels (Conservative, Balanced, Aggressive). Intelligently optimizes 45+ settings across bukkit.yml, spigot.yml, and Paper configurations with automatic backup creation. ### Commands: | Command | Description | Permission Required | |---------|-------------|--------------------| | `/perfobooster` (alias: `/pb`, `/perfob`) | Shows the help menu with available commands | `perfobooster.command` | | `/pb reload` | Reloads the PerfoBooster configuration | `perfobooster.reload` | | `/pb status` | Shows the current operational status of all optimization modules | `perfobooster.status` | | `/pb gc` | Manually triggers server garbage collection | `perfobooster.gc` | | `/pb load` | Displays server load statistics, including entities, chunks, TPS, and MSPT | `perfobooster.load` | | `/pb sysinfo` | Shows detailed system information such as memory usage, CPU load, storage | `perfobooster.sysinfo` | | `/pb update` | Displays information about the current plugin version and available updates | `perfobooster.update` | | `/pb update check` | Forces a new check for plugin updates | `perfobooster.update` | | `/pb update download` | Downloads the latest available update | `perfobooster.admin` | | `/pb info` | Shows plugin information including server details, performance summary | `perfobooster.command` | | `/pb optimizer` | Access to experimental software optimization features | `perfobooster.admin` | | `/pb optimizer optimize ` | Apply intelligent optimizations (conservative/balanced/aggressive) | `perfobooster.admin` | | `/pb optimizer stats` | Show optimization statistics and success rates | `perfobooster.admin` | | `/pb optimizer backup list` | List available configuration backups | `perfobooster.admin` | | `/pb optimizer restore ` | Restore configuration from a specific backup | `perfobooster.admin` | | `/pb optimizer help` | Show optimizer help and level descriptions | `perfobooster.admin` | ### Permissions: | Permission | Description | Default | |------------|-------------|----------| | `perfobooster.command` | Allows access to the base `/perfobooster` command and help | `true` | | `perfobooster.reload` | Allows reloading the PerfoBooster configuration | `op` | | `perfobooster.status` | Allows checking the current optimization status | `op` | | `perfobooster.gc` | Allows manual triggering of garbage collection | `op` | | `perfobooster.load` | Allows viewing server load statistics | `op` | | `perfobooster.sysinfo` | Allows viewing system information | `op` | | `perfobooster.update` | Allows checking for plugin updates | `op` | | `perfobooster.admin` | Allows downloading updates, update notifications, and software optimizer access | `op` | ### Software Optimizer Levels: ### 🟢 Conservative - Safe Choice - **Performance Gain**: ⭐⭐☆☆☆ (Moderate) | **Gameplay Impact**: ⭐☆☆☆☆ (Minimal) - **Spawn Reductions**: 20-50% reduction in spawn limits - **Entity Ranges**: 13% reduction in activation ranges - **Features**: Basic optimizations, explosion optimization, item despawn improvements - **Best For**: First-time users, production servers, minimal risk tolerance - **Expected TPS Gain**: +0.5-3 TPS depending on server size ### 🟡 Balanced - Recommended Default - **Performance Gain**: ⭐⭐⭐⭐☆ (High) | **Gameplay Impact**: ⭐⭐☆☆☆ (Minor) - **Spawn Reductions**: 40-80% reduction in spawn limits - **Entity Ranges**: 19-38% reduction in activation ranges - **Features**: Alternate Current redstone, villager AI optimization, collision improvements - **Best For**: Most servers, good performance/gameplay balance - **Expected TPS Gain**: +1-6 TPS depending on server size ### 🔴 Aggressive - Maximum Performance - **Performance Gain**: ⭐⭐⭐⭐⭐ (Maximum) | **Gameplay Impact**: ⭐⭐⭐☆☆ (Moderate) - **Spawn Reductions**: 50-93% reduction in spawn limits - **Entity Ranges**: 25-50% reduction in activation ranges - **Features**: All optimizations enabled, nether ceiling damage, faster item despawn - **Best For**: High-performance servers, testing environments - **Expected TPS Gain**: +2-10 TPS depending on server size - **⚠️ Warning**: Test thoroughly before production use ### Optimization Coverage: ### 📊 Spawn Management (bukkit.yml) - **7 Entity Types**: Monsters, animals, water creatures, ambient, axolotls, water underground - **Conservative**: 20-50% spawn reductions - **Balanced**: 40-80% spawn reductions - **Aggressive**: 50-93% spawn reductions ### 🎯 Entity Performance (spigot.yml) - **5 Activation Ranges**: Animals, monsters, misc, water, villagers - **Merge Optimization**: Item and XP merge radius improvements - **Spawn Range**: Mob spawn distance optimization - **Hopper Performance**: 2x to 8x slower hopper checks for better performance ### 🌍 World Optimization (paper-world-defaults.yml) - **Collision System**: 25-75% reduction in entity collision checks - **Armor Stand Optimization**: Disabled collision lookups for better performance - **Despawn Ranges**: 25-44% closer despawn distances for all entity types - **Item Management**: Alternative despawn rates for 24+ common items (cobblestone, dirt, leaves, etc.) - **Arrow Cleanup**: Faster arrow despawn (20 ticks vs default) ### ⚡ Redstone & AI Optimization - **Redstone Implementation**: Alternate Current for 2-10x faster redstone (Balanced/Aggressive) - **Pathfinding**: Disabled on block updates for better performance (Balanced/Aggressive) - **Villager AI**: Slower POI validation and sensor updates (Balanced/Aggressive) - **Explosion Optimization**: Enabled across all levels ### 🛡️ Safety Features - **Automatic Backups**: Created before every optimization - **Restoration**: Easy rollback with timestamp-based backups - **Statistics Tracking**: Monitor optimization success rates - **Error Handling**: Graceful failure recovery ### Performance Expectations: ### 📈 Expected TPS Improvements | Server Size | Conservative | Balanced | Aggressive | |-------------|--------------|----------|-----------| | Small (1-10 players) | +0.5-1 TPS | +1-2 TPS | +2-3 TPS | | Medium (10-50 players) | +1-2 TPS | +2-4 TPS | +4-6 TPS | | Large (50+ players) | +2-3 TPS | +4-6 TPS | +6-10 TPS | ### 💾 Memory Usage Reduction - **Conservative**: 8-12% overall memory reduction - **Balanced**: 15-22% overall memory reduction - **Aggressive**: 25-35% overall memory reduction ### ⚠️ Gameplay Impact Warnings - **Conservative**: Minimal impact, safe for all servers - **Balanced**: May affect large mob farms, slower villager trading - **Aggressive**: Will affect mob farms, blocks nether roof access, test thoroughly ### Technical Details: - Full Folia support using region-based and async scheduling for optimal performance. - Works on Paper/Folia servers (1.20.1+). - Designed for minimal performance overhead. - Compatible with most gameplay plugins. - Intelligent configuration management with validation and rollback capabilities. - Optimizes 45+ settings across bukkit.yml, spigot.yml, and Paper configurations. ### Support: Having issues or need help configuring PerfoBooster? - Join our Discord: [https://discord.gg/yUghaxRSZs](https://discord.gg/yUghaxRSZs) ### Bstats:  ### Recommendation Guide: ### 🟢 Choose Conservative If: - First time using server optimization - Production server with strict uptime requirements - Server with complex redstone contraptions or farms - Want minimal risk and gradual optimization ### 🟡 Choose Balanced If: (Recommended for 80% of servers) - Want significant performance gains - Can tolerate minor gameplay adjustments - Most typical Minecraft servers - Good balance of performance vs functionality ### 🔴 Choose Aggressive If: - Need maximum performance optimization - High player count server with performance issues - Can test thoroughly before production deployment - Willing to adjust farms and builds if needed ### 🔄 Migration Path: 1. **Start with Conservative** - Test and monitor for 1-2 weeks 2. **Upgrade to Balanced** - If no issues, most servers stop here 3. **Consider Aggressive** - Only if maximum performance is needed *Remember: You can always restore from automatic backups if any level causes issues!* ### Tested Softwares Works on Paper, Folia, Foldenor, Leaf, Luminol, SparklyPaper, LinearPaper, Patina, Pufferfish, Purpur, Gale, Scatter, and DivineMC