InControlMob

InControlMob — инструмент для администраторов серверов, позволяющий гибко настраивать поведение мобов, их характеристики и лут без изменения кода.

InControlMob предоставляет администраторам мощную систему управления спавном мобов, поведением спавнеров, призванными сущностями, а также лутом и опытом. Основная механика проекта построена на использовании правил в формате JSON, которые хранятся в директории config/incontrolmob/.

Плагин поддерживает валидацию JSON-схем при загрузке, что позволяет безопасно изменять поведение сервера без написания кода. Система обеспечивает асинхронную загрузку правил, кэширование и индексацию по типам сущностей и причинам спавна для сохранения производительности.

Основные возможности системы включают проверку богатых условий, таких как тип сущности, мир, биом, уровень освещенности, причина спавна, время суток, сложность, наличие игроков поблизости, соответствие NBT-тегов и проверка регионов WorldGuard.

Доступные действия в рамках правил позволяют:

• Разрешать или запрещать спавн
• Изменять здоровье сущностей
• Устанавливать экипировку
• Добавлять эффекты зелий
• Заменять тип сущности
• Модифицировать выпадение предметов и опыт
• Устанавливать флаги (noGravity, invulnerable, glowing, persistent)
• Изменять скорость (velocity) или пассажиров

Управление приоритетами и логикой выполняется через флаг priority, параметр enabled и настройку continueOnMatch, определяющую порядок обработки файлов правил.

Для администраторов предусмотрены инструменты управления: список загруженных правил, экспорт текущих настроек в архив и симуляция оценки правил в конкретной точке.

Команды плагина:

/incontrolmob reload
/incontrolmob rules list
/incontrolmob rule test <ruleId> <entityType>
/incontrolmob export

Необходимые права доступа (permissions):

• incontrolmob.reload — перезагрузка правил
• incontrolmob.manage — управление правилами и экспорт
• incontrolmob.test — запуск тестов правил

Настройка и отладка

Конфигурационный файл config.yml содержит базовые параметры, такие как включение плагина, режим отладки (debug), действие по умолчанию и лимиты кэша.

При включении режима debug: true в config.yml в консоли будут выводиться подробные логи для диагностики правил.

В случае ошибок в JSON-файлах система пропустит некорректные правила и выведет отчет о валидации в консоль при выполнении команды перезагрузки.

Для оптимизации производительности рекомендуется избегать слишком широких правил и поддерживать разумный размер rule-cache-size.