Клик по NPC

Если NPC-торговец - это один конкретный NPC, открывающий один конкретный магазин, то это меню - обобщённый интерфейс “что это за NPC”, который может вызвать любой из нескольких NPC. Меню читает id, имя и мир кликнутого NPC через контекстные плейсхолдеры и предлагает действия, которые работают для любого из них.

menu.conf
_shared/templates.conf

# Клик по NPC - информационное меню о Citizens NPC, на которого кликнул игрок
# Документация: https://abstractmenus.github.io/docs/ru/examples/world-integrations/npc-click-info
# Открыть: правый клик по любому Citizens NPC с id 1, 2 или 3
# Требует: Citizens

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

title: "&6NPC: %activator_npc_name%"
size: 3

activators {
  clickNPC: [1, 2, 3]
}

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

  # Заголовок берёт данные из контекста NPC
  {
    slot: 4
    material: PLAYER_HEAD
    skullOwner: "%activator_npc_name%"
    name: "&6%activator_npc_name%"
    lore: [
      "&7Citizens NPC #&f%activator_npc_id%"
      "&7Мир: &f%activator_npc_world%"
      ""
      "&7Кликните по любой плитке ниже для действия."
    ]
  }

  # Универсальные действия для любого клика по NPC
  {
    slot: 11
    material: PAPER
    name: "&aПоздороваться"
    lore: ["&7Заставить этого NPC поздороваться."]
    click {
      actions {
        message: "&e[%activator_npc_name%] &fПривет, %player_name%!"
        sound: ${clickSound}
      }
    }
  }
  {
    slot: 13
    material: COMPASS
    name: "&aПоказать местоположение"
    lore: ["&7Вывести координаты этого NPC."]
    click {
      actions {
        message: "&e[%activator_npc_name%] &fЯ нахожусь в %activator_npc_world% у NPC с id %activator_npc_id%."
        sound: ${clickSound}
      }
    }
  }
  {
    slot: 15
    material: EMERALD
    name: "&aПоговорить с торговцем"
    lore: ["&7Открыть магазин этого NPC, если он есть."]
    click {
      actions {
        # В реальной настройке вы бы направляли конкретных NPC в конкретные меню магазинов.
        # Демо просто открывает обобщённый магазин торговца.
        openMenu: "ame_shop"
      }
    }
  }

  ${buttonClose} { slot: 22 }
]

# 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

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

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

Перечисление нескольких ID NPC в clickNPC: [1, 2, 3], чтобы любой из них открывал это меню
Персонализацию меню через %activator_npc_name%, %activator_npc_id%, %activator_npc_world% в заголовке, именах предметов и lore
Использование skullOwner: "%activator_npc_name%", чтобы текстура головы в заголовке соответствовала имени кликнутого NPC
Маршрутизацию разных NPC в разные меню (оставлено как упражнение через действие openMenu)

Паттерн маршрутизации NPC

Плитка “Поговорить с торговцем” в примере открывает ame_shop для любого NPC. На реальном сервере можно маршрутизировать по-разному в зависимости от NPC:

click {
  actions {
    rules {
      and {
        # Гипотетически: только NPC #2 открывает редкий магазин
        if: "%activator_npc_id% == 2"
      }
      actions { openMenu: "ame_rare_shop" }
      denyActions { openMenu: "ame_shop" }
    }
  }
}

Для более чем 2 маршрутов используйте oneof:

oneof: [
  { if: "%activator_npc_id% == 1", actions { openMenu: "ame_blacksmith_shop" } }
  { if: "%activator_npc_id% == 2", actions { openMenu: "ame_alchemy_shop"   } }
  { if: "%activator_npc_id% == 3", actions { openMenu: "ame_armorer_shop"   } }
]

oneof останавливается на первом совпадении, так что каждый ID NPC попадает ровно в одну ветку.

Попробовать

Установите Citizens.
Заспавните трёх NPC, запомните их ID.
Положите бандл в plugins/AbstractMenus/menus/example/. Замените clickNPC: [1, 2, 3] на ваши реальные ID NPC.
/am reload.
Кликните правой кнопкой по любому из NPC. Меню откроется с данными этого NPC в заголовке.