Плагин для серверов Майнкрафт, который автоматически восстанавливает модели BetterModel у NPC из Citizens. Он полезен на серверах с большим числом кастомных персонажей: модель повторно применяется после перезапуска, загрузки мира или чанка, перезагрузки Citizens либо BetterModel и при ошибке — с настраиваемыми повторными попытками.
Возможности
- Следит за настроенными NPC и ставит им нужную модель BetterModel без ручной правки.
- Импортирует уже назначенные модели из Citizens, включая данные traits, метаданные NPC и
plugins/Citizens/saves.yml. - Использует очередь, чтобы одинаковые или параллельные операции перезагрузки не мешали друг другу.
- Даёт меню администратора со списком NPC, их ID, моделями, состоянием и результатом последнего восстановления. Из него можно восстановить модель одного NPC или всех, включить либо отключить наблюдение и перезагрузить конфиг.
- При наличии PlaceholderAPI добавляет плейсхолдеры:
%bmnpc_total%,%bmnpc_queue%,%bmnpc_running%,%bmnpc_status_<id>%,%bmnpc_model_<id>%,%bmnpc_failures_<id>%.
Команды
/bmnpc gui— открыть меню администратора./bmnpc reload— перезагрузить конфигурацию./bmnpc all— восстановить модели всех настроенных NPC./bmnpc npc <id>— восстановить модель одного NPC./bmnpc sync— импортировать модели, уже назначенные NPC в Citizens./bmnpc sync overwrite— импортировать модели и обновить имеющиеся записи./bmnpc add <id> <model> [name]— добавить NPC в конфигурацию./bmnpc remove <id>— удалить NPC из конфигурации./bmnpc setmodel <id> <model>— сменить модель NPC./bmnpc enable <id>и/bmnpc disable <id>— включить или выключить автоматическое восстановление для NPC./bmnpc status,/bmnpc list,/bmnpc inspect <id>,/bmnpc history <id>— посмотреть состояние, список NPC, подробности и историю восстановления./bmnpc validate— проверить конфигурацию и настроенных NPC.
Права
bmnpcforcereload.admin открывает доступ ко всем командам плагина.
Отдельные права: bmnpcforcereload.reload.all, bmnpcforcereload.reload.single, bmnpcforcereload.gui, bmnpcforcereload.sync, bmnpcforcereload.manage, bmnpcforcereload.status, bmnpcforcereload.list, bmnpcforcereload.inspect, bmnpcforcereload.history, bmnpcforcereload.validate, bmnpcforcereload.update, bmnpcforcereload.config.reload.
Настройка
Основные параметры находятся в config.yml: интервал проверки, задержка после запуска, число попыток и задержка между ними, наблюдение за чанками, режим работы BetterModel и список NPC. Для каждого NPC задаются npc-id, model, enabled и события, при которых нужно заново применить модель: on-startup, on-world-load, on-chunk-load.
В bettermodel.mode можно выбрать auto, api или command; при недоступности API допускается запасной вариант с командой. Состояния NPC и история попыток хранятся в plugins/BMNpcForceReload/data.db.
Требования
Нужны Citizens и BetterModel. Плагин рассчитан на Paper и Folia. PlaceholderAPI подключается по желанию — для плейсхолдеров.
