MaxClear

MaxClear - это легковесный плагин для очистки сущностей на сервере Minecraft. Он создан специально для борьбы с лагом, вызванным скоплением мобов, дропа, стрел и другого мусора. При этом важные сущности (игроки, жители, стойки для брони, вагонетки) остаются в безопасности. Плагин подходит для серверов на Paper и Spigot, работает на Java 21+ и версии Minecraft 1.21.

Зачем нужен MaxClear

На любом активном сервере со временем накапливаются лишние сущности: выпавшие предметы, стрелы, опыт, фейерверки. Если их не чистить, сервер начинает тормозить, особенно в районах ферм мобов. MaxClear автоматически удаляет всё лишнее по расписанию, а также позволяет админам запускать ручную очистку. Плагин не трогает то, что должно остаться - например, именованные предметы или сущности рядом со спавном.

Основные возможности

• Автоматическая очистка - запускается с заданным интервалом (по умолчанию каждые 5 минут).
• Предупреждение перед очисткой - можно включить оповещение за несколько секунд до удаления.
• Ручная команда - /maxclear clear или /mc clear для мгновенной очистки.
• Список целей - вы сами решаете, какие типы сущностей удалять (по умолчанию ITEM, ARROW, EXPERIENCE_ORB, TNT и т.д.).
• Список исключений - защищает важных мобов (жителей, лошадей, панд) от удаления и от проверки лимита чанка.
• Защита именованных предметов - если включено, предметы с кастомным названием не удаляются.
• Защита спавна - можно задать радиус вокруг точки появления мира, внутри которого сущности не трогаются.
• Фильтр миров - очистка только в указанных мирах (если список пуст - работает везде).
• Анти-ферма по чанкам - ограничивает количество сущностей в одном чанке, чтобы фермы не создавали лавину мобов.
• Обновления - плагин проверяет новые версии при старте и каждые 5 часов, администраторы получают уведомление при входе.
• bStats - анонимная статистика использования (можно отключить).
• Гибкие сообщения - все тексты настраиваются через конфиг, поддерживаются цветовые коды &.

Команды и разрешения

Команда	Алиас	Право	Кто может	Описание
/maxclear	/mc	maxclear.admin	Игрок / Консоль	Показывает справку по командам
/maxclear reload	/mc reload	maxclear.admin	Игрок / Консоль	Перезагружает конфиг и обновляет задачи
/maxclear clear	/mc clear	maxclear.admin	Игрок / Консоль	Запускает ручную очистку
/maxclear get author	/mc get author	maxclear.admin	Игрок / Консоль	Показывает автора плагина
/maxclear get version	/mc get version	maxclear.admin	Игрок / Консоль	Показывает текущую версию

Право maxclear.admin по умолчанию выдаётся операторам (op). Игроки без него не видят таб-комплишн и не могут выполнять команды.

Как работает очистка

MaxClear удаляет сущность только если она проходит все проверки:

1. Тип сущности должен быть в списке entities.types.
2. Сущность не должна быть в списке исключений entities.exclude.
3. Если включена опция ignore-named-items, предметы с кастомным именем защищены.
4. Если min-distance-from-spawn больше 0, сущности внутри радиуса от спавна мира не удаляются.
5. Если список worlds не пуст, очистка работает только в указанных мирах.

Автоматическая очистка использует сообщение из messages.completed, ручная - из messages.manual-clear с подстановкой имени игрока.

Анти-ферма по чанкам

Когда опция chunk-limit.enabled включена, MaxClear отслеживает появление мобов и ограничивает количество не-игроков и не-исключённых сущностей в чанке. Параметр chunk-limit.max задаёт максимальное число. Сущности из списка исключений (например, жители, стойки для брони, вагонетки) не учитываются. Это помогает бороться с чрезмерным спавном на фермах, не блокируя полезных мобов.

Конфигурация

Основной файл - config.yml. Вот ключевые настройки:

Общие

Путь	Тип	По умолчанию	Описание
general.prefix	String	Задано в config.yml	Префикс перед сообщениями плагина
general.update-check	Boolean	true	Проверка обновлений при старте и каждые 5 часов
general.bstats	Boolean	true	Анонимная статистика bStats

