GUIShop (ГуиШоп)

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

Возможности

• Магазины с несколькими страницами и отдельное меню продажи.
• Редактор магазина прямо в игре: перенос предметов, изменение цен, названий, описаний, зачарований, зелий, фейерверков, количества и требуемого права.
• Продажа обычных и кастомных предметов, зачарованных книг, зелий, фейерверков, спавнеров с выбранным мобом и голов игроков по UUID либо текстуре Base64.
• Товары-команды: после покупки сервер выполняет заданные команды, в том числе с {PLAYER_NAME}, {PLAYER_UUID}, {PLAYER_WORLD} и {PLAYER_BALANCE}.
• Динамические цены: покупка уменьшает предложение и повышает цену, продажа делает наоборот; цены постепенно возвращаются к базовым. Можно задать пределы изменения, отдельные правила для вещей и связь предметов по крафтам.
• Встроенная экономика либо работа через совместимый с Vault плагин экономики.
• Статистика покупок и продаж для PlaceholderAPI, включая потраченные и полученные деньги, число операций и самые популярные товары.

Команды

Игрокам доступны:

• /shop или /buy — открыть меню магазина.
• /sell — открыть меню продажи.
• /value или /val — узнать цену предмета в руке.
• /bal, /balance или /money — посмотреть баланс встроенной экономики.
• /bal <игрок> — узнать баланс другого игрока.
• /pay <игрок> <сумма> — перевести деньги.
• /togglepay — включить или выключить уведомления о переводах.

Команды встроенной экономики работают, если она включена. Суммы принимают сокращения: 1k, 1.5M, 100B.

Администраторам:

• /gs reload — перезагрузить конфиги.
• /gs edit, /gs edit menu — открыть режим редактирования главного меню.
• /gs edit transaction — редактировать меню операций.
• /gs edit <магазин> — редактировать магазин.
• /gs edit <магазин> <страница> — редактировать страницу магазина.
• /gs iteminfo — показать данные предмета в руке для настройки: материал, описание, зачарования, зелья, фейерверки, PDC и NBT.
• /gs parsemob <тип> — проверить тип моба для спавнера.
• /gs toggleworth — включить или выключить показ стоимости для себя до конца сессии.
• /gs eco give|take|set <игрок> <сумма> — выдать, снять или установить баланс.
• /gs eco balance <игрок> — посмотреть баланс игрока.
• /gs eco reset <игрок> — сбросить баланс к начальному.
• /gs market status — состояние динамического рынка.
• /gs market info <предмет> — данные цены предмета.
• /gs market reset <предмет> или /gs market resetall — вернуть цену к базовой.

В режиме редактирования левый клик переносит предметы, правый клик или Shift+клик открывает редактор. Для кнопок навигации Shift+клик выполняет действие кнопки.

Права

• guishop.use — доступ к магазину.
• guishop.shop.* — доступ ко всем товарам.
• guishop.shop.<магазин>.<предмет> — доступ к конкретному товару.
• guishop.reload — перезагрузка плагина.
• guishop.creator — редактор магазина.
• guishop.value — команда /value.
• guishop.sell — команда /sell.
• guishop.admin — полный доступ администратора.

Настройка

Основные файлы находятся в plugins/GUIShop/:

• config.yml — общие параметры, команды, заголовки и кнопки.
• shops.yml — страницы магазинов и товары.
• menu.yml — главное меню.
• messages.yml — сообщения плагина.
• worth.yml — показ стоимости предметов.
• economy.yml — встроенная экономика.
• dynamicpricing.yml — правила динамических цен.

Для товара указываются, например, type, id, buy-price, sell-price, shop-name, buy-name, shop-lore, enchantments, quantity и permission. Тип COMMAND продаёт выполнение команд, а sudo: true запускает их от имени покупателя; без него команды выполняются от консоли.

Показ стоимости добавляет цену продажи в описание предмета только на стороне клиента и не изменяет сам предмет. В worth.yml можно выбрать формат, расположение строки, исключённые инвентари и названия вещей, а также скрыть цену на надетой броне.

Требования

Для экономики через внешние плагины нужен Vault и совместимый плагин экономики, например EssentialsX или CMI. Вместо него можно включить внутреннюю экономику.

• PacketEvents нужен для показа стоимости в описании предметов.
• PlaceholderAPI нужен для плейсхолдеров в названиях и описаниях, а также для статистики в скорбордах, голограммах и чате.
• Поддерживаются серверные ядра Bukkit, Spigot, Paper и Folia.