cbgsoptimizasion

# 🚀 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.