- Документация
- https://modrinth.com/datapack/bubblellaneous
Bubblellaneous — это датапак для Minecraft, расширяющий игровой мир мебелью, технологическими объектами, продуктами питания, а также различными дополнительными блоками и предметами. Согласно официальному описанию, проект предназначен для режима выживания, создания пользовательских карт и собственного игрового контента. Он распространяется по лицензии CC-BY-SA-4.0, относится к категориям decoration, food и storage и устанавливается в конкретный игровой мир.
Для выбранных файлов подтверждена совместимость с Minecraft 1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Датапак устанавливается в виде ZIP-архива без распаковки в папку datapacks. Для отображения содержимого также требуется ресурс-пак, а на сервере он должен быть установлен у всех игроков. Если документация не описывает какую-либо возможность, в настоящем руководстве она не предполагается.
Основная задача Bubblellaneous — дополнить Minecraft новым пользовательским содержимым, не изменяя назначение игры.
Официально подтверждены следующие направления:
• мебель;
• технологические объекты;
• продукты питания;
• различные дополнительные блоки;
• дополнительные предметы.
Автор также отмечает, что многие объекты имеют варианты, отличающиеся материалом или цветом. Полный перечень этих вариантов в опубликованной документации отсутствует, поэтому он не приводится.
Проект описывается как полностью переработанная версия ранее опубликованного датапака, ориентированная на выживание, создание карт и пользовательского контента.
Bubblellaneous состоит из двух частей.
Первая часть — сам датапак, который добавляется в выбранный игровой мир.
Вторая часть — ресурс-пак, обеспечивающий корректное отображение пользовательских моделей и оформления.
Документация отдельно подчёркивает, что при игре на сервере ресурс-пак должен использоваться всеми участниками.
Для отображения пользовательских блоков проект применяет сущности. Именно поэтому для создателей карт предусмотрен специальный порядок сохранения и восстановления состояния блоков при работе со структурами.
Внутреннее устройство игровых функций, система хранения данных и реализация отдельных объектов в исходной документации подробно не раскрываются.
Для выбранных файлов подтверждены:
• Minecraft 1.21.11;
• Minecraft 26.1;
• Minecraft 26.1.1;
• Minecraft 26.1.2;
• Minecraft 26.2.
Поддерживаемая платформа:
• datapack.
В опубликованных метаданных указано:
• client — optional;
• server — required.
Официальная таблица совместимости также содержит сведения о предыдущих поколениях проекта.
Указано, что:
• Minecraft 1.20.2 и более ранние версии не поддерживаются из-за ограничений игры;
• Minecraft 1.20.3 и 1.20.4 поддерживаются только версией 2.0.0;
• Minecraft 1.21.0–1.21.9 поддерживается только до версии 2.2.3;
• Minecraft 1.21.11–26.2 требует Bubblellaneous 3.0.0 или новее.
В метаданных выбранных файлов обязательные project dependencies отсутствуют.
Следовательно, нельзя утверждать необходимость установки дополнительных библиотек, модов или иных проектов.
При этом официальный текст прямо требует использование ресурс-пака. Именно он отвечает за отображение добавленных объектов.
Другие обязательные зависимости в предоставленной фактической основе отсутствуют.
Подтверждённый способ установки соответствует стандартной процедуре подключения датапаков.
Рекомендуемый порядок действий:
• Выбрать архив, соответствующий используемой версии Minecraft.
• Открыть папку нужного мира.
• Перейти в каталог datapacks.
• Поместить ZIP-архив без распаковки.
• Подключить соответствующий ресурс-пак.
• Запустить игровой мир.
При использовании сервера ресурс-пак необходимо установить всем игрокам.
Иные способы установки документацией не описаны.
Для получения пользовательского содержимого предусмотрен Bubble Bench.
Согласно официальному описанию, он создаётся путём броска стеклянной бутылки на верстак и позволяет получать пользовательские объекты без необходимости запоминать рецепты.
Для работы предусмотрены следующие функции:
• /function menu:bubblellaneous — настройки и отладка;
• /function give:bubblellaneous/ — выдача предметов;
• /function spawn:bubblellaneous/ — создание объектов;
• /function place:bubblellaneous/ — размещение блоков.
Полный перечень доступных идентификаторов предметов и блоков документация не публикует.
Для создателей карт предусмотрен специальный механизм сохранения пользовательских блоков.
Последовательность действий включает:
• выполнение /function bubblellaneous:blocks/copyproperties/preventcopying;
• сохранение данных блоков командой /execute as @e[tag=bbln.block] run function bubblellaneous:blocks/copyproperties/saveto_block;
• сохранение структуры;
• выполнение /function bubblellaneous:blocks/copyproperties/stopprevent_copying;
• размещение структуры с автоматическим восстановлением данных.
Документация также описывает систему событий на основе function tag.
Подтверждены следующие события:
• загрузка настроек;
• размещение блока;
• разрушение блока;
• срабатывание Bear Trap;
• освобождение Bear Trap;
• включение Electrical Box;
• выключение Electrical Box;
• срабатывание Alarm Block от сигнала редстоуна.
Для события разрушения блока отдельно отмечено использование /return 1, позволяющего предотвратить разрушение.
Bubble Bench Blacklist предназначен для скрытия отдельных объектов из Bubble Bench.
Это позволяет запретить получение выбранных блоков или предметов через данный механизм.
Документация приводит подтверждённые примеры команд.
Добавление записи:
data modify storage minecraft:bubblellaneous benchblacklist append value {entry: "block/acaciatable"}
Удаление записи:
data remove storage minecraft:bubblellaneous benchblacklist[{entry: "item/whitekey"}]
Изменения начинают действовать после выполнения /reload.
Другие способы управления этим списком не описаны.
В предоставленной фактической основе указаны два архива:
• bubblellaneousDPv3-0-6.zip;
• bubblellaneousDPv3-0-3.zip.
Для каждого файла опубликованы контрольные суммы SHA-512 и SHA-1, предназначенные для проверки целостности после получения.
Проект распространяется по лицензии CC-BY-SA-4.0.
Документация также сообщает о наличии переводов на английский (US и UK), русский, чешский, Toki Pona, немецкий, китайский, дореформенный русский, итальянский и японский языки. При этом уровень готовности отдельных локализаций различается.
Исходная информация отдельно указывает, что архивы не запускались.
Файлы этой карточки загружены с официального HTTPS-источника; размеры и опубликованные SHA-1/SHA-512 сверены, целостность и безопасные пути внутри архивов проверены статически. Файлы не запускались, поэтому динамическое поведение не заявляется как протестированное.
Оснований утверждать, что версии 3.0.6 или 3.0.3 проходили динамическое тестирование во время выполнения, нет.
Это датапак, добавляющий мебель, технологические объекты, продукты питания и различные дополнительные блоки и предметы.
Подтверждены Minecraft 1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2.
Нет. В метаданных обязательные project dependencies отсутствуют.
Да. Документация прямо указывает, что он необходим, а при игре на сервере должен быть установлен у всех игроков.
Это предусмотренный проектом способ получения пользовательского содержимого без необходимости запоминать рецепты.
Да. Для этого предусмотрен механизм Bubble Bench Blacklist с подтверждёнными командами добавления и удаления записей.
Они позволяют расширять игровую логику при создании собственных карт и пользовательских проектов.
Нет. В предоставленной фактической основе указаны только сверка контрольных сумм и статическая проверка архивов без утверждений о динамическом тестировании.
Для выбранных файлов подтверждена совместимость с Minecraft 1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Датапак устанавливается в виде ZIP-архива без распаковки в папку datapacks. Для отображения содержимого также требуется ресурс-пак, а на сервере он должен быть установлен у всех игроков. Если документация не описывает какую-либо возможность, в настоящем руководстве она не предполагается.
Назначение
Основная задача Bubblellaneous — дополнить Minecraft новым пользовательским содержимым, не изменяя назначение игры.
Официально подтверждены следующие направления:
• мебель;
• технологические объекты;
• продукты питания;
• различные дополнительные блоки;
• дополнительные предметы.
Автор также отмечает, что многие объекты имеют варианты, отличающиеся материалом или цветом. Полный перечень этих вариантов в опубликованной документации отсутствует, поэтому он не приводится.
Проект описывается как полностью переработанная версия ранее опубликованного датапака, ориентированная на выживание, создание карт и пользовательского контента.
Скриншоты и внешний вид
Принцип работы на высоком уровне
Bubblellaneous состоит из двух частей.
Первая часть — сам датапак, который добавляется в выбранный игровой мир.
Вторая часть — ресурс-пак, обеспечивающий корректное отображение пользовательских моделей и оформления.
Документация отдельно подчёркивает, что при игре на сервере ресурс-пак должен использоваться всеми участниками.
Для отображения пользовательских блоков проект применяет сущности. Именно поэтому для создателей карт предусмотрен специальный порядок сохранения и восстановления состояния блоков при работе со структурами.
Внутреннее устройство игровых функций, система хранения данных и реализация отдельных объектов в исходной документации подробно не раскрываются.
Совместимость
Для выбранных файлов подтверждены:
• Minecraft 1.21.11;
• Minecraft 26.1;
• Minecraft 26.1.1;
• Minecraft 26.1.2;
• Minecraft 26.2.
Поддерживаемая платформа:
• datapack.
В опубликованных метаданных указано:
• client — optional;
• server — required.
Официальная таблица совместимости также содержит сведения о предыдущих поколениях проекта.
Указано, что:
• Minecraft 1.20.2 и более ранние версии не поддерживаются из-за ограничений игры;
• Minecraft 1.20.3 и 1.20.4 поддерживаются только версией 2.0.0;
• Minecraft 1.21.0–1.21.9 поддерживается только до версии 2.2.3;
• Minecraft 1.21.11–26.2 требует Bubblellaneous 3.0.0 или новее.
Зависимости
В метаданных выбранных файлов обязательные project dependencies отсутствуют.
Следовательно, нельзя утверждать необходимость установки дополнительных библиотек, модов или иных проектов.
При этом официальный текст прямо требует использование ресурс-пака. Именно он отвечает за отображение добавленных объектов.
Другие обязательные зависимости в предоставленной фактической основе отсутствуют.
Установка
Подтверждённый способ установки соответствует стандартной процедуре подключения датапаков.
Рекомендуемый порядок действий:
• Выбрать архив, соответствующий используемой версии Minecraft.
• Открыть папку нужного мира.
• Перейти в каталог datapacks.
• Поместить ZIP-архив без распаковки.
• Подключить соответствующий ресурс-пак.
• Запустить игровой мир.
При использовании сервера ресурс-пак необходимо установить всем игрокам.
Иные способы установки документацией не описаны.
Bubble Bench и основные команды
Для получения пользовательского содержимого предусмотрен Bubble Bench.
Согласно официальному описанию, он создаётся путём броска стеклянной бутылки на верстак и позволяет получать пользовательские объекты без необходимости запоминать рецепты.
Для работы предусмотрены следующие функции:
• /function menu:bubblellaneous — настройки и отладка;
• /function give:bubblellaneous/ — выдача предметов;
• /function spawn:bubblellaneous/ — создание объектов;
• /function place:bubblellaneous/ — размещение блоков.
Полный перечень доступных идентификаторов предметов и блоков документация не публикует.
Возможности для разработчиков
Для создателей карт предусмотрен специальный механизм сохранения пользовательских блоков.
Последовательность действий включает:
• выполнение /function bubblellaneous:blocks/copyproperties/preventcopying;
• сохранение данных блоков командой /execute as @e[tag=bbln.block] run function bubblellaneous:blocks/copyproperties/saveto_block;
• сохранение структуры;
• выполнение /function bubblellaneous:blocks/copyproperties/stopprevent_copying;
• размещение структуры с автоматическим восстановлением данных.
Документация также описывает систему событий на основе function tag.
Подтверждены следующие события:
• загрузка настроек;
• размещение блока;
• разрушение блока;
• срабатывание Bear Trap;
• освобождение Bear Trap;
• включение Electrical Box;
• выключение Electrical Box;
• срабатывание Alarm Block от сигнала редстоуна.
Для события разрушения блока отдельно отмечено использование /return 1, позволяющего предотвратить разрушение.
Bubble Bench Blacklist
Bubble Bench Blacklist предназначен для скрытия отдельных объектов из Bubble Bench.
Это позволяет запретить получение выбранных блоков или предметов через данный механизм.
Документация приводит подтверждённые примеры команд.
Добавление записи:
data modify storage minecraft:bubblellaneous benchblacklist append value {entry: "block/acaciatable"}
Удаление записи:
data remove storage minecraft:bubblellaneous benchblacklist[{entry: "item/whitekey"}]
Изменения начинают действовать после выполнения /reload.
Другие способы управления этим списком не описаны.
Версии, локализация и лицензия
В предоставленной фактической основе указаны два архива:
• bubblellaneousDPv3-0-6.zip;
• bubblellaneousDPv3-0-3.zip.
Для каждого файла опубликованы контрольные суммы SHA-512 и SHA-1, предназначенные для проверки целостности после получения.
Проект распространяется по лицензии CC-BY-SA-4.0.
Документация также сообщает о наличии переводов на английский (US и UK), русский, чешский, Toki Pona, немецкий, китайский, дореформенный русский, итальянский и японский языки. При этом уровень готовности отдельных локализаций различается.
Безопасность
Исходная информация отдельно указывает, что архивы не запускались.
Файлы этой карточки загружены с официального HTTPS-источника; размеры и опубликованные SHA-1/SHA-512 сверены, целостность и безопасные пути внутри архивов проверены статически. Файлы не запускались, поэтому динамическое поведение не заявляется как протестированное.
Оснований утверждать, что версии 3.0.6 или 3.0.3 проходили динамическое тестирование во время выполнения, нет.
FAQ
Что представляет собой Bubblellaneous?
Это датапак, добавляющий мебель, технологические объекты, продукты питания и различные дополнительные блоки и предметы.
Какие версии Minecraft подтверждены?
Подтверждены Minecraft 1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2.
Требуются ли обязательные зависимости?
Нет. В метаданных обязательные project dependencies отсутствуют.
Нужен ли ресурс-пак?
Да. Документация прямо указывает, что он необходим, а при игре на сервере должен быть установлен у всех игроков.
Что такое Bubble Bench?
Это предусмотренный проектом способ получения пользовательского содержимого без необходимости запоминать рецепты.
Можно ли ограничить получение отдельных объектов?
Да. Для этого предусмотрен механизм Bubble Bench Blacklist с подтверждёнными командами добавления и удаления записей.
Для чего предназначены события проекта?
Они позволяют расширять игровую логику при создании собственных карт и пользовательских проектов.
Проверялись ли архивы запуском?
Нет. В предоставленной фактической основе указаны только сверка контрольных сумм и статическая проверка архивов без утверждений о динамическом тестировании.