Wandering Trader

Wandering Trader

Health points	20HP × 10
Behavior	Passive
Mob type	NPC
Hitbox size	In Java Edition: Height: 1.95 blocks Width: 0.6 blocks In Bedrock Edition: Height: 1.9 blocks Width: 0.6 blocks
Speed	0.7
Spawn	See § Spawning

{
    "title": "Wandering Trader",
    "rows": [
        {
            "field": "20<span class=\"hidden-alt-text\">HP</span><span class=\"nowrap mc-hearts\"><span class=\"iconbar pixel-image nowrap\" style=\"--icon-offset:-1px;\" title=\"1  heart\">(link to File:Heart (icon).png article, displayed as 9px|link=|alt=&#9829)</span> × 10</span>",
            "label": "(link to Health article, displayed as Health points)"
        },
        {
            "field": "Passive",
            "label": "Behavior"
        },
        {
            "field": "NPC",
            "label": "(link to Mob article, displayed as Mob) type"
        },
        {
            "field": "'''In (link to Java Edition article, displayed as ''Java Edition''):'''<br>\nHeight: 1.95 blocks<br>Width: 0.6 blocks<br>\n'''In (link to Bedrock Edition article, displayed as ''Bedrock Edition''):'''<br>\nHeight: 1.9 blocks<br>Width: 0.6 blocks",
            "label": "(link to Hitbox article, displayed as Hitbox size)"
        },
        {
            "field": "0.7",
            "label": "(link to Attribute#movementSpeed article, displayed as Speed)"
        },
        {
            "field": "See (link to #Spawning article, displayed as <span style=\"white-space: nowrap;\">§ Spawning</span>)",
            "label": "(link to Mob spawning article, displayed as Spawn)"
        }
    ],
    "invimages": [
        "Wandering Trader Spawn Egg",
        "Wandering Trader Spawn Egg BE"
    ],
    "images": [
        "Wandering Trader.png"
    ]
}

The wandering trader is a passive mob that randomly spawns near the player. It can trade, making natural items more available, less dangerous to obtain, and in some cases, renewable.

Spawning

The wandering trader appears randomly in the Overworld with 2 leashed trader llamas. They typically spawn within a 48-block radius of a player. In Bedrock Edition, they also try to spawn by a claimed bell in a village.

When the world is created (or updated from an older version), a counter is initialized to 24000 ticks (20 real-life minutes, or 1 Minecraft day). Each minute (1200 ticks), if /gamerule doTraderSpawning is set to true,‌ the counter is decreased by 1200. When the counter reaches 0 it is reset to 24000 and, if /gamerule doMobSpawning is set to true, an attempt may be made to spawn a wandering trader. The first time there is a 25% chance of making the attempt, which increases to 50% the second time and is 75% thereafter until a trader is spawned or no player is found for the attempt.

When attempting a spawn, a random player is selected. If no player is found, no trader is spawned but the chance for future attempts is reset to 25%. If a player is found, then 90% of the time the spawn attempt immediately fails.

If there is a bell within 48 blocks of the player then the nearest such bell is used as the target location.

After either of the above conditions are met: ten attempts are made to find a valid mob spawning location on the uppermost block of a random X/Z position within -48/+47 of the target location on each axis. In Java Edition, the game uses the highest Y-level “surface” block for these attempts, so the wandering trader will not spawn inside enclosed caves. If spawning the trader succeeds, an additional ten attempts are made for each of two trader llamas to find a position within -4/+3 of the trader. Wandering traders and their llamas can still spawn if the passive mob cap is full. Depending on the player's position, the wandering trader may spawn in a space underground.

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_event is set to false.

Despawning

A wandering trader despawns after being loaded for 48000 ticks (40 minutes, or 2 full Minecraft days), although ticks spent with the trading UI open are not counted. Naming the wandering trader with a name tag and/or placing the wandering trader in a boat/minecart does not prevent it from despawning. This also includes wandering traders as passengers of other mobs in Java Edition, where the wandering trader still despawns if summoned on top of another mob.

When a wandering trader is unloaded, either by moving into unloaded chunks or entering another dimension, its despawn timer freezes.

Wandering traders despawn sooner if all the trades are locked.‌

Behavior

After spawning, the wandering trader prefers to wander within 16 blocks of the initial spawning target location, even if that player leaves or the bell is removed, if not otherwise reacting to nearby players or mobs.

Wandering traders drink a potion of invisibility during dusk and as needed to renew the effect during the night. They also drink milk if invisible during the day to remove the Invisibility effect.

