Easy Model Entities

Easy Model Entities

!Easy Model Entities Logo

Примечание: Это ранний релиз для сбора отзывов. Некоторые настройки, форматы файлов и вывод экспорта могут измениться до финальной версии. Пожалуйста, сообщайте о проблемах и идеях в трекер задач.

Easy Model Entities превращает модели из Blockbench в сущности и блочные сущности Minecraft без необходимости писать отдельный Java-код для каждой модели.

Мод создан, чтобы упростить выпуск, тестирование и поддержку кастомных моделей. Вместо написания рендерера, регистрации отдельных классов сущностей и жёсткого программирования анимаций вы описываете модель данными и профилями ресурспака. EME предоставляет сущности-хосты, блоки-хосты, интеграцию с рендерером, валидацию профилей и небольшой слой автоматической анимации.

Установите его, если хотите кастомные модели из Blockbench, которые могут выглядеть как существа окружения, статичные отображаемые сущности, декоративные блочные сущности, алтари, мимики или рендерящиеся объекты с интеграцией в моды — и всё это с куда меньшим количеством шаблонного кода.

Введение и обзорное видео

▶YouTube · плеер загрузится по нажатию

✨ Зачем это использовать?

• Не нужен Java для каждой модели: Большинство моделей описываются датапаками и ресурспаками.
• Поддержка сущностей и блочных сущностей: Используйте движущиеся сущности для мобов или фиксированные блочные сущности для декораций и механизмов.
• Удобный рабочий процесс с Blockbench: Загружайте встроенные .bbmodel-ресурсы напрямую из ресурспаков.
• Поведение на основе профилей: Настраивайте тип хоста, тип тела, размеры, движение, поведение, рендеринг, текстуру и анимацию через JSON.
• Автоматическая анимация: Базовое поведение покоя, ходьбы, крыльев, хвоста и случайного покоя доступно из коробки.
• Стандартные клипы с ключевыми кадрами: Анимации Blockbench с именами idle, walk, swim, fly или attack воспроизводятся автоматически. hurt и death загружаются, но воспроизводятся только по команде или из мода. Клипы с любыми другими именами игнорируются, чтобы рантайм оставался простым (никаких стейт-машин, никакого Molang).
• API для разработчиков: Моды могут использовать делегаты рендеринга, кастомные аниматоры частей и данные профилей рантайма, не завися от внутренних классов рендерера.
• Диагностика и демо-профили: Команды помогают перечислять, проверять, отлаживать, спавнить и размещать тестовые модели в мире разработки.

🗣 Что можно создать?

• Существа окружения, NPC, тренировочные манекены и простые кастомные сущности.
• Статичные отображаемые модели, которые всё ещё используют рендеринг сущностей Minecraft.
• Декоративные блочные сущности, такие как алтари, статуи, жертвенники или мимики.
• Управляемые модами сущности и блочные сущности, использующие EME для загрузки моделей, рендеринга, работы с текстурами и опциональной анимации частей.

ℹ️ Быстрый старт

После установки мода попробуйте встроенные демо-профили в тестовом мире или мире для разработки:

/easy_model_entities summon easy_model_entities_examples:entity/little_explorer
/easy_model_entities summon easy_model_entities_examples:entity/stone_turtle
/easy_model_entities place_block easy_model_entities_examples:block_entity/shrine

Полезные команды для диагностики:

/easy_model_entities list_profiles
/easy_model_entities validate_profiles
/easy_model_entities debug_profile easy_model_entities_examples:entity/little_explorer
/easy_model_entities set_animation @e[distance=..8] walk

Больше демо-команд и пояснений — на странице вики «Demo Commands».

🧩 Плагин для Blockbench

Профиль JSON можно писать и вручную, но [Easy Model Entities Exporter][plugin] сделает это за вас: он экспортирует текущий проект Blockbench в готовый к установке датапак и ресурспак, определяет подходящий пресет по именам костей и проверяет модель перед записью.

Два способа его получить:

• Список плагинов Blockbench (рекомендуется): File > Plugins > Available, поиск по Easy Model Entities. Это проверенный релиз, поэтому новые версии могут появляться там с задержкой.

• Версия для разработки: используйте File > Plugins > Load Plugin from URL с этим адресом:

  https://raw.githubusercontent.com/MarkusBordihn/BOs-Easy-Model-Entities-Blockbench-Plugin/refs/heads/master/plugins/easy_model_entities/easy_model_entities.js

  Это текущее состояние ветки master — новее, но может содержать ошибки и не проходило проверку.

📦 Работа с паками

Easy Model Entities использует два слоя профилей:

• Серверные профили в датапаке определяют, что это за модель и как она себя ведёт.
• Профили рендера в ресурспаке определяют, какая модель, текстура, масштаб, границы и настройки анимации используются на клиенте.

Типичные файлы:

data/<namespace>/easy_model_entities/profiles/entity/<id>.json
data/<namespace>/easy_model_entities/profiles/block_entity/<id>.json

assets/<namespace>/easy_model_entities/render_profiles/entity/<id>.json
assets/<namespace>/easy_model_entities/render_profiles/block_entity/<id>.json
assets/<namespace>/easy_model_entities/models/<model>.bbmodel
assets/<namespace>/textures/entity/<texture>.png
assets/<namespace>/textures/block/<texture>.png

Полная структура описана на странице вики «Pack Usage».

Интеграция для разработчиков

Моды могут интегрировать EME в свои собственные рендереры, реализовав EasyModelRenderable и используя клиентские делегаты рендера:

• EasyModelEntityRenderDelegate
• EasyModelBlockEntityRenderDelegate
• EasyModelEntityRenderOptions
• EasyModelBlockEntityRenderOptions
• EasyModelPartAnimator

Кастомная анимация частей может либо дополнять автоматическую трансформацию EME, либо полностью заменять её с помощью EasyModelPartAnimationMode.REPLACE.

Примеры — на странице вики «Developer Integration».

Установка и совместимость

Устанавливайте сборку под соответствующий загрузчик и на клиент, и на сервер, если профили, сущности или block-entity используются в мультиплеере.

ℹ️ Документация

Дополнительную информацию смотрите в вики.

🐛 Сообщения о проблемах, багах, крашах и предложениях

Пожалуйста, сообщайте о проблемах и предложениях по ссылке на issues. Я рад помочь.