Активатор: clickItem

clickItem открывает меню, когда игрок правым кликом активирует предмет, подходящий под спецификацию, держа его в руке. Подходит для интерфейсов “магического жезла”, именных инструментов с открытием меню, навигации через компас и т.п.

средний

Фичи: clickItem-activatorno-command

Открыть: (ПКМ по предмету)

menu.conf

# Сниппет: активатор clickItem - открыть меню правым кликом по предмету в руке
# Документация: https://abstractmenus.github.io/docs/ru/examples/snippets/activator-clickitem
# Открыть: возьмите NETHER_STAR с именем "Жезл меню" и кликните по нему правой кнопкой.
# (Для теста получите его командой: /give @s minecraft:nether_star{display:{Name:'{"text":"Жезл меню"}'}})
# Требования: -

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

title: "&6Меню открыто кликом по предмету"
size: 1

activators {
  clickItem {
    material: NETHER_STAR
    name: "&6Жезл меню"
  }
}

items: [
  {
    slot: 4
    material: BOOK
    name: "&aСработало"
    lore: [
      "&7Вы открыли это меню правым кликом"
      "&7по NETHER_STAR с именем &6Жезл меню&7 в руке."
      ""
      "&7Смотрите документацию активаторов: clickEntity, clickBlockType,"
      "&7clickNPC, regionJoin и другие."
    ]
  }
  ${buttonClose} { slot: 8 }
]

_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.

Как использовать

activators {
  clickItem {
    material: NETHER_STAR
    name: "&6Menu Wand"
  }
}

Активатор сработает, только если совпадают все указанные свойства. Пример выше требует и материал, И точное имя предмета. Если игрок кликнет правой кнопкой по NETHER_STAR с другим именем - ничего не произойдёт.

Для совпадения только по материалу уберите поле name:. Для нескольких триггеров используйте список:

activators {
  clickItem: [
    { material: COMPASS }
    { material: NETHER_STAR, name: "&6Menu Wand" }
  ]
}

Плагин выставляет внутри меню плейсхолдеры %activator_item_*%, открывающие данные кликнутого предмета. Полную таблицу экстракторов смотрите в Контексте активатора.

Другие активаторы “от мира”

Та же форма, разные источники:

• clickBlock - клик по конкретному блоку с известными координатами
• clickBlockType - клик по любому блоку заданного материала
• clickEntity / shiftClickEntity - клик по сущности (мобу, стенду брони, рамке)
• clickNPC - клик по NPC из Citizens по id
• regionJoin / regionLeave - триггеры регионов WorldGuard
• button / lever / plate - стандартные редстоун-устройства

Их можно комбинировать в одном блоке activators {} - меню можно открыть и командой, и кликом по предмету, и входом в регион, всё одновременно.