Understanding Villager Trading Mechanics in Minecraft
Filed under Minecraft Economy & Trading · How we create content
Version scope: Java Edition 1.20+ and Bedrock Edition 1.11+

Key Takeaways
| Point | Details |
|---|---|
| Emeralds are the currency; | Emeralds are the currency; rubies were originally planned but replaced because Dinnerbone is red-green colorblind. |
| Each villager profession is | Each villager profession is linked to a specific job site block; without it, a villager can't restock trades. |
| Trades are organized into | Trades are organized into five tiers (Novice to Master), unlocked by trading and gaining experience. |
| Hero of the Village, | Hero of the Village, earned by defeating a raid, gives a temporary discount on all villager trades. |
| The Villager Trade Rebalance | The Villager Trade Rebalance experiment in Java Edition 1.20.2 changes which items villagers offer. |
| Gnembon, a Mojang technical | Gnembon, a Mojang technical lead, has said villager trading should be redesigned as quest-like discoveries. |
Villager trading is the backbone of Minecraft's survival economy. Whether you're after Mending books, diamond gear, or just a steady supply of emeralds, understanding how the system works saves you time and frustration. Here's a clear breakdown of the mechanics, the history, and the recent changes you need to know.
How Villager Professions and Job Site Blocks Work
Every villager has a profession — farmer, librarian, armorer, and so on — determined by the job site block they claim. A farmer needs a composter, a librarian a lectern, an armorer a blast furnace. Without access to their job site block, villagers can't restock their trades after you buy them out. In Bedrock Edition beta 1.11.0.4, the trading system was revamped so that villagers now resupply their trades when arriving at their job site.
Villagers Now resupply their trades when arriving at their job site.
If you break a villager's job site block, they lose their profession and become a nitwit until they claim a new one. This is crucial for setting up a trading hall: place the job site block, let the villager claim it, then lock in the trades by trading with them at least once.
Trade Tiers and Leveling Up
Each profession has five trade tiers: Novice, Apprentice, Journeyman, Expert, and Master. You unlock higher tiers by trading with the villager. Every time you complete a trade, the villager gains experience, and a green XP bar appears above their head. Once that bar fills, they level up and unlock new trades. The higher the tier, the more valuable (and expensive) the items tend to be. For example, a Novice librarian might offer bookshelves, while a Master librarian can sell enchanted books with top-tier enchantments.
The Hero of the Village Discount

