Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Wandering Trader: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Sync: updated from Minecraft
SyncBot (talk | contribs)
Sync: updated from Minecraft
 
(8 intermediate revisions by the same user not shown)
Line 40: Line 40:
When the world is created (or updated from an older version), a counter is initialized to 24000 [[Minecraft:tick]]s (20 real-life minutes, or 1 Minecraft day). Each minute (1200 ticks), if {{gmr|spawn_wandering_traders}} is set to {{code|true}},{{only|java}} the counter is decreased by 1200. When the counter reaches 0 it is reset to 24000 and an attempt may be made to spawn a wandering trader, unless the game rule {{gmr|spawn_mobs|domobspawning}} is set to {{code|false}}.
When the world is created (or updated from an older version), a counter is initialized to 24000 [[Minecraft:tick]]s (20 real-life minutes, or 1 Minecraft day). Each minute (1200 ticks), if {{gmr|spawn_wandering_traders}} is set to {{code|true}},{{only|java}} the counter is decreased by 1200. When the counter reaches 0 it is reset to 24000 and an attempt may be made to spawn a wandering trader, unless the game rule {{gmr|spawn_mobs|domobspawning}} is set to {{code|false}}.


When the counter is equal to 0 or lower for the first time, there is a 25% chance of making the attempt, which increases to 50% the second time and 75% thereafter until a trader is spawned, or no player is found for the attempt, where it will then be reset to 25%. If a player is found, then there is a 10% chance for a wandering trader to spawn. In summary, when the counter is equal to 0 or lower, the total chance that a trader will spawn will be either 2.5%, 5%, or 7.5% depending on the above conditions.
When the counter is equal to 0 or lower for the first time, there is a 25% chance of making the attempt, which increases to 50% the second time and 75% thereafter until a trader is spawned, or no player is found for the attempt, where it will then be reset to 25%. If a player is found, then there is a 10% chance for a wandering trader to spawn. In summary, when the counter is equal to 0 or lower, the total chance that a trader will spawn will be either 2.5%, 5%, or 7.5%, with the chance getting higher each time a spawn attempt fails.


When attempting a spawn, a random player is selected as the target location. If there is a [[Minecraft:bell]] within 48 blocks of the player, then the nearest such bell is used as the target location instead. Ten attempts are then made to find a valid mob spawning location. This is made 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 in ''Java Edition''. In ''Bedrock Edition'', the trader always spawns together with its llamas on the same block. Wandering traders and their llamas can still spawn if the passive [[Minecraft:mob cap]] is full.
When attempting a spawn, a random player is selected as the target location. If there is a [[Minecraft:bell]] within 48 blocks of the player, then the nearest such bell is used as the target location instead. Ten attempts are then made to find a valid mob spawning location. This is made 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 in ''Java Edition''. In ''Bedrock Edition'', the trader always spawns together with its llamas on the same block. Wandering traders and their llamas can still spawn if the passive [[Minecraft:mob cap]] is full.


{{IN|bedrock}}, when using [[Minecraft:spawn egg]]s or the {{cmd|summon}} [[Minecraft:command]] to spawn a wandering trader, llamas always spawn with it. Wandering traders never spawn if {{cmd|mobevent minecraft:wandering_trader_event}} is set to {{code|false}}.
{{IN|bedrock}}, when using [[Minecraft:spawn egg]]s or the {{cmd|summon}} [[Minecraft:command]] to spawn a wandering trader, llamas always spawn with it. Furthermore, wandering traders never spawn if {{cmd|mobevent minecraft:wandering_trader_event}} is set to {{code|false}}.


=== Despawning ===
=== Despawning ===
{{IN|java}}, a wandering trader despawns after being loaded for 48000 [[Minecraft:tick]]s (40 minutes, or 2 full ''Minecraft'' days), although ticks spent with the trading UI open are not counted. {{IN|bedrock}}, a wandering trader despawns after being loaded for either 48000 ticks (2 full ''Minecraft'' days) or 72000 ticks (3 full days) '''and''' the nearest player is more than 24 blocks away from it. In ''Bedrock Edition'', wandering traders also immediately despawn if all trades are used up and the nearest player is more than 24 blocks away.
{{IN|java}}, a wandering trader despawns after being within both render distance and simulation distance for 48000 [[Minecraft:tick]]s (40 minutes, or 2 full ''Minecraft'' days), although ticks spent with the trading UI open are not counted. {{IN|bedrock}}, a wandering trader despawns after being loaded for either 48000 ticks (2 full ''Minecraft'' days) or 72000 ticks (3 full days) '''and''' the nearest player is more than 24 blocks away from it. In ''Bedrock Edition'', wandering traders also immediately despawn if all trades are used up and the nearest player is more than 24 blocks away.


Unlike most mobs, naming the wandering trader with a [[Minecraft:name tag]] and/or placing it in a [[Minecraft:boat]]/[[Minecraft:minecart]] does not prevent it from despawning.<ref>{{bug|MC-143982||Named wandering traders despawn|WAI}}</ref> This also includes wandering traders as passengers of other mobs in ''Java Edition'', where it still despawns if summoned on top of another mob.
Unlike most mobs, naming the wandering trader with a [[Minecraft:name tag]] and/or placing it in a [[Minecraft:boat]]/[[Minecraft:minecart]] does not prevent it from despawning.<ref>{{bug|MC-143982||Named wandering traders despawn|WAI}}</ref> This also includes wandering traders as passengers of other mobs in ''Java Edition'', where it still despawns if summoned on top of another mob.
Line 53: Line 53:
When a wandering trader is unloaded, either by moving into unloaded [[Minecraft:chunk]]s or entering another [[Minecraft:dimension]], its despawn timer freezes.
When a wandering trader is unloaded, either by moving into unloaded [[Minecraft:chunk]]s or entering another [[Minecraft:dimension]], its despawn timer freezes.


{{IN|java}}, wandering traders spawned via {{cmd|summon}}, [[Minecraft:spawn egg]]s or [[Minecraft:spawner]]s have a default <code>DespawnDelay</code> value of 0, meaning they do ''not'' despawn after 48000 ticks.
In ''Java Edition'', wandering traders spawned via {{cmd|summon}}, [[Minecraft:spawn egg]]s or [[Minecraft:spawner]]s have a default <code>DespawnDelay</code> value of 0, meaning they do ''not'' despawn after 48000 ticks.


== Behavior ==
== Behavior ==
Line 128: Line 128:
|{{TradeLine|lvl=Special|slot=3-4|wantQuant=5|give=Potion of Invisibility|giveNote=wandering_trader_invisibility_duration|giveNoteText=Duration: 8:00|maxTrades=1}}
|{{TradeLine|lvl=Special|slot=3-4|wantQuant=5|give=Potion of Invisibility|giveNote=wandering_trader_invisibility_duration|giveNoteText=Duration: 8:00|maxTrades=1}}
|{{TradeLine|lvl=Special|slot=3-4|wantQuant=6|give=Blue Ice|maxTrades=6}}
|{{TradeLine|lvl=Special|slot=3-4|wantQuant=6|give=Blue Ice|maxTrades=6}}
|{{TradeLine|lvl=Special|slot=3-4|wantQuant=6-20|give=Enchanted Iron Pickaxe|wantNote=wandering_trader_enchant_price|wantNoteText=The price of this trade is the base price, 1 emerald, plus the random enchantment level chosen (5–19).|giveNote=wandering_trader_enchant_level|giveNoteText=When creating an enchantment offer, the game uses a random enchantment level from 5 to 19. The enchantments are never [[Minecraft:treasure enchantments]].|maxTrades=1}}
|{{TradeLine|lvl=Special|slot=3-4|wantQuant=6-20|wantNote=Wandering Trader Iron Pickaxe|give=Enchanted Iron Pickaxe|giveNote=Wandering Trader Iron Pickaxe|giveNoteText=[[Minecraft:Enchanting table mechanics#Value|Enchanted]] with a random experience cost in range 5–19, equivalent to the middle slot of an [[Minecraft:enchanting table]] with [[Minecraft:Enchanting table mechanics#Bookshelf placement|13 bookshelves]]. The price is 1 plus the experience cost in emeralds.|maxTrades=1}}
|{{TradeLine|lvl=Ordinary|slot=5-9|give=Fern|maxTrades=12}}
|{{TradeLine|lvl=Ordinary|slot=5-9|give=Fern|maxTrades=12}}
|{{TradeLine|lvl=Ordinary|slot=5-9|give=Sugar Cane|maxTrades=8}}
|{{TradeLine|lvl=Ordinary|slot=5-9|give=Sugar Cane|maxTrades=8}}
Line 205: Line 205:
|{{TradeLine|lvl=Ordinary|slot=5-9|wantQuant=5|give=Spruce Sapling|maxTrades=8}}
|{{TradeLine|lvl=Ordinary|slot=5-9|wantQuant=5|give=Spruce Sapling|maxTrades=8}}
|{{TradeLine|lvl=Ordinary|slot=5-9|wantQuant=5|give=Nautilus Shell|maxTrades=5}}}}
|{{TradeLine|lvl=Ordinary|slot=5-9|wantQuant=5|give=Nautilus Shell|maxTrades=5}}}}
In the [[Minecraft:Third Drop 2026|third drop of 2026]]{{upcoming}}, wandering traders can also sell:
* 1 {{BlockSprite|Poplar Sapling}} [[Minecraft:poplar sapling]] for 5 emeralds; with 8 trades in stock
* 3 {{BlockSprite|Shelf Mushroom}} [[Minecraft:shelf mushroom]]s for 1 emerald; with 12 trades in stock
* 8 {{BlockSprite|Poplar Log}} [[Minecraft:poplar log]]s for 1 emerald; with 4 trades in stock


== Drops ==
== Drops ==
Line 526: Line 531:
|{{HistoryLine|||dev=19w09a|Added two new [[Minecraft:sound]]s for wandering traders when they drink Invisibility potions and milk.}}
|{{HistoryLine|||dev=19w09a|Added two new [[Minecraft:sound]]s for wandering traders when they drink Invisibility potions and milk.}}
|{{HistoryLine||1.15.2|dev=pre1|The spawning of wandering traders can now be controlled using {{cmd|gamerule doTraderSpawning}}.}}
|{{HistoryLine||1.15.2|dev=pre1|The spawning of wandering traders can now be controlled using {{cmd|gamerule doTraderSpawning}}.}}
|{{HistoryLine||1.17|dev=21w05a|Wandering traders can sell [[Minecraft:small dripleaf]].}}
|{{HistoryLine||1.17|dev=21w05a|Wandering traders can now sell [[Minecraft:small dripleaf|small dripleaves]].}}
|{{HistoryLine|||dev=21w13a|Wandering traders can sell [[Minecraft:pointed dripstone]], [[Minecraft:rooted dirt]] and [[Minecraft:moss block]].}}
|{{HistoryLine|||dev=21w13a|Wandering traders can now sell [[Minecraft:pointed dripstone]], [[Minecraft:rooted dirt]] and [[Minecraft:moss block]]s.}}
|{{HistoryLine||1.19|dev=22w15a|Wandering traders can sell [[Minecraft:mangrove propagule]]s.}}
|{{HistoryLine||1.19|dev=22w15a|Wandering traders can now sell [[Minecraft:mangrove propagule]]s.}}
|{{HistoryLine||1.19.4|exp=Update 1.20|dev=23w07a|Wandering traders can sell [[Minecraft:cherry sapling]]s.}}
|{{HistoryLine||1.19.4|exp=Update 1.20|dev=23w07a|Wandering traders can now sell [[Minecraft:cherry sapling]]s.}}
|{{HistoryLine||1.20.2|exp=[[Minecraft:Villager Trade Rebalance]]|dev=23w31a|Wandering traders now sell more items, and buy certain items from the player.
|{{HistoryLine||1.20.2|exp=[[Minecraft:Villager Trade Rebalance]]|dev=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.}}
|Most existing trades have lower prices and higher amounts in stock.}}
|{{HistoryLine||1.21.2|exp=Winter Drop|dev=24w40a|Wandering traders can now sell [[Minecraft:pale oak sapling]]s.}}
|{{HistoryLine||1.21.2|exp=Winter Drop|dev=24w40a|Wandering traders can now sell [[Minecraft:pale oak sapling]]s.|If the "Villager Trade Rebalance" experiment is also enabled, wandering traders can now sell [[Minecraft:pale oak log]]s.}}
|{{HistoryLine||1.21.4|dev=24w44a|Wandering traders can sell [[Minecraft:open eyeblossom]], [[Minecraft:pale moss]], and [[Minecraft:pale hanging moss]].}}
|{{HistoryLine||1.21.4|dev=24w44a|Wandering traders can now sell [[Minecraft:open eyeblossom]]s, [[Minecraft:pale moss block]]s, and [[Minecraft:pale hanging moss]].}}
|{{HistoryLine||1.21.5|dev=25w07a|The changes to wandering trader trades have been moved from [[Minecraft:Villager Trade Rebalance|experimental features]] and are now available during normal gameplay.}}
|{{HistoryLine||1.21.5|dev=25w07a|The changes to wandering trader trades have been moved from [[Minecraft:Villager Trade Rebalance|experimental features]] and are now available during normal gameplay.}}
|{{HistoryLine|||dev=25w08a|Some of the new trades have changed from a stock of one single trade to a stock of two trades.}}
|{{HistoryLine|||dev=25w08a|Some of the new trades have changed from a stock of one single trade to a stock of two trades.}}
Line 540: Line 545:
|{{HistoryLine|||dev=snap11|Wandering traders can now sell [[Minecraft:name tags]].}}
|{{HistoryLine|||dev=snap11|Wandering traders can now sell [[Minecraft:name tags]].}}
|{{HistoryLine||26.2|dev=snap6|Wandering traders can now sell [[Minecraft:sulfur spike]]s.<ref>{{bug|MC-307560||Wandering traders are unable to sell sulfur spikes|F}}</ref>}}
|{{HistoryLine||26.2|dev=snap6|Wandering traders can now sell [[Minecraft:sulfur spike]]s.<ref>{{bug|MC-307560||Wandering traders are unable to sell sulfur spikes|F}}</ref>}}
|{{HistoryLine|java upcoming}}
|{{HistoryLine||26.3|dev=snap1|Wandering traders can now sell [[Minecraft:poplar sapling]]s and [[Minecraft:shelf mushroom]]s.}}
|{{HistoryLine|||dev=snap2|Wandering traders can now sell [[Minecraft:poplar log]]s.<ref>{{bug|MC-309082||Wandering traders do not sell poplar logs|F}}</ref>}}
}}
}}


