Action: itemAdd

itemAdd adds an item (or list of items) to the player’s inventory. The shape inside is the full item-definition spec - everything that works on a regular menu item works here too: material, name, lore, enchantments, custom NBT.

beginner

Features: itemAdd

Open: /ame_snip_give Copy

menu.conf

# Snippet: itemAdd action
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/action-give-item
# Open: /ame_snip_give

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

title: "&6itemAdd Action"
size: 1
activators { command: "ame_snip_give" }

items: [
  {
    slot: 4
    material: WOODEN_PICKAXE
    name: "&aGive me a tool"
    lore: ["&7Click to receive a wooden pickaxe."]
    click {
      actions {
        itemAdd {
          material: WOODEN_PICKAXE
          name: "&aStarter Pickaxe"
        }
        sound: ${successSound}
      }
    }
  }
  ${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.

Usage

actions {
  itemAdd {
    material: WOODEN_PICKAXE
    name: "&aStarter Pickaxe"
  }
}

Multiple items via list:

actions {
  itemAdd: [
    { material: BREAD, count: 16 }
    { material: APPLE, count: 4 }
    { material: GOLDEN_APPLE }
  ]
}

If the player’s inventory is full, items overflow to the ground (vanilla behavior). To check inventory space first, gate the click with the freeSlot or freeSlotCount rules.