Area Lib
Area Lib - библиотека для Fabric, которая позволяет другим модам создавать произвольные области в мире Майнкрафт. Сама по себе контента не добавляет, но служит основой для зональных механик, миниигр и карт.
Area Lib - это библиотечный (library) мод для Fabric, который даёт другим проектам инструмент для работы с произвольными областями мира. Проще говоря, это не самостоятельный мод, а каркас: он не добавляет блоков, мобов или предметов, зато без него не заведутся моды, которым нужны зоны. Из подтверждённых примеров - Area Tools, Meret, Super Mod и Grappling Hooke (последний подключает Area Lib как необязательную зависимость).
Если вы делаете карту, миниигру, PvP-арену или просто хотите менять правила по регионам, эта библиотека снимает с вас половину головной боли. Вместо того чтобы городить селекторы, скорборды и редстоун, вы просто создаёте зону одной командой и дальше работаете с ней как с объектом.
Что умеет Area Lib
Библиотека регистрирует области в мире и сохраняет их вместе с данными уровня, так что перезапуск сервера их не сбросит. В основе лежит система зон: обычные коробочные (box) и составные (union). Всё управление идёт через команды, отдельного GUI нет.
Плюсы в двух словах:
- единый API для всех зональных модов;
- данные хранятся на уровне мира, а не в памяти сессии;
- MIT-лицензия - можно использовать в своих проектах свободно.
Создание областей
Базовая команда для создания зоны:
/area create
Например, /area create <id> box ~ ~ ~ ~5 ~5 ~5 создаст коробочную область размером 5x5x5 от вашей текущей позиции. Идентификатор (id) вы задаёте сами - потом по нему будете обращаться к зоне в других командах и модах.
Совет: называйте id осмысленно (например, spawn_zone или arena_1), а не test и abc. Когда областей станет несколько десятков, вы себя за это поблагодарите.
Изменение свойств области
Встроенные свойства
У зон есть базовые параметры - цвет и приоритет. Их правят командой:
/area modify <id> <property> <value>
Приоритет особенно важен, если зоны пересекаются: побеждает та, у которой он выше. Это типичная проблема на больших картах, где арена частично накладывается на город.
Компоненты
Компоненты - это расширяемые модули, которые добавляют к зоне конкретную функциональность. С ними работают так:
/area modify <id> components (set|remove|get|copy_from) ...
То есть компонент можно установить, убрать, посмотреть или скопировать с другой зоны. Именно через компоненты сторонние моды навешивают на область своё поведение - запрет PvP, особые точки возрождения, музыкальные треки и прочее.
Объединённые (union) области
Иногда зона - это не один кусок, а несколько. Для этого есть union:
/area create <id> union <...areas>
Добавить подобласть позже можно так:
/area modify_composite <id> add <sub_area>
А убрать - так:
/area modify_composite <id> remove <sub_area>
Удобная штука для сложных построек вроде L-образных арен или разбросанных по карте чекпоинтов.
Удаление и проверка зон
Полностью удалить область:
/area delete <id>
Узнать, в какой зоне вы сейчас находитесь:
/area query
Команда /area query - первое, что стоит проверить, если зональная механика не срабатывает. Часто оказывается, что игрок стоит на границе или вообще вне нужной области, а дело не в моде.
Важный нюанс: библиотека ничего не делает сама
Области в Area Lib по умолчанию пассивны. Они не запрещают PvP, не телепортируют, не выдают предметы - вообще ничего. Чтобы зона обрела смысл, нужен мод, который её использует. Например, area-tools добавляет набор инструментов на базе этой библиотеки: ограничения предметов по зонам, отдельные точки возрождения, отключение PvP, события входа/выхода и селектор @a[area=<id>] для выбора игроков внутри области.
Поэтому не удивляйтесь, если после установки Area Lib в игре ничего не изменится. Так и задумано - это инфраструктура, а не геймплей.
Кому это реально нужно
Проект известен прежде всего как база для карт, миниигр и зональных правил. Meret использует его для музыкальных зон на картах, Super Mod - чтобы включать механики Superhot внутри выбранных областей. Если вы автор карты, делаете хаб с разными режимами или пишете свой мод с зонами, это ваш инструмент. Обычному выживальщику он без сторонних модов не пригодится.
Версии и требования
- Загрузчик: только Fabric
- Режимы: server-side и client-and-server
- Поддержка Minecraft Java: 1.20.1, 1.21.1, 1.21.7-1.21.8, 1.21.10-1.21.11, а также ветки 26.1.x и 26.3
- Лицензия: MIT
- Последняя подробно описанная версия -
0.8.0+26.1(Alpha)
В версии 0.8.0 добавили кодеки сериализации компонентов, перенос сохранённых данных на уровень мира, команду /area modify components, экранный оверлей при переключении отображения и разделение отслеживаемых компонентов на entity-tracked и sampled. Для авторов модов это заметное обновление API.
Важно знать
Совместимо ли с Forge или NeoForge? Нет, только Fabric. Если играете на Forge-сборке, придётся искать альтернативы или запускать через мост вроде Sinytra Connector, но это уже с оговорками.
Нужно ли ставить мод на клиент? Зависит от режима. Server-side вариант работает только на сервере, но некоторые компоненты (вроде оверлея отображения зон) требуют установки и на клиенте.
Что если удалить библиотеку? Моды, которые её требуют, просто перестанут запускаться. Данные зон хранятся на уровне мира, так что при повторной установке они, скорее всего, останутся на месте.
Проект свежий и небольшой. На момент написания у него около 13,8 тыс. загрузок и всего несколько подписчиков, так что баги и ломающие изменения между версиями - вполне реальная история. Перед крупным обновлением делайте бэкап мира.
Короче, Area Lib - крепкий фундамент для зональных механик в Майнкрафт. Скачать его стоит тем, кто использует моды на его основе или пишет собственные. Обычным игрокам он не нужен напрямую - но именно на таких библиотеках держится половина интересных карт и серверных фич.
Как поиграть с друзьями с модом Area Lib?
Мод Area Lib куда интереснее в компании: поднимите сервер Майнкрафт с уже установленным модом, позовите друзей и играйте по своим правилам. Хостинг Майнкрафт для мода Area Lib будет готов за пару минут - BungeeHost сделает всё за вас.