Торговые абонементы

Торговые абонементы — предметы, временно снижающие комиссию аукциона для игрока при активации. Конфигурация абонементов находится в settings/passes.yml.

Выдача абонементов

Команда для выдачи предмета игроку:

/ah admin givepass <игрок> <ключ> [количество]

Пример: /ah admin givepass Steve vip_pass 2

Конфигурация

Абонементы объявляются в секции passes:

passes:
  example_pass:
    material: PAPER
    name: "<green>Абонемент на скидку 10%"
    lore:
      - "<gray>Дает скидку 10% на комиссию аукциона"
      - "<gray>Длительность: 1 час"
      - ""
      - "<yellow>Нажмите ПКМ, чтобы активировать"
    percent: 10.0
    duration: "1h"
    glow: true
    custom-model-data: 0
    hide-flags: true
    click-type: "RIGHT"
    custom-pdc:
      - "myapp:special_id;STRING;pass_10"
      - "myapp:level;INTEGER;1"

  vip_pass:
    material: GOLD_INGOT
    name: "<gold>VIP Абонемент (50%)"
    lore:
      - "<gray>Дает скидку 50% на комиссию аукциона"
      - "<gray>Длительность: 24 часа"
      - ""
      - "<yellow>Нажмите Shift+ПКМ, чтобы активировать"
    percent: 50.0
    duration: "24h"
    glow: true
    hide-flags: true
    click-type: "SHIFT_RIGHT"

Параметры

Параметр	Описание
`material`	Ванильный материал (`PAPER`, `GOLD_INGOT`) или ID предмета из ItemsAdder, Oraxen, Nexo.
`name`	Отображаемое имя (поддерживает MiniMessage и цвета).
`lore`	Описание предмета.
`percent`	Процент скидки на налог аукциона (`10.0` = 10%).
`duration`	Длительность действия скидки (`1h`, `24h`, `7d`).
`click-type`	Тип клика для активации: `RIGHT`, `LEFT`, `SHIFT_RIGHT`, `SHIFT_LEFT`, `ANY_RIGHT`, `ANY_LEFT`.
`glow`	Эффект зачарования (`true`/`false`).
`custom-model-data`	Номер CustomModelData.
`hide-flags`	Скрытие ванильных флагов предмета (`true`/`false`).
`custom-pdc`	Данные для записи в `PersistentDataContainer`. Формат: `namespace:key;ТИП;значение` (типы: `STRING`, `INTEGER`, `LONG`, `DOUBLE`, `FLOAT`, `BYTE`, `SHORT`).

Защита предметов

Предметы-абонементы защищены от изменения:

Блокировка использования в рецептах верстака.
Запрет переименования и сброса NBT на наковальне и точиле.
Запрет модификации в кузнечном столе.

Продление времени

Если игрок активирует абонемент с таким же процентом скидки, время действия суммируется (текущий остаток + длительность нового абонемента). При активации абонемента с другим процентом скидка и таймер перезаписываются.

События

При активации абонемента вызывается событие AuctionPassUseEvent и выполняются действия из секции use_pass файла settings/events.yml:

events:
  use_pass:
    enabled: true
    actions:
      - "[send-message] <gradient:#d4fc79:#96e6a1>Абонемент активирован!</gradient>"
      - "[play-sound] ENTITY_PLAYER_LEVELUP 1.0 1.0"

Начало работы

Настройка

Основные разделы

Разработчикам

Торговые абонементы

Выдача абонементов

Конфигурация

Параметры

Защита предметов

Продление времени

События

​Выдача абонементов

​Конфигурация

​Параметры

​Защита предметов

​Продление времени

​События

Выдача абонементов

Конфигурация

Параметры

Защита предметов

Продление времени

События