Item Settings

This page covers all configuration options for individual items within the menu-items list.

---

Basic Item Example

menu-items:
  - slot: 13
    material: DIAMOND_SWORD
    name: "&c&lLegendary Sword"
    amount: 1
    glint: true
    lore:
      - "&7Attack Damage: &c+10"
      - "&7Durability: &aUnbreakable"
      - ""
      - "&eClick to purchase"
    sound: "ENTITY_PLAYER_LEVELUP"
    close-menu: true
    command: "shop buy sword"

---

Positioning Items

Item positions can be specified using either slot or location.

1. slot (Zero-Indexed Slot ID)

Zero-indexed slot position starting from the top-left (0):

 0  1  2  3  4  5  6  7  8   (Row 1)
 9 10 11 12 13 14 15 16 17   (Row 2)
18 19 20 21 22 23 24 25 26   (Row 3)
...

slot: 13 # Center of row 2

2. location (One-Indexed Column, Row)

One-indexed "col,row" coordinates (compatible with EasyMenu 5/6):

location: "5,2" # Column 5, Row 2 (same as slot 13)

:::note Priority If both slot and location are specified on the same element, slot takes precedence. :::

---

Item Properties Reference

Key	Type	Default	Description
id	Text	Deterministic	Element ID. Derived automatically (e.g. slot-13 or location-5-2) if omitted.
material	Material	Required	Material name (e.g. DIAMOND, COMPASS, PLAYER_HEAD).
name	Text	Material name	Display name. Color codes and placeholders supported.
lore	Text List	[]	List of lore lines (becomes button tooltip on Native Dialogs).
amount	Integer	1	Stack size.
glint	Boolean	None	Gives the item an enchantment glint effect.
custom-model-data	Integer	None	CustomModelData integer for resource packs.
base64	Text	None	Base64 skin texture string for PLAYER_HEAD.
sound	Sound	None	Sound effect played when clicked.
close-menu	Boolean	true	Closes the menu after action execution finishes.
click-policy	Enum	PRIMARY	Click types to accept (PRIMARY, LEFT, RIGHT, ANY).

---

Custom Heads (base64)

When material: PLAYER_HEAD is used, specify custom head textures with the base64 property:

menu-items:
  - slot: 13
    material: PLAYER_HEAD
    name: "&eGift Box"
    base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWI3Y2JjY2UxMGFhMmJjNzRiOTZjNmYxNWQ3N2VkMTkyYmM3YjNmZGU5YThjMmY5NWVhYjlkMTFlOTMyZDYyIn19fQ=="
    command: "present claim"

---

Modern Item Components (components)

EasyMenu 7 supports modern Minecraft item components (1.20.5+):

menu-items:
  - slot: 13
    material: NETHERITE_CHESTPLATE
    name: "&6&lIndestructible Armor"
    components:
      unbreakable: true                  # Unbreakable item
      max-stack-size: 1                  # Maximum stack size
      rarity: epic                       # Item rarity (common, uncommon, rare, epic)
      hide-tooltip: false                # Hide tooltip flag
      enchantment-glint-override: true   # Override glint
      item-model: "minecraft:bundle"     # 1.21.6+ item model reference
    command: "shop buy armor"

:::info Version Fallback Components unsupported by the running server (e.g. item-model on 1.20.1) produce a single startup warning and are skipped gracefully. The menu and items continue to function normally. :::