ClearDrops+
ClearDrops+ is a Minecraft cleanup plugin for your Server.
It keeps your worlds clean by removing dropped items and limiting entity-heavy chunks in a controlled, predictable and TPS-safe way.
ClearDrops+ is not a simple “delete everything” cleaner. It separates item cleanup from entity cleanup, respects server performance, protects valuable content and gives admins full control over when and how cleanup should happen.
Perfect for survival, SMP and farm-heavy servers that want cleaner worlds, better performance and safer cleanup behavior.
✨ What is new in 1.3?
ClearDrops+ 1.3 expands the plugin from a dropped item cleaner into a smarter server hygiene tool.
This update adds:
- Smart entity cleanup for animals and mobs
- Separate global timed entity cleanup
- Optional chunk-load entity cleanup
- Per-group entity limits
- Separate limits for cows, pigs, chickens and sheep
- Protection for named, tamed, leashed and saddled entities
- Protection for villagers with professions
- Protection for named villagers and named iron golems
- Custom item protection for names, lore, CustomModelData and PersistentDataContainer items
- New admin commands for scanning and cleaning entity-heavy chunks
⚡ Core Features
- Automatic dropped item cleanup at configurable intervals
- Warning messages before item cleanup starts
- TPS protection to skip or stop cleanup when the server is under load
- Batch-based item removal to prevent lag spikes
- Minimum item age filter to protect freshly dropped items
- Material blacklist via
blacklist.yml
- Custom item protection via
config.yml
- Per-world control using
ALL or WHITELIST mode
- Optional chunk-based item cleanup
- Smart entity cleanup for crowded animal and mob chunks
- Separate timers for item cleanup and entity cleanup
🧹 Global Item Cleanup
The classic item cleanup system removes dropped items from loaded worlds after a configurable interval.
Example use case:
- Remove dropped items every 60 minutes
- Warn players before cleanup
- Skip cleanup if TPS is too low
- Only remove items that are old enough
- Never remove blacklisted materials
- Protect custom items with name, lore, CustomModelData or PDC data
This system is designed to keep the ground clean without causing lag spikes.
🗺️ Item Chunk Cleanup Worker
ClearDrops+ includes an optional chunk-load based item cleanup system.
This system is useful for chunks that contain too many dropped items when they are loaded.
Features:
- Runs only on already loaded chunks
- Never force-loads chunks
- Uses a safe queue worker
- Supports per-tick processing limits
- Supports chunk cooldowns
- Supports dynamic TPS scaling
- Supports per-world overrides
- Can notify admins when cleanup happens
This makes it safe for larger servers and prevents heavy cleanup work from happening all at once.
🐔 Smart Entity Cleanup
ClearDrops+ 1.3 introduces a new smart entity cleanup system.
This system can limit large animal and mob farms per chunk.
Instead of deleting all entities, it only removes extra, unprotected entities above the configured limit.
Example:
If chickens are limited to 20 per chunk and a chunk contains 100 chickens, ClearDrops+ will only remove the overflow slowly and safely, based on your configured remove-per-run value.
This helps against oversized farms that can hurt TPS, especially on low-end servers.
🐄 Separate Animal Limits
Farm animals can be configured separately.
This means you can set limits like:
- 20 cows per chunk
- 20 pigs per chunk
- 20 chickens per chunk
- 20 sheep per chunk
This is more precise than one global animal limit.
Example:
entity-cleanup:
groups:
cows:
enabled: true
max-per-chunk: 20
remove-per-run: 10
types:
- COW
chickens:
enabled: true
max-per-chunk: 20
remove-per-run: 10
types:
- CHICKEN
🌍 Global Timed Entity Cleanup
Entity cleanup can run on its own timer, separate from item cleanup.
Example:
- Item cleanup every 2 hours
- Animal and mob cleanup every 1 hour
The global entity cleanup only scans chunks that are already loaded by the server.
It does not force-load chunks.
This means it stays safe and predictable even on larger maps.
📦 Optional Chunk-Load Entity Cleanup
ClearDrops+ can also check entities when chunks naturally load.
This can be enabled or disabled separately.
Example:
entity-cleanup:
enabled: true
chunk-load:
enabled: false
global:
enabled: true
With this setup:
- Entity cleanup while players explore the map is disabled
- Global timed entity cleanup is still enabled
- Only already loaded chunks are scanned during the global cleanup
This gives server owners full control over how entity cleanup should behave.
🛡️ Entity Protection
ClearDrops+ does not blindly delete player-owned or valuable entities.
The protection system can protect:
- Named entities
- Tamed animals
- Leashed animals
- Saddled animals
- Villagers with professions
- Named villagers
- Named iron golems
Example:
If a player has a leashed sheep or a named animal inside a crowded farm chunk, ClearDrops+ will count it as protected and will not remove it.
This makes the cleanup safer and fairer for SMP servers.
💎 Custom Item Protection
ClearDrops+ can protect custom dropped items by checking their item metadata.
This is useful for servers using custom item systems such as:
- ItemCoreX
- Oraxen
- ItemsAdder
- MMOItems
- MythicMobs item drops
- Other custom item plugins
Protection options include:
- Custom display names
- Lore
- CustomModelData
- PersistentDataContainer keys
- Enchanted items, optional
Example:
item-protection:
enabled: true
protect-named-items: true
protect-lore-items: true
protect-custom-model-data: true
protect-persistent-data-items: true
protect-enchanted-items: false
The material blacklist still exists, but it only protects items by Bukkit material type.
Custom items should be protected through item-protection.
📊 Performance & Safety
ClearDrops+ is designed to be performance-friendly.
It includes:
- TPS checks before and during cleanup
- Batch-based removal
- Queue-based chunk processing
- Configurable chunks per tick
- Configurable items per tick
- Configurable entities removed per run
- Dynamic TPS-based scaling
- No async entity access
- No unsafe chunk loading
- No forced chunk loading
The plugin only works with chunks that are already loaded by the server.
🔎 Admin Tools
ClearDrops+ includes useful admin commands for checking cleanup behavior.
/cd entityscan
Scans the current chunk and shows useful information about configured entity groups.
It displays:
- Entity groups found in the chunk
- Total entities per group
- Configured group limit
- Overflow amount
- Protected entities
- Removable entities
- Entity types found
This is useful when checking player farms.
/cd entityclear
Cleans the current chunk using the configured entity group limits.
It does not remove all entities.
It only removes extra, unprotected entities above the configured limit.
📜 Commands
| Command |
Description |
Permission |
/cd help |
Show command help |
Everyone |
/cd next |
Show time until the next item clear |
Everyone |
/cd clear |
Manually start global item cleanup |
cleardrops.admin |
/cd status |
Show plugin status |
cleardrops.admin |
/cd stats |
Show cleanup statistics |
cleardrops.admin |
/cd info |
Show plugin and config information |
cleardrops.admin |
/cd cleanhere |
Clean dropped items in the current chunk |
cleardrops.admin |
/cd entityscan |
Scan entity groups in the current chunk |
cleardrops.admin |
/cd entityclear |
Clean entity overflow in the current chunk |
cleardrops.admin |
/cd debug start |
Enable debug logging |
cleardrops.admin |
/cd debug stop |
Disable debug logging |
cleardrops.admin |
/cd reload |
Reload configuration files |
cleardrops.admin |
🔐 Permissions
| Permission |
Description |
cleardrops.admin |
Grants access to all administrative commands |
⚙️ Configuration
ClearDrops+ provides a flexible configuration system.
You can configure:
- Global item cleanup interval
- Warning times
- Player and console notifications
- Minimum TPS
- Minimum item count
- Minimum item age
- Items removed per tick
- World whitelist mode
- Material blacklist
- Custom item protection
- Item chunk cleanup
- Entity cleanup master switch
- Chunk-load entity cleanup
- Global timed entity cleanup
- Entity group limits
- Entity protection rules
- Dynamic TPS scaling
- Debug logging
- Update checker
All configuration files are generated automatically on first startup.
🔄 Update-Friendly Configuration
ClearDrops+ is designed to be update-friendly.
- Missing keys in
config.yml, messages.yml, and blacklist.yml can be added automatically
- Existing settings are preserved where possible
- Config files use internal version numbers
- Built-in Modrinth update checker
- Optional console update notifications
- Optional admin join notifications
Server owners can usually replace the .jar file and compare the new default configuration with their existing files.
