ShopShelves

ShopShelves - мод для Fabric, который превращает новый блок полки (Shelf Block) из Minecraft 1.21.9 в полноценные магазины. Если вы когда-нибудь хотели быстро настроить торговлю на сервере без громоздких плагинов вроде ChestShop - это решение для вас. Мод делится на два типа: администраторские магазины (Admin Shops) и игровые (PlayerShelves).

Зачем это нужно?

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

Основные возможности

Типы магазинов

• Администраторские магазины - ставятся с помощью полки, работают на покупку, продажу или сразу оба направления. Их нельзя сломать с лицевой стороны, и они не зависят от мирового белого списка.
• Игровые магазины (PlayerShelves) - игрок создаёт полку, приседая и устанавливая её рядом с сундуком, бочкой или медным сундуком. Автоматически связывается с контейнером (поддерживаются двойные сундуки). Можно задать цену на каждый слот через интерфейс.

Настройка цен

• Глобальные цены - задаются через pricing.yml для любых предметов, включая зелья, зачарованные книги, козьи рога и головы игроков.
• Ценовые штампы - команда /shops price позволяет навесить на предмет одноразовую цену, которую потом можно использовать в магазине.
• Гибкие коэффициенты - цены можно указывать на количество (например, 10 долларов за 64 блока земли), мод сам считает цену за единицу.

Отображение и оформление

• Плавающий текст - над полкой отображается информация о магазине (название, цена, количество). Текст динамически обновляется при изменении запасов.
• Пользовательские метки - можно установить свою надпись с поддержкой цветовых кодов (&c, &#RRGGBB) и переносом строки.
• Два режима отображения цен - TRIPLEPRICE (цена на каждый слот) и SINGLEPRICE (общая цена) - для игровых магазинов принудительно используется второй.

Защита и управление

• Лимиты на игровые магазины - настраиваются через права (shopshelves.playershelves.5 - до 5 полок).
• Режим администратора - /shops admin даёт возможность обходить все ограничения и быстро настраивать магазины.
• Защита от взрывов - полки и связанные контейнеры не уничтожаются криперами, TNT и визерами.
• Автоматическая миграция конфигов - при обновлении мода старые файлы не ломаются, новые настройки добавляются сами.

Команды

• /shops или /shopshelves - главная справка.
• /shops admin - включить/выключить режим админа.
• /shops reload - перезагрузить конфиги без перезапуска сервера.
• /shops update - перерисовать все плавающие тексты.
• /shops mode [mode] - изменить способ отображения сообщений (чат, actionbar или оба) и режим цен.

Глобальные цены (требуется shopshelves.itemprice)

• /shops itemprice - посмотреть текущие цены на предмет в руке.
• /shops itemprice <цена> <buy/sell/both> <количество> - установить глобальную цену.

Ценовой штамп (требуется shopshelves.price)

• /shops price <цена> <buy/sell/both> <количество> - создать штамп на предмете в руке.

Права доступа

Право	Описание	По умолчанию
shopshelves.command	Доступ к /shops	Все игроки
shopshelves.admin	Режим админа	OP 2
shopshelves.reload	Перезагрузка	OP 2
shopshelves.update	Обновление дисплеев	OP 4
shopshelves.mode	Смена режима отображения	OP 4
shopshelves.itemprice	Управление глобальными ценами	OP 2
shopshelves.price	Создание ценовых штампов	OP 2
shopshelves.playershelf	Создание игровых магазинов	OP 0
shopshelves.playershelves.unlimited	Безлимитные магазины	OP 4
shopshelves.playershelves.<число>	Лимит магазинов (например, .10 = 10)	OP 2
shopshelves.setlabel	Установка метки	OP 2
shopshelves.setlabel.color	Цветовые коды в метках	OP 4

Требования

• Minecraft 1.21.9
• Fabric
• EcoBal (обязательный мод для экономики) - скачать

Политика модпаков

• Разрешено включать ShopShelves в любые сборки.
• Указывать автора не обязательно, но приятно.
• Не модифицируйте JAR-файл напрямую.
• Продажа модпака, содержащего этот мод, запрещена.

API для разработчиков

Если вы пишете свои моды и хотите взаимодействовать с магазинами, используйте класс ShopshelvesApi. Пример проверки, является ли блок магазином:

ShopshelvesApi api = ShopshelvesApi.getInstance();
if (api.isShopShelf(blockEntity)) {
    // это магазин
}

Методы getShopMode и getShopOwner позволяют получить режим и владельца. Подробнее - в документации к API.

Итог

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