Bookshelf View Module

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

Звучит узко? По факту это база для кучи механик: системы камер, прицелы, магические посохи, лазеры, механики шпионажа, детекторы пересечения прицела с зоной. Всё это строится на raycast (трассировке луча) - способе узнать, что именно попадает в линию взгляда.

Что умеет Bookshelf View Module

• Выполняет команды по прицелу - команды запускаются в точке, на которую смотрит сущность
• Три цели трассировки - блоки, сущности и произвольные точки
• Точный контроль позиции блока - можно задать, как именно разместить блок или как его коснуться
• Проверка линии видимости - функция can_see_at определяет, видит ли сущность заданное место
• Гибкая форма столкновения - с версии 3.0.0 добавлен аргумент hitbox_shape для выбора между хитбоксом и интерактивной зоной сущности

Для кого это

Bookshelf View Module - инструмент для авторов датапаков, а не для обычных игроков. Если вы просто закинули сборку модов и хотите добавить что-то интересное в мир, скорее всего вам ближе готовые датапаки и моды. А вот если вы пишете свои функции на mcfunctions и хотите добавить в них логику "посмотрел туда - что-то произошло", без модуля придётся вручную считать лучи, что больно и громоздко.

Модуль входит в состав библиотеки Bookshelf, вместе с остальными её модулями. Полный набор - Bookshelf Suite. То есть это не самостоятельная штука, а часть одного механизма - как отдельная деталь Lego, которая работает только со своей системой.

Совместимость и технические нюансы

Датапак не привязан к Fabric, Forge, NeoForge или Quilt - это чистый Java Edition, потому что датапакам загрузчики ни к чему. На Modrinth проект помечен для Java Edition и поддерживает версии 1.21.5-1.21.11, а также снапшоты 26.1 и 26.2. Короче, если у вас актуальный Minecraft, скорее всего всё подойдёт.

Лицензия - MPL-2.0. Это значит, что код открыт, и его можно использовать в своих проектах на условиях этой лицензии. По загрузкам модуль собрал около 1,3 тысяч скачиваний. Немного? Ну, аудитория у него специфическая - это библиотека для разработчиков, здесь массовость не главное.

Важный нюанс: в свежей версии 3.0.0 починили расчёт максимальной дистанции can_see_at - раньше она могла работать некорректно, и сущность "видела" сквозь слишком большие расстояния. Если вы уже строили что-то на старой версии, обновление стоит поставить, чтобы не ловить странные баги с видимостью.

Практический совет

Не пытайтесь тащить View Module в мир без других модулей Bookshelf и без понимания, как работают локальные функции и хранилища scoreboard. Здесь вам пригодится опыт в командных блоках и функциях на уровне чуть выше базового. Зато результат - аккуратные и предсказуемые механики, которые не грузят сервер лишними проверками каждый тик.

Если собираете сервер или пишете свой датапак, Bookshelf View Module - правильный выбор: он не делает никакой "магии", а даёт чистый инструмент для работы со взглядом. Остальное - за вашей фантазией. Скачать Bookshelf View Module можно для последних версий Minecraft, но помни: без базовой библиотеки он не поедет.