Автоочистка

Путь	Тип	По умолчанию	Описание
auto-clear.enabled	Boolean	true	Включить автоматическую очистку
auto-clear.interval	Integer	300	Интервал в секундах между очистками

Предупреждение

Путь	Тип	По умолчанию	Описание
messages.warning.enabled	Boolean	true	Включить предупреждение перед очисткой
messages.warning.seconds-before	Integer	10	За сколько секунд до очистки отправлять предупреждение
messages.warning.message	String	Настраивается	Текст предупреждения, поддерживает {time}

Сообщения об очистке

Путь	Тип	Описание
messages.completed.message	String list	Транслируется после автоочистки, поддерживает {count}
messages.manual-clear.message	String	Транслируется после ручной очистки, поддерживает {player} и {count}
messages.no-permission	String	Отправляется игроку без прав
messages.plugin-reload	String	После успешной перезагрузки
messages.subcommand-invalid	String	При неверной подкоманде
messages.subcommand-specified	String	Когда не указана обязательная подкоманда

Обновления

Путь	Тип	Описание
messages.update-available	String	Строка уведомления админа при входе (доступна новая версия)
messages.update-current	String	Строка с текущей версией
messages.update-download	String	Строка перед ссылкой на скачивание

Удаление сущностей

Путь	Тип	Поведение по умолчанию
entities.types	String list	Типы сущностей, которые разрешено удалять (ITEM, ARROW, EXPERIENCE_ORB и др.)
entities.exclude	String list	Типы сущностей, защищённые от удаления и лимита чанка (игроки, жители, стойки и т.д.)
entities.settings.ignore-named-items	Boolean	Защищает именованные предметы
entities.settings.min-distance-from-spawn	Integer	Радиус защиты от спавна мира (0 - отключено)
entities.settings.worlds	String list	Миры для очистки (пусто - все миры)

По умолчанию удаляются: ITEM, ARROW, EXPERIENCE_ORB, TNT, FIREWORK_ROCKET, TRIDENT, SNOWBALL, EGG, ENDER_PEARL. Защищены: игроки, жители, рамки, стойки для брони, картины, вагонетки, лодки и их варианты.

Алиасы имён сущностей

Для совместимости со старыми версиями Minecraft MaxClear поддерживает алиасы:

Алиас	Разрешается в
BOAT	Все обычные лодки (дуб, ель, берёза и т.д.)
CHEST_BOAT	Все лодки с сундуком
MINECART_CHEST	CHEST_MINECART
MINECART_FURNACE	FURNACE_MINECART
MINECART_HOPPER	HOPPER_MINECART
MINECART_TNT	TNT_MINECART
MINECART_MOB_SPAWNER	SPAWNER_MINECART
MINECART_COMMAND	COMMAND_BLOCK_MINECART

Имена сущностей приводятся к верхнему регистру при загрузке конфига.

Плейсхолдеры

Плейсхолдер	Где используется	Описание
{time}	messages.warning.message	Секунд до автоочистки
{count}	messages.completed.message, messages.manual-clear.message	Количество удалённых сущностей
{player}	messages.manual-clear.message	Имя отправителя ручной очистки
{version}	Сообщения об обновлениях	Версия плагина (текущая или новая)

Советы владельцам серверов

• Держите список исключений (entities.exclude) актуальным - если на сервере есть NPC, кастомные мобы или дисплейные сущности от других плагинов, добавьте их туда.
• Используйте фильтр миров (entities.settings.worlds), если хотите чистить только определённые миры (например, ресурсные миры).
• Если на спавне разбросаны декоративные предметы, установите min-distance-from-spawn больше 0.
• Значение messages.warning.seconds-before должно быть меньше интервала автоочистки, иначе предупреждение будет проигнорировано (плагин безопасно отключит его и запишет в лог).
• Для обычных изменений конфига достаточно команды /maxclear reload - перезагружать сервер не нужно.

MaxClear - простой и надёжный инструмент для поддержания порядка на сервере Minecraft. Скачайте плагин MaxClear и забудьте о лаге от лишних сущностей.