🚀 CBGS Performance Suite
Overview
Your Folia server is under constant pressure. Entities build up, chunks consume CPU, and performance can collapse when your server reaches high activity.
CBGS Performance Suite is an advanced optimization platform built specifically for Folia 1.21.x. It uses Folia's regionized architecture to provide intelligent, thread-safe performance improvements without unsafe operations or console spam.
Designed for high-performance servers that need more than a basic optimizer.
🧠 Optimization
⚡ Dynamic View Distance
Automatically controls view and simulation distance based on current performance.
- Reduces workload during high MSPT
- Restores performance when stable
- Smart hysteresis prevents constant changes
💥 SmartPhysics
Controls excessive physics activity before it creates performance issues.
Monitors:
- Block updates
- Redstone activity
- High-load mechanics
Automatically prevents extreme performance spikes while maintaining gameplay.
🧟 SmartVillagerAI
Reduces unnecessary AI calculations during heavy server load.
Provides:
- Lower CPU usage
- Better stability
- Automatic performance recovery
🗑️ EntityOptimizer
Advanced entity management system.
Features:
- Region-safe cleanup
- Reduced entity pressure
- Intelligent optimization handling
📦 ChunkOptimizer
Continuously monitors chunk activity and detects performance problems.
Provides detailed information about heavy areas and helps locate sources of lag.
🔄 SmartItemMerger
Improves dropped item handling with asynchronous scanning and Folia-safe validation.
Designed to work with Folia's threading system without unsafe cross-region access.
📊 Monitoring
🖥️ Dashboard
Open /perf dashboard
View live:
- TPS
- MSPT
- CPU usage
- RAM usage
Updated every second.
🎯 BossBar & ActionBar
Display live performance statistics directly in-game.
Commands:
/perf bossbar
Shows TPS health visually.
/perf actionbar
Displays live TPS, MSPT, and CPU information.
🔥 RegionProfiler
Runs asynchronously to calculate performance pressure.
Tracks:
- Entity activity
- Chunk activity
- Region performance
Quickly identifies areas causing performance issues.
🪝 API
PlaceholderAPI
Works with:
- Scoreboards
- Holograms
- Chat plugins
Placeholders:
%cbgsperf_tps% %cbgsperf_mspt% %cbgsperf_cpu% %cbgsperf_ram% %cbgsperf_worst_region% %cbgsperf_is_lagging%
Developer API
Allows other plugins to interact with CBGS.
Example:
PerformanceAPI.getTPS(); PerformanceAPI.getMSPT(); PerformanceAPI.isLagging(); PerformanceAPI.getWorstRegion();
🛡️ Folia Support
CBGS Performance Suite is designed around Folia's threading model.
Features:
✅ Region-safe scheduling
✅ Async processing
✅ No unsafe cross-region operations
✅ No main-thread blocking
Uses:
- AsyncScheduler
- GlobalRegionScheduler
- EntityScheduler
Built the Folia way.
⚙️ Commands
/perf status
Shows live performance statistics.
/perf dashboard
Opens the performance dashboard.
/perf bossbar
Toggles TPS BossBar.
/perf actionbar
Toggles ActionBar statistics.
/perf regions
Shows region performance information.
/perf chunks/perf entities
Shows active server counts.
/perf export
Exports debugging information.
/perf reload
Reloads configuration without restarting.
🚀 Performance
CBGS Performance Suite gives Folia servers powerful tools to stay stable, optimized, and ready for demanding workloads.
Better monitoring.
Smarter optimization.
Built for Folia.
