trading (task type)

Since v3.15.1

Minecraft 1.16+ required

Paper required

Trade with a Villager or Wandering Trader.

Options

Key	Description	Type	Required	Default	Notes
amount	The number of items to trade.	Integer	Yes	-	-
mob / mobs	The specific mob(s) to trade with.	Entity type, or list of entities	No	-	Not specifying this field will allow all mob types to count towards the task. Please see this list for entity types.
item	The specific item to trade.	Material, or ItemStack	No	-	Accepts standard item definition. Please see this list (1.13+) or this list (1.8-1.12) for material names.
exact-match	Whether the item should exactly match what is defined.	Boolean	No	true	-
first-ingredient	The specific item to be used as the first ingredient in a trade.	Material, or ItemStack	No	-	Accepts standard item definition. Please see this list (1.13+) or this list (1.8-1.12) for material names.
first-ingredient-exact-match	Whether the first ingredient item should exactly match what is defined.	Boolean	No	true	-
second-ingredient	The specific item to be used as the second ingredient in a trade.	Material, or ItemStack	No	-	Accepts standard item definition. Please see this list (1.13+) or this list (1.8-1.12) for material names.
second-ingredient-exact-match	Whether the second ingredient item should exactly match what is defined.	Boolean	No	true	-
mode	The specific mode of trading.	String	No	result	One of: result, first_ingredient, second_ingredient.
worlds	Worlds which should count towards the progress.	List of world names	No	-	-

Examples

Buy 10 carrots from a Villager:

tradecarrots:
  type: "trading"
  amount: 10                            # amount of items to trade
  mob: VILLAGER                         # (OPTIONAL) trader type
  item: CARROT                          # (OPTIONAL) item to trade
  worlds:                               # (OPTIONAL) restrict to certain worlds
   - "world"