ChunkEntityLimiter

ChunkEntityLimiter автоматически ограничивает количество сущностей и выпавших предметов, предотвращая лаги от ферм мобов или массовых дропов. Система использует двойную проверку лимитов для обеспечения высокой производительности сервера.

ChunkEntityLimiter предназначен для оптимизации производительности сервера за счет интеллектуального контроля плотности объектов. Плагин предотвращает значительные потери FPS и задержки, вызванные чрезмерным скоплением мобов или предметов, сохраняя при этом важные для игрового процесса сущности.

Система функционирует на основе двух уровней проверки: индивидуальный лимит на каждый чанк и агрегированный лимит для группы чанков в радиусе вокруг игрока. Это позволяет эффективно бороться с лагами от крупных ферм или зон с массовым выпадением предметов.

• Нативная поддержка Folia: полная оптимизация под архитектуру региональных потоков.
• Умная логика очистки: удаление сущностей происходит по принципу «Oldest First» — сначала удаляются самые старые объекты, чтобы сохранить недавно появившихся мобов.
• Двухуровневое ограничение: лимиты применяются как к отдельным чанкам, так и к области вокруг игрока.
• Точный подсчет предметов: возможность конфигурации подсчета стаков по фактическому количеству предметов (например, стак из 64 блоков булыжника будет считаться как 64 единицы, а не 1 сущность).
• Гранулярные уведомления: раздельное управление отчетами об очистке и предупреждениями о перегрузке с выбором охвата (Никто, только ОП или все игроки поблизости).
• Мониторинг производительности: встроенный профилировщик для отслеживания времени выполнения фаз классификации и очистки.

Процесс обработки объектов проходит через четыре этапа:

• Классификация: сущности делятся на «Защищенные» (Protected) и «Удаляемые» (Removable).
• Проверка защиты: сущности с именами, на поводке, прирученные, экипированные или боссы игнорируются при очистке, если не включен параметр clean-protected-if-over-limit.
• Сортировка: все удаляемые сущности сортируются по времени их появления (Spawn Time).
• Исполнение: плагин удаляет объекты, начиная с самых старых, пока общее количество не упадет ниже установленного лимита.

/chunklimit reload
/chunklimit stats
/chunklimit notify [type] [scope]
/chunklimit performance [reset]

Основные параметры в config.yml позволяют детально настроить поведение лимитов:

• entity-limits.default-limit: Базовое количество сущностей на чанк (по умолчанию 100).
• entity-limits.item-limit: Максимальное количество выпавших предметов (по умолчанию 300).
• entity-limits.check-interval-ticks: Интервал проверки в игровых тиках (рекомендуется 600 для 30 сек или 1200 для 60 сек).
• entity-limits.chunk-check-radius: Радиус проверки чанков вокруг игрока (0 — отключено).
• entity-limits.chunk_entity_multiplier: Коэффициент ослабления лимита для чанков вокруг игрока (например, 1.5 делает лимит в 1.5 раза выше базового).
• entity-limits.count-item-stack-amount: Если true, стак из 64 предметов считается как 64 сущности; если false — как 1 сущность.
• ignored-types / ignored-items: Списки типов сущностей и предметов, которые полностью игнорируются системой.
• custom-limits: Возможность задать индивидуальные лимиты для конкретных типов (например, ZOMBIE: 200).
• protection: Настройки защиты для именованных сущностей, сущностей на поводке, прирученных животных, экипированных мобов и боссов.
• settings.clean-protected-if-over-limit: Если true, защищенные сущности будут удаляться только в том случае, если лимит превышен даже после удаления всех обычных объектов.
• settings.clean_all_loaded_chunks: Включение глобальной очистки загруженных чанков (Phase 1). Для Folia рекомендуется false для повышения производительности.
• settings.notify-threshold: Процент заполнения лимита (0-100), при котором отправляется предупреждение.
• settings.notification-radius: Радиус уведомлений для игроков (в блоках).

Для работы на платформе Folia рекомендуется отключать глобальную очитку чанков (clean_all_loaded_chunks: false), так как региональная архитектура потоков требует иного подхода к обработке данных.