Поддержка экспорта и ограничения

Server API передаёт данные, подготовленные серверным экспортом редактора. Доступность функции в BDEngine не означает, что её полный игровой механизм присутствует в этом JSON. Ниже описан состав текущего экспортёра.

Что входит в экспорт

Возможность	Где находятся данные	Условия
Блоки, предметы и текст в виде дисплеев	passengers	Экспортируемые визуальные части сцены
Трансформации и свойства визуальных частей	SNBT в passengers	Зависят от объекта и целевой версии Minecraft
Анимация дисплеев, включая изменение поддерживаемых свойств	datapack.anim_keyframes	Экспорт из Animator
Звуковые события	datapack.sound_keyframes	Полный экспорт с непустыми звуковыми последовательностями
Начальные хитбоксы	hitbox	Полный экспорт с хитбоксами
Анимация хитбоксов	datapack.anim_keyframes	Есть соответствующие ключи
Длительность и шаг последовательностей	meta.animations, meta.sounds	Метаданные соответствующих наборов
Версия Minecraft и режим	version, type	Добавляются экспортёром

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

Исключения и размер публикации

Настоящие структуры. Серверный экспорт не поддерживает настоящие блоки структуры. Если проект содержит экспортируемую структуру, редактор предлагает использовать датапак.

Отдельные начала координат групп. Экспорт с активным разделением модели на части с отдельными началами координат не поддерживается этим способом. Для него нужен датапак.

Пользовательские .mcfunction. Файлы собственных функций и их регистрация в load/tick не передаются в серверный JSON. При этом текст команды на таймлайне может попасть в кадры. Если такая команда вызывает пользовательскую функцию, наличие команды в JSON не означает, что тело функции тоже было передано.

Вспомогательные объекты редактора. Встроенные объекты bde:oak_boat и bde:player_model не имеют соответствующего block_display и отклоняются экспортёром. Ресурсы Minecraft, на которые ссылаются дисплеи, должны быть доступны в целевой среде.

Размер публикации. Перед отправкой редактор сжимает JSON с помощью gzip и кодирует результат в Base64. Для публикации проверяется предел 1 048 576 байт (1 МиБ) этой упакованной строки. Это не предел длины распакованного ответа GET и не размер файла .bdengine. При превышении уменьшите сцену или объём событий и повторите экспорт.

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

Камера, частицы и дополнительные каналы

Некоторые возможности передают команды или ресурсы без всех служебных функций датапака:

Возможность	Что передаётся	Что важно для чтения данных
Анимация камеры	Команды движения и параметров камеры в кадрах	Создание служебной камеры, подключение игрока и завершение режима не предоставляются готовым механизмом
Команды таймлайна	Строки команд в соответствующих кадрах	Исполнитель, разрешения и используемые внешние ресурсы определяются интеграцией
Время суток	Команды time set, если включена его анимация	Это изменение состояния мира, а не свойство отдельного дисплея
Запуски частиц на таймлайне	Команды particle в кадрах	Начальные статические функции частиц из датапака не включаются
Вероятностный запуск группы частиц	Команды со ссылками на условия и datapack.predicates.particle_chance	Предикаты передаются как данные; API не регистрирует их в Minecraft
Области взаимодействия и сиденья	Механизм создания и обработчики не включаются	Наличие хитбокса не заменяет эти возможности

Ориентируйтесь на фактические поля ответа и контекст команд. У метода плагина fullProject: true переводит редактор в Animator перед экспортом. Значение false сохраняет текущий режим, поэтому уже открытый Animator тоже может дать type: "full". Проверяйте поле type в результате. Это не обещание полного датапака в JSON. Локальный файл JSON использует тот же серверный экспортёр и разделяет ограничения состава.

Выбрать подходящий формат

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

Проект .bdengine предназначен для продолжения работы в редакторе. Minecraft Live Link связывает редактор с миром во время работы и является отдельным способом взаимодействия.

Применить на практике

Получить данные проекта и JSON-экспорт из плагина редактора.