Server-side only — clients don't need this installed. Runs a configurable auto-clear cycle (default: every 5 minutes) that removes dropped items, hostile mobs, projectiles, XP orbs, and more. Named pets, tamed animals, and leashed mobs are protected by default.
Tip: Works in singleplayer too.
Protection Options
| Protection | Description | Default |
|---|---|---|
| Named Entities | Mobs with a name tag are safe | On |
| Tamed Animals | Pets (cats, dogs, parrots, etc.) | On |
| Leashed Mobs | Entities on a lead are ignored | On |
| Player Radius | Entities within X blocks of players are spared | 0 (off) |
Entity Filtering
| Entity Type | Default |
|---|---|
| Items (dropped) | On |
| Hostile mobs | On |
| Projectiles | On |
| XP Orbs | On |
| Boats | Off |
| Minecarts | Off |
Blacklist / Whitelist
Blacklist mode (default): only listed entities are cleared.
Whitelist mode: only listed entities are cleared, all others ignored.
Supports entities from any mod using modid:entity_type.
Default blacklist: minecraft:item, minecraft:arrow, minecraft:experience_orb, minecraft:zombie, minecraft:skeleton, minecraft:creeper, minecraft:spider, minecraft:enderman
Warnings
Chat warnings at 30, 10, 5, 3, and 1 seconds before each clear. Message text supports {count} and {time} placeholders.
Commands
Requires OP Level 2.
| Command | Description |
|---|---|
/clearlag clear |
Run a clear cycle immediately |
/clearlag count |
Preview how many entities would be cleared |
/clearlag timer |
Show time until next auto-clear |
/clearlag reset |
Reset the auto-clear timer |
/clearlag info |
Show current config settings |
/clearlag reload |
Reload config and restart scheduler |
Configuration
config/sarosclearlag-common.toml:
| Option | Default | Range | Description |
|---|---|---|---|
autoCleanEnabled |
true |
- | Enable auto-clear |
autoCleanInterval |
300 |
30-3600 | Interval in seconds |
showWarnings |
true |
- | Show warnings |
warningTime |
30 |
5-120 | Seconds before clear to warn |
useWhitelistMode |
false |
- | Whitelist instead of blacklist |
protectNamedEntities |
true |
- | Protect named entities |
protectTamedEntities |
true |
- | Protect tamed animals |
protectLeashedEntities |
true |
- | Protect leashed mobs |
protectionRadiusPlayers |
0 |
0-128 | Radius around players |
broadcastClearMessage |
true |
- | Broadcast to all players |
Note: This wiki serves as documentation. For active discussion, please join the Discord Server.
