Blockbench Import Library - модели Blockbench на сервере Minecraft

Blockbench Import Library (сокращённо BIL) - серверная библиотека для Fabric, которая закрывает одну из главных болей моддинга Майнкрафта: как показать игрокам кастомные 3D-модели и анимированных существ, не заставляя их ставить моды на клиент. Всё работает через обычный серверный ресурспак и ванильные механики, так что игрок заходит с чистым клиентом и сразу видит полноценную модель. Сразу уточню: это не контентный мод. Сам по себе BIL ничего в игру не добавляет, это инструмент для разработчиков модов и создателей серверного контента.

По факту BIL делает для Fabric то, что в мире Bukkit-плагинов давно делает ModelEngine: берёт модель из Blockbench и превращает её в живую сущность внутри Minecraft, с анимациями, хитбоксами и логикой. Если вы собираете сервер с уникальными боссами, квестовыми NPC или анимированным декором - это фундамент, на котором всё строится.

Как это работает

Механика изящная. Библиотека импортирует модель из Blockbench (поддерживаются и обычные generic-модели, и файлы плагина Animated Java), автоматически генерирует item-модель и текстуры, а затем через Polymer собирает серверный ресурспак. Игрок при входе на сервер просто соглашается на загрузку ресурспака - и всё, никаких клиентских модов.

Сама модель рендерится через item display entity с CustomModelData. Это своего рода "виртуальные" сущности: для сервера они почти бесплатные, а трансформации (повороты, сдвиги костей) обновляются асинхронно. Короче, десяток анимированных моделей на экране не уронит TPS, что для серверной стороны критично.

Основные возможности

Разберём по пунктам, что тут реально под капотом:

• Анимации с Molang - модели импортируются вместе с анимациями, а в ключевых кадрах можно использовать выражения Molang. Пока поддерживаются q.anim_time и q.life_time, но и этого хватает для динамического управления анимацией из кода.
• CustomModelData и Item Displays - модель привязывается к предмету с CustomModelData и отображается через display-сущности с минимальной нагрузкой на сервер.
• Крупные кости - снято ванильное ограничение на размер кости 3x3x3 блока. Можно делать огромных существ и массивные конструкции без костылей.
• Фичи Blockbench - effect keyframes (команды и звуковые эффекты в кадрах), режимы зацикливания анимаций, типы интерполяции и другое.
• Расширения AnimatedJava - поддержка вариантов модели, чёрный список костей (bone blacklisting), условные эффекты и локаторы.

Начиная с версии 1.3.0 библиотека понимает формат AjBlueprint с easing для ключевых кадров, а также свойства light_emission и shade - то есть модель может светиться и корректно реагировать на затенение прямо из Animated Java.

Поддержка ванильных механик мобов

Приятный бонус: BIL из коробки умеет в то, что обычно приходится писать руками. Кастомная модель ведёт себя как нормальный моб, а не как летающая картинка.

Механика	Что это даёт
Точные хитбоксы	Видны через F3+B, размер соответствует модели
Езда верхом	На сущности с моделью можно кататься
Неймтеги	Имена над головой работают как у ванильных мобов
Невидимость и свечение	Поддержка эффектов зелий и glowing
Анимация горения	Модель корректно отображает огонь при поджоге
Частицы и поводок	Стандартные партиклы и leash без костылей
Анимация смерти	Проигрывается при гибели сущности
Плавные коллизии	Динамические хитбоксы и масштаб на лету
Персональный тикинг	Каждая сущность тикает оптимизированно, без лишних вычислений

Для серверного PvE-контента это must-have: босс выглядит так, будто его рисовали сами разработчики игры, но технически это всё ещё ванильная сущность.

Зависимости и версии

Библиотека сделана под Fabric и требует две вещи: Fabric API и Polymer - именно Polymer отвечает за генерацию ресурспака и серверную магию. Среда - сервер и одиночная игра. Актуальные сборки выходят под линейки Minecraft 1.21.x, 26.1 и 26.2, свежий стабильный релиз - 2.1.3 под 26.2, а для грядущей 26.3 уже есть релиз-кандидат 2.2.0.

Подключение к своему проекту стандартное, через Gradle: добавляете maven-репозиторий автора (адрес указан в его документации) и зависимость de.tomalbrc:blockbench-import-library:<версия> через modImplementation с include(), чтобы библиотека упаковалась прямо в ваш jar.

Команды для тестов

В BIL есть встроенные команды, чтобы быстро глянуть модель в игре без написания кода:

• /bil model create id<.ajmodel>|filepath <model> - спавнит модель по идентификатору моба или по пути к json-файлу от корня сервера. Для файлов Animated Java обязательно дописывайте .ajmodel к id или пути. Такие модели не сохраняются после рестарта, это чисто для тестов.
• /bil model <цели> animation|variant|scale <аргументы> - меняет модель у выбранных сущностей: можно временно поменять масштаб, переключить вариант, запустить, поставить на паузу или остановить анимацию.

Совет: перед тем как встраивать модель в свой мод, прогоните её через эти команды. Ловить кривой pivot или сломанную анимацию на этапе кода - то ещё удовольствие, а тут всё видно сразу.

Что в планах у автора

Ветка	Планируемые фичи
1.x	Модификаторы костей для более живых анимаций, обработка pre/post значений ключевых кадров, генерация mcmeta для анимированных текстур, поддержка кривых Безье
2.x	Динамическая скорость анимаций (сейчас все анимации пререндерятся при импорте), per-player анимации для отдельных игроков или групп, несколько наездников на одну сущность, составные хитбоксы, партиклы

Из важных ограничений текущих версий: скорость анимации на лету не поменять (всё печётся при импорте), анимации видны всем игрокам сразу, и наездник может быть только один. Если для вашего проекта это критично - ждите ветку 2.x или обходите своим кодом.

Важные нюансы

Важный нюанс: автор больше не публикует обновления на Modrinth - свежие версии выходят на CurseForge. Если вы нашли BIL на Modrinth и он выглядит заброшенным, это не так, просто проект переехал.

Совет: BIL - штука серверная. Если вы крутите Fabric-сервер для друзей, например на BungeeHost (https://bungee.host), библиотеку и ваши модели ставите только на сервер, а игроки просто принимают ресурспак при входе. Это идеальный сценарий для приватного сервера с уникальным контентом: никакой возни с установкой модов у каждого участника.

Скачать blockbench import library стоит в первую очередь разработчикам Fabric-модов и владельцам серверов, которые хотят кастомных мобов, боссов и декор уровня крупных проектов. Обычным игрокам библиотека сама по себе ничего не даст - но если мод в вашей сборке требует BIL как зависимость, ставьте смело, конфликтов с популярными модами вроде Sodium у неё нет.