PerfoBooster

PerfoBooster delivers powerful server optimization through intelligent resource management, helping administrators maintain smooth gameplay even under heavy load.

Key Features:

- Software Optimizer (Experimental): Automatically despawn configurable entity types (e.g., bats, experience orbs) far from players to reduce entity load, while protecting named entities. - Software Optimizer (Experimental): Control animal breeding and mob spawner output per chunk to prevent entity overload from farms. - Software Optimizer (Experimental): Freezes specified mob types in place by disabling their movement and behavior to reduce CPU usage while keeping them visually present. - Software Optimizer (Experimental): Intelligently unloads chunks that are far from players and not actively used, freeing up server memory. - Software Optimizer (Experimental): Restricts plugins from loading new chunks synchronously, preventing potential lag spikes (configurable whitelist). - Software Optimizer (Experimental): Identifies and unloads chunks exhibiting excessive tile entity update activity if no players are nearby. - Software Optimizer (Experimental): Fine-tunes hopper behavior with smart throttling for empty/full hoppers, global transfer-per-tick limits, and optional per-chunk hopper count limits. - Software Optimizer (Experimental): Dynamically adjusts mob spawner settings (spawn count, delay, activation range, max nearby entities) based on TPS, light levels, and player proximity. - Software Optimizer (Experimental): Accelerates leaf block removal when logs are broken or leaves naturally decay, preventing floating leaf blocks and reducing world clutter for improved performance. - Software Optimizer (Experimental): Limits the maximum yield/radius of explosions to prevent excessive damage, with entity-specific limits for TNT, Creepers, Fireballs, Wither Skulls, and End Crystals. - Software Optimizer (Experimental): Prevents chain reactions where explosions trigger other nearby explosions, with configurable radius and cooldown settings to stop TNT chains and block ignition. - Software Optimizer (Experimental): Completely disables explosions based on server performance or configuration, with TPS-based automatic deactivation and entity-specific controls. - Software Optimizer (Experimental): Prevents players from spamming redstone-interactive blocks, with configurable interaction limits and temporary blacklisting. - Software Optimizer (Experimental): Prevents lag by limiting the total number of redstone components allowed within a radius, blocking placement and interactions when limits are exceeded. - Software Optimizer (Experimental): 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. - Software Optimizer (Experimental): Triggers Java's garbage collection intelligently when memory usage exceeds configurable thresholds, helping to maintain stable memory. - Software Optimizer (Experimental): Automatically adjusts players' view distance based on current server TPS, reducing network and client-side load during lag. - Software Optimizer (Experimental) 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 <level>` | 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 <timestamp>` | 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

- Expected TPS Gain: ⭐⭐☆☆☆ (Moderate) | Expected TPS Gain: ⭐☆☆☆☆ (Minimal) - Expected TPS Gain: 20-50% reduction in spawn limits - Expected TPS Gain: 13% reduction in activation ranges - Expected TPS Gain: Basic optimizations, explosion optimization, item despawn improvements - Expected TPS Gain: First-time users, production servers, minimal risk tolerance - Expected TPS Gain: +0.5-3 TPS depending on server size

🟡 Balanced - Recommended Default

- Expected TPS Gain: ⭐⭐⭐⭐☆ (High) | Expected TPS Gain: ⭐⭐☆☆☆ (Minor) - Expected TPS Gain: 40-80% reduction in spawn limits - Expected TPS Gain: 19-38% reduction in activation ranges - Expected TPS Gain: Alternate Current redstone, villager AI optimization, collision improvements - Expected TPS Gain: Most servers, good performance/gameplay balance - Expected TPS Gain: +1-6 TPS depending on server size

🔴 Aggressive - Maximum Performance

- ⚠️ Warning: ⭐⭐⭐⭐⭐ (Maximum) | ⚠️ Warning: ⭐⭐⭐☆☆ (Moderate) - ⚠️ Warning: 50-93% reduction in spawn limits - ⚠️ Warning: 25-50% reduction in activation ranges - ⚠️ Warning: All optimizations enabled, nether ceiling damage, faster item despawn - ⚠️ Warning: High-performance servers, testing environments - ⚠️ Warning: +2-10 TPS depending on server size - ⚠️ Warning: Test thoroughly before production use

Optimization Coverage:

📊 Spawn Management (bukkit.yml)

- Aggressive: Monsters, animals, water creatures, ambient, axolotls, water underground - Aggressive: 20-50% spawn reductions - Aggressive: 40-80% spawn reductions - Aggressive: 50-93% spawn reductions

🎯 Entity Performance (spigot.yml)

- Hopper Performance: Animals, monsters, misc, water, villagers - Hopper Performance: Item and XP merge radius improvements - Hopper Performance: Mob spawn distance optimization - Hopper Performance: 2x to 8x slower hopper checks for better performance

🌍 World Optimization (paper-world-defaults.yml)

- Arrow Cleanup: 25-75% reduction in entity collision checks - Arrow Cleanup: Disabled collision lookups for better performance - Arrow Cleanup: 25-44% closer despawn distances for all entity types - Arrow Cleanup: Alternative despawn rates for 24+ common items (cobblestone, dirt, leaves, etc.) - Arrow Cleanup: Faster arrow despawn (20 ticks vs default)

⚡ Redstone & AI Optimization

- Explosion Optimization: Alternate Current for 2-10x faster redstone (Balanced/Aggressive) - Explosion Optimization: Disabled on block updates for better performance (Balanced/Aggressive) - Explosion Optimization: Slower POI validation and sensor updates (Balanced/Aggressive) - Explosion Optimization: Enabled across all levels

🛡️ Safety Features

- Error Handling: Created before every optimization - Error Handling: Easy rollback with timestamp-based backups - Error Handling: 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

- Aggressive: 8-12% overall memory reduction - Aggressive: 15-22% overall memory reduction - Aggressive: 25-35% overall memory reduction

⚠️ Gameplay Impact Warnings

- Aggressive: Minimal impact, safe for all servers - Aggressive: 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

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. Consider Aggressive - Test and monitor for 1-2 weeks 2. Consider Aggressive - 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