🧹 CleanerPlugin

Auto-cleans dropped items after a configurable time. Full customization, zero lag.

Overview

CleanerPlugin automatically removes items that sit on the ground for too long, keeping your server clean and lag-free. Perfect for survival servers, mini-games, or any world that needs item management.

✨ Features

• Auto-cleanup — Items vanish after configurable time (default: 10 mins)
• Manual cleanup — /cleaner clean command for instant cleanup
• Smart blacklist — Protect valuable items (diamonds, emeralds, netherite, etc.)
• Per-world filtering — Only clean specific worlds
• ELY logging — Structured cleanup logs for advanced monitoring
• Runtime control — Enable/disable without reloading
• Zero dependencies — Pure Bukkit API, no bloat
• Folia support — Works on async-threaded servers

🎯 Commands

Command	Permission	What it does
/cleaner clean	cleaner.admin	Instantly clean all dropped items
/cleaner reload	cleaner.admin	Reload config from disk
/cleaner status	Any	Show current settings
/cleaner enable/disable	cleaner.admin	Toggle cleanup (runtime)

🔧 Configuration

Default config.yml:

enabled: true
cleanup-interval-ticks: 12000    # 10 minutes
item-lifespan-ticks: 12000       # How long items stay
log-cleanup: false

blacklist-items:
  - DIAMOND
  - EMERALD
  - NETHERITE_INGOT
  # Add more items to protect

Customize everything:

• Cleanup interval (20 secs to 1 hour+)
• Item lifespan (independent from cleanup)
• Blacklist protection (keep valuables)
• Per-world settings
• Max items per tick (prevent lag spikes)
• Custom messages

📦 Platform Support

✅ Bukkit 1.8+
✅ Spigot (all versions)
✅ Paper (1.8.8+)
✅ Purpur (all versions)
✅ Folia (1.20.1+)

🔐 Permissions

• cleaner.admin — Access all commands
• cleaner.bypass — Items won't be cleaned (future feature)

🚀 Installation

1. Download JAR
2. Drop into plugins/ folder
3. Restart server
4. Edit config.yml as needed
5. Done!

💡 Use Cases

• Survival servers — Auto-clean after players die
• Mini-games — Clean up arena items between rounds
• Creative servers — Remove clutter without manual intervention
• Economy servers — Protect valuable items, clean junk

📝 Configuration Examples

Fast cleanup (30 secs):

cleanup-interval-ticks: 600
item-lifespan-ticks: 600

Lazy cleanup (30 mins):

cleanup-interval-ticks: 36000
item-lifespan-ticks: 36000

Keep only valuables:

blacklist-items:
  - DIAMOND
  - DIAMOND_BLOCK
  - EMERALD
  - NETHERITE_INGOT
  - ENCHANTED_BOOK

❓ FAQ

Q: Will it lag my server?
A: No. Cleanup runs async and checks only once per interval (default 10 mins). Max items per tick setting prevents spikes.

Q: Can I protect certain items?
A: Yes! Add them to the blacklist in config.yml.

Q: Does it work on Folia?
A: Yes! Full Folia support for async-threaded servers.

Q: Can I run cleanup manually?
A: Yes! /cleaner clean instantly cleans all items.

---

Made for Bukkit/Spigot/Paper/Purpur/Folia ecosystems.
Simple. Clean. Effective.