blockbench import library

blockbench import library

Эта библиотека упрощает процесс интеграции моделей Blockbench (обычных и из плагина AnimatedJava для Blockbench) в ваши моды на Fabric.

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

Библиотека обеспечивает всестороннюю поддержку анимаций, включая выражения Molang для ключевых кадров, а также множество функций Blockbench и дополнительно поддержку одного из его плагинов — AnimatedJava.

Возможности:

• Поддержка анимаций: импорт моделей с предварительно отрендеренными анимациями и использование выражений Molang (сейчас только q.anim_time и q.life_time) для динамического управления анимацией.
• CustomModelData и Item Displays: использует CustomModelData и Item Displays для отображения модели с минимальной нагрузкой на сервер через «виртуальные» сущности отображения предметов. — Трансформации Item Display обновляются асинхронно для плавной работы.
• Поддержка крупных костей: обходит ограничения ванильной игры, позволяя использовать кости, превышающие стандартное ограничение в 3x3x3.
• Поддержка функций Blockbench: обеспечивает совместимость с различными функциями Blockbench, включая ключевые кадры эффектов (команды и звуковые эффекты), режимы зацикливания анимаций, интерполяции и многое другое.
• Расширения AnimatedJava: предоставляет дополнительный функционал для AnimatedJava, включая поддержку вариантов, чёрный список костей, условные эффекты и поддержку локаторов.
• Интеграция функций ванильных мобов: поддержка из коробки многих функций ванильных мобов, таких как точные хитбоксы (видны при F3+B), возможность езды, именные таблички, невидимость, свечение, анимации огня, эффекты частиц, поводки, анимации смерти, плавные коллизии, динамические хитбоксы/масштаб и тикинг для конкретных сущностей для оптимизированной производительности.

Загляните в README на Github и документацию для получения дополнительной информации!

Установка

repositories {
    maven { url "https://maven.tomalbrc.de" }
}

dependencies {
    modImplementation include("de.tomalbrc:blockbench-import-library:[TAG]")
}

Использование

Документация доступна здесь

Команды

• `/bil model create id<.ajmodel>|filepath `

  Создаёт модель в игре на основе идентификатора моба или пути к файлу (от корневой папки сервера) к json-файлу модели. Эти модели не сохраняются и в основном предназначены для тестирования. Если вы хотите загрузить файл .ajmodel, убедитесь, что добавили .ajmodel к идентификатору или пути к файлу.

• `/bil model animation|variant|scale `

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

Планы развития

1.x

• Модификатор костей для более динамичных анимаций
• Обработка pre/post значений для ключевых кадров
• Генерация mcmeta для анимированных текстур
• Поддержка Безье для ключевых кадров

2.x

• Динамические анимации для динамической скорости анимации, сейчас все анимации предварительно рендерятся во время импорта
• Анимации для отдельных игроков; показывать анимации только одному игроку или группе игроков. Сейчас все анимации воспроизводятся глобально, видимы для всех игроков
• Несколько наездников (для сущностей), сейчас поддерживается только 1
• Несколько хитбоксов (требует тех же изменений, что и поддержка нескольких наездников)
• Эффекты частиц (?)

Test Sever

Заходи на тестовый сервер с клиентом 1.20.5-1.21+ по адресу

mc.tomalbrc.de:25565

чтобы протестировать этот мод и мои другие моды + будущие, ещё не выпущенные моды и фичи!