Block as Button

clickBlockType listens for right-clicks on any block of a given material, anywhere in the world. Different from clickBlock (which targets a specific block by coordinates). The opened menu can read the clicked block’s position, world, type via %activator_block_*% placeholders.

intermediate

Features: clickBlockType-activatoractivator_block-placeholdersno-command

Open: (right-click block)

menu.conf

# Block-as-Button - clickBlockType activator opens menu when player clicks a material
# Docs: https://abstractmenus.github.io/docs/en/examples/world-integrations/block-as-button
# Open: right-click any DIAMOND_BLOCK in the world
# Requires: -

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

title: "&bDiamond Block clicked at %activator_block_x%, %activator_block_y%, %activator_block_z%"
size: 1

activators {
  clickBlockType: ["DIAMOND_BLOCK"]
}

items: [
  {
    slot: 4
    material: DIAMOND
    name: "&bWelcome"
    lore: [
      "&7You clicked a diamond block in"
      "&7world &f%activator_block_world%&7."
      ""
      "&7Activator placeholders give you the"
      "&7clicked block's coords, world, type, etc."
    ]
  }
  ${buttonClose} { slot: 8 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/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: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# 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: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  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&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

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

What it teaches

• The clickBlockType activator targeting a material
• Reading the click context via %activator_block_x%, %activator_block_y%, %activator_block_z%, %activator_block_world%
• Putting placeholders in the menu title: for dynamic titles per-click

Activator format

activators {
  clickBlockType: ["DIAMOND_BLOCK"]
}

A list of materials. The menu opens when the player right-clicks any block whose type appears in the list. To add more triggers:

activators {
  clickBlockType: ["DIAMOND_BLOCK", "EMERALD_BLOCK", "BEACON"]
}

Note this fires on EVERY block of the listed types - server-wide. For “specific block at known coordinates” (e.g., one signpost at the spawn area), use clickBlock instead with the world + coords.

Block context placeholders

Inside the menu, %activator_block_*% exposes the clicked block:

Placeholder	Returns
%activator_block_world%	World name
%activator_block_x%	X coordinate
%activator_block_y%	Y coordinate
%activator_block_z%	Z coordinate
%activator_block_type%	Material name

The example uses these in the menu title - clicking different diamond blocks opens menus titled with each block’s coords. Useful for “info about this specific signpost” UIs.

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Place a diamond block somewhere in the world.
4. Right-click it. The menu opens with the block’s coordinates in the title.