epicnpc — мост между CustomNPC и EpicFight
Если вы когда-нибудь пытались заставить своих кастомных NPC драться в стиле EpicFight, то знаете, насколько это больно. Модели не рендерятся, скрипты не вызывают боевые методы, а анимации просто игнорируются. Именно эту проблему решает epicnpc — небольшой, но крайне полезный патч для Minecraft, который подружает CustomNPC с EpicFight.
Проект распространяется через GitHub-релизы и представляет собой патч плюс изменённую логику рендеринга. Он не добавляет рендер напрямую к NPCEntity — вместо этого вы в настройках модели CustomNPC выбираете другую модель, например зомби, и уже поверх неё всё работает корректно. Да, звучит немного костыльно, но на практике это самый рабочий способ подружить два мода.
Зачем нужен epicnpc для Minecraft
EpicFight — это мод про боевую систему: стойки, комбо, анимации ударов. CustomNPC — про создание собственных персонажей с диалогами и скриптами. По отдельности они великолепны, но вместе не работают из коробки. В EpicFight есть методы, которые используют классы, доступные только на клиенте, и при этом на них нет клиентских аннотаций. Из-за этого скрипты CustomNPC не могут их вызвать напрямую.
epicnpc решает это элегантно: добавляет патч и обёртку-класс, через который боевые методы вызываются косвенно. В результате NPC может проигрывать анимации EpicFight, например блок длинным мечом или активный удар.
- Поддержка кастомных моделей NPC через изменённую логику рендеринга.
- Возможность вызывать анимации EpicFight из скриптов CustomNPC.
- Совместимость с модом «Модная мастерская» (Fashion Workshop) версии 2.0.4.
- Простой API для скриптов через класс EditTool.
Поддерживаемые версии и загрузчики
epicnpc ориентирован на классические сборки Minecraft с загрузчиком Forge — именно на нём исторически работают и CustomNPC, и EpicFight. Версии стоит подбирать в связке: патч должен соответствовать версии EpicFight и CustomNPC, иначе методы просто не найдутся. Перед установкой всегда сверяйтесь с описанием релиза на GitHub.
Кстати, если не хочется вручную возиться с зависимостями, в лаунчере foxygame.net дополнение epicnpc ставится буквально в один клик — каталог сам подтянет нужные версии Forge, CustomNPC и EpicFight, а автообновление потом не даст сборке развалиться после очередного патча.
Как установить epicnpc
Установка не требует глубоких знаний, но аккуратность важна. Порядок такой:
- Установите Forge нужной версии и запустите игру хотя бы раз.
- Поместите CustomNPC и EpicFight в папку mods.
- Скачайте epicnpc из GitHub-релизов и добавьте файл в mods.
- Запустите Minecraft и проверьте, что моды загрузились без конфликтов.
- В настройках модели CustomNPC выберите подходящую модель (например, зомби).
Скачать epicnpc лучше всего с официальной страницы релизов, чтобы не поймать устаревшую или битую сборку. Если вы используете лаунчер с каталогом модов, поищите epicnpc прямо там — так вы точно получите совместимую версию.
Пример скрипта и работа с анимациями
Главная фишка — вызов анимаций EpicFight из скрипта CustomNPC. Через класс EditTool с флагом AVOID_ONLY_CLIENT вы можете проиграть нужную анимацию на NPC. В простейшем примере функция interact берёт MCEntity у NPC и запускает анимацию, например блок длинным мечом.
Синтаксис опирается на ResourceLocation из Minecraft и статический метод playAnimations. Это позволяет строить полноценные боевые сцены: NPC реагирует на взаимодействие игрока, встаёт в стойку, наносит удары. Всё это без правки ядра модов.
Известные ограничения
Честно говоря, патч не идеален. Некоторые модели рендерятся с проблемами — например, железный голем и дракон Края могут выглядеть криво. Это связано с особенностями логики рендеринга и скелетной анимации. Автор прямо предупреждает: рендер к NPCEntity не добавлен, поэтому в настройках модели CustomNPC выбирайте другие варианты вроде зомби.
Ещё один момент: проект помечен как заброшенный. Автор рекомендует перейти на Epic Fight Script Extension, если вам нужна активная поддержка и более широкий функционал. Тем не менее epicnpc остаётся рабочим решением для тех, кто уже собрал сборку и не хочет её ломать.
Итог
epicnpc — это нишевый, но честный патч, который закрывает конкретную дыру между CustomNPC и EpicFight. Он даёт анимации боя, поддержку «Модной мастерской» 2.0.4 и понятный API для скриптов. Да, есть ограничения по моделям и проект больше не развивается, но для многих сборок это по-прежнему самый быстрый путь оживить NPC. Если вам нужен долгосрочный вариант — смотрите в сторону Epic Fight Script Extension, а epicnpc оставьте как проверенное решение здесь и сейчас.