Minecraft Villager Trade Guide

What the tool does

The builder creates a long /summon minecraft:villager command. The command defines the villager's appearance and behavior, then adds an Offers block with a list of Recipes.

Main structure

Every trade has at least two item stacks: buy and sell. If the price uses two items, the command also includes buyB.

Offers:{
  Recipes:[
    {
      buy:{id:"minecraft:emerald",count:8},
      sell:{id:"minecraft:paper",count:1},
      maxUses:999999
    }
  ]
}

Minecraft versions

Minecraft 1.20.5 moved item data to Data Components. The builder can switch between both item-stack formats.

• 1.20.5+ uses count and components.
• Before 1.20.5 uses Count and the older tag compound.

{id:"minecraft:paper",count:1,components:{"minecraft:custom_model_data":12}}
{id:"minecraft:paper",Count:1b,tag:{CustomModelData:12}}

Villager fields

• Profession controls the villager outfit and work style.
• Biome type changes the visual variant: plains, desert, taiga, swamp, and more.
• Level changes the badge shown on the villager's belt.
• NoAI keeps the villager in place, which is useful for server NPC shops.
• Invulnerable protects the trader from accidental damage.

Trade fields

• Buy item is the main price, such as emerald.
• Second buy item is an optional extra price, such as diamond or a quest item.
• Sell item is the reward the player receives.
• CustomModelData lets the villager sell an item with a custom resource-pack model.
• Max uses controls how many times the trade can be used.

Using it on a server

Copy the generated command into a command block or an operator console.

Important: if the command is longer than 256 characters, use a command block. Minecraft chat can cut off longer summon commands.

Practical ideas

• A pass vendor that accepts quest tokens.
• An NPC blacksmith that sells CustomModelData weapons.
• An archivist that exchanges found documents for clues.
• A faction trader with items locked behind story currency.