Wandering Trader

	“	A mysterious blue-clad villager has appeared out of nowhere! You gasp and drop your controller. You fall to your knees. Your mind explodes with questions: "How did it get here?", "Why is it trying to trade with me?" and "Minecraft villagers outside of villages? What blasphemy is this?!" Calm down, friend! Everything is fine! You've just encountered Minecraft's latest and most experienced salesman – the Wandering Trader!	„
		— Per Landin

The wandering trader is a passive NPC mob found randomly across the world.

Spawning

The wandering trader appears randomly across the world or periodically in village gathering sites, usually near village meeting points, with 2 leashed trader llamas.

At any time, there can be only one wandering trader naturally spawned in the world. After 24000 ticks (20 real-life minutes, or 1 Minecraft day) have passed since the world is created, the game attempts to spawn a wandering trader. If there are no wandering traders currently in the world, the game tries to spawn a new wandering trader after every following 24000 ticks, within a 48-block radius of a player. The first spawn attempt has a 2.5% chance of success; if it fails, after another 24000 ticks another spawn attempt is made with a 5% chance of success. If that fails, for all subsequent spawn attempts the chance caps at 7.5%. On average, it takes 14.325 Minecraft days for a wandering trader to spawn. After 48000 or 72000 ticks, the trader despawns along with its llamas, resetting the cycle.

Trader llamas will not despawn if they are detached from the wandering trader's leads.

When using spawn eggs or the /summon command to spawn a wandering trader, llamas always spawn with it.‌ Wandering traders never spawn if /mobevent minecraft:wandering_trader is set to false.

Behavior

The wandering trader has 6 random trades. New trades are not unlocked after trading with it.

After spawning, the wandering trader has a managed schedule for 40–60 minutes. After the time expires, the wandering trader despawns, even if the wandering trader is named with a name tag or put in a vehicle such as a minecart or boat. A wandering trader despawns sooner if all trades have been locked. The trader may later respawn with new trades.

The wandering trader can sometimes form a caravan, due to wild llamas that follow the leashed trader llama(s).

Wandering traders drink a potion of invisibility during dusk. At dawn they drink milk to remove the invisibility.‌

Wandering traders avoid zombies and their variants, all illager variants, and vexes, staying at least 8 blocks away. Unlike other villagers, a wandering trader killed by zombies does not become a zombie villager.

Wandering traders drink potions of invisibility if hurt by magic attacks or projectiles from hostile mobs, or when avoiding illagers, vexes, and zombies.‌

When attacked by a player, a wandering trader flees from the player as a villager would do. The llamas however, will attack the player if their master gets hit.

Like villagers, wandering traders can also close and open wooden doors.‌

Unlike most other villager-like mobs, wandering traders do not visually sit down when riding objects such as boats and minecarts, which is intentional.

Drops

• a milk bucket (8.5% chance, increased 1% per level of Looting).‌
• a potion of invisibility (8.5% chance, increased 1% per level of Looting) if killed while holding or before finishing drinking.

A wandering trader also drop leads when killed or when separated too far from its trader llamas. The leads break and appear at the position of the llamas. The llamas will also drop their leads when killed, and if a wandering trader and one of its llamas are riding the same boat, the lead will break.

Trading

The trading system is a gameplay mechanic that allows players to buy items with emeralds.

A player can click on the wandering trader to view the items offered for sale. Different offers may be viewed by pressing the left and right buttons next to the currently displayed offer. All offers involve emeralds as a currency. A wandering trader has an emerald above its head while trading‌ and typically sells items generated in the world or otherwise related to nature, such as plants, dyes, and buckets of fish. They can also trade less common items, such as coral or blue ice.

After the player purchases the same item several times, the wandering trader will lock the trade, but unlike villagers, is unable to unlock the trade.

Unlike villagers who both give and receive emeralds in exchange for items, wandering traders only sell items for emeralds. They also lack an experience bar. On top of this, wandering traders do not modify their offers based on increased or decreased demand naturally, unless the player edits the corresponding NBT data flag through use of the data command.

Data values

Wandering traders have entity data associated with them that contain various properties of the mob.

