Перейти к содержимому
AbstractMenus AbstractMenus

Магазин предметов

Дополнение к Донат-рангам по уровням. Там магазин продаёт права, здесь - предметы, которые игрок может использовать напрямую. Тот же паттерн money/takeMoney, что и в обычном магазине, только цены выше: подразумевается оплата донатной валютой, а не накопленными монетами.

средний
Фичи: money-ruletakeMoneyitemAdd-with-enchantmentsdonor-currency
Требует: Vault
Открыть: /ame_store 
# Донат-магазин предметов - покупка внутриигровых предметов за донатные токены
# Docs: https://abstractmenus.github.io/docs/ru/examples/donate/item-store
# Open: /ame_store
# Requires: Vault (или PlayerPoints addon для донатных токенов)


include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))


title: "&6Донат-магазин предметов"
size: 3


activators {
  command: "ame_store"
}


items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "18-26" }


  # Заголовок
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lДонат-предметы"
    lore: ["&7Особые предметы, которые можно купить", "&7за донатную валюту."]
  }


  # Мифический меч
  {
    slot: 11
    material: NETHERITE_SWORD
    name: "&dМифический меч"
    lore: [
      "&7Уникальный зачарованный меч."
      ""
      "&7Острота V"
      "&7Прочность III"
      "&7Починка"
      ""
      "&eЦена: &a1000 токенов"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      rules { money: 1000 }
      actions {
        takeMoney: 1000
        itemAdd {
          material: NETHERITE_SWORD
          name: "&dМифический меч"
          enchantments {
            sharpness: 5
            unbreaking: 3
            mending: 1
          }
        }
        sound: ${successSound}
        message: "&dВы получили Мифический меч!"
      }
      denyActions: ${denyNoMoney}
    }
  }


  # Постоянный токен полёта
  {
    slot: 13
    material: ELYTRA
    name: "&bЭлитры"
    lore: [
      "&7Ванильные элитры для полёта в выживании."
      ""
      "&eЦена: &a500 токенов"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      rules { money: 500 }
      actions {
        takeMoney: 500
        itemAdd { material: ELYTRA }
        sound: ${successSound}
        message: "&aЭлитры добавлены в инвентарь."
      }
      denyActions: ${denyNoMoney}
    }
  }


  # Набор голов
  {
    slot: 15
    material: PLAYER_HEAD
    name: "&6Набор декоративных голов (5x)"
    lore: [
      "&7Пять голов игрока с кастомными"
      "&7текстурами для декора."
      ""
      "&eЦена: &a100 токенов"
    ]
    click {
      rules { money: 100 }
      actions {
        takeMoney: 100
        itemAdd: [
          { material: PLAYER_HEAD, count: 5 }
        ]
        sound: ${successSound}
        message: "&aНабор голов выдан."
      }
      denyActions: ${denyNoMoney}
    }
  }


  ${buttonClose} { slot: 22 }
]
↓ menu.conf

Бандл включает _shared/templates.conf и INSTALL.txt.

Что показывает

Заголовок раздела «Что показывает»
  • Предметы с кастомными именами и предзачарованиями через itemAdd { name: ..., enchantments { ... } }
  • Флаг flags: HIDE_ATTRIBUTES для инструментов и мечей (иначе ваниль покажет под именем диапазон урона)
  • Цены в диапазоне донатной валюты

Как выбрать провайдера экономики

Заголовок раздела «Как выбрать провайдера экономики»

По умолчанию takeMoney: 1000 использует провайдера, который указан в config.conf providers.economy. Для системы донатных токенов обычно хочется направить это через отдельный провайдер (например, аддон PlayerPoints), а не через обычную экономику Vault.

Два варианта:

1. Донатная валюта на весь сервер: в config.conf сделайте донатные токены экономикой по умолчанию. Тогда все вызовы takeMoney пойдут через них. Самый простой путь, если весь сервер живёт на токенах.

2. Провайдер на конкретное действие: оставьте Vault по умолчанию, но в каждом действии этого меню укажите донатного провайдера явно:

takeMoney: { amount: 1000, provider: "playerpoints" }

Так обычный магазин продолжит работать с Vault, а донат-магазин будет списывать токены.

Кастомные предметы

Заголовок раздела «Кастомные предметы»

Мифический меч показывает, как собрать неванильный предмет через itemAdd:

itemAdd {
  material: NETHERITE_SWORD
  name: "&dМифический меч"
  enchantments {
    sharpness: 5
    unbreaking: 3
    mending: 1
  }
}

Любое поле, которое работает на отображаемом предмете меню, работает и здесь - lore, модификаторы атрибутов, кастомные NBT, прочность, модель. Полный список см. в документации формата предметов.

Как попробовать

Заголовок раздела «Как попробовать»
  1. Закиньте бандл в plugins/AbstractMenus/menus/example/.
  2. /am reload.
  3. /eco give <you> 2000.
  4. Введите /ame_store в игре.