EzClean

# EzClean - Minecraft Entity Cleaner Plugin Automated entity sweeps, live countdowns, pay-to-cancel, Discord webhooks, PlaceholderAPI, Spark profiling, and async scheduler monitoring for **Paper 26.1+**, Spigot, and Purpur. **Platform:** Paper 26.1+, Spigot/Bukkit, Purpur | **Java:** 17+ | **Storage:** SQLite (bundled) or MySQL **Optional:** Vault, WorldGuard, Discord, PlaceholderAPI, Spark, EzCountdown Check our latest project: (https://modrinth.com/plugin/pvpindex-battle) --- ## Why Choose EzClean? EzClean is designed for modern Minecraft servers that demand performance, flexibility, and safety. Here’s why it stands out: - **100% SpigotMC/Bukkit compatible** – Works on Spigot, Paper, and Purpur. No Paper-only dependencies. - **Profile-based scheduling** – Create multiple cleaner profiles, each with its own interval, world targets, entity rules, and broadcast messages. - **Interactive countdowns** – Themed warnings, recaps, and staff-only cancel prompts using MiniMessage placeholders: `{minutes}`, `{count}`, `{cleaner}`, `{cost}`. - **Granular removal rules** – Toggle hostile mobs, passive mobs, villagers, vehicles, drops, orbs, projectiles, TNT, clouds. Protect players, armor stands, displays, tamed pets, named mobs. - **World targeting** – Clean specific worlds or use `*` for network-wide sweeps. - **Force keep/remove lists** – Tag any `EntityType` to always keep or remove for custom events or mechanics. --- ## Feature Highlights EzClean offers powerful features to keep your Minecraft server running smoothly and your players happy: - **MiniMessage ready** – Themed warning, interval, dynamic, pre-clean, and cancel broadcasts using Adventure MiniMessage tags: `minutes`, `count`, `cleaner id`, `cancel costs`. - **WorldGuard integration** – Regions flagged with `ezclean-bypass` are automatically skipped during entity sweeps. - **Pay-to-cancel safety net** – Optional Vault hooks let you charge players to cancel a cleanup, with hover tooltips and refund protection. - **Safe defaults** – Critical entities are protected until you explicitly opt in to remove them. - **Lightweight configuration** – Cleaners, MiniMessage copy, and death chests in tidy YAML files. - **Hot reload friendly** – Reload profile changes instantly with your favorite plugin manager or `/reload confirm`. - **Smart pile detection** – Automatically cull stacks of drops or other spammy entities that exceed your per-block limit. - **Entity merging** – Merge nearby same-type entities before removal to reduce packet spam and improve sweep efficiency. - **Optional death chests** – Capture player drops in temporary containers that despawn on a timer instead of scattering items everywhere. - **Language / i18n support** – Ships with bundled English, Dutch, and Spanish translations; drop any `<lang>.yml` into the `lang/` folder to add your own locale. - **Discord webhook notifications** – Post cleanup summaries to a Discord channel by setting a webhook URL in `config.yml`. No bot token or extra plugins required. - **PlaceholderAPI support** – Expose live stats as `%ezclean_<stat>%` placeholders for scoreboards, holograms, and chat formatters. - **Spark integration** – Use Spark's precise TPS/MSPT rolling averages for smarter scheduling and trigger automatic profiler sessions when entity counts spike. - **EzCountdown integration** – Drive pre-cleanup countdowns through EzCountdown for richer, theme-able announcements. - **Storage-backed stats** – Persist cleanup statistics across restarts with the bundled SQLite database or an external MySQL/MariaDB instance. - **Update notifier** – Ops receive a clickable in-chat notice when a newer EzClean version is available. - **Interactive setup GUI** – Configure cleaner profiles through a point-and-click inventory wizard without touching YAML. --- ## Configure What Gets Cleaned 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. - Create unlimited cleaner profiles, each with unique world targets, countdown cadence, and broadcast messages. - Toggle entity groups (hostile mobs, passive mobs, villagers, vehicles, drops, orbs, projectiles, clouds, falling blocks, TNT) per profile. - Fine-tune specific `EntityType` values using `keep`/`remove` arrays to protect custom mobs or purge event clutter. - Mix profiles for global sweeps, world-specific cleanups, or niche arenas, without affecting other schedules. - Reload the plugin to instantly apply changes and monitor `/ezclean time` for updated countdowns. --- ## Pay-to-Cancel Cleanups Let staff delay scheduled cleanups with a single click, optionally charging a Vault-backed fee and showing dynamic MiniMessage prompts. - Clickable countdown broadcasts let staff with `ezclean.cancel` permission delay the next cleanup instantly. - Charge an optional Vault-backed fee per profile and automatically refund playe