Minecraft Wiki
Advertisement
Minecraft Wiki
For the mob in Minecraft Dungeons, see MCD:Wandering Trader.
Wandering Trader
Wandering Trader.png
Health points

20♥ × 10

Behavior

Passive

Hitbox size

In Java Edition:
Height: 1.95 Blocks
Width: 0.6 Blocks

In Bedrock Edition:
Height: 1.9 Blocks
Width: 0.6 Blocks

Spawn

See § Spawning

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 across the world with 2 leashed trader llamas. They typically spawn within a 48-block radius of a player. They also try to spawn by a claimed bell in a village.

At any time, there can be only one wandering trader naturally spawned in loaded chunks. However, it is possible to have more than one wandering trader present by having one spawn in loaded chunks, while having another in unloaded chunks. 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.[note 1] If there are no wandering traders currently in any loaded chunks, the game tries to spawn a new wandering trader after every following 24000 ticks. 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 10.411 Minecraft days (or 3.5 real-life hours) for a wandering trader to spawn. After 48000 or 72000[verify] ticks, the trader despawns, even when named, along with its trader llamas, resetting the cycle. In Java Edition, each time a spawn attempt succeed, 10 spawn attempts are made for the wandering trader and both trader llamas on the topmost block in chosen X/Z-coordinates that is not air. Usual spawn-proofing (see Spawn) also works for wandering traders.‌[Java Edition only]

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.

In Java Edition, wandering traders never spawn if /gamerule doTraderSpawning is set to false.

When playing on a remote island, wandering traders usually spawn in the water. The game prefers spawning them on the world surface, but they also spawn underground if the player is sufficiently deep and the spawn volume is large enough‌[Bedrock Edition only][more information needed].

More than one wandering trader can be spawned using a spawn egg or using commands, although all the wandering traders look the same, but not their trader llamas.

Despawning[]

The wandering trader despawns along with its leashed trader llamas after 2-3 days, which is 40-60 minutes of real time. Naming the wandering trader with a name tag or placing the wandering trader in a boat/minecart do 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.

Wandering traders despawn sooner if all the trades are locked.

Wandering traders do not despawn if marked persistent, by setting the NBT tag {PersistenceRequired: 1b}, or setting manually with /data merge or /data modify[JE only].

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. In Java Edition, they drink milk at dawn to remove the invisibility effect.

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

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

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 does not drink a invisibility potion if attacked by a player, unlike being attacked other mobs.

Like villagers, wandering traders can also close and open wooden doors.‌[BE only]

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

Drops[]

  • A milk bucket (8.5% chance, increased 1% per level of Looting) if killed while holding or before finishing drinking.‌[JE only]
  • 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 drops 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 also drop their leads when killed, and if a wandering trader and one of its llamas are riding the same boat, the lead breaks. This counts up to two leads.

Wandering traders do not drop any loot when they despawn.

Wandering traders do not reward any experience when killed or when the player successfully trades with the wandering trader.

Trading[]

For the available trades for the wandering trader, see Trading § Wandering trader.

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

A player can click on the wandering trader to view the items offered for sale, 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. A wandering trader has an emerald above its head while trading.‌[BE only]

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 block, blue ice, or nautilius shells. Overall, trades offered by wandering traders offer a way to obtain biome-specific materials, without having to travel to the specific biomes.

After the player purchases the same item 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.

The trade slots of the wandering trader in Java Edition.

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 or decrease the prices of its items being sold if attacked by the player, or if the player has the Hero of the Village effect.

Unlike villagers, wandering traders only sell items, they do not buy items. 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[JE only] command.

As of the first part of the Caves & Cliffs update, wandering traders are the only source of dripleaves. They are also the only renewable source of sand, red sand, and coral blocks.

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

Sounds[]

