Bookshelf

Этот плагин меняет механику книжных полок в Minecraft, позволяя игрокам открывать их как сундуки, хранить в них книги и использовать для повышения шанса получения нужного энтчмента.

Основная функция заключается в превращении книжных полок в доступные для инвентаря контейнеры. Игроки могут открыть книжную полку правой кнопкой мыши, получив интерфейс, аналогичный сундуку. Это позволяет хранить внутри полки книги и другие предметы, что ранее было невозможно. При взаимодействии с блоком срабатывает визуальный эффект частиц, который можно включить или выключить в конфигурационном файле. Количество рядов в инвентаре полки настраивается пользователем по умолчанию установлено на два ряда. Также плагин воспроизводит звук установки книги при добавлении или удалении предмета из полки.

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

Особый интерес представляет функция усиления стола зельеварения. Если окружающие полки заполнены книгами с конкретным энтчментом, например, «Острота 5», то шанс получения именно этого энтчмента гарантирован. Чем больше заполнено слотов полками с нужными книгами, тем выше вероятность успеха. Эта функция доступна для версий игры 1.11 и выше и также может быть отключена в настройках. Важно помнить, что для версий от 1.8 до 1.10.2 поддержка повышения шанса зельеварения не предусмотрена.

Плагин поддерживает экспериментальную работу с бункерами и бункерными вагонетками, но эти функции требуют отдельной активации в конфигурации. При обмене предметов между бункерами и полками срабатывает событие InventoryMoveItemEvent, что позволяет разработчикам создавать кастомные механики. Также при открытии или закрытии полки игроком генерируются события PlayerOpenBookshelfEvent и PlayerCloseBookshelfEvent. Если у игрока нет прав доступа к конкретной полке, событие срабатывает с отменой действия (cancelled) с низким приоритетом, учитывая защиту от других плагинов.

Интеграция с системами защиты сервера обеспечивает корректную работу плагинов с контейнерами. Поддерживаются плагины Bolt, LWCX, BlockLocker для защиты контейнеров. Для защиты территорий и территорий игроков работают WorldGuard (версии 7.0.0 и новее), GriefPrevention, RedProtect, Residence, Towny, Lands, ASkyBlock, BentoBox, SuperiorSkyblock2, GriefDefender и PlotSquared (версии 4, 5 и 6). Также поддерживаются плагины для скрытия игроков: EssentialsX, CMI, SuperVanish, PremiumVanish. Для визуализации анимаций взаимодействия с полками требуется плагин InteractionVisualizer (последняя версия разработки).

Для управления плагин предоставляет две основные команды. Команда /bookshelf reload перезагружает конфигурацию и настройки плагина без остановки сервера. Команда /bookshelf update проверяет наличие обновлений и уведомляет администратора, если доступна новая версия. Для доступа к этим командам и другим функциям требуются соответствующие права доступа, которые по умолчанию назначаются только операторам.

Права доступа для плагина включают: bookshelf.use, разрешающее игрокам открывать полки (по умолчанию отключено); bookshelf.reload для перезагрузки (по умолчанию op); bookshelf.copynbt для копирования полки с NBT-данными в творческом режиме (по умолчанию op); bookshelf.update для получения уведомлений об обновлениях (по умолчанию op). Полный список прав и описание конфигурационных параметров доступны в официальном файле конфигурации проекта.

Существуют определенные ограничения функционала. Книжные полки не издают сигнал редстоуна через компаратор, так как метод реализации на данный момент не найден. Также транзакции с полками не отслеживаются системными логгерами блоков, такими как CoreProtect, хотя автор планирует добавить собственную систему логирования. Сбор статистики использования осуществляется через сервис bStats, при этом конфиденциальная информация о сервере не отправляется. Проверка обновлений также происходит через внешний API без передачи приватных данных.