Что такое DucLib

DucLib - библиотечный мод и API для разработчиков модов под Minecraft Java Edition. Он не добавляет в игру новых мобов, оружие или отдельный контент, а предоставляет готовые инструменты для создания сложных моделей и анимаций сущностей.

Если обычных Java-моделей уже недостаточно, DucLib помогает собрать более гибкую геометрию и нормально связать её с анимациями. Библиотека особенно полезна для проектов с нестандартными животными, монстрами и декоративными существами. Например, Recrafted Creatures использует DucLib для моделей и анимаций новых животных.

Что умеет библиотека

DucLib позволяет добавлять в Minecraft собственные геометрические модели с более точной настройкой текстур. В стандартных Java-моделях UV-развёртка часто задаётся менее гибко, а здесь можно настроить UV отдельно для каждой грани модели.

Поддерживаются:

• модели сущностей с UV-развёрткой для отдельных граней;
• box UV, если требуется более привычная развёртка для целых кубов;
• анимации на основе ванильных keyframe-анимаций;
• запуск и остановка анимаций из разных частей игровой логики;
• управление анимациями внутри goals и других поведений мобов.

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

Как DucLib меняет игру

Сам по себе DucLib не добавляет видимых изменений в готовый мир. После установки библиотеки вы не получите новые биомы или предметы. Её задача техническая: дать другим модам основу для качественных моделей и плавных анимаций.

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

В этом плане DucLib похож на базовый API: обычному игроку он нужен для запуска совместимого контентного мода, а автору модификации помогает не писать одну и ту же систему моделей и анимаций с нуля.

Анимации и keyframe-система

Библиотека работает вместе с ванильными keyframe-анимациями Minecraft. Такой подход позволяет описывать движение модели через ключевые кадры, а затем запускать нужную последовательность в подходящий момент.

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

UV-развёртка моделей

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

Это пригодится для существ со сложной геометрией, асимметричными деталями и несколькими материалами. Также библиотека поддерживает UV для отдельных кубов и box UV. Такие возможности упрощают перенос нестандартных моделей в Minecraft и помогают избежать проблем, когда текстура неожиданно растягивается или отображается не на той стороне.

Совместимость и версии

Поддержка зависит от конкретного файла DucLib и загрузчика модов:

• Forge для Minecraft 1.19.2 - 1.19.4;
• Forge для Minecraft 1.20 - 1.20.1;
• NeoForge для Minecraft 1.21.1;
• подтверждённой версии для Fabric нет.

Самый новый опубликованный файл - DucLib 1.2.0 для Minecraft 1.21.1 и NeoForge. Для старых сборок модов нужно подбирать файл библиотеки точно под версию игры и загрузчик. Forge-версия не заменяет NeoForge-файл, даже если номера Minecraft совпадают.

Важный нюанс для игроков

DucLib имеет смысл скачивать только тогда, когда другой мод прямо указывает его в зависимостях. Отдельно библиотека почти ничего не меняет в игровом процессе, зато без неё зависимый проект может не запуститься или завершить загрузку с ошибкой.

Перед установкой проверьте три вещи: версию Minecraft, используемый загрузчик и требуемую версию DucLib. Особенно внимательно стоит отнестись к сборкам на Minecraft 1.20.1 и 1.21.1, где могут использоваться разные загрузчики и разные файлы библиотеки.

На сервере DucLib тоже должна быть установлена, если зависимый мод работает на серверной стороне. В противном случае сервер не сможет загрузить классы моделей или анимаций, даже если клиент игрока настроен правильно.

Для каких модов нужен DucLib

Главный подтверждённый пример использования - Recrafted Creatures. Этот мод добавляет новых животных и применяет DucLib для их моделей и анимаций. Поэтому при установке Recrafted Creatures библиотека становится обязательной частью комплекта.

DucLib также встречается в сборках модов Terra2.0, KokodCraft II, Coexist RPG и Warrior's Odyssey RPG. В таких сборках библиотека обычно устанавливается автоматически как зависимость, но при ручной сборке модпака её наличие лучше проверить отдельно.

Что исправлялось в обновлениях

В предыдущих версиях разработчики исправляли несколько важных технических проблем:

• сброс незакольцованных анимаций;
• работу UV для отдельных кубов;
• критический краш серверов;
• порядок воспроизведения keyframe-анимаций.

Эти исправления важны не только авторам модов. Ошибки в библиотеке могли проявляться уже внутри другого проекта: моб переставал проигрывать нужную анимацию, модель отображалась с неправильной текстурой или сервер аварийно завершал запуск.

Итог

DucLib - лёгкая библиотека для Minecraft, предназначенная прежде всего разработчикам модов и игрокам, которые устанавливают зависимые проекты. Она добавляет гибкие модели, UV-развёртку отдельных граней и удобное управление ванильными keyframe-анимациями.

Для обычной игры DucLib не является самостоятельным контентным модом. Это техническая основа, благодаря которой другие модификации получают более выразительных существ и аккуратную анимацию. Если нужный мод требует DucLib, устанавливайте библиотеку в ту же папку и под тот же загрузчик, что указаны для вашей версии Minecraft. Проект распространяется под лицензией MIT.