# EzClean – Minecraft Entity Cleaner Plugin<\/p>\n
Automated entity sweeps, live countdowns, pay-to-cancel, Discord webhooks, PlaceholderAPI, Spark
\nprofiling, and async scheduler monitoring for **Paper 26.1+**, Spigot, and Purpur.<\/p>\n
**Platform:** Paper 26.1+, Spigot\/Bukkit, Purpur | **Java:** 17+ | **Storage:** SQLite (bundled) or MySQL
\n**Optional:** Vault, WorldGuard, Discord, PlaceholderAPI, Spark, EzCountdown<\/p>\n
Check our latest project: PvPIndex<\/p>\n
—<\/p>\n
## Why Choose EzClean?<\/p>\n
EzClean is designed for modern Minecraft servers that demand performance, flexibility, and safety. Here\u2019s why it stands out:<\/p>\n
– **100% SpigotMC\/Bukkit compatible** \u2013 Works on Spigot, Paper, and Purpur. No Paper-only dependencies.
\n– **Profile-based scheduling** \u2013 Create multiple cleaner profiles, each with its own interval, world targets, entity rules, and broadcast messages.
\n– **Interactive countdowns** \u2013 Themed warnings, recaps, and staff-only cancel prompts using MiniMessage placeholders: `{minutes}`, `{count}`, `{cleaner}`, `{cost}`.
\n– **Granular removal rules** \u2013 Toggle hostile mobs, passive mobs, villagers, vehicles, drops,
\n orbs, projectiles, TNT, clouds. Protect players, armor stands, displays, tamed pets, named mobs.
\n– **World targeting** \u2013 Clean specific worlds or use `*` for network-wide sweeps.
\n– **Force keep\/remove lists** \u2013 Tag any `EntityType` to always keep or remove for custom events or mechanics.<\/p>\n
—<\/p>\n
## Feature Highlights<\/p>\n
EzClean offers powerful features to keep your Minecraft server running smoothly and your players happy:<\/p>\n
– **MiniMessage ready** \u2013 Themed warning, interval, dynamic, pre-clean, and cancel broadcasts —<\/p>\n ## Configure What Gets Cleaned<\/p>\n Take full control over what entities are removed or protected on your Minecraft server. Mix and match profiles, entity groups, and custom rules for ultimate flexibility.<\/p>\n – Create unlimited cleaner profiles, each with unique world targets, countdown cadence, and broadcast messages. —<\/p>\n ## Pay-to-Cancel Cleanups<\/p>\n Let staff delay scheduled cleanups with a single click, optionally charging a Vault-backed fee and showing dynamic MiniMessage prompts.<\/p>\n – Clickable countdown broadcasts let staff with `ezclean.cancel` permission delay the next cleanup instantly. —<\/p>\n ## Monitor Async Scheduler Load<\/p>\n <\/p>\n ## Tracking the Cause of Lag<\/p>\n EzClean makes it easy to diagnose and track down the source of server lag, especially – **Scheduler Usage Snapshots:** – **Live Usage Monitoring:** – **Plugin Filtering:** – **Stopping the Feed:** – **Visual Feedback:** **Tip:** If you notice a spike in scheduled tasks or a particular plugin dominating the <\/p>\n —<\/p>\n ## Optional Death Chests<\/p>\n – Convert player drops into a 54-slot chest near the death location instead of littering the ground with items. ### Advanced Death Chest Options (Optional)<\/p>\n – **Per-player chest limits** \u2013 Restrict the number of active death chests each player can have at once to prevent abuse and clutter. “`yml Players exceeding the limit will have their oldest chest removed automatically. “`yml – Permission: `ezclean.deathchest.protection.bypass` lets a player open any chest regardless of protection. “`yml —<\/p>\n ## Admin Commands<\/p>\n – `\/ezclean help` \u2013 List all available subcommands and their required permissions. —<\/p>\n ## Quick Start<\/p>\n – Drop `EzClean.jar` into your Paper or Purpur `plugins\/` directory and restart the server. —<\/p>\n ## WorldGuard Bypass Tag<\/p>\n – Install WorldGuard alongside EzClean to unlock region-based exclusions. —<\/p>\n ## Cleanup Scope at a Glance<\/p>\n | Category | Default | Notes | —<\/p>\n ## Example Configurations<\/p>\n ### cleaners\/default.yml<\/p>\n “`yml warning: broadcast: cancel: worlds: pile-detection: remove: protect: entity-types: ### messages.yml<\/p>\n “`yml cleaners: {} ### death-chests.yml<\/p>\n “`yml —<\/p>\n ## Requirements<\/p>\n – Java 17 or newer (matches the Paper 26.1 API baseline). —<\/p>\n ## Support & Links<\/p>\n – Questions or feature requests? Join our Discord and open a ticket under the EzClean category. —<\/p>\n **Ready for spotless worlds?** <\/p>\n","protected":false},"excerpt":{"rendered":" Configurable recurring entity clear and other advanced tools for lag prevention<\/p>\n","protected":false},"featured_media":67560,"template":"","meta":{"_minecraft_slug":"ezclean","_minecraft_project_id":"Nfe9727w","_minecraft_author":"Shadow48402","_minecraft_license":"MIT","_minecraft_downloads":366,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ezclean.zip","_minecraft_size_bytes":3068456,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T11:14:48.815051Z","_minecraft_date_created":"2026-01-25T00:58:06.112479Z","_minecraft_date_modified":"2026-05-13T21:27:58.881198Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ezclean","_minecraft_icon_attachment_id":67560,"_minecraft_imported_at":"2026-06-03T20:40:58+00:00","_minecraft_import_hash":"b6439d75fdd56041ba1c553821f41a28","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-67559","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n using Adventure MiniMessage tags: `minutes`, `count`, `cleaner id`, `cancel costs`.
\n– **WorldGuard integration** \u2013 Regions flagged with `ezclean-bypass` are automatically skipped during entity sweeps.
\n– **Pay-to-cancel safety net** \u2013 Optional Vault hooks let you charge players to cancel a cleanup, with hover tooltips and refund protection.
\n– **Safe defaults** \u2013 Critical entities are protected until you explicitly opt in to remove them.
\n– **Lightweight configuration** \u2013 Cleaners, MiniMessage copy, and death chests in tidy YAML files.
\n– **Hot reload friendly** \u2013 Reload profile changes instantly with your favorite plugin manager or `\/reload confirm`.
\n– **Smart pile detection** \u2013 Automatically cull stacks of drops or other spammy entities that exceed your per-block limit.
\n– **Entity merging** \u2013 Merge nearby same-type entities before removal to reduce packet spam and improve sweep efficiency.
\n– **Optional death chests** \u2013 Capture player drops in temporary containers that despawn on a timer instead of scattering items everywhere.
\n– **Language \/ i18n support** \u2013 Ships with bundled English, Dutch, and Spanish translations; drop any
\n `
\n– **Discord webhook notifications** \u2013 Post cleanup summaries to a Discord channel by setting a webhook
\n URL in `config.yml`. No bot token or extra plugins required.
\n– **PlaceholderAPI support** \u2013 Expose live stats as `%ezclean_
\n holograms, and chat formatters.
\n– **Spark integration** \u2013 Use Spark’s precise TPS\/MSPT rolling averages for smarter scheduling and
\n trigger automatic profiler sessions when entity counts spike.
\n– **EzCountdown integration** \u2013 Drive pre-cleanup countdowns through EzCountdown for richer,
\n theme-able announcements.
\n– **Storage-backed stats** \u2013 Persist cleanup statistics across restarts with the bundled SQLite database
\n or an external MySQL\/MariaDB instance.
\n– **Update notifier** \u2013 Ops receive a clickable in-chat notice when a newer EzClean version is available.
\n– **Interactive setup GUI** \u2013 Configure cleaner profiles through a point-and-click inventory wizard
\n without touching YAML.<\/p>\n
\n– Toggle entity groups (hostile mobs, passive mobs, villagers, vehicles, drops, orbs, projectiles,
\n clouds, falling blocks, TNT) per profile.
\n– Fine-tune specific `EntityType` values using `keep`\/`remove` arrays to protect custom mobs or purge event clutter.
\n– Mix profiles for global sweeps, world-specific cleanups, or niche arenas, without affecting other schedules.
\n– Reload the plugin to instantly apply changes and monitor `\/ezclean time` for updated countdowns.<\/p>\n
\n– Charge an optional Vault-backed fee per profile and automatically refund players if cancellation fails.
\n– Customize hover, success, broadcast, and error messages with MiniMessage placeholders: `{player}`, `{cleaner}`, `{minutes}`, `{cost}`.
\n– Players without permission see the standard warning, keeping the feature gated to trusted ranks.<\/p>\n
\nwhen it is related to scheduled tasks or plugin activity. Use the following features to pinpoint lag causes:<\/p>\n
\n – Run `\/ezclean usage` to instantly view a breakdown of all pending sync and async tasks,
\n sorted by plugin. This helps you identify which plugins are scheduling the most work
\n and may be contributing to lag.<\/p>\n
\n – Use `\/ezclean usage live` to start a real-time feed in chat and action bar, showing task
\n counts and the busiest plugins as they change. This is ideal for catching lag spikes
\n as they happen and correlating them with plugin activity.<\/p>\n
\n – Add a plugin name to `\/ezclean usage` or `\/ezclean usage live` to focus on a specific plugin’s scheduler activity.<\/p>\n
\n – Use `\/ezclean usage stop` to end a live monitoring session at any time.<\/p>\n
\n – The action bar graph and chat output make it easy to spot sudden increases in scheduled tasks, which often correlate with lag events.<\/p>\n
\nscheduler, investigate that plugin’s configuration or recent activity. EzClean’s tools are
\nespecially useful during peak times or after adding new plugins.<\/p>\n
\n– Set a despawn timer (or keep chests indefinitely) and auto-drop leftovers if the chest breaks or expires.
\n– Customize the MiniMessage inventory title and toggle the feature on the fly without restarting the server.
\n– Keeps messy drop piles off the ground so your cleanup cycles have less to sweep in the first place.<\/p>\n
\n – Example:<\/p>\n
\n max-chests-per-player: 2
\n “`<\/p>\n
\n – Permission: `ezclean.deathchest.limit.bypass` lets a player ignore the chest limit.
\n– **Configurable loot protection** \u2013 Only the owner can open their death chest for
\n a configurable time after death (e.g., 5 minutes), after which anyone may access it.
\n – Example:<\/p>\n
\n loot-protection:
\n enabled: true
\n owner-only-minutes: 5
\n “`<\/p>\n
\n– **Hologram or particle effects above chests** \u2013 Display a floating label or visual effect above each death chest for easy spotting.
\n – Example:<\/p>\n
\n hologram:
\n enabled: true
\n text: “
\n particles:
\n enabled: true
\n type: VILLAGER_HAPPY
\n “`<\/p>\n
\n– `\/ezclean setup` \u2013 Open the interactive inventory GUI to configure a cleaner profile without editing YAML.
\n– `\/ezclean run [cleaner]` \u2013 Trigger any configured profile instantly when staff need a manual sweep.
\n– `\/ezclean cancel [cleaner]` \u2013 Delay the next cleanup cycle (and optionally charge a Vault fee) via command or the clickable broadcast prompt.
\n– `\/ezclean time [cleaner]` \u2013 Check how many minutes remain before the next scheduled cleanup runs.
\n– `\/ezclean reload` \u2013 Reload EzClean’s configuration bundle without restarting to apply new profiles, messages, or entity rules.
\n– `\/ezclean usage [plugin|live|stop] [plugin]` \u2013 Diagnose heavy scheduler usage, start a live monitor, or cancel an active session (`ezclean.usage`).
\n– `\/ezclean stats [cleaner]` \u2013 View detailed statistics for a cleaner profile, including run
\n counts, total entities removed, average duration, TPS impact, and top affected worlds\/groups.
\n– `ezclean.deathchest.limit.bypass` \u2013 Allows a player to ignore the per-player death chest limit.
\n– `ezclean.deathchest.protection.bypass` \u2013 Allows a player to open any death chest regardless of loot protection timer.<\/p>\n
\n– Let EzClean generate `cleaners\/default.yml`, `messages.yml`, and `death-chests.yml` inside its data folder on first launch.
\n– Duplicate `cleaners\/default.yml` for world-specific schedules, then adjust world lists, removal toggles, broadcast cadence, and cancel costs per profile.
\n– Theme broadcasts in `messages.yml`, tweak death chest timers in `death-chests.yml`, and
\n reload the plugin (or restart) to apply changes before checking `\/ezclean time`.<\/p>\n
\n– EzClean automatically registers the `ezclean-bypass` state flag during startup. No manual flag setup required.
\n– Use `\/rg flag
\n– Switch the flag back to `deny` (or remove it) when you want EzClean to resume removing entities from that region.
\n– Entities inside an `allow` region are skipped while the rest of the server is tidied normally.<\/p>\n
\n|———————————-|———–|———————————————————————–|
\n| Hostile mobs | Enabled | Removes `Enemy` instances unless explicitly kept. |
\n| Passive mobs | Disabled | Culls `Animals`, `WaterMob`, `Ambient`, `Golem`, and `Allay` entities |
\n| Villagers & traders | Disabled | Targets villagers and wandering traders (`AbstractVillager`) |
\n| Vehicles | Disabled | Removes `Vehicle` entities such as boats and minecarts |
\n| Dropped items | Enabled | Clears loose `Item` entities server-wide |
\n| Projectiles & orbs | Enabled | Targets arrows, snowballs, thrown potions, and experience orbs |
\n| Area effect clouds | Enabled | Sweeps lingering potion clouds from combat-heavy areas |
\n| Falling blocks & TNT | Enabled | Removes rogue falling blocks and primed TNT |
\n| Players, armor stands & displays | Protected | Stay intact unless you toggle the `protect.*` switches off |
\n| Tamed mobs | Protected | Ignored while `protect.tamed-mobs` stays enabled |
\n| Named mobs | Protected | Skip entities with custom names when `protect.name-tagged-mobs` is on |<\/p>\n
\ninterval-minutes: 60<\/p>\n
\n enabled: false
\n minutes-before: 5<\/p>\n
\n start:
\n enabled: true
\n summary:
\n enabled: true
\n interval:
\n enabled: false
\n every-minutes: 15
\n dynamic:
\n enabled: false
\n minutes: [30, 15, 10, 5]<\/p>\n
\n enabled: true
\n cost: 50000.0<\/p>\n
\n – “*”<\/p>\n
\n enabled: true
\n max-per-block: 120
\n entity-types:
\n – ITEM
\n – EXPERIENCE_ORB
\n ignore-named-entities: true<\/p>\n
\n hostile-mobs: true
\n passive-mobs: false
\n villagers: false
\n dropped-items: true
\n projectiles: true
\n experience-orbs: true
\n area-effect-clouds: true
\n falling-blocks: true
\n primed-tnt: true<\/p>\n
\n players: true
\n armor-stands: true
\n display-entities: true
\n tamed-mobs: true
\n name-tagged-mobs: true<\/p>\n
\n keep: []
\n remove: []
\n“`<\/p>\n
\ndefaults:
\n warning:
\n message: “
\n broadcast:
\n start:
\n message: “
\n summary:
\n message: “
\n pre-clean:
\n message: “”
\n interval:
\n message: “
\n dynamic:
\n message: “
\n stats-summary:
\n message: “
\n cancel:
\n hover-message: “
\n success-message: “
\n broadcast-message: “
\n insufficient-funds-message: “
\n disabled-message: “
\n no-economy-message: “
\n“`<\/p>\n
\nenabled: false
\ndespawn-minutes: 30
\ninventory-title: “
\n“`<\/p>\n
\n– Paper or Purpur 26.1+ server build.
\n– SQLite is bundled. No setup needed. Set `storage.type: mysql` in `config.yml` to use MySQL\/MariaDB instead.
\n– Vault + economy provider (only if you enable pay-to-cancel cleanups).
\n– Optional: PlaceholderAPI, Spark, EzCountdown, WorldGuard (all auto-detected on startup).
\n– Optional: A plugin manager if you prefer in-game reloads instead of full restarts.<\/p>\n
\n– Share performance feedback or suggestions on your resource discussion thread so we can keep tuning the defaults.<\/p>\n
\nInstall EzClean today and let automated cleaners do the grunt work while staff focus on players!<\/p>\n