NPC-торговец

clickNPC от Citizens - популярный активатор на RPG-серверах. Игрок подходит к NPC-торговцу, кликает правой - открывается меню магазина. Меню может читать контекст NPC через плейсхолдеры %activator_npc_*% - в этом примере имя NPC подставляется в заголовок, чтобы торговец казался “своим”.

средний

Фичи: clickNPC-activatorCitizens-integration%activator_npc_*%-placeholdersmoney-rule

Требует: CitizensVault

Открыть: (ПКМ по NPC)

menu.conf

# NPC Vendor - магазин, открывающийся по клику на NPC из Citizens
# Docs: https://abstractmenus.github.io/docs/ru/examples/shops/npc-vendor
# Open: правый клик по NPC из Citizens с id 1 (замените на id вашего NPC)
# Requires: Citizens, Vault

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

title: "&6Торговец %activator_npc_name%"
size: 3

activators {
  clickNPC: [1]
}

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

  {
    slot: 4
    material: EMERALD
    name: "&aДобро пожаловать, путник"
    lore: ["&7Купите товары у %activator_npc_name%."]
  }

  {
    slot: 11
    material: BREAD
    count: 8
    name: "&6Хлеб x8"
    lore: ["&eЦена: &a$30"]
    click {
      rules { money: 30 }
      actions {
        takeMoney: 30
        itemAdd { material: BREAD, count: 8 }
        sound: ${successSound}
      }
      denyActions: ${denyNoMoney}
    }
  }
  {
    slot: 13
    material: COOKED_BEEF
    count: 4
    name: "&6Стейк x4"
    lore: ["&eЦена: &a$50"]
    click {
      rules { money: 50 }
      actions {
        takeMoney: 50
        itemAdd { material: COOKED_BEEF, count: 4 }
        sound: ${successSound}
      }
      denyActions: ${denyNoMoney}
    }
  }
  {
    slot: 15
    material: GOLDEN_APPLE
    name: "&6Золотое яблоко"
    lore: ["&eЦена: &a$200"]
    click {
      rules { money: 200 }
      actions {
        takeMoney: 200
        itemAdd { material: GOLDEN_APPLE }
        sound: ${successSound}
      }
      denyActions: ${denyNoMoney}
    }
  }

  ${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.

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

• Активатор clickNPC с ID NPC из Citizens
• Плейсхолдер %activator_npc_name% для персонализированных заголовков
• Как плейсхолдеры из контекста активатора пробрасываются в предметы меню

Настройка

Этот активатор работает только если установлен Citizens и существует хотя бы один NPC с указанным ID. Чтобы узнать ID NPC:

1. Посмотрите на NPC.
2. Выполните /npc sel.
3. Выполните /npc, чтобы увидеть инфу по выбранному NPC, включая ID.

Замените clickNPC: [1] на реальный ID вашего NPC. Если несколько NPC должны открывать один и тот же магазин:

clickNPC: [1, 5, 12]

Плейсхолдеры из контекста NPC

Внутри меню %activator_npc_*% отдают данные кликнутого NPC:

Плейсхолдер	Возвращает
%activator_npc_id%	Числовой ID NPC
%activator_npc_name%	Отображаемое имя NPC
%activator_npc_world%	Мир, в котором находится NPC

В примере %activator_npc_name% используется в заголовке, поэтому заголовок меню превращается в “Торговец BlacksmithBob” или какое там у NPC имя.

Чем это лучше command: для торговцев

Команда /shop - универсальная: все используют один синтаксис, чтобы открыть одно и то же меню. Правый клик по NPC привязывает магазин к конкретной точке в мире и даёт торговцу визуальную личность. Игроки также не могут случайно открыть магазин из любой точки - они физически идут к NPC. Лучше для отыгрыша, меньше спама командами.

Чтобы был гибрид (открытие по клику на NPC ИЛИ командой) - в блок activators кладите оба:

activators {
  command: "ame_vendor"
  clickNPC: [1]
}

Попробовать

1. Установите Citizens.
2. Заспавните NPC: /npc create Bob, потом посмотрите на него, /npc sel, /npc чтобы подтвердить ID.
3. Закиньте бандл в plugins/AbstractMenus/menus/example/. Поправьте clickNPC: [1] на ID вашего NPC.
4. /am reload.
5. Кликните правой по NPC.