Wandering Trader

From Minecraft Wiki
(Redirected from Wandering trader)
Jump to: navigation, search
Wandering Trader
Wandering Trader.png
Health points

20 (Heart.svg × 10)


See § Spawning

Internal ID

JE : ?
BE : 118

Namespaced ID


Java Edition.pngMclogo.svg

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[1]

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


The wandering trader appears randomly across the world or periodically in village gathering sites, usually near village meeting points, with two 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) have passed since the world is created, the game attempts to spawn a wandering trader.[note 1] 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%. 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.

In Bedrock Edition, 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.


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

After spawning, the wandering trader will have a managed schedule for 40–60 minutes. After the time expires, the wandering trader will despawn. They will despawn even if they are named with a name tag or put in a vehicle such as a minecart or boat. A wandering trader will despawn 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 will drink a potion of invisibility during dusk. Once it is dawn, they will drink milk to remove the invisibility.‌[Java Edition only]

Wandering traders will avoid zombies and their variants, all illager variants, and vexes, staying at least 8 blocks away. Unlike other villagers, wandering traders killed by zombies will not themselves turn into a zombie.[2]

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

They will run away when attacked by players.‌[Bedrock Edition only]


A wandering trader can drop:

  • leads, either when killed, or when separated too far from the trader llamas (the llamas can be unable to follow due to a fence or deep pool of water); the leads break and appear at the position of the llamas.
  • a Milk Bucket[Java Edition only] (8.5% chance, increased 1% per level of Looting) when killed.
  • a potion of invisibility (8.5% chance, increased 1% per level of Looting) when killed while holding or before finishing drinking.


The trading system is a gameplay mechanic that allows players to trade emeralds for items.

Right-clicking a wandering trader will allow a player to trade with them. Different offers may be viewed by pressing the left and right buttons next to the currently displayed offer. All offers involve emerald as a currency. Trading allows the acquisition of rare items that would otherwise be fairly difficult to obtain, such as coral or blue ice.

In Java Edition, after 2–12 times an offer is repeated, the wandering trader will lock the trade offer, and the wandering trader will no longer offer this trade permanently.

Unlike villagers who both give and receive emeralds in exchange for items, wandering traders only sell items for emeralds. Players cannot exchange items for emeralds. Wandering traders also have no experience bar and they don't modify their offers based on increased demand.

Data values[edit]

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

  • Entity data
    • Tags common to all entities see Template:Nbt inherit/entity/template
    • Tags common to all mobs see Template:Nbt inherit/mob/template
    • Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template
    •  DespawnDelay: The number of ticks until this wandering trader is forced to despawn.
    •  WanderTarget: Where this trader will wander towards.
      •  X: The X coordinate to wander towards.
      •  Y: The Y coordinate to wander towards.
      •  Z: The Z coordinate to wander towards.
    •  Offers: Is generated when the trading menu is opened for the first time.
      •  Recipes: List of trade options.
        • A trade option.
          •  rewardExp: 1 or 0 (true/false) - true if this trade will provide XP orb drops. All trades from naturally-generated villagers in Java Edition reward XP orbs.
          •  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.
          •  uses: The number of times this trade has been used. The trade becomes disabled when this is greater or equal to maxUses.
          •  buy: The first 'cost' item, without the Slot tag.
          •  buyB: May not exist. The second 'cost' item, without the Slot tag.
          •  sell: The item being sold for each set of cost items, without the Slot tag.


Icon Advancement In-game description Parent Actual requirements (if different) Internal ID
Advancement-plain-raw.pngWhat a Deal!Successfully trade with a VillagerAdventureTake an item from a villager's trading output slot, and put it in your inventory.minecraft:adventure/trade


Java Edition
1.1419w05aAdded the wandering trader.
19w06aWandering traders will now drink invisibility potions at dusk and milk buckets at dawn.
19w09aAdded two new sounds for wandering traders when they drink invisibility potions and milk.
Bedrock Edition
1.10.0beta the wandering trader, which is only available through Experimental Gameplay.
1.11.0beta 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.
beta implemented wandering traders, separate from Experimental Gameplay.
Wandering traders now disappear faster after all trades are disabled.
Wandering traders now have 6 random trades, instead of 4.
1.12.0beta traders now have sounds.


Issues relating to "Wandering Trader" are maintained on the bug tracker. Report issues there.



  1. If a world is upgraded to Java Edition 1.14 (starting from 19w05a) from a previous version, the timer starts at the time the world was saved. So if the world was last saved at noon in 1.13 and then upgraded to 1.14, the algorithm tries to spawn a wandering trader every day at noon.


  1. a b "Meet the Wandering Trader" – Minecraft.net
  2. MC-143747