Базовый кит

Самая простая форма меню с наградой: карточка с описанием, кнопка “забрать” и кнопка закрытия. Клик по кнопке - игрок получает набор предметов, немного опыта, звуковой эффект и сообщение-подтверждение.

Что показывает пример

• Несколько действий подряд внутри одного блока click { actions { ... } }
• Список-форма itemAdd: для выдачи нескольких предметов сразу
• Действие giveXp для ванильных очков опыта
• Отложенное closeMenu: 20 (закрыть через 20 тиков = 1 секунда, чтобы игрок успел увидеть сообщение об успехе до закрытия меню)

новичок

Фичи: itemAddgiveXpsoundmessagecloseMenu-delay

Открыть: /ame_kit Скопировать

menu.conf

# Basic Kit - набор предметов в один клик
# Docs: https://abstractmenus.github.io/docs/ru/examples/kits-and-rewards/basic-kit
# Open: /ame_kit
# Requires: -

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

title: "&6Стартовый кит"
size: 3

activators {
  command: "ame_kit"
}

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

  # Описание кита
  {
    slot: 4
    material: PAPER
    name: "&6&lСтартовый кит"
    lore: [
      "&7Получи разовый набор стартовых предметов"
      "&7и 50 опыта, чтобы начать своё приключение."
      ""
      "&eСодержимое:"
      "&7- Железный меч"
      "&7- Железная кирка"
      "&7- Хлеб x16"
      "&7- 50 опыта"
    ]
  }

  # Кнопка получения
  {
    slot: 13
    material: CHEST
    name: "&aЗабрать кит"
    lore: [
      "&7Нажми, чтобы получить кит."
    ]
    click {
      actions {
        itemAdd: [
          { material: IRON_SWORD }
          { material: IRON_PICKAXE }
          { material: BREAD, count: 16 }
        ]
        giveXp: 50
        sound: ${successSound}
        message: "&aТы забрал стартовый кит!"
        closeMenu: 20
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf ↓ Бандл (.zip)

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

Как это работает

Блок click кнопки “забрать” выполняет пять действий по порядку:

1. itemAdd: [ ... ] - список-форма позволяет положить в инвентарь игрока несколько предметов за один раз.
2. giveXp: 50 - даёт 50 опыта через настроенный levels-провайдер (по умолчанию ванильный опыт).
3. sound: ${successSound} - проигрывает звук успеха из общих шаблонов.
4. message: - подтверждение в чат.
5. closeMenu: 20 - закрытие через 20 тиков (1 секунда). Число вместо true добавляет задержку, чтобы игрок успел заметить, что действия выполнились.

Никакой проверки кулдауна тут нет. Любой может жать на кнопку и получать киты бесконечно. Чтобы повесить на это кулдаун, посмотри пример с ежедневным китом - там добавлен setVarp с временной меткой и правило if, сравнивающее её с текущим временем.

Кастомизация

Замени любой предмет в списке itemAdd на нужные тебе материалы. Добавь сколько угодно записей. Поле count: опциональное, по умолчанию 1.

Для зачарованных предметов работает поле enchantments на предмете:

itemAdd: [
  {
    material: DIAMOND_SWORD
    enchantments {
      sharpness: 5
      unbreaking: 3
    }
  }
]

Попробовать

После установки пакета примеров:

1. Положи бандл в plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Введи /ame_kit в игре.