Wandering traders avoid zombies and their variants (zombie villagers, husks, drowned, zombified piglins, zoglins), all illager variants, ravagers, 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 (but not players), 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, attack the player by spitting if their master gets hit, except in Peaceful. The llamas stop attacking if the player is killed and respawns, if the llamas are leashed after the wandering trader is killed, or if the player gets far enough away from them for a short period of time.

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

Despite their similarities to villagers, attacking or killing wandering traders does not anger iron golems.

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

Trading

The trading UI of a wandering trader in Java Edition.

The trading system is a gameplay mechanic that allows players to buy and sell items, but from a wandering trader this time.

Pressing the use control on the wandering trader allows a player to view the different trade offers, similar to a villager. Different offers are visible in a list, and clicking on one of the offers moves the corresponding items to the slots above the player's inventory. All offers involve emeralds as a currency.

Wandering traders typically sell 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 blocks, blue ice, or nautilus shells. Overall, trades offered by wandering traders offer a way to obtain biome-specific materials, without having to travel to the specific biomes. They will also buy a select few items from the player, giving emeralds in return.

After the player uses the same trade several times, the wandering trader locks the trade, but unlike villagers, never unlocks the trade. The wandering trader can appear again around the player with new trades after a while.

Wandering traders do not have the novice-master trading system like villagers. Instead, the player can buy anything from the wandering trader without the need of unlocking the previous trades.

Wandering traders do not increase the prices of its items being sold if attacked by the player, but does decrease the price if the player has the Hero of the Village effect.‌

Unlike villagers, wandering traders do not have an experience bar and do not modify their offers or prices based on changing demand. This (the trade items or prices) can be changed by the player by editing the corresponding NBT data flag through the use of the /data‌ command.

Wandering traders are the only renewable source of sand, red sand, coral blocks, and small dripleaves.

The wandering trader cannot work at a job site block and restock, even when summoned with a villager profession or other villager data.

Drops

Item		Roll Chance	Quantity (Roll Chance)
			Default	Looting I	Looting II	Looting III
	Milk Bucket	8.5%–11.5%	1–3 (8.5%)	1–4 (9.5%)	1–5 (10.5%)	1–6 (11.5%)
	Potion of Invisibility	8.5%–11.5%	1 (8.5%)	1–2 (9.5%)	1–3 (10.5%)	1–4 (11.5%)

A wandering trader is also a source of leads, as it typically spawns with two leashed trader llamas. These leads break and drop (at the location of the llama) if either trader or llama dies or if they are separated.

Separating mobs upon leads have the connection broken, dropping the leads if they enter boats for example. Unless they enter the same boat at the same time, every lead is always broken if at least one moves into a boat.

Wandering traders do not drop any loot when they despawn.

Wandering traders do not reward any experience when killed.

In Bedrock Edition, wandering traders reward experience after a successful trade.

Sounds

Java Edition:
Wandering traders use the Friendly Creatures sound category for entity-dependent sound events.

[hide]Sounds
Sound	Subtitles	Source	Description	Resource location	Translation key	Volume	Pitch	Attenuation distance
	​Wandering Trader mumbles	Friendly Creatures	Randomly	entity.wandering_trader.ambient	subtitles.entity.wandering_trader.ambient​	1.0	0.8-1.2	16
	​Wandering Trader trades	Friendly Creatures	While the trade UI on a wandering trader is open	entity.wandering_trader.trade	subtitles.entity.wandering_trader.trade​	1.0	0.8-1.2	16
	​Wandering Trader dies	Friendly Creatures	When a wandering trader dies	entity.wandering_trader.death	subtitles.entity.wandering_trader.death​	1.0	0.8-1.2	16
	​Wandering Trader hurts	Friendly Creatures	When a wandering trader is damaged	entity.wandering_trader.hurt	subtitles.entity.wandering_trader.hurt​	1.0	0.8-1.2	16
	​Wandering Trader agrees	Friendly Creatures	When a player successfully trades with a wandering trader	entity.wandering_trader.yes	subtitles.entity.wandering_trader.yes​	1.0	0.8-1.2	16
	​Wandering Trader disagrees	Friendly Creatures	When a player fails to trade with a wandering trader due to lack of resources	entity.wandering_trader.no	subtitles.entity.wandering_trader.no​	1.0	0.8-1.2	16
	​Wandering Trader drinks milk	Friendly Creatures	While a wandering trader is drinking milk to become visible during daytime	entity.wandering_trader.drink_milk	subtitles.entity.wandering_trader.drink_milk​	0.5	0.9-1.0	16
	​Wandering Trader drinks potion	Friendly Creatures	While a wandering trader is drinking a potion to become invisible during nighttime	entity.wandering_trader.drink_potion	subtitles.entity.wandering_trader.drink_potion​	varies	0.9-1.0	16
	​Wandering Trader disappears	Friendly Creatures	When a wandering trader becomes invisible	entity.wandering_trader.disappeared	subtitles.entity.wandering_trader.disappeared​	0.8	0.9-1.1	16
	​Wandering Trader appears	Friendly Creatures	When a wandering trader becomes visible	entity.wandering_trader.reappeared	subtitles.entity.wandering_trader.reappeared​	0.8	0.9-1.1	16

