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.

ClearDropsPlus