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, Paper and Spigot servers 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 WHITELIST 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

```yaml 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