s1mpleclean

# 🧹 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:** ```yaml 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):** ```yaml cleanup-interval-ticks: 600 item-lifespan-ticks: 600 ``` **Lazy cleanup (30 mins):** ```yaml cleanup-interval-ticks: 36000 item-lifespan-ticks: 36000 ``` **Keep only valuables:** ```yaml 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.