🧹 Entity Cleaner
Entity Cleaner is a ClearLag alternative built into Voidium. It automatically removes dropped items, XP orbs, arrows, and optionally mobs — with full protection for named entities, tamed animals, bosses, and whitelisted items.
Enabled by default. Configure in
entitycleaner.json.
Jump to
⚙️ How it works
- Every
cleanupIntervalSeconds(default 300 = 5 minutes), a cleanup cycle starts. - Warning messages are broadcast at
warningTimes(default: 30s, 10s, 5s before cleanup). - At cleanup time, the configured entity types are removed from all loaded dimensions.
- A summary message shows removed counts per category.
Entity types
| Toggle | Default | Removes |
|---|---|---|
removeDroppedItems |
true |
Dropped item entities |
removePassiveMobs |
false |
Animals (cows, pigs, sheep, etc.) |
removeHostileMobs |
false |
Monsters (zombies, skeletons, creepers, etc.) |
removeXpOrbs |
true |
Experience orbs |
removeArrows |
true |
Arrows stuck in ground/walls |
Farm-friendly defaults: Only items, XP, and arrows are removed. Mobs are protected by default — your farms and animal pens stay safe.
📝 Configuration
File: config/voidium/entitycleaner.json
| Field | Type | Default | Description |
|---|---|---|---|
enabled |
boolean | true |
Master switch |
cleanupIntervalSeconds |
int | 300 |
Seconds between cleanups (min 10) |
warningTimes |
int[] | [30, 10, 5] |
Seconds before cleanup to send warnings |
warningMessage |
string | &e[EntityCleaner] &fClearing entities in &c%seconds% &fseconds! |
Warning broadcast. Placeholder: %seconds% |
cleanupMessage |
string | &a[EntityCleaner] &fRemoved &e%items% items&f, &e%mobs% mobs&f, &e%xp% XP orbs&f, &e%arrows% arrows&f. |
Summary message. Placeholders: %items%, %mobs%, %xp%, %arrows% |
🛡️ Protection
Protection toggles
| Field | Default | Description |
|---|---|---|
removeNamedEntities |
false |
If false, entities with name tags are protected |
removeTamedAnimals |
false |
If false, tamed animals (wolves, cats, horses) are protected |
protectBosses |
true |
If true, bosses (Ender Dragon, Wither, modded bosses) are never removed |
Entity whitelist
Entities in entityWhitelist are never removed regardless of other settings:
"entityWhitelist": [
"minecraft:villager",
"minecraft:iron_golem",
"minecraft:snow_golem",
"minecraft:wandering_trader",
"minecraft:trader_llama"
]
Item whitelist
Dropped items in itemWhitelist are never removed:
"itemWhitelist": [
"minecraft:diamond",
"minecraft:netherite_ingot",
"minecraft:netherite_scrap",
"minecraft:elytra",
"minecraft:nether_star",
"minecraft:totem_of_undying",
"minecraft:enchanted_golden_apple"
]
⌨️ Commands
| Command | Permission | Description |
|---|---|---|
/voidium clear |
OP | Force cleanup of all configured types |
/voidium clear items |
OP | Clear only dropped items |
/voidium clear mobs |
OP | Clear only mobs |
/voidium clear xp |
OP | Clear only XP orbs |
/voidium clear arrows |
OP | Clear only arrows |
/voidium clear preview |
OP | Preview what would be removed (no deletion) |