Craft-Animation

Craft Animation

Craft Animation — это переиспользуемая библиотека анимаций для разработки модов на Forge. Это не контентный мод, который сам по себе добавляет оружие, мобов или игровые системы. Вместо этого он предоставляет общую основу для анимаций, которую другие моды могут использовать для загрузки, воспроизведения, сэмплирования и применения анимаций единообразным способом. Цель — поддержать игроков, мобов, обычных сущностей, блоки, блочные сущности, предметы и объекты рендера на основе display через одну общую runtime-структуру. Поддерживаемые цели

• Игроки
• Мобы
• Обычные сущности
• Блоки
• Блочные сущности
• Предметы
• Объекты рендера на основе display Включённые системы
• Общие типы целей анимации
• Структуры клипов на основе ключевых кадров
• Поддержка easing
• Контроллеры для воспроизведения, остановки, цикла и скорости воспроизведения
• Runtime-отслеживание активных субъектов анимации
• Загрузка анимаций из JSON
• Примеры ресурсов анимаций Поддерживаемые форматы Craft Animation построен вокруг двух основных путей ввода:
• Встроенный общий формат JSON-клипов
• Загрузка JSON-эмоций в стиле Emotecraft Это значит, что вы можете либо создавать собственный формат клипов напрямую, либо переиспользовать существующие структуры данных анимаций игрока как часть вашего пайплайна. Как подключить и использовать в своём моде Эта библиотека предназначена для подключения к вашему собственному коду рендера, модели или геймплея. Она не внедряет готовые анимации автоматически во все ванильные пути рендера сама по себе. Обычный рабочий процесс выглядит так: 1. Создайте JSON-файл анимации Пример расположения:

assets/yourmod/animations/guardian_idle.json

Вы можете использовать встроенный пример файла как образец:

assets/craftanimation/animations/example_idle.json

2. Загрузите и зарегистрируйте клип Используйте AnimationLibrary через CraftAnimationApi.library().

AnimationClip clip = CraftAnimationApi.library().loadBuiltin(
    "assets/yourmod/animations/guardian_idle.json",
    getClass().getClassLoader()
);

Если клип уже зарегистрирован, вы можете получить его позже так:

AnimationClip clip = CraftAnimationApi.library().require("yourmod:guardian_idle");

3. Создайте ключ субъекта анимации Runtime хранит отдельное состояние анимации для каждого субъекта через AnimationSubjectKey. Пример для игрока:

AnimationSubjectKey key = AnimationSubjectKey.player(
    level.dimension().location().toString(),
    player.getUUID()
);

Пример для моба:

AnimationSubjectKey key = AnimationSubjectKey.mob(
    level.dimension().location().toString(),
    mob.getUUID()
);

Пример для блочной сущности:

AnimationSubjectKey key = AnimationSubjectKey.blockEntity(
    level.dimension().location().toString(),
    pos.getX(), pos.getY(), pos.getZ()
);

4. Запустите воспроизведение

CraftAnimationApi.runtime().play(key, clip);

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

CraftAnimationApi.runtime().controller(key).setSpeed(1.25F);

5. Продвигайте анимацию каждый тик

CraftAnimationApi.runtime().tick(key, deltaTicks);

Или обновляйте все активные контроллеры сразу:

CraftAnimationApi.runtime().tickAll(deltaTicks);

6. Сэмплируйте текущую позу

AnimationPose pose = CraftAnimationApi.runtime().sample(key);

Сэмплированная AnimationPose — это то, что вы применяете внутри своего рендера игрока, модели сущности, рендера блочной сущности, кастомного рендера предмета или логики рендера display. Коротко, обычный порядок использования такой:

• Загрузить клип
• Создать ключ субъекта
• Запустить клип
• Тикать runtime
• Сэмплировать позу
• Применить позу в своём коде рендера/модели Типичные случаи использования
• Позы ожидания игрока при удержании кастомного оружия
• Позы ожидания, ходьбы или атаки мобов
• Воспроизведение анимаций боссов или скриптовых сущностей
• Движение машин или структур блочных сущностей
• Кинематографические таймлайны и визуальные эффекты на основе display Примечания
• Этот мод в первую очередь является библиотекой для разработчиков.
• Установка его самого по себе не добавит крупного игрового контента.
• Финальный визуальный результат анимации всё ещё зависит от того, как потребляющий мод применяет сэмплированные позы к своему рендеру или слою модели.
• Runtime общий, но финальный путь реализации различается для игроков, сущностей, блоков и кастомных систем рендера. Для кого предназначен
• Разработчики модов на Forge
• Проекты, которым нужна переиспользуемая data-driven система анимаций
• Мультиверсионные среды модов, желающие сохранить одну общую архитектуру анимаций