ClearDrops+

ClearDrops+

ClearDrops+ is a Minecraft cleanup plugin.

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.

---

🧩 Configuration Example

Click to show example config.yml

clear:
  interval-seconds: 3600

safety:
  min-tps: 14.0
  min-items-to-clear: 10

filters:
  minAgeSeconds: 60

performance:
  items-per-tick: 200

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

chunk-cleanup:
  enabled: true
  min-items: 20
  max-chunks-per-tick: 1
  max-remove-per-chunk: 800
  chunk-cooldown-seconds: 60
  only-existing-chunks: true
  notify-admins: true

entity-cleanup:
  enabled: true

  chunk-load:
    enabled: false
    max-chunks-per-tick: 1
    chunk-cooldown-seconds: 120

  notify-admins: true

  global:
    enabled: true
    interval-seconds: 3600
    min-tps: 14.0
    chunks-per-tick: 1

  protection:
    protect-named-entities: true
    protect-tamed-animals: true
    protect-leashed-entities: true
    protect-saddled-entities: true
    protect-villagers-with-profession: true
    protect-villagers-with-custom-name: true
    protect-iron-golems-with-custom-name: true

  groups:
    cows:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - COW

    pigs:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - PIG

    chickens:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - CHICKEN

    sheep:
      enabled: true
      max-per-chunk: 20
      remove-per-run: 10
      types:
        - SHEEP

    monsters:
      enabled: true
      max-per-chunk: 60
      remove-per-run: 20
      types:
        - ZOMBIE
        - CREEPER
        - SKELETON
        - SLIME

    villagers:
      enabled: false
      max-per-chunk: 30
      remove-per-run: 5
      types:
        - VILLAGER

    iron-golems:
      enabled: false
      max-per-chunk: 20
      remove-per-run: 3
      types:
        - IRON_GOLEM

🔄 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.

Check Out My Other Plugins

• InfernalForge Modrinth
• BoatLimiter Modrinth
• ScoreTab Modrinth
• ItemCoreX Modrinth