Line 554: Line 562:
|Wandering traders now have 6 random trades, instead of 4.}}
|Wandering traders now have 6 random trades, instead of 4.}}
|{{HistoryLine||1.12.0|dev=beta 1.12.0.2|Wandering traders now have [[Minecraft:sound]]s.}}
|{{HistoryLine||1.12.0|dev=beta 1.12.0.2|Wandering traders now have [[Minecraft:sound]]s.}}
|{{HistoryLine||1.17.0|dev=beta 1.16.230.54|Wandering traders can sell [[Minecraft:small dripleaf]], [[Minecraft:pointed dripstone]], [[Minecraft:rooted dirt]] and [[Minecraft:moss block]].}}
|{{HistoryLine||1.17.0|dev=beta 1.16.230.54|Wandering traders can now sell [[Minecraft:small dripleaf|small dripleaves]], [[Minecraft:pointed dripstone]], [[Minecraft:rooted dirt]] and [[Minecraft:moss block]]s.}}
|{{HistoryLine||1.19.0|dev=Preview 1.19.0.21|Can no longer open or close doors.
|{{HistoryLine||1.19.0|dev=Preview 1.19.0.21|Can no longer open or close doors.
|Now randomly moves around.
|Now randomly moves around.
Line 560: Line 568:
|Added new sound effects for gaining and losing [[Minecraft:Invisibility]].
|Added new sound effects for gaining and losing [[Minecraft:Invisibility]].
|Can now be named with a [[Minecraft:name tag]], but this does not stop them from despawning.}}
|Can now be named with a [[Minecraft:name tag]], but this does not stop them from despawning.}}
|{{HistoryLine|||dev=Preview 1.19.0.25|Wandering traders can sell [[Minecraft:mangrove propagule]]s.}}
|{{HistoryLine|||dev=Preview 1.19.0.25|Wandering traders can now sell [[Minecraft:mangrove propagule]]s.}}
|{{HistoryLine||1.19.10|dev=Preview 1.19.10.21|Wandering traders now drink [[Minecraft:milk]] at dawn.}}
|{{HistoryLine||1.19.10|dev=Preview 1.19.10.21|Wandering traders now drink [[Minecraft:milk]] at dawn.}}
|{{HistoryLine||1.19.20|dev=Preview 1.19.20.20|Wandering traders no longer spawn underground.}}
|{{HistoryLine||1.19.20|dev=Preview 1.19.20.20|Wandering traders no longer spawn underground.}}
|{{HistoryLine||1.20.30|dev=Preview 1.20.20.20|Wandering traders can now sell 1 cherry sapling for 5 emeralds.
|{{HistoryLine||1.20.30|dev=Preview 1.20.20.20|Wandering traders can now sell [[Minecraft:cherry sapling]]s.
|Wandering traders can no longer sell [[Minecraft:wheat seed]]s, [[Minecraft:beetroot seed]]s, [[Minecraft:pumpkin seed]]s and [[Minecraft:melon seed]]s.}}
|Wandering traders can no longer sell [[Minecraft:wheat seed]]s, [[Minecraft:beetroot seed]]s, [[Minecraft:pumpkin seed]]s and [[Minecraft:melon seed]]s.}}
|{{HistoryLine|||dev=Preview 1.20.20.21|Wandering traders now sell blue, black, brown or white [[Minecraft:dye]]s instead of [[Minecraft:lapis lazuli]], [[Minecraft:ink sac]]s, [[Minecraft:cocoa bean]]s and [[Minecraft:bone meal]].}}
|{{HistoryLine|||dev=Preview 1.20.20.21|Wandering traders now sell blue, black, brown or white [[Minecraft:dye]]s instead of [[Minecraft:lapis lazuli]], [[Minecraft:ink sac]]s, [[Minecraft:cocoa bean]]s and [[Minecraft:bone meal]].}}
|{{HistoryLine||1.20.30|exp=[[Minecraft:Villager Trade Rebalancing]]|dev=Preview 1.20.30.20|Wandering traders now sell more items, and buy certain items from the player.
|{{HistoryLine||1.20.30|exp=[[Minecraft:Villager Trade Rebalancing]]|dev=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.}}
|Most existing trades have lower prices and higher amounts in stock.}}
|{{HistoryLine||1.21.50|dev=Preview 1.21.50.20|Wandering traders can now sell [[Minecraft:pale oak sapling]]s, [[Minecraft:open eyeblossom]]s, [[Minecraft:pale hanging moss]], and [[Minecraft:pale moss]].}}
|{{HistoryLine||1.21.50|dev=Preview 1.21.50.20|Wandering traders can now sell [[Minecraft:pale oak sapling]]s, [[Minecraft:open eyeblossom]]s, [[Minecraft:pale hanging moss]], and [[Minecraft:pale moss block]]s.}}
|{{HistoryLine||1.21.70|dev=Preview 1.21.70.23|The changes to wandering trader trades have been moved from [[Minecraft:Villager Trade Rebalance|experimental features]] and are now available during normal gameplay.}}
|{{HistoryLine||1.21.70|dev=Preview 1.21.70.23|The changes to wandering trader trades have been moved from [[Minecraft:Villager Trade Rebalance|experimental features]] and are now available during normal gameplay.}}
|{{HistoryLine|||dev=Preview 1.21.70.25|Wandering traders' buy trades can now be used twice before being locked, instead of just once.}}
|{{HistoryLine|||dev=Preview 1.21.70.25|Wandering traders' buy trades can now be used twice before being locked, instead of just once.}}
Line 574: Line 582:
|{{HistoryLine|||dev=Preview 26.10.25|Wandering traders can now sell [[Minecraft:name tag]]s.}}
|{{HistoryLine|||dev=Preview 26.10.25|Wandering traders can now sell [[Minecraft:name tag]]s.}}
|{{HistoryLine||26.30|dev=Preview 26.30.25|Wandering traders can now sell [[Minecraft:sulfur spike]]s.}}
|{{HistoryLine||26.30|dev=Preview 26.30.25|Wandering traders can now sell [[Minecraft:sulfur spike]]s.}}
|{{HistoryLine|bedrock upcoming}}
|{{HistoryLine||26.50|dev=Preview 26.50.20|Wandering traders can now sell [[Minecraft:poplar log]]s.}}
}}
}}


