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 NMS completely, 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 (NEW)

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

• Cleans dropped items when chunks load (no force-loading)
• 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 large 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 (NEW)

• Optional debug logging (console and file)
• Runtime debug toggle via command
• Detailed cleanup statistics
• Track removed items, cleanup runs and skipped actions

---

📜 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 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 item count
• Items removed per tick
• World whitelist support
• Material blacklist support
• Chunk cleanup & dynamic TPS scaling options

All configuration files are generated automatically on first startup.

---

🧩 Compatibility

• Minecraft: 1.21.x
• Java: 21 or newer
• Platforms: Paper, Spigot and Paper-based forks (e.g. Purpur)

---

# ClearDropsPlus Configuration
# Controls automatic item cleanup and performance limits.
#
# Notes:
# - All time values are in seconds
# - Chunks are never force-loaded
# - Chunk cleanup only runs on natural chunk load

clear:
  interval-seconds: 3600

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

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

ClearDrops+ — Clean smarter, not harder.