ClearDrops+

ClearDrops+

ClearDrops+ is a Minecraft plugin that keeps worlds clean by removing dropped items in a controlled and predictable way.

Instead of blindly clearing everything on a timer, ClearDrops+ reacts to server TPS and only removes items when it actually makes sense. It uses safe cleanup logic, avoids unsafe chunk handling, and stays simple by design. Built for modern Paper and Spigot servers.

Perfect for survival servers that want cleaner worlds, smooth gameplay, and full control over how item cleanup works.

---

⚡Core Features

• Automatic clearing of dropped items at configurable intervals
• Warning messages before items are removed
• TPS protection (skip or stop cleanup on low TPS)
• Batch-based removal (items per tick) to prevent lag spikes
• Item age filter to protect freshly dropped items
• Material blacklist via blacklist.yml
• Per-world control using ALL or WHITELIST mode

---

🗺️Advanced Chunk Cleanup

ClearDrops+ includes an optional smart chunk-load cleanup system:

• Cleans dropped items when chunks load without force-loading chunks
• Queue-based processing with per-tick limits
• Chunk cooldowns to avoid repeated cleanups
• Dynamic TPS-based scaling of cleanup limits
• Optional admin notifications
• Per-world chunk cleanup overrides

Designed to be safe, predictable, and performance-friendly, even on larger servers.

---

📊Performance & Safety

• Fully TPS-aware logic for global and chunk cleanup
• Cleanup automatically pauses when TPS drops
• No async entity access
• No unsafe chunk loading
• Designed to avoid lag spikes and server freezes

---

Debug, Statistics & Admin Tools

• Optional debug logging (console and file)
• Runtime debug toggle via command
• Detailed cleanup statistics
• Track removed items, cleanup runs, and skipped actions
• /cd info command for plugin and config information
• Improved admin-friendly status and statistics output
• Command tab completion

---

📜⚙️Update-Friendly Configuration

ClearDrops+ now handles updates much better for existing servers:

• Missing keys in config.yml, messages.yml, and blacklist.yml are added automatically
• Existing settings are preserved during updates
• Version-aware config, message, and blacklist handling
• Built-in Modrinth update checker
• Console notification when a new version is available
• In-game admin notification on join
• Clickable Modrinth link in the update message

This means server owners can usually just replace the .jar file without deleting their existing plugin folder.

---

📜Commands

Command	Description	Permission
/cd clear	Manually start global item clearing	cleardrops.admin
/cd next	Show time until the next clear	Everyone
/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 the current chunk	cleardrops.admin
/cd debug start|stop	Toggle debug logging	cleardrops.admin
/cd reload	Reload configuration files	cleardrops.admin

---

🔐Permissions

• cleardrops.admin
  Grants access to all administrative commands.

---

⚙️Configuration

ClearDrops+ provides a clean and flexible configuration system:

• Clear intervals and warning times
• Minimum TPS requirements
• Minimum item age and minimum item count
• Items removed per tick
• World whitelist support
• Material blacklist support
• Chunk cleanup options
• Dynamic TPS scaling
• Update-checker settings
• Per-world chunk cleanup overrides

All configuration files are generated automatically on first startup.

---

Check Out my other Plugins

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

---

Example Configuration

config-version: 1

clear:
  interval-seconds: 3600

warnings:
  times-seconds:
    - 300
    - 60
    - 10
    - 5
    - 4
    - 3
    - 2
    - 1

notifications:
  warnings-before-clear:
    broadcast-players: true
    console: true

  global-clear-start:
    broadcast-players: true
    console: true

  global-clear-finish:
    broadcast-players: true
    console: true

  clear-stopped-low-tps:
    broadcast-players: true
    console: true

worlds:
  mode: ALL
  list:
    - world
    - world_nether
    - world_the_end

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

filters:
  minAgeSeconds: 60

performance:
  items-per-tick: 200

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

world-settings:
  world:
    chunk-cleanup:
      min-items: 120

  world_nether:
    chunk-cleanup:
      enabled: false

  world_the_end:
    chunk-cleanup:
      min-items: 60
      max-remove-per-chunk: 400
      notify-admins: false

debug:
  enabled: false
  to-console: true
  to-file: true
  file-prefix: "debug"

dynamic-limits:
  enabled: true
  full-tps: 20.0
  min-tps: 14.0
  min-scale: 0.25

update-checker:
  enabled: true
  notify-admins-on-join: true
  notify-console: true