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.