NBT Tags for Wandering Trader in Minecraft (Java Edition 1.16/1.17/1.18/1.19/1.20)

This Minecraft tutorial explains the NBT tags (formerly called data tags) that you can use for a wandering trader in Minecraft Java Edition (PC/Mac) 1.16, 1.17, 1.18, 1.19 and 1.20.

TIP: If you are not running Minecraft Java Edition (PC/Mac) 1.16/1.17/1.18/1.19/1.20, find NBT tags for wandering trader in another version of Minecraft:

Background

In Minecraft Java Edition 1.16, 1.17, 1.18, 1.19 and 1.20, the entity value for a wandering trader is wandering_trader. The wandering_trader entity has a unique set of NBT tags that can be used in Minecraft commands such as: /summon and /data.

wandering trader

TIP: When you summon a wandering trader, only the wandering trader spawns. It does not spawn the trader llamas that are normally seen leashed to the wandering trader.

What are NBT tags (formerly called Data Tags)?

NBT tags allow you to set certain properties of an entity (such as wandering_trader). The NBT tag is always surrounded in {} such as {CustomName:"\"Joe\""}. If there is more than one NBT tag used in a game command, the NBT tags are separated by a comma such as {CustomName:"\"Joe\"", NoAI:1}.

List of NBT Tags

Here is a list of the NBT tags that you can use for wandering_trader in Minecraft Java Edition (PC/Mac) 1.16, 1.17, 1.18, 1.19 and 1.20:

NBT Tag Value (Description)
Offers

Lists the custom trades for the wandering trader.
"buy" is the first item to buy
"buyB" is optional and is the second item to buy
"sell" is the item that is sold by the wandering trader
"id" is the Minecraft ID for the item
"Count" is the number of items
"maxUses" is the number of times that the trade can be done before it is unavailable
"xp" is the amount of experience earned by a player for performing the trade
"uses" is the number of time this trade has been completed
"priceMultiplier" is the price multiplier to apply to the trade
"specialPrice" determines the special price for the trade
"demand" is the demand for the trade
"rewardExp" determines whether the player is rewarded with xp (the amount of experience set in the "xp" tag) after completing the trade


Syntax
Offers:{Recipes:[{trade}, {trade}, ... {trade}]}

where trade is:
buy:{id:item,Count:<number>}, buyB:{id:item,Count:<number>}, sell:{id:item,Count:<number>}, maxUses:9999999

Example (1 trade)
Offers:{Recipes:[{buy:{id:emerald,Count:6}, sell:{id:diamond_chestplate,Count:1}, maxUses:9999999}]}

Example (2 trades)
Offers:{Recipes:[{buy:{id:emerald,Count:6}, sell:{id:diamond_chestplate,Count:1}, maxUses:9999999},
{buy:{id:blue_dye,Count:2}, buyB:{id:red_dye,Count:3}, sell:{id:golden_apple,Count:1},maxUses:9999999}]}
LeftHanded

0 (The wandering trader is right-handed)
1 (The wandering trader is left-handed)

Example
{LeftHanded:1}
CustomName

name (The name to assign to the wandering trader)

Example
{CustomName:"\"Joe\""}
Health

number (The number of health points the wandering trader has)

Example
{Health:35.0f}
AbsorptionAmount

number (The number of absorption health points the wandering trader has)

Example
{AbsorptionAmount:2.0f}
Invulnerable

0 (The wandering trader will take damage like normal)
1 (The wandering trader will not take any damage from attacks or physical surroundings)

Example
{Invulnerable:1}
PersistenceRequired

0 (The wandering trader will despawn naturally)
1 (The wandering trader won't despawn)

Example
{PersistenceRequired:1}
NoAI

0 (The wandering trader will have artificial intelligence and will move/behave like normal)
1 (The wandering trader will have no artificial intelligence and will appear motionless)

Example
{NoAI:1}
Silent

0 (The wandering trader will make its usual noises in the game)
1 (The wandering trader will not make any noise in the game)

Example
{Silent:1}
Fire

ticks (The number of game ticks until the wandering trader is no longer on fire - there are 20 ticks in a second)

Example
{Fire:60}
PortalCooldown

ticks (The number of game ticks until the wandering trader can go through a portal again - there are 20 ticks in a second)

Example
{PortalCooldown:120}
Air

ticks (The number of game ticks the wandering trader has air left for)

Example
{Air:120}
id

wandering trader (The entity value used to represent a wandering trader in the Passengers tag)

Example
{id:wandering_trader}
Passengers

The mob that is riding on the wandering trader. Use the entity value for the passenger mob

Example of skeleton as passenger
Passengers:[{id:skeleton}]

NBT Tag Examples

To summon a wandering trader that is named Joe:

/summon wandering_trader ~ ~ ~ {CustomName:"\"Joe\""}

To summon a wandering trader that trades 6 emeralds for 1 diamond chestplate:

/summon wandering_trader ~ ~ ~ {Offers:{Recipes:[{buy:{id:emerald,Count:6}, sell:{id:diamond_chestplate,Count:1}, maxUses:9999999}]}}

Target Selectors

Before we finish discussing data tags, let's quickly explore how to use the @e target selector. The @e target selector allows you to target entities in your commands. If you use the type=wandering_trader value, you can target wandering traders:

@e[type=wandering_trader]

Target Selector Examples

To change the name of the nearest wandering trader to Joe:

/data merge entity @e[type=wandering_trader,limit=1,sort=nearest] {CustomName:"\"Joe\""}

To kill all wandering traders:

/kill @e[type=wandering_trader]

Next, learn how to use the game commands in Minecraft.

Command Examples

Here are some game command examples for a wandering trader in Minecraft:

summon wandering trader
How to Summon a Wandering Trader

Command Generators

If you need help, you can use these tools to automatically generate commands for you:

summon mob generator (java edition)
Summon Mob Generator
villager trade generator (java edition)
Villager Trade Generator
summon llama with chest generator (java edition)
Summon Llama with Chest Generator
summon donkey with chest generator (java edition)
Summon Donkey with Chest Generator
summon mule with chest generator (java edition)
Summon Mule with Chest Generator
Share on: