Overview

SigmaClearLag is a lightweight, Folia-compatible entity cleanup plugin. It periodically sweeps the world for items, XP orbs, excess mobs, and vehicles — reducing entity count to keep your server's TPS healthy. It protects named mobs, tamed animals, villagers, and high-value items throughout the process.

Why Use SigmaClearLag?

Entity accumulation is one of the primary causes of TPS drops on survival and SMP servers. SigmaClearLag automates cleanup on a schedule with configurable warnings, so players always have advance notice and no important entities are lost.

Key Features

• Scheduled Cleanup — Configurable interval (default 5 min) with multi-stage warnings
• Smart Entity Protection — Named, tamed, leashed, ridden, and villager entities are always preserved
• Item Whitelist — High-value items (Elytra, Netherite, etc.) are never cleared
• Per-Chunk Mob Caps — Species-level limits enforced per chunk during sweeps
• Global Entity Caps — Server-wide caps per mob type regardless of chunk limits
• Manual Clear — Admins can trigger an immediate cleanup with /lag clear
• Live Stats — /lag info shows time until next clear and recent cleanup counts
• PlaceholderAPI — Countdown timer available as a placeholder
• Folia Compatible — Uses RegionScheduler and AsyncScheduler

Supported Versions

Component	Requirement
Minecraft	Paper/Spigot 1.21+
Java	Java 21+
API Version	1.21
Folia	Supported

Dependencies

Plugin	Type	Purpose
PlaceholderAPI	Optional	%sigmaclearlag_countdown% placeholder

Quick Example

# See when the next clear fires
/lag info

# Trigger an immediate clear (admin)
/lag clear

# Reload configuration
/lag reload

How It Works

1. A scheduled timer counts down from schedule-interval seconds
2. Warning messages are sent at each configured threshold (e.g. 60 s, 30 s, 10 s, 5 s)
3. At zero, the plugin iterates all loaded chunks and:
   • Removes dropped items (except whitelisted ones)
   • Removes XP orbs and non-whitelisted projectiles
   • Enforces per-chunk mob limits (removing lowest-priority mobs first)
   • Enforces global mob caps
   • Removes excess minecarts / vehicles
4. Protected entities (named, tamed, leashed, ridden) are never touched

What's Next?

• Quickstart Guide — Running in 3 steps
• Configuration Reference — All options
• Features — Protection rules and limits in detail