How to Build a Villager Trading Hall in Minecraft

A villager trading hall is a row of small cells with one villager in each and its workstation right next to it. Nobody wanders off, so you can trade with dozens of villagers in seconds. Fill it from a breeder, trade once to lock each good offer and cure zombified villagers for a permanent discount. Checked against Java 26.3.

What is a villager trading hall?

According to the Minecraft Wiki, a trading hall has three parts: a way in, cells for the villagers worth keeping and a way out for the rest. Each villager needs its workstation within reach, because a sold-out trade only comes back when it works there. That happens up to twice a day, in Java even without a bed.

According to the wiki, librarians are a renewable source of treasure enchantments such as Mending, which the enchanting table never offers. That makes a librarian trading hall worth the effort. Which books are worth buying is covered in the best Minecraft enchantments.

Get villagers into your hall

• Breed them. Most halls are fed by a villager breeder, says the wiki. Beds and food are all it takes; see how to breed villagers in Minecraft.
• Move them by boat or minecart. In survival you can’t put a villager on a lead.
• Only adults work. Babies grow up after 20 minutes. A nitwit in a green coat never takes a job, so swap it out.
• One at a time. In Java an unemployed villager claims the nearest free workstation within 48 blocks. Close each cell before the next villager comes in.

Build a simple trading hall in Minecraft

1. Pick a covered spot. Lightning within 3 to 4 blocks turns a villager into a witch, so give the hall a solid roof.
2. Light it up and close it off. In Java, zombies hunt villagers from 35 to 52.5 blocks away. Torches stop monsters spawning inside.
3. Build a row of cells, one block wide and two blocks high, with a gap at the front to click the villager.
4. Place the workstation next to the villager at foot height or one layer lower; right under its feet counts too. A lectern is three wooden slabs on the top row, a bookshelf in the middle and one slab at the bottom centre.
5. Bring in a villager. It has to get within 2 blocks of the workstation to claim it. Green particles mean it’s done.
6. Plan a way out. The wiki’s standard design pushes unwanted villagers out with pistons.

Don’t kill unwanted villagers yourself: your reputation drops, prices rise and iron golems can turn on you. Deaths by fire or lava don’t count against you.

Pick a profession and lock the trades

The workstation decides the job: a lectern makes a librarian, a composter a farmer. In Java each level adds up to two random trades from a pool. In the 26.3 game files, a novice librarian offers two of three: 24 paper for an emerald, a bookshelf or an enchanted book.

Don’t like what you see? Break the workstation and put it back. As long as nobody has traded with the villager, it rolls new trades. This is how to lock villager trades: trade once. From then on it keeps its job and offers for good, through all five levels from Novice to Master.

Cure a zombie villager for a discount

A villager you cure gives you a permanent discount, and villagers nearby a smaller one. It works once per villager, and only if it had a job. Lock the trades first: a cured villager only keeps its offers if a player traded with it.

1. Switch to Hard. A villager killed by a zombie becomes a zombie villager 0% of the time on Easy, 50% on Normal and 100% on Hard.
2. Let a zombie reach it. A name tag (paper and an iron, gold or copper nugget) stops the zombie despawning.
3. Throw a Splash Potion of Weakness: a water bottle with a fermented spider eye, plus gunpowder. See every Minecraft potion recipe.
4. Feed it a golden apple: eight gold ingots around an apple. An enchanted golden apple doesn’t work.
5. Wait 3 to 5 minutes under a roof. Until then it’s still a zombie, and it burns in daylight.

Don’t switch to Peaceful meanwhile: zombie villagers despawn like all monsters. The discount hits hardest on books, tools and armor. In the 26.3 files those trades react four times as strongly to reputation, with a price multiplier of 0.2 instead of 0.05.

The best villager trades to look for

These are base prices from the Java 26.3 game files, before any discount.

A librarian’s book can be any enchantment except Soul Speed, Swift Sneak and Wind Burst, each equally likely, at a random level. The 26.3 list has 40, so about one book in 40 is Mending. As a treasure enchantment it costs double: 10 to 38 emeralds plus a book. Since 26.1 master librarians sell candles instead of name tags.

The Villager Trade Rebalance is still an experiment in 26.3, shipped as a separate data pack. Only with it on do librarians sell books by biome. Then only a master librarian from a swamp sells Mending.

A villager trading hall in Bedrock

• Beds matter. In Bedrock a villager needs a bed nearby to restock. It doesn’t have to sleep in it.
• Workstations go per village. Villagers list free workstations within 16 blocks, and an unemployed villager with a bed takes the first one, however far away. The wiki calls this inconsistent, so place one at a time.
• Trades work by slot. Each level fills a fixed number of slots, each with one trade from its own pool, so offers differ from Java.
• The discount spreads. Villagers within a 16-block cube give a small discount too, growing with the number of cured villagers up to 10.
• Bad reputation hurts less. Negative reputation can cancel a discount, but it never pushes a price above normal.

Trading halls on a server

• Everyone has their own prices. Each villager keeps a reputation per player. The cure discount goes to whoever cured the villager, and its permanent part never spreads through gossip. A second cure gives nothing, so agree who cures which villager.
• Stock is shared. A librarian’s book trade works 12 times before it sells out. When a friend empties it, everyone waits for the restock.
• Easy is the default. server.properties starts on difficulty=easy, where zombies never convert villagers. Use /difficulty hard while you zombify. On Paper, zombie-villager-infection-chance in config/paper-world-defaults.yml can also set the chance.
• Watch out for raids. In Java any claimed bed, workstation or bell makes a village, so a player with Bad Omen can start a raid in your hall. /gamerule raids false turns raids off.
• Keep it compact. Paper keeps ticking villagers outside their activation range of 32 blocks (tick-inactive-villagers: true in spigot.yml), so a huge hall costs server time. Spark, built into Paper, shows how much. More than 24 villagers crammed together take damage (max_entity_cramming).
• Experiments are set at the start. The trade rebalance only runs if it was enabled when the world was created, for example with initial-enabled-packs (default vanilla).