Creating Upgrades

Complete Example

upgrades:
  reinforced_blade:
    from:
      item: IRON_SWORD
      name: "&fReinforced Blade"
      amount: 1
    to:
      item: DIAMOND_SWORD
      name: "&bMasterwork Blade"
      lore:
        - "&7Upgrade chance: &f%chance%%"
        - "&7Price: &f%price%"
      amount: 1
      item-flags: []
      unbreakable: false
      hide-tooltip: false
      decoration-only: false
      custom-model-data: 0
    chance: 75
    coin: 2500
    enchantments:
      - "SHARPNESS:3"
    reset-enchants: false
    disallowed-enchantments:
      - "VANISHING_CURSE"
    required-items:
      crystal:
        material: AMETHYST_SHARD
        name: ""
        amount: 8
        lore: []
        enchantments: []
    no-required-items-found: "&cYou need 8 amethyst shards."

Registration Checklist

Add IRON_SWORD to config.yml under upgradable-items.
Give the recipe a unique key such as reinforced_blade.
Use a valid Bukkit material or supported custom-item prefix for from.item and to.item.
Match from.name exactly when the source needs a custom display name. Leave it empty for an unnamed source.
Configure the result and optional restrictions.
Run /itemupgrader reload and inspect the console for invalid item or enchantment messages.
Use /itemupgrader item <player> reinforced_blade true to give the source item for testing.
Test with insufficient source quantity, ingredients, money, a conflicting enchantment, success, failure, and menu cancellation.