• [NBT Compound / JSON Object] Entity data
  • Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
  • Tags common to all entities see Template:Nbt inherit/entity/template
  • Tags common to all mobs see Template:Nbt inherit/mob/template
  • [Int] DespawnDelay: The number of ticks counted down until this wandering trader is forced to despawn. The wandering trader despawns when this value reaches 1.
  • [NBT Compound / JSON Object] Offers: Is generated when the trading menu is opened for the first time.
    • [NBT List / JSON Array] Recipes: List of trade options.
      • [NBT Compound / JSON Object] A trade option.
        • [NBT Compound / JSON Object] buy: The first 'cost' item, without the Slot tag.
          • Tags common to all items see Template:Nbt inherit/itemnoslot/template
        • [NBT Compound / JSON Object] buyB: May not exist. The second 'cost' item, without the Slot tag.
          • Tags common to all items see Template:Nbt inherit/itemnoslot/template
        • [Int] maxUses: The maximum number of times this trade can be used before it is disabled. Increases by a random amount from 2 to 12 when offers are refreshed.
        • [Byte] rewardExp: 1 or 0 (true/false) - true if this trade provides XP orb drops. All trades from naturally-generated villagers in Java Edition reward XP orbs.
        • [NBT Compound / JSON Object] sell: The item being sold for each set of cost items, without the Slot tag.
          • Tags common to all items see Template:Nbt inherit/itemnoslot/template
        • [Int] uses: The number of times this trade has been used. The trade becomes disabled when this is greater or equal to maxUses.
  • [Int Array] wander_target: The block location that the trader wanders toward.
  • [NBT List / JSON Array] Inventory: Each compound tag in this list is an item in the wandering trader's inventory, up to a maximum of 8 slots. Items in two or more slots that can be stacked together are automatically be condensed into one slot. If there are more than 8 slots, the last slot is removed until the total is 8. If there are 9 slots but two previous slots can be condensed, the last slot returns after the two other slots are combined. Wandering traders don't change their inventory automatically or drop items from it upon death. The inventory is currently unused.
    • [NBT Compound / JSON Object] An item in the inventory, excluding the Slot tag.
      • Tags common to all items see Template:Nbt inherit/itemnoslot/template

Advancements

Icon	Advancement	In-game description	Actual requirements (if different)
	What a Deal!	Successfully trade with a Villager	Take an item from a villager or wandering trader's trading output slot.

History

Java Edition
1.14							Added the wandering trader. {"type": "java", "version": "1.14", "exp": "", "snap": "", "content": "Added the wandering trader."}
							Wandering traders will now drink invisibility potions at dusk and milk buckets at dawn. {"type": "java", "version": "", "exp": "", "snap": "", "content": "Wandering traders will now drink invisibility potions at dusk and milk buckets at dawn."}
							Added two new sounds for wandering traders when they drink invisibility potions and milk. {"type": "java", "version": "", "exp": "", "snap": "", "content": "Added two new sounds for wandering traders when they drink invisibility potions and milk."}
Bedrock Edition
1.10.0							Added the wandering trader, which is only available through Experimental Gameplay. {"type": "bedrock", "version": "1.10.0", "exp": "", "snap": "", "content": "Added the wandering trader, which is only available through Experimental Gameplay."}
1.11.0							Wandering traders will now drink a potion of invisibility during dusk, when hurt by projectiles or magic attacks, and when avoiding illagers and zombies. {"type": "bedrock", "version": "1.11.0", "exp": "", "snap": "", "content": "Wandering traders will now drink a potion of invisibility during dusk, when hurt by projectiles or magic attacks, and when avoiding illagers and zombies."}
							If a player is holding an emerald, wandering traders now hold items they want to trade. {"type": "bedrock", "version": "1.11.0", "exp": "", "snap": "", "content": "If a player is holding an emerald, wandering traders now hold items they want to trade."}
							Fully implemented wandering traders, separate from Experimental Gameplay. {"type": "bedrock", "version": "", "exp": "", "snap": "", "content": "Fully implemented wandering traders, separate from Experimental Gameplay."}
							Wandering traders now disappear faster after all trades are disabled. {"type": "bedrock", "version": "", "exp": "", "snap": "", "content": "Wandering traders now disappear faster after all trades are disabled."}
							Wandering traders now have 6 random trades, instead of 4. {"type": "bedrock", "version": "", "exp": "", "snap": "", "content": "Wandering traders now have 6 random trades, instead of 4."}
1.12.0							Wandering traders now have sounds. {"type": "bedrock", "version": "1.12.0", "exp": "", "snap": "", "content": "Wandering traders now have sounds."}
PlayStation 4 Edition
1.91							Added the wandering trader. {"type": "ps4", "version": "1.91", "exp": "", "snap": "", "content": "Added the wandering trader."}

Issues

Issues relating to "Wandering Trader" are maintained on the bug tracker. Issues should be reported and viewed there.

Gallery

• 

  A group of spawned-in wandering traders with a trader llama in the background.

• 

  A wandering trader and its llama.

• 

  A wandering trader drinking a potion of invisibility.

• 

  Two wandering traders.

• A wandering trader in 19w05a.

  A wandering trader in 19w05a.

• An early concept image of the wandering trader.[1]

  An early concept image of the wandering trader.

• Another early concept.

  Another early concept.