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