EzClean - Плагин очистки сущностей для Майнкрафт серверов

EzClean - это серверный плагин для Майнкрафт, который борется с одной из самых больных проблем любого крупного проекта: засорение мира сущностями. Вагонетки, дропы, снаряды, опыт, облака зелий - всё это копится, жрёт оперативку и роняет TPS. EzClean автоматически вычищает этот мусор по расписанию, причём делает это аккуратно, с настраиваемыми профилями и защитой важных сущностей.

Если у вас когда-нибудь падал тик-рейт после массового замеса или после фермы мобов - вы знаете, зачем это нужно. Плагин работает на Paper 26.1+, а также на Spigot, Bukkit, Purpur и Folia. Требуется Java 17+. Актуальная версия - 3.0.1, совместимая с Minecraft 1.21.x.

Зачем нужен EzClean

Классический вопрос админа: сервер вроде мощный, а лаги всё равно есть. И причина часто не в железе, а в десятках тысяч дропнутых предметов, которые никто не убирает. EzClean решает это без головной боли: ставите интервал, выбираете что удалять, и всё. Плюс есть предупреждения игрокам, чтобы они успели забрать ценности.

По факту это не один плагин, а целый набор инструментов для оптимизации и диагностики сервера.

Ключевые возможности

• Профили очистки - создавайте сколько угодно профилей, у каждого свой интервал, список миров, правила по сущностям и сообщения. Можно сделать глобальную чистку для всей сети и отдельный щадящий профиль для арен-арен.
• Настраиваемые каунтдауны - тематические предупреждения и итоговые отчёты с плейсхолдерами {minutes}, {count}, {cleaner}, {cost} на базе MiniMessage.
• Точные правила удаления - отдельно включаются враждебные мобы, мирные, жители, вагонетки и лодки, дропы, сферы опыта, снаряды, TNT, облака эффектов, падающие блоки.
• Защита важного - игроки, стойки для брони, отображаемые сущности, прирученные и именованные мобы по умолчанию не трогаются.
• Списки keep/remove - можно принудительно сохранять или удалять конкретные EntityType, если у вас кастомные мобы или ивент-механики.
• Выбор миров - чистка нужных миров или всей сети сразу через *.

Работа с WorldGuard

Если у вас стоит WorldGuard, EzClean сам регистрирует флаг ezclean-bypass при запуске. Просто помечаете безопасные зоны командой /rg flag <region> ezclean-bypass allow - и сущности в спавне, на выставках или в редстоун-лабораториях больше не пропадут. Очень удобно для творческих зон, где игроки оставляют декоративные стенды.

Отмена очистки за валюту

Прикольная фича для серверов с экономикой. Уполномоченный игрок или стафф может кликнуть по сообщению в чате и отложить следующую чистку, заплатив Vault-валюту. Если отмена не проходит - деньги возвращаются. Все сообщения (подсказка, успех, ошибка) кастомизируются через MiniMessage. Игроки без прав ezclean.cancel видят только обычное предупреждение.

Диагностика нагрузки планировщика

Вот это уже реально полезная штука для тех, кто ищет причину лагов. EzClean умеет показывать, какие плагины грузят сервер своими задачами.

• /ezclean usage - мгновенный снимок всех синхронных и асинхронных задач с сортировкой по плагинам.
• /ezclean usage live - живой монитор прямо в чате и на action bar. Показывает, какие плагины резвятся больше всех.
• Фильтр по плагину - добавьте имя к команде, чтобы следить за конкретным подозреваемым.
• /ezclean usage stop - останавливает мониторинг.

Совет: если видите всплеск задач от одного плагина - копайте его конфиг. Часто именно там спрятаны грабли.

Death Chest - сундуки смерти

Опциональная, но крайне приятная штука. Вместо разбросанных вещей при смерти игрока появляется сундук на 54 слота рядом с местом гибели. Настраивается таймер исчезновения, а вещи из лопнувшего сундука выпадают на землю.

Расширенные настройки:

