# Understanding Villager Trading Mechanics in Minecraft

Canonical: https://guides.gaialegends.pro/posts/villager-trading-mechanics-minecraft
Published: 2026-11-07
Updated: 2026-11-07
Version scope: Java Edition 1.20+ and Bedrock Edition 1.11+

> Villager trading in Minecraft uses emeralds as currency. Each villager type has a profession tied to a job site block, with trades organized into five tiers unlocked by leveling up. Trading with a villager grants experience, and once all trades are used, the villager must restock by working at its job site. The Hero of the Village status effect, obtained by defeating a raid, gives a discount on trades. In Java Edition 1.20.2, Mojang added an experimental Villager Trade Rebalance toggle that changes trade offerings.

<TldrBox>Villager trading in Minecraft uses emeralds as currency. Each villager type has a profession tied to a job site block, with trades organized into five tiers unlocked by leveling up. Trading with a villager grants experience, and once all trades are used, the villager must restock by working at its job site. The Hero of the Village status effect, obtained by defeating a raid, gives a discount on trades. In Java Edition 1.20.2, Mojang added an experimental Villager Trade Rebalance toggle that changes trade offerings.</TldrBox>

## 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


![Understanding Villager Trading Mechanics in Minecraft supporting Minecraft scene 1](/images/posts/villager-trading-mechanics-minecraft-inline-1.webp)

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](/posts/player-shops-vs-villager-trading-comparison). And if you're curious about other bartering mechanics, our [piglin bartering guide](/posts/piglin-bartering-mechanics-and-rewards) covers another way to trade in Minecraft.

## 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.

## Sources

- Villagers Now resupply their trades when arriving at their job site. — [Bedrock Edition beta 1.11.0.4](https://minecraft.wiki/w/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](https://minecraft.wiki/w/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](https://minecraft.wiki/w/Bedrock_Edition_beta_1.11.0.4)
- Experiments Added the "Villager Trade Rebalance" experimental toggle (trade\_rebalance data pack). — [Java Edition 1.20.2](https://minecraft.wiki/w/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](https://minecraft.wiki/w/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](https://minecraft.wiki/w/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](https://minecraft.wiki/w/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](https://minecraft.wiki/w/Gnembon)
