⚡ Better TPS — The Next-Gen Adaptive TPS Stabilizer & Lag Profiler

Better TPS is an ultra-optimized, enterprise-grade server stabilization, chunk profiling, and lag diagnosis engine engineered to lock Minecraft servers at 20.0 TPS with 0.00ms player-perceived lag.

Instead of permanently limiting gameplay or using crude, single-threaded entity purges that crash modern Folia and Paper servers, Better TPS delivers multi-threaded Folia & Paper regional scheduling, intelligent exponential moving average (EMA) tick analysis, non-intrusive adaptive degradation profiles, dynamic BossBar & Action Bar HUDs, and real-time chunk lag diagnostics.

---

🌐 HYDRAZ Network

Developed with pride by the creators of HYDRAZ Network. Join the official server to experience our ultra-smooth performance stack live:

🌐 Server Address	🎮 Version
play.hydraz.online	1.16.5 — 1.21.x+

---

⚡ Why Better TPS? (Competitor Benchmark)

Feature / Metric	⚡ Better TPS	❌ Generic ClearLag	❌ Traditional Profilers
Folia Multi-Threading	Native Region Scheduler Bridge	Crashes on Region Boundaries	Unstable on Multi-Threading
Adaptive TPS Stabilization	Smooth Multi-Tier Pacing	Hard Kill-All Purges	None (Passive Only)
Real-Time BossBar Gauge	Dynamic Multi-Color Health Bar	None	Separate Mod/Addon
Action Bar Performance HUD	Live TPS, MSPT & RAM HUD	None	Clunky Commands
Chunk Lag Diagnosis	Interactive /btps chunks Profiler	Basic entity counts	High Profiling Overhead
Console Spam Reducer	Built-in Log4j Spike Filter	None	Separate Plugin
Universal Backwards Support	1.16.5 through 1.21.x+ (Single Jar)	Version-locked	Breaks on updates
Ecosystem Ready	PlaceholderAPI + spark Support	None	Isolated

---

🚀 Key Features

🛡️ 1. Multi-Threaded Folia & Paper Architecture

• Universal platform scheduler bridge (PlatformScheduler) dynamically detects RegionizedServer.
• Automatically schedules profile adjustments and telemetry timers onto GlobalRegionScheduler without crashing Folia threads or blocking Paper ticks.

📊 2. Dynamic Performance BossBar & Action Bar HUD

• Real-Time BossBar Gauge (/tps bossbar):
  • Displays dynamic TPS, MSPT, and RAM utilization at the top of the screen.
  • Smooth progression bar with color transitions: Green (19.5–20.0 TPS), Yellow (16.0–19.4 TPS), Red (<16.0 TPS).
• Action Bar HUD (/tps hud):
  • Non-intrusive action bar ticker displaying live performance metrics above the hotbar.

📸 Click to view in-game preview

⚙️ 3. Adaptive Stabilizer & Dynamic Pacing

• Continuous Exponential Moving Average (EMA) sampling eliminates false positive triggers.
• Multi-tier tuning profiles (Normal, Mild, Moderate, Aggressive, Emergency):
  • Automatically paces world adjustments across ticks without freezing player connections.
  • Gracefully throttles spawn limits, entity cramming, and random tick speed during peak load.
  • Automatically recovers to full fidelity as soon as server load stabilizes.

🔍 4. In-Depth Chunk Profiler & Lag Diagnostics

• /bettertps chunks: Displays the top laggiest chunks ranked by tile entities, villagers, redstone activity, and entity counts.
• /bettertps diagnose: Instant comprehensive diagnostic summary.
• /bettertps gc: Smart garbage collection and memory telemetry inspection.

🧩 5. Rich PlaceholderAPI Integration

• %bettertps_tps%: Formatted live TPS (e.g. 19.98).
• %bettertps_tps_colored%: Colorized TPS string with matching Minecraft color codes.
• %bettertps_mspt% & %bettertps_mspt_colored%: Real-time MSPT.
• %bettertps_profile%: Active stabilization profile name.
• %bettertps_health%: Server health state (Optimal, Good, Degraded, Severe Lag).
• %bettertps_ram_used%, %bettertps_ram_max%, %bettertps_ram_percent%: Live memory metrics.

---

⌨️ Commands & Permissions

Command	Alias	Description	Permission
/tps	/mspt, /serverlag, /lag	Display live server TPS, MSPT, and RAM	ettertps.tps
/tps bossbar	/btps bossbar	Toggle real-time BossBar performance gauge	ettertps.bossbar
/tps hud	/btps hud	Toggle real-time Action Bar performance ticker	ettertps.hud
/bettertps status	/btps status	View active stabilizer mode, profile, and EMA health	ettertps.admin
/bettertps gui	/btps gui	Open interactive control and profile tuning GUI	ettertps.admin
/bettertps chunks	/btps chunks	View top 5 laggiest loaded chunks across worlds	ettertps.admin
/bettertps diagnose	/btps diagnose	Run comprehensive real-time lag diagnosis	ettertps.admin
/bettertps auto <on	off>	/btps auto	Toggle automatic stabilization mode
/bettertps profile <name>	/btps profile	Force a specific tuning profile	ettertps.admin
/bettertps gc	/btps gc	Request garbage collection and memory compaction	ettertps.admin
/bettertps reload	/btps reload	Hot-reload all configuration settings	ettertps.admin

---

⚙️ Configuration (config.yml)

Click to expand full default config.yml

`yaml

=======================================================

Better TPS Configuration

Next-Gen Adaptive TPS Stabilizer & Profiler

=======================================================

enabled: true auto-mode: true

features: client-smooth-mode: true tune-world-distances: false tune-random-tick-speed: true tune-spawn-settings: true tune-max-entity-cramming: true tune-spawn-gamerules: true filter-console-spam: true

alerts: enabled: true below-tps: 18.0 above-mspt: 60.0 cooldown-seconds: 60 sound: true

worlds: mode: blacklist names: []

sampling: interval-ticks: 120 ema-alpha: 0.35

thresholds: mild-below: 19.5 moderate-below: 18.9 aggressive-below: 18.1 emergency-below: 17.0 recover-above: 19.85

stability: degrade-consecutive-samples: 3 recover-consecutive-samples: 12 recover-min-seconds: 120 emergency-consecutive-samples: 1 emergency-bypass-cooldown: true allow-multi-step-degrade: true max-profile-steps-per-switch: 1 min-online-players-for-auto: 1 cooldown-seconds-between-profile-switch: 90

limits: min-view-distance: 5 max-view-distance: 12 min-simulation-distance: 5 max-simulation-distance: 10 min-random-tick-speed: 1 max-random-tick-speed: 4

profile-apply: worlds-per-tick: 1 interval-ticks: 2 distance-change-cooldown-seconds: 300

network: ping-aware-recovery: true recover-max-average-ping-ms: 180 pause-non-emergency-switches-on-high-ping: true max-average-ping-for-non-emergency-switch-ms: 220

mitigation: auto-mitigate: true min-severity: 50 min-confidence: 50 item-clear-threshold: 40

spam-filter: max-messages-per-second: 5 time-window-ms: 1000 `

---

📦 Compatibility & Platform Support

• Server Loaders: Bukkit, Spigot, Paper, Purpur, Pufferfish, and Folia (Multi-Threading).
• Minecraft Releases: 1.16.5, 1.17.x, 1.18.x, 1.19.x, 1.20.x, 1.21.x+
• Java: Java 17, Java 21, and Java 22+.