[SimplePetsAddon] ItemEconomy Addon

Этот аддон для плагина SimplePets предоставляет администраторам серверов возможность устанавливать цены на питомцев, которые игроки смогут приобретать за внутриигровые предметы. Вам больше не потребуются дополнительные плагины для создания экономической системы покупки питомцев.

Совместимость и требования

Для работы аддона необходим основной плагин SimplePets. Дополнительно поддерживаются плагины, добавляющие пользовательские модели предметов, такие как Custom Items или ItemsAdder, но они не являются обязательными. Если вы используете кастомные модели, потребуется указать номер CustomModelData и базовый материал предмета.

Способы установки

Установка через команду (самый простой способ)

Просто выполните команду /pet addon install ItemEconomy в консоли сервера или в игре. Система автоматически загрузит и активирует аддон.

Установка через графический интерфейс

1. Выполните команду /pet addon
2. В открывшемся меню выберите пункт "Install Addons" в нижней строке
3. Найдите аддон ItemEconomy в списке
4. Нажмите на него для установки

Если процесс установки зависнет с сообщением "Installing...", проверьте консоль сервера на наличие ошибок. При их отсутствии попробуйте другой способ установки.

Ручная установка

1. Откройте папку плагина SimplePets
2. Перейдите в папку "Addons" (создайте её, если она отсутствует)
3. Скачайте файл аддона и поместите его в папку Addons
4. Перезапустите сервер для загрузки аддона

Настройка конфигурации

# Скрывать цену, если у игрока есть права обхода
Hide-Price-If-Bypassed: true

# Требовать оплату при каждом вызове питомца
Pay-Per-Use-Enabled: false

Price:
  # Текст для бесплатных питомцев
  Free: FREE
  # Текст при наличии прав обхода
  Bypassed: BYPASSED

Cost:
  # Цвет при недостатке предметов
  Short: '&#fa7d7d'
  # Цвет при достаточном количестве
  Over: '&#99ffac'

Boolean:
  'true': '&#92fc98true'
  'false': '&#fa7d7dfalse'

Messages:
  PurchaseSuccessful:
    # Сообщение при успешной покупке
    One-Time-Purchase: '&eSimplePets &6>> &7Вы успешно приобрели питомца {type}.'
    # Сообщение при успешной оплате
    Pay-Per-Use: '&eSimplePets &6>> &7Вы успешно оплатили вызов питомца {type}.'

  # Сообщение при недостатке предметов
  InsufficientFunds: '&eSimplePets &6>> &cУ вас недостаточно предметов для покупки этого питомца, требуется {cost-display}'

  Lore-Lines:
    # Строки описания для разовой покупки
    One-Time-Purchase:
      - '&#ffbf5eЦена: &#99ffac{cost-display}'
      - '&#ffbf5eПриобретено: {purchased}'

    # Строки описания для оплаты за использование
    Pay-Per-Use:
      - '&#ffbf5eЦена: &#99ffac{cost-display}'

# Настройки стоимости для каждого типа питомцев
# - 'enabled': включить/отключить плату
# - 'display': отображаемая цена
# - 'material': материал для оплаты
# - 'count': количество предметов
# - 'custom-model-data': данные кастомной модели (-1 если не используется)

type:
  allay:
    enabled: true
    display: 10 Diamonds
    cost:
      material: DIAMOND
      count: 10
      custom-model-data: -1
  # ... аналогичные настройки для всех остальных питомцев

# Права обхода оплаты
bypass_permissions:
  # Основное право обхода
  parent: pet.itemeconomy.bypass
  type:
    # Права обхода для конкретных питомцев
    allay: pet.itemeconomy.bypass.allay
    # ... аналогичные права для всех остальных питомцев

Особенности настройки

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