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 <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

• 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

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