Features
Scheduled Auto-Clear
SigmaClearLag runs on a configurable timer. When the countdown reaches zero:
- Warning messages are broadcast (if configured)
- All loaded chunks are scanned
- Entities matching the configured sweep actions are removed
- A summary message reports what was cleared
- The timer resets
The timer is independent of player activity — it ticks continuously regardless of who is online.
Entity Protection Rules
The following entity types are never removed, regardless of sweep configuration:
| Protection | Description |
|---|---|
| Named entities | Any mob with a custom name tag (from Name Tag item) |
| Tamed mobs | Wolves, cats, horses, llamas, parrots, etc. |
| Villagers | All villager variants including wandering traders |
| Armor stands | All armor stands |
| Leashed entities | Any entity currently attached to a lead |
| Ridden entities | Any entity a player is actively riding |
Each protection rule can be individually disabled in config.yml if your server has a specific reason to do so.
Item Whitelist
High-value items in the item-whitelist are always preserved even when sweep.items: true. The plugin checks the item material against the whitelist before removing.
Default protected items:
DIAMONDNETHERITE_INGOTELYTRATOTEM_OF_UNDYING
Add any material name in uppercase to extend the whitelist.
Per-Chunk Mob Limits
During a sweep, each chunk is checked against its configured mob-type limits. If a chunk has more of a given mob type than the per-chunk cap allows, the excess mobs are removed — lowest priority first (random selection within the same chunk).
per-chunk-limits:
default-mob-max: 30
specific:
ZOMBIE: 10
CREEPER: 5
This prevents mob-farm stacking from concentrating hundreds of mobs in a few chunks.
Global Mob Caps
After per-chunk limits are applied, global caps are checked across the entire server. If the total count of any mob type exceeds its global cap, mobs are removed world-wide until within the cap.
Global caps prevent mob populations from growing unreasonably large even when spread across many chunks.
Vehicle Limits
Excess minecarts (regular, chest, hopper) beyond the per-chunk vehicle limits are removed during sweeps. This targets abandoned minecart clutter and prevents minecart duplication exploits from accumulating entities.
Multi-Stage Warnings
Before each auto-clear, warning messages are broadcast at each configured threshold:
warning-times: [60, 30, 10, 5]
This gives players time to pick up valuable drops before the sweep runs. Warning messages are fully configurable and support color codes.
Manual Clear
Admins with sigmaclearlag.clear can trigger /lag clear at any time. Manual clears execute immediately with no warnings and reset the auto-clear timer.
PlaceholderAPI Integration
| Placeholder | Example | Description |
|---|---|---|
%sigmaclearlag_countdown% | 247 | Seconds until next auto-clear |
Use in scoreboards, tab lists, or holograms so players can always see when the next clear fires.
Folia Compatibility
On Folia, entity operations use RegionScheduler to ensure each chunk's entities are processed on the correct region thread. The chunks-per-tick setting is ignored since region threading manages throughput automatically.