Entity Item Cleaner

EntityItemCleaner helps you keep your server clean and lag-free by automatically removing unnecessary entities like dropped items, mobs and XP orbs, fully configurable and safe by default.

✨ Features

- ⏱ Automatic cleanup timer - 🔔 Configurable warning messages - 🧠 Smart mob removal > - Players are never affected > - ArmorStands are never removed > - Named mobs (bosses, pets, quest mobs) can be protected

- 📦 Item cleanup - ✨ Optional XP orb cleanup - ⚙ Enable / disable AutoClear via config - 🧾 Detailed cleanup statistics - 💬 Fully configurable messages - 🔐 Permission-based commands - 🧩 Lightweight & performance-safe - 🚀 No dependencies - 🔧 Supported Versions

Spigot / Paper

Minecraft 1.21+

Java 21

🛠 Configuration Highlights

``` enable-autoclear: true clear-interval-minutes: 10

remove: mobs: true ignore-named-mobs: true items: true experience-orbs: true ```

✔ Enable or disable AutoClear

✔ Choose exactly what gets removed

✔ Protect bosses, pets and named mobs

✔ Fully customizable warning & result messages

⏰ Smart Warning System

Warn players before cleanup with readable time formatting:

- 5 min - 2 min 30s - 10s

Example:

&e[IEC] &cCleanup in &6{time}&cs

💬 Messages & Placeholders

All messages are configurable via config.yml.

Available placeholders:

``` {time} – time until cleanup {items} – removed items {mobs} – removed mobs {xp} – removed XP orbs {amount} – total removed entities ```

⌨ Commands

``` /eic clearall ```

Manually trigger a cleanup

Shows detailed cleanup results

Permission-based

Permission:

``` entityitemcleaner.clear ```

🧠 Why EntityItemCleaner?

✔ No aggressive or unsafe clearing

✔ No TPS abuse

✔ No async mistakes

✔ No unnecessary features

✔ Designed for production servers

EntityItemCleaner focuses on predictability, safety and performance – exactly what server admins expect from a modern cleanup plugin.

📦 Planned / Possible Extensions

- /eic reload - /eic stats - TPS-based cleanup - Per-world cleanup rules - Entity age filtering - ActionBar warnings

📄 License

Free to use on your server.

Do not redistribute without permission.