Line 599: Line 609:
* The wandering trader was inspired by traveling merchants from various RPGs, specifically ones that appeared to provide players with healing items in dangerous places.<ref>{{Mcnet|meet-wandering-trader|Meet the Wandering Trader|March 22, 2019|Per Landin}}</ref> It especially resembles the Travelling Merchant from ''Terraria''.
* The wandering trader was inspired by traveling merchants from various RPGs, specifically ones that appeared to provide players with healing items in dangerous places.<ref>{{Mcnet|meet-wandering-trader|Meet the Wandering Trader|March 22, 2019|Per Landin}}</ref> It especially resembles the Travelling Merchant from ''Terraria''.
* 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.
* 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.
* The "Drop 3 of 2026" [[Minecraft:experiment]] {{in|BE}} referred to the [[Minecraft:abandoned camp]]s as "the wandering trader's hidden stashes".
** The next ''Preview'' changed this to "the abandoned camps".
* If listened closely, the hurt and death noises of the wandering trader contain [[Minecraft:villager]] hurt and death noises.


== Gallery ==
== Gallery ==
Line 616: Line 629:
=== Screenshots ===
=== Screenshots ===
<gallery>
<gallery>
Wandering traders.png|A group of spawned-in wandering traders with a trader [[Minecraft:llama]] in the background
File:Wandering traders.png|A group of spawned-in wandering traders with a trader [[Minecraft:llama]] in the background
Trader and llama.png|A wandering trader and its llama
File:Trader and llama.png|A wandering trader and its llama
Wandering Trader Drinking Potion.png|A wandering trader drinking a [[Minecraft:potion of Invisibility]]
File:Wandering Trader Drinking Potion.png|A wandering trader drinking a [[Minecraft:potion of Invisibility]]
Two wandering Trader.png|Two wandering traders
File:Two wandering Trader.png|Two wandering traders
Wandering Trader at player village.png|A wandering trader that spawned in a player-made village {{in|ee}}
File:Wandering Trader at player village.png|A wandering trader that spawned in a player-made village {{in|ee}}
Wandering trader.png|Wandering trader in the windswept hills
File:Wandering trader.png|Wandering trader in the windswept hills
Wanderingtraderandnitwit.png.jpg|A wandering trader next to a nitwit [[Minecraft:villager]]
File:Wanderingtraderandnitwit.png.jpg|A wandering trader next to a nitwit [[Minecraft:villager]]
File:Wandering trader in the Backrooms.jpeg|A wandering trader in what appears to be the {{Wikipedia|Backrooms}}
</gallery>
</gallery>



