Bookshelf Interaction Module

Bookshelf Interaction Module - модуль из библиотеки Bookshelf, который превращает невидимые сущности Interaction в живые кнопки и интерактивные зоны. Вешаешь на сущность обработчики - и она начинает реагировать на левый клик, правый клик и наведение курсора.

Если вы делаете карту с меню прямо в мире, а не в чате, это ровно тот инструмент. Зайдёт мапмейкерам и тем, кто собирает интерфейсы внутри Minecraft, а не снаружи.

Что за библиотека Bookshelf

Bookshelf - датапак-библиотека для Minecraft Java Edition. Набор производительных модулей, с которыми сложные системы собираются проще. Готовых механик в духе "нажми кнопку - открой магазин" тут нет. Это низкоуровневый API: разработчик сам назначает обработчики и сам решает, что произойдёт при срабатывании.

Модуль входит в организацию Bookshelf, но ставится и отдельно от неё. Полный набор лежит в Bookshelf Suite - там же блоки, хитбоксы, математика, raycast и другие вещи, которые постоянно нужны при сборке карт.

Какую проблему он закрывает

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

Модуль забирает эту рутину на себя. Клик и наведение становятся готовыми событиями.

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

• Левый клик - регистрация команд на удар по сущности
• Правый клик - регистрация команд на использование
• Начало наведения - момент, когда игрок навёл курсор
• Конец наведения - момент, когда увёл
• Постоянное наведение - отслеживание, пока курсор остаётся на сущности
• Запуск от имени игрока или от целевой сущности - обработчик выполняется так, как нужно вам

Последний пункт недооценивают. Иногда логику надо прогнать от лица того, кто кликнул, а иногда - от лица самой сущности, чтобы не потерять её контекст. Здесь это переключается.

Где это реально пригодится

Меню прямо на карте, без серверных плагинов. Кнопки "старт", "назад", "купить". Торговые автоматы. Лифты. Диалоги с NPC. Квестовые таблички. Зоны на арене, которые срабатывают от одного наведения. Всё то, что раньше требовало либо плагина на сервере, либо костылей с оседланными мобами и невидимыми стойками для брони.

Ещё вариант - обучающие карты. Наводишь курсор на объект, всплывает подсказка, кликаешь - открывается следующий шаг. Без модов у игрока.

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

Параметр	Значение
Тип	датапак, библиотека
Платформа	Minecraft Java Edition
Версии	1.21.5-1.21.11, а также 26.1-26.3
Модлоадер	не требуется
Лицензия	MPL-2.0
Зависимости	нет, ставится отдельно или в составе Bookshelf Suite

Датапак кладётся в папку datapacks мира или сервера. Fabric, Forge, NeoForge и Quilt тут ни при чём - это не мод, а набор функций. Игрокам качать тоже ничего не надо, всё работает на стороне мира. На сервере ставится так же просто, на BungeeHost подобные библиотеки вообще поднимаются в пару кликов.

Важный нюанс

Библиотека обновляется часто, и версии модулей привязаны к версии ядра. Общая Bookshelf 4.2.1 (19 сентября 2026, под Minecraft 26.3) починила коллизии ID в модуле raycast. До неё 4.2.0 принесла модули анимации и конечных автоматов. Так что если Suite у вас стоит с прошлого сезона - есть что обновить, особенно на сборках, где несколько датапаков делят одни и те же идентификаторы.

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

Важно знать

Нужен ли Fabric или Forge? Нет. Это датапак, модлоадер не требуется вообще.

Можно ли поставить на сервер? Да, и в одиночной игре тоже. Плюс в том, что клиенту ничего докачивать не надо.

Игрокам что-то устанавливать? Нет. Всё держится на функциях мира.

Совместим ли с другими датапаками? Да, при условии, что вы следите за версией ядра и не смешиваете релизы из разных веток.

Есть ли готовые кнопки? Нет. Модуль даёт события, а визуал и логику вы делаете сами. Для быстрых проектов это может показаться лишним шагом, но на длинной дистанции экономит часы.

Насколько это грузит игру? Заявлено как производительное решение - обработка событий идёт точечно, без постоянного перебора всех сущностей мира.

Скачайте Bookshelf Interaction Module, если делаете карту с интерактивом и устали городить проверки на клики вручную. Для сборки полноценного набора инструментов берите сразу Bookshelf Suite.