Skip to content
AbstractMenus AbstractMenus

NPC Click Info

Where NPC Vendor is one specific NPC opening one specific shop, this menu is a generic “what’s this NPC about” UI that any of several NPCs can trigger. The menu reads the clicked NPC’s id/name/world via context placeholders and offers actions that work for any of them.

intermediate
Features: clickNPC-multiple-ids%activator_npc_*%-placeholdersskullOwner-from-placeholderopenMenu-routing
Requires: Citizens
Open: (right-click NPC) 
# NPC Click Info - info menu about a Citizens NPC the player clicked
# Docs: https://abstractmenus.github.io/docs/en/examples/world-integrations/npc-click-info
# Open: right-click any Citizens NPC with id 1, 2, or 3
# Requires: 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" }


  # Header pulls from NPC context
  {
    slot: 4
    material: PLAYER_HEAD
    skullOwner: "%activator_npc_name%"
    name: "&6%activator_npc_name%"
    lore: [
      "&7Citizens NPC #&f%activator_npc_id%"
      "&7World: &f%activator_npc_world%"
      ""
      "&7Click any tile below for an action."
    ]
  }


  # Generic actions any NPC click can offer
  {
    slot: 11
    material: PAPER
    name: "&aGreet"
    lore: ["&7Make this NPC say hi."]
    click {
      actions {
        message: "&e[%activator_npc_name%] &fHello, %player_name%!"
        sound: ${clickSound}
      }
    }
  }
  {
    slot: 13
    material: COMPASS
    name: "&aShow location"
    lore: ["&7Print this NPC's coordinates."]
    click {
      actions {
        message: "&e[%activator_npc_name%] &fI'm in %activator_npc_world% at NPC id %activator_npc_id%."
        sound: ${clickSound}
      }
    }
  }
  {
    slot: 15
    material: EMERALD
    name: "&aTalk to vendor"
    lore: ["&7Open this NPC's shop, if it has one."]
    click {
      actions {
        # In a real setup you'd route specific NPCs to specific shop menus.
        # The demo just opens the generic vendor shop.
        openMenu: "ame_shop"
      }
    }
  }


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

Bundle includes _shared/templates.conf and INSTALL.txt.

What it teaches

Section titled “What it teaches”
  • Listing multiple NPC IDs in clickNPC: [1, 2, 3] so any of them opens this menu
  • Personalizing the menu via %activator_npc_name%, %activator_npc_id%, %activator_npc_world% in title, item names, and lore
  • Using skullOwner: "%activator_npc_name%" so the header item’s player-head texture matches the clicked NPC’s name
  • Routing different NPCs to different downstream menus (left as an exercise via the openMenu action)

NPC routing pattern

Section titled “NPC routing pattern”

The example’s “Talk to vendor” tile opens ame_shop for any NPC. A real server might route differently per NPC:

click {
  actions {
    rules {
      and {
        # Hypothetical: only NPC #2 opens the rare shop
        if: "%activator_npc_id% == 2"
      }
      actions { openMenu: "ame_rare_shop" }
      denyActions { openMenu: "ame_shop" }
    }
  }
}

For more than 2 routes, use 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 short-circuits on the first match, so each NPC ID hits exactly one branch.

Try it

Section titled “Try it”
  1. Install Citizens.
  2. Spawn three NPCs, note their IDs.
  3. Drop the bundle into plugins/AbstractMenus/menus/example/. Update clickNPC: [1, 2, 3] to your actual NPC IDs.
  4. /am reload.
  5. Right-click any of the NPCs. The menu opens with that NPC’s data in the header.