One of the most satisfying ways to get better prices is to earn the Hero of the Village status effect. You get this by successfully defending a village from a raid. The effect lasts for three game days and gives you a discount on all villager trades.
Status effects Hero of the Village can now be obtained by defeating a raid, and lasts for three days.
Players now receive a discount from villager trades while they have the Hero of the Village status effect.
This was added in the same Bedrock Edition beta that revamped the trading system. Stack the discount with a cured zombie villager (which permanently reduces prices) and you can get some incredibly cheap deals.
The Villager Trade Rebalance Experiment
In Java Edition 1.20.2, Mojang introduced an experimental feature called the "Villager Trade Rebalance." This is a toggleable data pack that changes which items villagers offer and at what prices, aiming to make exploration more rewarding and reduce the dominance of a single "best" villager setup.
Experiments Added the "Villager Trade Rebalance" experimental toggle (trade_rebalance data pack).
1.20.2 is a minor update to Java Edition, released on September 21, 2023, which adds the "Villager Trade Rebalance" experiment, the /random command, function macros, changes diamond generation, and fixes bugs.
The rebalance adjusts trades for cartographers, librarians, and other professions, and can be enabled when creating a new world or through the world's data packs folder. It's still experimental, so it's not active by default.
A Bit of Trading History: Rubies and Emeralds
It's a fun piece of trivia: emeralds weren't always the currency of choice. Originally, rubies were intended to be used for trading. They appeared in a screenshot released by Jeb on May 21, 2012, when the trading system was first being tested. They were later replaced by emeralds because Dinnerbone is red-green colorblind.
They could be seen in a screenshot released by Jeb on May 21, 2012, in which the trading system was first being tested.
They were later replaced by emeralds because Dinnerbone is red-green colorblind; though their texture remained in the files after emeralds were implemented.
Ruby textures remained in the game files for years after emeralds were implemented, a quiet nod to what could have been.
The Future of Villager Trading
Even Mojang developers think the current system could be better. Gnembon, a technical lead at Mojang, has stated that villager trading needs to be redesigned from scratch, in the form of quest-like discoveries that encourage exploration and progression.
Gnembon thinks that villager trading needs to be redesigned from scratch, in the form of quest-like discoveries that encourage exploration and progression.
For now, the experimental trade rebalance is the closest we have to a new vision. If you're running a server or a long-term survival world, it's worth toggling on to see how it changes the flow of your economy.
Practical Tips for Efficient Trading
- Cure zombie villagers for permanent discounts. A cured villager offers drastically reduced prices that stack with Hero of the Village.
- Lock in trades early. Once you've traded with a villager once, their profession is locked, even if you break their job site block. This lets you move them to a trading hall without losing their trades.
- Restock by letting them work. Villagers restock their trades up to twice per day (in Java Edition) after they've spent time at their job site block. Make sure they have access to it.
- Use a farmer for easy emeralds. Farmers buy pumpkins, melons, and wheat, which are easy to farm in bulk. It's the quickest path to a stack of emeralds early game.
For more on how villager trading compares to player-run shops on multiplayer servers, check out our comparison of player shops vs villager trading. And if you're curious about other bartering mechanics, our piglin bartering guide covers another way to trade in Minecraft.
Sources
- Villagers Now resupply their trades when arriving at their job site. — Bedrock Edition beta 1.11.0.4
- Status effects Hero of the Village can now be obtained by defeating a raid, and lasts for three days. — Bedrock Edition beta 1.11.0.4
- Players now receive a discount from villager trades while they have the Hero of the Village status effect. — Bedrock Edition beta 1.11.0.4
- Experiments Added the "Villager Trade Rebalance" experimental toggle (trade\_rebalance data pack). — Java Edition 1.20.2
- 1.20.2 is a minor update to Java Edition, released on September 21, 2023, which adds the "Villager Trade Rebalance" experiment, the /random command, function macros, changes diamond generation, and fixes bugs. — Java Edition 1.20.2
- They could be seen in a screenshot released by Jeb on May 21, 2012, in which the trading system was first being tested. — Mentioned features
- They were later replaced by emeralds because Dinnerbone is red-green colorblind; though their texture remained in the files after emeralds were implemented. — Mentioned features
- Gnembon thinks that villager trading needs to be redesigned from scratch, in the form of quest-like discoveries that encourage exploration and progression. — Gnembon
Frequently Asked Questions
How do I get a villager to restock their trades?
Villagers restock their trades by working at their job site block. They need to have access to it and be able to pathfind to it. In Java Edition, they can restock up to twice per Minecraft day (every 10 minutes or so).
Does Hero of the Village affect all villagers or just the ones in the raided village?
Hero of the Village affects all villagers you interact with while the status effect is active, regardless of which village you raided. The effect lasts for three in-game days.
Can I change a villager's profession after trading with them?
No. Once you trade with a villager at least once, their profession is locked in permanently. You can only change a villager's profession if you have never traded with them.
What is the Villager Trade Rebalance experiment?
It's an experimental data pack added in Java Edition 1.20.2 that changes the trades offered by villagers, aiming to make exploration more rewarding and balance overpowered trades like librarian-enchanted books. It must be enabled manually.
Related guides

Player Shops vs Villager Trading: Which Economy Fits Your Server?
Compare player-run shops and villager trading in Minecraft multiplayer. Learn the pros, cons, and best use cases for each system in your server economy.

Minecraft Economy 101: How Supply and Demand Work on Player-Driven Servers
Learn how supply and demand shape Minecraft economies, from vanilla villager trading mechanics to player-driven server markets. Includes inflation control...

How to Use a Minecraft Villager Trading Chart for Max Profit 2026
Master the Minecraft villager trading chart in 2026. Learn trade prices, zombie curing discounts, piglin bartering, and how to flip items for max profit.

How to Build the Most Efficient Minecraft Trading Hall in 2026
Learn how to build the most efficient Minecraft trading hall in 2026 — layouts, zombie curing, best villager professions, and emerald farming tips.
Have a question or another approach?
Compare notes with other readers. Include your edition and version when discussing mechanics.