SoundSubtitlesSourceDescriptionResource locationTranslation keyVolumePitchAttenuation
distance
Wandering Trader mumbles??entity.wandering_trader.ambientsubtitles.entity.wandering_trader.ambient1.0?16
Wandering Trader dies??entity.wandering_trader.deathsubtitles.entity.wandering_trader.death9.0?16
Wandering Trader hurts??entity.wandering_trader.hurtsubtitles.entity.wandering_trader.hurt1.0?16
Wandering Trader disagrees??entity.wandering_trader.nosubtitles.entity.wandering_trader.no1.0?16
Wandering Trader trades??entity.wandering_trader.tradesubtitles.entity.wandering_trader.trade1.0?16
Wandering Trader agrees??entity.wandering_trader.yessubtitles.entity.wandering_trader.yes1.0?16
Wandering Trader drinks milk??entity.wandering_trader.drink_milksubtitles.entity.wandering_trader.drink_milk1.0?16
Wandering Trader drinks potion??entity.wandering_trader.drink_potionsubtitles.entity.wandering_trader.drink_potion0.65 / 0.7?16
Wandering Trader disappears??entity.wandering_trader.disappearedsubtitles.entity.wandering_trader.disappeared0.8?16
Wandering Trader appears??entity.wandering_trader.reappearedsubtitles.entity.wandering_trader.reappeared0.8?16

Data values[]

ID[]

Java Edition:

NameResource locationTranslation key
Wandering Traderwandering_traderentity.minecraft.wandering_trader

Bedrock Edition:

NameResource locationNumeric ID Translation key
Wandering Traderwandering_trader118entity.wandering_trader.name

Entity data[]

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

Java Edition:

Main article: Entity format
  • Entity data
      • Additional fields for mobs that can breed
    • Tags common to all entities
    • Tags common to all mobs
    •  DespawnDelay: The number of ticks counted down until this wandering trader is forced to despawn. The wandering trader will despawn when this value reaches 1.
    •  Offers: Is generated when the trading menu is opened for the first time.
      •  Recipes: List of trade options.
        • A trade option.
          •  buy: The first 'cost' item, without the Slot tag.
            • Tags common to all items
          •  buyB: May not exist. The second 'cost' item, without the Slot tag.
            • Tags common to all items
          •  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.
          •  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.
          •  sell: The item being sold for each set of cost items, without the Slot tag.
            • Tags common to all items
          •  uses: The number of times this trade has been used. The trade becomes disabled when this is greater or equal to maxUses.
    •  WanderTarget: Destination toward where this trader wanders.
      •  X: The X coordinate to wander toward.
      •  Y: The Y coordinate to wander toward.
      •  Z: The Z coordinate to wander toward.
    •  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.
      • An item in the inventory, excluding the Slot tag.
        • Tags common to all items

Bedrock Edition:

See Bedrock Edition level format/Entity format.

Achievements[]

Icon Achievement In-game description Actual requirements (if different) Gamerscore earned Trophy type (PS4)
PS4 Other platforms
The HagglerAcquire or spend 30 Emeralds by trading with villagers or with wandering trader.30GSilver

Advancements[]

Icon Advancement In-game description Parent Actual requirements (if different) Resource location
Advancement-plain-raw.pngWhat a Deal!
Successfully trade with a Villager AdventureTake an item from a villager or wandering trader's trading output slot, and put it in your inventory.adventure/trade

History[]

Java Edition
1.1419w05aWandering Trader.png Added the wandering trader.
19w06aWandering traders 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.
1.15.2Pre-Release 1The spawning of wandering traders can now be controlled using /gamerule doTraderSpawning.
1.1721w05aWandering traders now can sell small dripleaf.
21w13aWandering traders now can sell pointed dripstone, rooted dirt and moss block.
Bedrock Edition
1.10.0beta 1.10.0.3Wandering Trader.png Added the wandering trader, available only through Experimental Gameplay.
1.11.0beta 1.11.0.3Wandering 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.
beta 1.11.0.4Wandering 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.0beta 1.12.0.2Wandering traders now have sounds.
1.17.0beta 1.16.230.54Wandering traders now can sell small dripleaf, pointed dripstone, rooted dirt and moss block.
PlayStation 4 Edition
1.91Wandering Trader.png Added the wandering trader.

Issues[]

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

Gallery[]

Screenshots[]

In other media[]

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.[4]
  • Villagers display their held items differently than most creatures do, using the "ground" parameter instead of the usual hand parameter in model display settings.

Notes[]

  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.

References[]

  1. MC-143747 – resolved as "Won't Fix"
  2. MC-161106 – resolved as "Works as Intended"
  3. "Meet the Wandering Trader" – Minecraft.net
  4. Meet the Wandering Trader
Advertisement