Bedrock Edition:

[hide]Sounds
Sound	Source	Description	Resource location	Volume	Pitch
	Friendly Creatures	Randomly	mob.wanderingtrader.idle	1.0	0.8-1.2
	Friendly Creatures	When a wandering trader dies	mob.wanderingtrader.death	1.0	0.8-1.2
	Friendly Creatures	When a wandering trader is damaged	mob.wanderingtrader.hurt	1.0	0.8-1.2
	Friendly Creatures	When a wandering trader becomes invisible	mob.wanderingtrader.disappeared	1.0	0.8-1.2
	Friendly Creatures	When a wandering trader becomes visible	mob.wanderingtrader.reappeared	1.0	0.8-1.2
	Friendly Creatures	While a wandering trader is drinking milk to become visible during daytime	mob.wanderingtrader.drink_milk	1.0	0.8-1.2
	Friendly Creatures	When a wandering trader drinks a potion to become invisible during nighttime	mob.wanderingtrader.drink_potion	0.7	0.8-1.2
	Friendly Creatures	While the trade UI on a wandering trader is open	mob.wanderingtrader.haggle	1.0	0.8-1.2
	Friendly Creatures	When a player successfully trades with a wandering trader	mob.wanderingtrader.yes	1.0	0.8-1.2
	Friendly Creatures	When a player fails to trade with a wandering trader due to lack of resources	mob.wanderingtrader.no	1.0	0.8-1.2

Data values

ID

Java Edition:

Name	Identifier	[hide]Translation key
Wandering Trader	wandering_trader	entity.minecraft.wandering_trader

Bedrock Edition:

Name	Identifier	Numeric ID	[hide]Translation key
Wandering Trader	wandering_trader	118	entity.wandering_trader.name

Entity data

Wandering traders have entity data associated with them that contains various properties.

Java Edition:

• [NBT Compound / JSON Object] Entity data
  • Additional fields for mobs that can breed see Template:Nbt inherit/breedable/template[show]
  • Tags common to all entities see Template:Nbt inherit/entity/template[show]
  • Tags common to all mobs see Template:Nbt inherit/mob/template[show]
  • [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[show]
        • [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[show]
        • [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[show]
        • [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[show]

Bedrock Edition:

See Bedrock Edition level format/Entity format.

Achievements

[hide]
Icon		Achievement	In-game description	Actual requirements (if different)	Gamerscore earned	Trophy type (PS)
PS4	Other
		It Spreads	Kill a mob next to a catalyst	—	10	Bronze
		Overkill	Deal nine hearts of damage in a single hit.	Damage can be dealt to any mob, even those that do not have nine hearts of health overall.	30	Bronze
		Over-Overkill	Deal 50 hearts of damage in a single hit using the Mace	—	20	Silver
		The Haggler	Acquire or spend 30 Emeralds by trading with villagers or with wandering trader. [sic]	—	30	Silver

Advancements

Icon	Advancement	In-game description	Actual requirements (if different)
	A Throwaway Joke	Throw a Trident at something. Note: Throwing away your only weapon is not a good idea.	Hit a mob with a thrown trident.
	Adventure	Adventure, exploration and combat	Kill any mob, or be killed by any living entity.
	Arbalistic	Kill five unique mobs with one crossbow shot	Armor Stand also counts for this advancement. This is a hidden advancement, meaning that it can be viewed by the player only after completing it, regardless of if its child advancement(s), if any, have been completed.
	Over-Overkill	Deal 50 hearts of damage in a single hit using the Mace	–
	Star Trader	Trade with a Villager at the build height limit	Stand on any block that is higher than 318 and trade with a villager or wandering trader.
	Take Aim	Shoot something with an Arrow	Using a bow or a crossbow, shoot a mob with an arrow, tipped arrow, or spectral arrow.
	What a Deal!	Successfully trade with a Villager	Take an item from a villager or wandering trader's trading output slot.

History

[hide]Java Edition
1.14			19w05a				Added wandering traders.
			19w06a				Wandering traders now drink invisibility potions at dusk and milk buckets at dawn.
			19w09a				Added two new sounds for wandering traders when they drink invisibility potions and milk.
1.15.2			Pre-Release 1				The spawning of wandering traders can now be controlled using /gamerule doTraderSpawning.
1.17			21w05a				Wandering traders can sell small dripleaf.
			21w13a				Wandering traders can sell pointed dripstone, rooted dirt and moss block.
1.19			22w15a				Wandering traders can sell mangrove propagules.
1.19.4 Experiment Update 1.20			23w07a				Wandering traders can sell cherry saplings.
1.20.2 Experiment Villager Trade Rebalance			23w31a				Wandering traders now sell more items, and buy certain items from the player.
							Most existing trades have lower prices and higher amounts in stock.
1.21.2 Experiment Winter Drop			24w40a				Wandering traders can sell pale oak sapling.
1.21.4			24w44a				Wandering traders can sell open eyeblossom, pale moss, and pale hanging moss.
1.21.5			25w07a				The changes to wandering trader trades have been moved from experimental features and are now available during normal gameplay.
			25w08a				Some of the new trades have changed from a stock of one single trade to a stock of two trades.
[hide]Bedrock Edition
1.10.0 Experiment Experimental Gameplay			beta 1.10.0.3				Added wandering traders, available only through Experimental Gameplay.
1.11.0 Experiment Experimental Gameplay			beta 1.11.0.3				Wandering traders 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.
							The spawning of wandering traders can now be enabled or disabled using the /mobevent command.
1.11.0			beta 1.11.0.4				Wandering traders have been fully implemented and are now 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.0			beta 1.12.0.2				Wandering traders now have sounds.
1.17.0			beta 1.16.230.54				Wandering traders can sell small dripleaf, pointed dripstone, rooted dirt and moss block.
1.19.0			Preview 1.19.0.21				Can no longer open or close doors.
							Now randomly moves around.
							Changed drinking sound to match Java Edition.
							Added new sound effects for gaining and losing invisibility.
							Can now be named with a name tag, but this does not stop them from despawning.
			Preview 1.19.0.25				Wandering traders can sell mangrove propagules.
1.19.10			Preview 1.19.10.21				Wandering traders now drink milk at dawn.
1.19.20			Preview 1.19.20.20				Wandering traders no longer spawn underground.
1.20.30			Preview 1.20.20.20				Wandering traders can now sell 1 cherry sapling for 5 emeralds.
							Wandering traders can no longer sell wheat seeds, beetroot seeds, pumpkin seeds and melon seeds.
			Preview 1.20.20.21				Wandering traders now sell blue, black, brown or white dyes instead of lapis lazuli, ink sacs, cocoa beans and bone meal.
1.20.30 Experiment Villager Trade Rebalancing			Preview 1.20.30.20				Wandering traders now sell more items, and buy certain items from the player.
							Most existing trades have lower prices and higher amounts in stock.
1.21.50			Preview 1.21.50.20				Wandering traders can now sell pale oak saplings, open eyeblossoms, pale hanging moss, and pale moss.
1.21.70			Preview 1.21.70.23				The changes to wandering trader trades have been moved from experimental features and are now available during normal gameplay.
			Preview 1.21.70.25				Wandering traders' buy trades can now be used twice before being locked, instead of just once.
[hide]PlayStation 4 Edition
1.91							Added wandering traders.
							If a player is holding an emerald, wandering traders hold items they want to trade.

• 

  An early concept featuring texture close to pre-Texture Update design.

• 

  Another concept.

• 

  Concept with a hat and early trader llama.

• 

  A wandering trader in 19w05a.

Issues

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

Trivia

• The wandering trader was inspired by traveling merchants from various RPGs, specifically ones that appeared to provide players with healing items in dangerous places.
• Wandering traders display their held items differently than most creatures do, using the "ground" parameter instead of the usual hand parameter in model display settings.

Gallery

Screenshots

• 

  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 that spawned in a player-made village in Minecraft Education.

• 

  Wandering trader in the windswept hills.

• 

  A wandering trader next to a nitwit villager.

Textures

• 

  Wandering trader texture file.

In other media

• 

  Artwork

• 

  Artwork with background

• 

  A Wandering Trader in promotional artwork for the first Caves & Cliffs update.

• 

  Makena offering a milk bucket to a wandering trader.

• 

  An isometric wandering trader near sheep.

• 

  A wandering trader speaking to Sunny.

• 

  Wandering trader and cartographer in front of sheep.

• 

  A wandering trader with Efe.

• 

  Animated wandering trader artwork.

• 

  Lego Minecraft figure

• 

  Concept art for A Wanderous Journey.

• 

  A wandering trader in A Minecraft Movie.

• 

  A strange looking wandering trader in concept art for Minecraft Adventure.

• 

  A wandering trader in Element Animation’s "latest masterpiece."

See also

• The Traveling Trader, a DLC map themed around wandering traders

External links

• Meet the Wandering Trader – Minecraft.net on March 22, 2019