• Лимит сундуков на игрока - в max-chests-per-player указывается максимум, старый сундук удаляется автоматически. Право ezclean.deathchest.limit.bypass снимает ограничение.
• Защита лута - какое-то время сундук может открыть только владелец (например, 5 минут), потом - все желающие. Настраивается в loot-protection.
• Голограммы и партиклы - можно повесить над сундуком плавающий текст или эффект частиц для удобного поиска.

Как настроить профиль

Всё хранится в YAML. Файл cleaners/default.yml - основной, остальные делаются копированием. Ключевые параметры:

• interval-minutes - как часто запускать очистку.
• warning - предупреждение игрокам перед чисткой.
• cancel - включение отмены за деньги и её цена.
• worlds - список миров.
• pile-detection - автоуборка кучи дропа сверх лимита на блок.
• remove.* - что удаляется.
• protect.* - что неприкосновенно.

Сообщения правятся в messages.yml, сундуки смерти - в death-chests.yml. Перезагрузка без рестарта через /ezclean reload.

Команды для админов

• /ezclean help - список всех подкоманд и нужных разрешений.
• /ezclean setup - открыть интерактивный GUI-редактор профиля, можно настроить всё кликами без правки YAML.
• /ezclean run [cleaner] - запустить профиль вручную.
• /ezclean cancel [cleaner] - отложить чистку.
• /ezclean time [cleaner] - сколько осталось до следующей чистки.
• /ezclean reload - перезагрузка конфига.
• /ezclean stats [cleaner] - статистика: число запусков, всего удалено, средняя длительность, влияние на TPS, топ миров и групп.

Что чистится по умолчанию

Категория	По умолчанию
Враждебные мобы	Включено
Мирные мобы	Выключено
Жители и торговцы	Выключено
Лодки и вагонетки	Выключено
Дроп	Включено
Снаряды и опыт	Включено
Облака эффектов	Включено
Падающие блоки и TNT	Включено
Игроки, стойки, отображения	Защищены
Прирученные и именованные мобы	Защищены

Быстрый старт

1. Киньте EzClean.jar в папку plugins/ и перезапустите сервер.
2. Плагин сам создаст cleaners/default.yml, messages.yml и death-chests.yml.
3. Скопируйте дефолтный профиль для каждого мира и подкрутите список миров, правила и интервалы.
4. Настройте тексты в messages.yml и таймеры смерти в death-chests.yml.
5. Перезагрузите плагин и проверьте /ezclean time.

Требования и совместимость

• Java 17 или новее.
• Paper или Purpur 26.1+, а также Spigot, Bukkit, Folia.
• SQLite идёт в комплекте, для MySQL/MariaDB поставьте storage.type: mysql в конфиге.
• Vault - только если включаете отмену за валюту.
• Опционально подхватываются: PlaceholderAPI, Spark, EzCountdown, WorldGuard.

Важные нюансы

• В 3.0.0 появилась локализация (английский, нидерландский, испанский), постоянное хранение статистики, GUI настройки и уведомления об обновлениях. Свой язык добавляется простым YAML-файлом в папку lang/.
• В 3.0.1 пофиксили падение /ezclean setup из-за NullPointerException и неработающие клики в редакторе GUI. Так что если у вас стояла 3.0.0 - обновляйтесь.
• Discord-уведомления работают через вебхук, никаких ботов и лишних плагинов ставить не нужно.
• PlaceholderAPI отдаёт статистику как %ezclean_<stat>% - удобно вешать на скорборды, голограммы и форматирование чата.
• Интеграция со Spark позволяет использовать точные TPS/MSPT-метрики для умного расписания и авто-запуск профайлера при скачке сущностей.
• Проект работает под лицензией MIT, исходники открыты.

Если у вас сервер на 30+ онлайна - EzClean фактически обязателен. Он снимает нагрузку с тиков, даёт админам понятную картину и не даёт мирам превращаться в свалку. Скачайте EzClean и забудьте про ручные чистки через WorldEdit.