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+

# 🛠 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

&e &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.