🧹 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

Download JAR
Drop into plugins/ folder
Restart server
Edit config.yml as needed
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.

s1mpleclean