Advanced Auto-Cleanup and TPS

X-ClearLag is not just a timer that clears entities every 5 minutes; it is a smart system designed to prioritize server performance.

📈 Auto-Cleanup by TPS Drop

If you have a large server, traditional automatic cleanup can be insufficient or annoying. X-ClearLag monitors the server’s TPS (Ticks Per Second) and can trigger cleanup tasks only when the server starts to suffer lag.

How to configure it

In your config.yml, look for the tps-check section:

tps-check:
  enabled: true
  threshold: 16.0
  interval: 60
  task-to-run: ["clearlag"]
  cooldown-seconds: 60 # Cooldown between automatic cleanups

threshold: 16.0: If the server drops to 16.0 TPS (which indicates lag; 20 is optimal), the alarm will trigger.
interval: 60: Every how many seconds the plugin silently checks the TPS.
task-to-run: Determines which cleanup tasks you want to force to run. You can list multiple tasks.

⚠️

When emergency TPS cleanup is activated, countdown warnings are ignored to avoid delaying the solution. Entities will be cleared immediately.

🐲 BossBar Integration

Most ClearLag plugins use heavy chat messages that annoy players. X-ClearLag can use an elegant native BossBar (dragon bar) for countdown warnings.

bossbar:
  enabled: true
  color: "RED"
  style: "SOLID"
  title: "&e&lClearing in &c&l%time%s"

color: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW.
style: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20.

(Only available for Minecraft version 1.9+ onwards, as legacy 1.8 versions do not support native BossBars without complex external plugins).

🔐 Permissions ❓ FAQ