Skip to content
AbstractMenus AbstractMenus

Inventory Crafting

A workbench-style menu that “crafts” items: the player must hold the recipe ingredients in their inventory, clicking the recipe consumes them and gives back the crafted result. Different mechanism from drag-and-drop slots - this checks the player’s regular inventory.

What it teaches

Section titled “What it teaches”
  • The inventoryItems rule for “does the player have these items”
  • itemRemove to consume the matching items
  • itemAdd to give the crafted output
  • Defining recipes as named blocks at file scope, referenced via ${name} substitution
intermediate
Features: inventoryItems-ruleitemRemoveitemAddtemplate-substitutionrecipe-template
Open: /ame_craft 
# Inventory Crafting - craft items by consuming ingredients from inventory
# Docs: https://abstractmenus.github.io/docs/en/examples/snippets/inventory-crafting
# Open: /ame_craft
# Requires: -


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


title: "&6Hunter's Workbench"
size: 1


activators {
  command: "ame_craft"
}


# Recipe definitions kept at file level - the click block references them via ${...}.


helmetRecipe {
  output {
    material: LEATHER_HELMET
    name: "&aHunter's Hat"
    enchantments {
      durability: 2
    }
  }
  requirements: [
    { material: LEATHER, count: 5 }
  ]
}


chestplateRecipe {
  output {
    material: LEATHER_CHESTPLATE
    name: "&aHunter's Jacket"
    enchantments {
      durability: 2
      thorns: 1
    }
  }
  requirements: [
    { material: LEATHER, count: 8 }
    { material: STRING,  count: 1 }
    { material: IRON_INGOT, count: 1 }
  ]
}


items: [
  ${helmetRecipe.output} {
    slot: 2
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Required:"
      "&7- Leather x5"
      ""
      "&aClick to craft"
    ]
    click {
      rules {
        inventoryItems: ${helmetRecipe.requirements}
      }
      actions {
        itemRemove: ${helmetRecipe.requirements}
        itemAdd: ${helmetRecipe.output}
        sound: ${successSound}
        message: "&aYou crafted a Hunter's Hat!"
      }
      denyActions: ${denyNotEnoughItems}
    }
  }


  ${chestplateRecipe.output} {
    slot: 6
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Required:"
      "&7- Leather x8"
      "&7- String x1"
      "&7- Iron Ingot x1"
      ""
      "&aClick to craft"
    ]
    click {
      rules {
        inventoryItems: ${chestplateRecipe.requirements}
      }
      actions {
        itemRemove: ${chestplateRecipe.requirements}
        itemAdd: ${chestplateRecipe.output}
        sound: ${successSound}
        message: "&aYou crafted a Hunter's Jacket!"
      }
      denyActions: ${denyNotEnoughItems}
    }
  }


  ${buttonClose} { slot: 8 }
]


# Local deny action for missing-ingredients case
denyNotEnoughItems {
  sound:   ${deniedSound}
  message: "&cYou don't have enough materials."
}
↓ menu.conf

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

How it works

Section titled “How it works”

Each recipe defines an output (the crafted item) and a requirements list (the ingredients):

helmetRecipe {
  output {
    material: LEATHER_HELMET
    name: "&aHunter's Hat"
    enchantments { durability: 2 }
  }
  requirements: [
    { material: LEATHER, count: 5 }
  ]
}

The click block references both:

click {
  rules { inventoryItems: ${helmetRecipe.requirements} }
  actions {
    itemRemove: ${helmetRecipe.requirements}
    itemAdd: ${helmetRecipe.output}
    ...
  }
  denyActions: ${denyNotEnoughItems}
}

This pattern keeps the recipe data in one place: the rule, the consumption, and the output all reference the same helmetRecipe block. Adding or editing a recipe means editing one block, not three.

Inventory crafting vs drag-and-drop

Section titled “Inventory crafting vs drag-and-drop”

Two distinct AbstractMenus patterns for “crafting”:

  • Inventory crafting (this example): items stay in the player’s normal inventory. The inventoryItems rule looks at the inventory, itemRemove deducts from it. Player never moves items.
  • Drag-and-drop crafting: the menu has draggable slots. Player physically drags items into them. Uses the placeItem action, placedItem rule, and the draggable field on items. See the drag-and-drop docs for the alternative pattern.

This snippet uses the inventory-crafting pattern because it composes well with shop-like UIs and doesn’t need a custom slot configuration.

Adding more recipes

Section titled “Adding more recipes”

Define a new xxxRecipe block at file scope with output {} and requirements: [...]. Add an item in the items list referencing it the same way the helmet does. Three places get the recipe: the display item, the rule, the actions. Keeping them all ${xxxRecipe.something} means recipes can’t drift out of sync.

Try it

Section titled “Try it”

After installing the example pack:

  1. Drop the bundle into plugins/AbstractMenus/menus/example/.
  2. /am reload.
  3. Get 5 leather in your inventory.
  4. Type /ame_craft in-game.
  5. Click the helmet recipe. Leather consumed, hat appears.