Bookshelf Position Module - координаты и повороты сущностей для датапаков

Bookshelf Position Module - один из модулей библиотеки Bookshelf, которую раньше знали под именем Gunivers Libs. Задача у него узкая, но до жути полезная: дать датапакам читать и записывать координаты и углы поворота сущностей через scoreboard. Если вы пишете карты, мини-игры или просто сложные системы на функциях, вы наверняка ловили себя на мысли, что ванильный Майнкрафт ну никак не хочет отдавать позицию моба обычным числом. Вот этот модуль как раз закрывает ту самую дыру.

По сути это конструктор для тех, кто делает кастомные карты и нестандартные механики на датапаках. Никакого загрузчика ставить не надо, все работает на чистой Java Edition.

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

• Добавляет, получает или задаёт координаты для сущностей
• Переводит значения между локальными и мировыми координатами
• Работает с осями по отдельности, а также с горизонтальным и вертикальным углом

Ключевой момент: любая позиция или поворот превращается в обычное scoreboard-значение. А раз это число - его можно сравнивать, складывать, вычитать и подставлять куда угодно. Для картостроителя это открывает целый пласт механик, которые на ваниле раньше требовали диких костылей.

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

Представьте, что вы делаете мини-игру, где игрока надо телепортировать ровно туда, откуда он стартовал, или проверять, дошёл ли моб до нужной точки. Без чтения позиции в переменную приходится городить execute positioned и вручную сверять дистанции. Модуль позволяет взять координату и просто сравнить её как число - быстро и без боли. То же самое с углами: скажем, хотите узнать, куда смотрит игрок, чтобы открыть дверь или запустить сценку. Раньше это было целое приключение, теперь - пара строк.

Особенно выручает преобразование между локальными и мировыми координатами. Локальная система считается относительно сущности, мировая - относительно всего мира. Если строите механизм, привязанный к мобу (какую-нибудь движущуюся платформу или турель), без этого пересчёта просто не обойтись.

Совместимость и версии

Это датапак, а не мод. То есть Fabric, Forge, NeoForge, Quilt и прочие загрузчики тут не нужны вообще - модуль работает на серверной стороне и в одиночке средствами самой игры. Заявлена совместимость с Minecraft 1.21.5 - 1.21.11, а также с современными ветками 26.1, 26.2 и 26.3.

Актуальная ветка Bookshelf для Minecraft 26.3 - 4.2.1, и это хотфикс поверх предыдущих релизов. Отдельных изменений именно в Position Module в релизных заметках не заявлено, но сама библиотека активно развивается.

С чем сочетается

Модуль - часть экосистемы Bookshelf, поэтому логично использовать его вместе с остальными компонентами. Пригодится связка с другими модулями библиотеки: например, Move и Link отвечают за управление движением и синхронизацию сущностей, а вместе с Position Module это даёт полноценный контроль над поведением мобов. Есть и полная подборка - Bookshelf Suite, если хочется взять всю библиотеку разом. Также в версии 4.2.0 подъехали модули анимаций и конечных автоматов - направление, которое стоит держать в голове, если пишете что-то посложнее обычной механической схемы.

Важный нюанс

Модуль можно использовать как отдельно, так и в составе более крупных сборок библиотеки. Но помните: он рассчитан на тех, кто уже умеет работать с функциями, тегами и scoreboard. Если вы никогда не писали датапаки, начинать сразу с этого модуля не стоит - сначала разберитесь с базовым синтаксисом функций, а потом уже беритесь за координаты. И да, держите версию библиотеки в соответствии с версией Minecraft: несовпадение ветки и игры - самая частая причина, почему ничего не срабатывает.

Если вы делаете карты, мини-игры или кастомные механики, скачать Bookshelf Position Module имеет смысл как минимум для того, чтобы перестать изобретать велосипед с execute. Для разработчиков датапаков это по факту must-have из базового набора.