Latest revision as of 11:14, 26 July 2026

Template:Infobox entity

A wandering trader is a Minecraft:passive mob similar to Minecraft:villagers that sometimes spawns near Minecraft:players, alongside two Minecraft:trader llamas tied to it with Minecraft:leads. It can be Minecraft:traded with, buying commonly available resources and selling Minecraft:items mostly native to specific Minecraft:biomes. Its trades are randomized each time it spawns, and it will despawn after enough time has passed.

Spawning

Wandering traders spawn randomly with two leashed trader llamas in the Minecraft:Overworld near the player, in any biome except in Minecraft:the void biome, controlled by the Template:Cd biome tag Template:In. They typically spawn within a 48-block centered box of a player. Template:IN, they also try to spawn by a claimed Minecraft:bell in a Minecraft:village.

When the world is created (or updated from an older version), a counter is initialized to 24000 Minecraft:ticks (20 real-life minutes, or 1 Minecraft day). Each minute (1200 ticks), if Template:Gmr is set to Template:Code,Template:Only the counter is decreased by 1200. When the counter reaches 0 it is reset to 24000 and an attempt may be made to spawn a wandering trader, unless the game rule Template:Gmr is set to Template:Code.

When the counter is equal to 0 or lower for the first time, there is a 25% chance of making the attempt, which increases to 50% the second time and 75% thereafter until a trader is spawned, or no player is found for the attempt, where it will then be reset to 25%. If a player is found, then there is a 10% chance for a wandering trader to spawn. In summary, when the counter is equal to 0 or lower, the total chance that a trader will spawn will be either 2.5%, 5%, or 7.5%, with the chance getting higher each time a spawn attempt fails.

