Bookshelf Link Module

Bookshelf Link Module - это модуль из экосистемы Bookshelf, библиотеки датапаков для Minecraft Java Edition. По сути, он даёт картостроителям и авторам командных систем то, чего ванильный майнкрафт не умеет: привязку одной сущности к другой, чтобы они двигались и поворачивались как единое целое.

Зачем это вообще нужно

В ванильном Minecraft всё делается через команды и tp по расписанию. И как только постройка состоит не из одного моба, а из десятка, начинается боль. Каждый объект надо тащить за собой вручную, вычислять относительные координаты, крутить поворот родителя вручную через execute, синхронизировать всё это тиками. Мод Bookshelf Link Module решает именно эту задачу: вы объявляете связь родитель-потомок, а модуль сам держит позицию и поворот потомка относительно родителя. Дальше вы двигаете только родителя, а "прицепленные" сущности едут за ним.

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

Что умеет модуль

• Создание связей родитель-потомок между сущностями - две сущности связываются в иерархию
• Сохранение относительной позиции - потомок остаётся на заданном смещении от родителя
• Синхронизация поворотов - при повороте родителя потомок крутится вместе с ним
• Пакет готовых функций для связывания, перемещения, вращения и зеркалирования сущностей, а также выполнения команд относительно родителей или потомков

Если вы раньше собирали карусели на командных блоках, детские карусели из бронестоек или "лицо" из пары мобов, привязанных к шалщеру - это ровно та же логика, только нормально оформленная и без костылей.

Совместимость и техническая сторона

Модуль выпускается как датапак, а не как мод. Это значит, что загрузчик Fabric, Forge или NeoForge тут не нужен вообще - он работает на чистой ванили и ставится в папку datapacks. Актуальная версия библиотеки на сегодня - 4.2.1 для Minecraft 26.3, также доступны ветки для 26.2, 26.1 и диапазона 1.21.5-1.21.11. Распространяется проект под лицензией MPL-2.0.

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

Важный нюанс: версия 4.2.1 в линейке Bookshelf помечена как hotfix-релиз. Правка там касается коллизий идентификаторов сущностей в модуле raycast, а не самого Link Module. Так что если вы сидите на более старой версии - обновляться ради самого линка особого смысла нет, но если используете raycast в связке, лучше не отставать.

Кому это зайдёт

Прежде всего картостроителям - тем, кто собирает приключенческие карты, паркур или мини-игры с движущимися объектами. Модуль экономит часы работы над командами и убирает целый класс багов, связанных с рассинхроном поворотов. Также пригодится авторам датапак-систем, например при создании кастомных механик вокруг мобов - от летающих боссов до "умных" NPC, которые должны держать строй.

Скачать Bookshelf Link Module стоит, если вы уже работаете с командными системами и вам нужны точные связи сущностей. Если же вы просто играете в выживании - это не тот инструмент, который что-то изменит в вашем прохождении. Здесь речь про разработку, а не про геймплей.

Как это ставить

1. Скачайте архив датапака под вашу версию Minecraft.
2. Положите его в папку world/datapacks вашего мира, затем перезайдите в мир или выполните /reload.
3. Проверьте работоспособность через /datapack list - датапак должен появиться в списке.

Учтите, что Bookshelf Link Module - это именно модуль библиотеки, а не самостоятельный проект с полноценным меню. Часто его ставят как часть Bookshelf Library или полного Bookshelf Suite вместе с другими модулями, и функции вызываются напрямую из команд и скриптов. Отдельного конфига с настройками здесь ждать не стоит.

Дополнительно

Проект не относится ни к одному жанру вроде хоррора, PvP или аниме - это инфраструктурный инструмент. Никаких мемов, вирусных трендов или фан-сообщества вокруг него нет, и это нормально для библиотечного датапака. Его задача - тихо и надёжно работать под капотом вашей системы. Из подтверждённых связей - именно экосистема Bookshelf, где модули задуманы как кирпичики одного конструктора. Если вы уже пользуетесь другими пакетами от Bookshelf, Link Module логично встанет в тот же набор и не потребует отдельной возни.