ChunkEntityLimiter - лимит сущностей и предметов на сервере Майнкрафт

Если вы администрируете сервер Minecraft, то наверняка сталкивались с ситуацией, когда игроки строят огромные фермы мобов или спамят дропом - сервер начинает тормозить, тики проседают, игроки жалуются. ChunkEntityLimiter решает эту проблему: он автоматически следит за количеством сущностей и предметов в каждом чанке и удаляет лишнее, не трогая то, что важно.

Плагин работает на Paper, Spigot, Purpur и Folia (с полной поддержкой региональной многопоточности Folia). Система двойная: сначала проверяется лимит на один чанк, потом - суммарный лимит на область вокруг игрока. Это позволяет гибко бороться с лагом и от ферм, и от скоплений в одном месте.

Как это работает (Cleanup Logic)

1. Все сущности делятся на "защищённые" и "удаляемые".
2. Защищённые - это именованные, прирученные, оседланные, с экипировкой, боссы. Они не трогаются, пока не включена опция clean-protected-if-over-limit.
3. Удаляемые сортируются по времени появления - самые старые уходят первыми.
4. Плагин убирает сущности, пока их количество не станет ниже лимита.

Простая логика, но она спасает сервер от десятков тысяч зомби в чанке.

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

Основная команда: /chunklimit (алиасы /cl, /climit).

Команда	Описание	Право
/chunklimit reload	Перезагрузить конфиг	chunklimiter.reload (op)
/chunklimit stats	Показать статистику сущностей в текущем чанке и радиусе	chunklimiter.stats (по умолчанию true)
/chunklimit notify [type] [scope]	Настроить уведомления: report (отчёт об очистке) или warning (предупреждение о приближении к лимиту); none, op, all	chunklimiter.notify (op)
/chunklimit performance [reset]	Показать метрики производительности (время на классификацию, очистку и т.д.)	chunklimiter.performance (op)

Пример: /cl notify report op - получать отчёты об очистке только админам.

Основные настройки config.yml

В конфиге можно тонко настроить лимиты под свой сервер. Вот ключевые параметры:

• entity-limits.default-limit - максимальное количество всех сущностей (кроме отдельно настроенных) на один чанк. По умолчанию 100.
• entity-limits.item-limit - лимит предметов (дропа) на чанк. По умолчанию 300.
• entity-limits.check-interval-ticks - интервал проверки в тиках (20 тиков = 1 сек). Рекомендуется 600 (30 сек) или 1200 (60 сек) для экономии производительности.
• entity-limits.chunk-check-radius - радиус проверки вокруг игрока (0 - отключено). Если поставить 2, то проверяется область 5x5 чанков вокруг игрока, и на неё накладывается суммарный лимит. Удобно для активных зон.
• entity-limits.count-item-stack-amount - считать ли стаки предметов по количеству: если true, то стак из 64 булыжника считается как 64 единицы. Если false - как 1 сущность.
• entity-limits.ignored-types - типы сущностей, которые вообще не учитываются (например, железные големы, жители).
• entity-limits.ignored-items - предметы, которые не удаляются (алмазы, незерит и т.п.).
• entity-limits.custom-limits - переопределение лимитов для конкретных мобов (например, зомби - 200, криперы - 200).

Защита ценных сущностей (protection)

• protect-named-entities - защищать именованных (true/false).
• protect-leashed-entities - защищать привязанных на поводке.
• protect-tamed-animals - защищать прирученных (волки, кошки, попугаи).
• protect-equipped-entities - защищать мобов с экипировкой.
• protect-boss-entities - защищать боссов (Дракон Края, Визер).

Если clean-protected-if-over-limit true, то при превышении лимита сначала удаляются обычные сущности, а если всё ещё много - то и защищённые. Лучше оставить false, чтобы ценные мобы не слетели.

Советы по настройке для разных ситуаций

• Для Folia рекомендуется отключить глобальную очистку всех загруженных чанков (clean-all-loaded-chunks: false). Вместо этого плагин будет чистить только чанки рядом с игроками - это значительно снижает нагрузку.
• Интервал 600 тиков (30 секунд) - золотая середина. Если мобофермы гигантские, можно уменьшить до 200-300, но это увеличит нагрузку самого плагина.
• Multiplier для радиуса вокруг игрока позволяет сделать лимиты более лояльными в активной зоне (например, коэффициент 1.5 даёт на 50% больше сущностей в ближних чанках).
• Уведомления можно настроить так, чтобы обычные игроки не видели отчётов об очистке - только админы (cleanup-report-scope: OP).

Что в итоге

ChunkEntityLimiter - это жирный плюс к стабильности сервера. Особенно полезен на проектах с большим онлайном и кучей автоматических ферм. Настраивается один раз и забываешь: плагин сам следит за тем, чтобы сущностей не становилось слишком много. И главное - не трогает то, что нужно игрокам (лут, именованные ослы с сундуками, домашние волки).

Скачать плагин ChunkEntityLimiter можно на официальных площадках (внутренние ссылки не требуются). Подходит для Майнкрафт 1.17+ (проверено на 1.20 и 1.21). Если используете Folia - убедитесь, что версия плагина поддерживает региональные чанки.

В общем, если ваш сервер страдает от лагов из-за мобоферм - этот плагин то, что нужно. Быстро, легко и без геморроя.