When attempting a spawn, a random player is selected as the target location. If there is a Minecraft:bell within 48 blocks of the player, then the nearest such bell is used as the target location instead. Ten attempts are then made to find a valid mob spawning location. This is made 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 in Java Edition. In Bedrock Edition, the trader always spawns together with its llamas on the same block. Wandering traders and their llamas can still spawn if the passive Minecraft:mob cap is full.

Template:IN, when using Minecraft:spawn eggs or the Template:Cmd Minecraft:command to spawn a wandering trader, llamas always spawn with it. Furthermore, wandering traders never spawn if Template:Cmd is set to Template:Code.

Despawning

Template:IN, a wandering trader despawns after being within both render distance and simulation distance for 48000 Minecraft:ticks (40 minutes, or 2 full Minecraft days), although ticks spent with the trading UI open are not counted. Template:IN, a wandering trader despawns after being loaded for either 48000 ticks (2 full Minecraft days) or 72000 ticks (3 full days) and the nearest player is more than 24 blocks away from it. In Bedrock Edition, wandering traders also immediately despawn if all trades are used up and the nearest player is more than 24 blocks away.

Unlike most mobs, naming the wandering trader with a Minecraft:name tag and/or placing it in a Minecraft:boat/Minecraft:minecart does not prevent it from despawning.<ref>Template:Bug</ref> This also includes wandering traders as passengers of other mobs in Java Edition, where it still despawns if summoned on top of another mob.

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

In Java Edition, wandering traders spawned via Template:Cmd, Minecraft:spawn eggs or Minecraft:spawners have a default DespawnDelay value of 0, meaning they do not despawn after 48000 ticks.

Behavior

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

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

Wandering traders avoid Minecraft:zombies and their variants (Minecraft:zombie villagers, Minecraft:husks, Minecraft:drowned, Minecraft:zombified piglins, Minecraft:zoglins), all Minecraft:illager variants (Minecraft:pillagers, Minecraft:vindicators, Minecraft:evokers, Minecraft:illusionersTemplate:Only), Minecraft:ravagers, and Minecraft:vexes, staying at least 8 Minecraft:blocks away. Unlike Minecraft:villagers, a wandering trader killed by zombies does not become a Minecraft:zombie villager.<ref>Template:Bug</ref> Minecraft:Witches do not attack wandering traders during Minecraft:raids.

Wandering traders drink potions of Invisibility if hurt by magic attacks or projectiles from hostile Minecraft:mobs (but not players), or when avoiding illagers, vexes, and zombies.Template:Only

When attacked by a Minecraft:player, a wandering trader flees from the player as a Minecraft:villager would do. The Minecraft:trader llamas, however, attack the player by spitting if their master gets hit, except in Minecraft: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 Minecraft:llamas that follow the leashed trader llama(s).

Despite their similarities to villagers, attacking or killing wandering traders does not anger Minecraft:iron golems.<ref>Template:Bug</ref>

Like villagers and witches, wandering traders do not visually sit down when riding objects such as Minecraft:boats and Minecraft:minecarts.<ref>Template:Bug</ref>

Template:IN, when a player holds an emerald or other item near a wandering trader who wants that item, the wandering trader holds up an item it offers in exchange, similar to villagers.

Trading

File:Wandering Trader GUI.png
The trading UI of a wandering trader in Java Edition

The Minecraft:trading system is a Minecraft:gameplay mechanic that allows Minecraft:players to buy and sell Minecraft:items, in this case from a wandering trader.

Pressing the Template:Control 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 Minecraft:inventory. All offers involve Minecraft:emeralds as a currency.

