FancyNpcs Custom Models

FancyNpcs Custom Models - серверный плагин-дополнение, которое соединяет два популярных инструмента: FancyNpcs и BetterModel. Суть простая - берёте любую кастомную 3D-модель, импортированную в BetterModel, и вешаете её на NPC вместо обычного человеческого скина. Никаких клиентских модов игрокам ставить не нужно, всё работает через серверный ресурспак.

Зачем это вообще нужно

Если вы собирали RPG-сервер, хаб или квестовую карту, то знаете боль: ванильные NPC выглядят как обычные игроки со скинами. Максимум - поменять скин, экипировку и имя. Хочется дракона у входа в данж, говорящего гоблина-торговца или босса с анимацией атаки - а ваниль такого не даёт.

BetterModel как раз решает проблему моделей: он рендерит детализированные 3D-модели из Blockbench прямо на сервере через пакеты и display-сущности. Но сам по себе он NPC не создаёт. FancyNpcs Custom Models - это мост между ними. Плагин даёт модели полноценную NPC-логику: триггеры, диалоги, действия, взгляд на игрока. По факту получается живой персонаж с кастомной внешностью и анимациями, а не просто декоративная статуя.

Для серверов с упором на атмосферу это must-have. Квестовые NPC, боссы, питомцы, анимированные декорации в спавне - всё это теперь делается парой команд. Плагин относится к категориям Utility и Decoration, и по факту закрывает обе задачи разом.

Требования и установка

Порядок важен, плагин без зависимостей просто не заведётся:

• FancyNpcs 2.10.1 или новее
• BetterModel 3.1.0 или новее
• FancyNpcs Custom Models (сам аддон)

Поддерживаются Paper и Folia - что отдельно радует, потому что многие NPC-плагины на Folia до сих пор сыплют ошибками. Версии Minecraft свежие: 26.1.2, 26.2 и 26.3. Если вы держите сервер на актуальной версии Майнкрафт, конфликтов быть не должно.

Как назначить модель NPC

Весь процесс умещается в пять шагов:

1. Установите все три плагина из списка выше
2. Импортируйте нужные модели в BetterModel
3. Убедитесь, что ваш NPC имеет тип player: /npc type (npc) player
4. Назначьте модель командой /npc custom_model (npc) (название модели)
5. Готово - NPC отобразится с выбранной 3D-моделью

Чтобы убрать модель и вернуть обычный вид, пропишите /npc custom_model (npc) @none.

Важный нюанс: тип NPC обязательно должен быть player. Если у вас NPC-зомби или NPC-житель, команда не сработает - сначала переключите тип. Это логично, ведь именно player-сущность служит якорем для рендера модели.

Ограничения, о которых стоит знать заранее

С назначенной моделью часть стандартных команд FancyNpcs перестаёт работать. Это не баг, а особенность: модель полностью заменяет рендер персонажа.

Команда	Что происходит
/npc displayname	Не работает, имя над головой не отображается
/npc equipment	Экипировка не видна на модели
/npc glowing	Свечение применить нельзя
/npc skin	Скин не имеет смысла - внешность задаёт модель
/npc turn_to_player	Зависит от самой модели

Из практики: если вам нужно имя над NPC, делайте его текстовой голограммой через сторонний плагин или встройте табличку в саму модель в BetterModel. С экипировкой та же история - хотите меч в лапах у босса, рисуйте его в Blockbench как часть модели.

Анимации

Отдельный плюс аддона - поддержка анимаций. Работают они только для NPC с назначенными моделями, и доступны два новых действия:

• play_animation_once - проигрывает анимацию один раз
• play_animation_loop - крутит анимацию в бесконечном цикле

Привязка к триггеру делается стандартной системой действий FancyNpcs:

/npc action (npc) (триггер) add play_animation_once (название анимации)

Есть и прямая команда для ручного запуска:

/npc play_animation (npc) (название анимации) [--loop]

Флаг --loop включает циклическое воспроизведение. Это открывает классные сценарии: торговец машет рукой, когда игрок подходит, босс в хабе разминается в ожидании, стражник у ворот дышит и косится по сторонам в цикле. Такие детали сильно оживляют сервер, игроки это чувствуют сразу.

Совет из опыта: не злоупотребляйте looping-анимациями, если NPC много и они стоят кучно. Десяток анимированных моделей в одном чанке на слабом клиенте ощутимо просаживает FPS. Лучше ставить play_animation_once на триггер приближения - и эффектнее, и легче для железа.

Пара слов про телеметрию

Плагин собирает анонимную статистику использования - без IP-адресов, имён серверов и чего-либо, по чему вас можно опознать. Если принципиально не хотите участвовать, сбор отключается, детали есть в документации плагина.

Итог

FancyNpcs Custom Models пока проект молодой (вышел около пяти месяцев назад и набрал порядка полутора тысяч загрузок), но связку FancyNpcs плюс BetterModel на модных серверах он закрывает почти безальтернативно. Лицензия MIT, исходники открыты. Если вы делаете RPG-контент, хаб-лобби или квестовые зоны и хотите NPC, которых запомнят - это именно тот инструмент.

Совсем просто всё разворачивается и на BungeeHost - плагины из связки ставятся там в один клик, так что сервер с анимированными NPC для игры с друзьями поднимается за вечер. Скачайте FancyNpcs Custom Models, подтяните модели из BetterModel и дайте вашим NPC наконец нормальную внешность.