ShopGUI

ShopGUI — плагин для Minecraft 1.21.10 (Paper), который добавляет GUI магазин с покупкой предметов и выполнением команд за валюту из CoinsEngine.

---

Возможности

• Настраиваемый GUI магазин с предметами
• Интеграция с CoinsEngine для работы с валютами
• Поддержка зачарованных предметов и кастомных голов
• Гибкая настройка валюты через конфиг
• Выполнение команд от имени консоли
• Современный код для Paper 1.21.10 с поддержкой MiniMessages формата
• Возможность продавать предметы или выполнять команды

---

Конфигурация (config.yml)

# Настройки магазина

# Используемая валюта из CoinsEngine
currency: "coins"

# Название GUI магазина (поддерживает цвета и форматирование)
gui-title: "<gold>Магазин за коины"

messages:
  player-only: "<red>Эта команда только для игроков!"
  no-permission: "<red>У вас нет прав для использования данной команды!"
  reload-success: "<green>Конфигурация магазина перезагружена!"
  item-not-found: "<red>Предмет не найден!"
  item-create-fail: "<red>Ошибка создания предмета!"
  currency-not-found: "<red>Ошибка: валюта не найдена! Обратитесь к администратору."
  not-enough-money: "<red>Недостаточно средств! Нужно: <yellow>{price}."
  purchase-success: "<green>Вы успешно купили <yellow>{item}</yellow> за <gold>{price}</gold>!"

# Если не задана command, то игроку при покупке выдаётся предмет, иначе - выполняется команда
shop-items:
  empty_spawner:
    name: "<gold>Пустой спавнер"
    material: SPAWNER
    slot: 10
    price: 2000
    lore:
      - "<gray>Пустой спавнер для мобов"
      - "<gray>Цена: <gold>{price}"
      - ""
      - "<yellow>Можно настроить с помощью яиц призыва"

  zombie_egg:
    name: "<dark_green>Яйцо призыва зомби"
    material: ZOMBIE_SPAWN_EGG
    slot: 19
    price: 500
    lore:
      - "<gray>Используйте на спавнере для настройки"
      - "<gray>Цена: <gold>{price}"

  skeleton_egg:
    name: "<white>Яйцо призыва скелета"
    material: SKELETON_SPAWN_EGG
    slot: 20
    price: 600
    lore:
      - "<gray>Используйте на спавнере для настройки"
      - "<gray>Цена: <gold>{price}"

  elytra_unbreaking3_mending1:
    name: "<dark_purple>Элитры"
    material: ELYTRA
    slot: 43
    price: 1000
    lore:
      - ""
      - "<gray>Цена: <gold>{price}"
      - ""
      - "<yellow>ЛКМ: <white>чтобы купить"
    enchantments:
      unbreaking: 3
      mending: 1

  cosmetic_key:
    name: "<light_purple>Ключ от кейса с косметикой"
    material: PLAYER_HEAD
    texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTdhOTc3MmY3ODMxMmIxNDE1NmE0ZThiNjZhNTQ4YjE3MjViYTY5MWI4YjdhMDY2OGFmNjE2MWMyYjgzOGU5YiJ9fX0="
    slot: 37
    price: 150
    lore:
      - "<gray>Получите ключ для открытия кейса"
      - "<gray>с косметикой /uc"
      - ""
      - "<gray>Цена: <gold>{price}"
      - ""
      - "<yellow>ЛКМ: <white>чтобы купить"
    command: "uc give key 1 %player%"

Поддерживаемые параметры для предметов:

• name — название предмета (поддерживает цвета и форматирование)
• material — тип материала (например, SPAWNER, ELYTRA, PLAYER_HEAD)
• slot — слот в GUI (0-53)
• price — цена в указанной валюте
• lore — описание предмета ({price} автоматически заменяется на цену)
• command — команда для выполнения при покупке (вместо выдачи предмета)
• texture — текстура для головы (Base64)
• enchantments — зачарования для предмета

Переменные в командах:

• %player% — автоматически заменяется на имя игрока

---

Использование магазина

1. Открытие магазина: /dshop
2. Покупка предмета: ЛКМ по предмету в GUI
3. Автоматическое списание: Валюта автоматически списывается с баланса игрока
4. Выполнение команды: После покупки игроку выдаётся купленный предмет или выполняется указанная команда от имени консоли

Процесс покупки:

• Проверка достаточности средств
• Автоматическое списание валюты
• Выполнение команды или создание предмета
• Информативное сообщение о покупке

---

Команды и права

• /dshop — открыть магазин (permission: dshop.use)
• /dshop reload — перезагрузить конфиг (permission: dshop.reload)

Разрешения:

• dshop.use — доступ к магазину
• dshop.reload — перезагрузка конфига

---

Настройка валюты

Плагин использует валюту из CoinsEngine, указанную в конфиге:

currency: "coins"

Поддерживаемые форматы валют:

• coins — основная валюта
• gems — драгоценные камни
• tokens — жетоны
• Любая другая валюта, созданная в CoinsEngine

Для создания новой валюты используйте команды CoinsEngine:

/coinsengine currency create mycurrency ⛁
/coinsengine currency setname mycurrency "Моя валюта"

---

Требования

• Minecraft Paper 1.21.10
• Java 21
• Обязательно: CoinsEngine (для экономики)

---

Установка

1. Убедитесь, что установлен CoinsEngine
2. Скачайте последнюю версию ShopGUI
3. Поместите файл в папку /plugins
4. Перезапустите сервер
5. Настройте config.yml под свои нужды
6. Используйте /dshop reload для применения изменений

---

📄 Лицензия

Плагин распространяется под лицензией MIT.