Wandering traders typically sell items generated in the world or otherwise related to nature, such as Minecraft:plants, Minecraft:dyes, and Minecraft:buckets of fish. They can also trade less common items, such as Minecraft:coral blocks, Minecraft:blue ice, or Minecraft: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 Minecraft: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.

Template:IN, wandering traders show available items once the player holds the required item, similar to Minecraft:villagers.

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 Minecraft:Hero of the Village effect Template:In.

Unlike Minecraft:villagers, wandering traders do not have an experience bar or career levels, 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 Template:CmdTemplate:Only command.

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

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

Trade offers

The wandering trader offers nine trades in total, always consisting of two purchase trades, two special trades, and five ordinary trades.

These trades in each of these groups are not divided into categories; for example, a single wandering trader can sell 2 different saplings. Each individual trade is equally likely.

In the trading GUI, the trade offers are always listed in this order:

  • 2 purchase trades
  • 2 special trades
  • 5 ordinary trades

Template:TradeTable

In the third drop of 2026Template:Upcoming, wandering traders can also sell:

Drops

A wandering trader is also a source of Minecraft:leads, as it typically spawns with two leashed Minecraft:trader llamas. These leads break and drop (at the location of the llama) if either trader or llama dies, if they are separated, or if the player uses shears to snip the lead(s). Shearing the wandering trader has no effect. The leads can only be sheared off the llamas.

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 (or Minecraft:minecart).

Wandering traders do not drop any loot or Minecraft:experience when killed (except for the consumables mentioned above).

Template:IN, wandering traders reward experience after a successful trade.

Sounds

Template:JE: Template:SoundTable

Template:BE: Template:SoundTable

Data values

ID

Template:Edition: Template:ID table

Template:Edition: Template:ID table

Entity data

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

Template:El: Template:Main

<section begin="entity data" />

  • Template:Nbt Entity data
    • Template:Nbt inherit/breedable
    • The Template:Cd tag cannot be set to a negative number, making it impossible for them to be a baby.
    • Template:Nbt inherit/entity
    • Template:Nbt inherit/mob
    • Template:Nbt: The number of ticks counted down until this wandering trader is forced to despawn. The wandering trader despawns when this value reaches 1. If set to a value of 0 or less, the value will not change and the wandering trader will not despawn.
    • Template:Nbt: Is generated when the trading menu is opened for the first time.
    • Template:Nbt: The block location that the trader wanders toward.
    • Template:Nbt: 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.

<section end="entity data" />

Template:El:

See Minecraft:Bedrock Edition level format/Entity format.

Achievements

Template:Load achievements

Achievements that apply to all mobs: Template:Collapse

Advancements

Template:Load advancements

Advancements that apply to all mobs: Template:Collapse

History

Java Edition

Template:HistoryTable

Bedrock Edition

Template:HistoryTable

PlayStation 4 Edition

Template:HistoryTable

Data history

Template:HistoryTable

Issues

Template:Issue list

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.<ref>Template:Mcnet</ref> It especially resembles the Travelling Merchant from Terraria.
  • 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.
  • The "Drop 3 of 2026" Minecraft:experiment Template:In referred to the Minecraft:abandoned camps as "the wandering trader's hidden stashes".
    • The next Preview changed this to "the abandoned camps".
  • If listened closely, the hurt and death noises of the wandering trader contain Minecraft:villager hurt and death noises.

Gallery

Renders

Concept artwork

Screenshots

Textures

In other media

See also

References

Template:Reflist Template:Reflist

External links

Navigation

Template:Navbox entities Template:Navbox villagers

Minecraft:de:Fahrender Händler Minecraft:es:Vendedor ambulante Minecraft:fr:Marchand ambulant Minecraft:it:Mercante ambulante Minecraft:ja:行商人 Minecraft:ko:떠돌이 상인 Minecraft:lzh:行商 Minecraft:pl:Wędrowny handlarz Minecraft:pt:Vendedor Ambulante Minecraft:ru:Странствующий торговец Minecraft:th:พ่อค้าเร่ร่อน Minecraft:uk:Мандрівний крамар Minecraft:zh:流浪商人