Skip to main content

Item Binding

Lets admins bind a specific item - a vanilla material or an ItemsAdder custom item - as the base item for a tool, instead of using the default item-material.

How It Works​

  1. Run /sigmatools bind <tool> to open the binding GUI.
  2. GUI shows your inventory: valid items (matching the tool type) highlighted green, invalid items red.
  3. Click a valid item to bind it - saved to config.yml automatically.
  4. Future tool creation uses the bound item as the base, with SigmaTools NBT data added on top.
/sigmatools bind pickaxe
/sigmatools bind axe
/sigmatools bind bucket
/sigmatools bind hoe

Supported Items​

  • Vanilla - any material matching the tool type (e.g. WOODEN_PICKAXE, IRON_PICKAXE for pickaxe).
  • ItemsAdder - custom items are auto-detected if ItemsAdder is installed; falls back to the vanilla material if the custom item isn't found.

Configuration​

tools:
  pickaxe:
    bound-item:
      type: "vanilla"          # or "itemsadder"
      material: "IRON_PICKAXE" # fallback material for itemsadder type
      itemsadder-id: "namespace:custom_pickaxe"  # only for itemsadder

Priority: bound item > item-material > default material, falling back down the chain if a step is invalid.

Clear a binding: comment out or delete the bound-item block in config.yml, then /sigmatools reload.

Validation​

  • Item type must match the tool (pickaxe material for pickaxe, etc.).
  • Vanilla materials must be valid; ItemsAdder items must exist and load correctly.
  • Invalid bindings fall back to default item-material automatically.

Troubleshooting​

See Troubleshooting for binding GUI errors and bound-item-not-applying issues.

See Also​