Villager Trade Rebalance
Note:
Villager Trade Rebalance[Java Edition only] or Villager Trade Rebalancing[Bedrock Edition only] is an experiment available in both Java Edition and Bedrock Edition that tweaks the trades of several villager professions and wandering traders in an attempt to make them more fair.
According to Mojang[1], librarian trades are considered to be too overpowered compared to using an enchanting table or searching for enchanted books. With the new changes, players must explore villages in different biomes and unlock villager tiers instead of relying on random chances. Wandering traders had unfair prices and didn't sell many useful items. With the new changes, their prices are lowered, more trades are added, and they can also purchase items from the player. Additionally, various explorer maps were given to cartographers to make it easier for players to locate specific biomes.
In Java Edition 1.21.5 and Bedrock Edition 1.21.70, the cartographer and wandering trader changes were fully implemented and moved out of the experiment.
Additions
General
- Added the following structure tags:[Java Edition only]
#on_desert_village_maps: containsvillage_desert.#on_jungle_explorer_maps: containsjungle_pyramid.#on_plains_village_maps: containsvillage_plains.#on_savanna_village_maps: containsvillage_savanna.#on_snowy_village_maps: containsvillage_snowy.#on_swamp_explorer_maps: containsswamp_hut.#on_taiga_village_maps: containsvillage_taiga.
Changes
World generation
- Increased the chance of generating enchanted books with Mending.
- Increased the chance of generating enchanted books with Unbreaking (level I to III).
- Increased the chance of generating enchanted books with Unbreaking (level I to III).
- Increased the chance of generating enchanted books with Efficiency (level I to V).
- Increased the chance of generating enchanted books with Quick Charge (level I to III).
Gameplay
- Changed the trading mechanism of librarians selling enchanted books.
- Instead of offering every possible enchanted book, librarians now offer specific enchanted books depending on which biome they come from.[note 1]
- All tradable enchanted books are now split to special books and common books.
- Special books have a specific enchantment with a fixed level, and are available only from master librarians with full XP.
- Common books have a specific enchantment without a fixed level, just like before.
| Level | Java Edition | Bedrock Edition | Villager wants | Player receives | Trades in stock | Villager experience | Price multiplier | |
|---|---|---|---|---|---|---|---|---|
| Probability | Probability | Slot | ||||||
| 67% | 100% | 1 | 24 × | 16 | 2 | 0.05 | ||
| 67% | 50% | 2 | 5–64 × + | 12 | 1 | 0.2 | ||
| 67% | 50% | 9 × | 12 | 1 | 0.05 | |||
| 67% | 100% | 3 | 4 × | 12 | 10 | 0.05 | ||
| 67% | 50% | 4 | 5–64 × + | 12 | 5 | 0.2 | ||
| 67% | 50% | 12 | 5 | 0.05 | ||||
| 67% | 100% | 5 | 5 × | 12 | 20 | 0.05 | ||
| 67% | 50% | 6 | 5–64 × + | 12 | 10 | 0.2 | ||
| 67% | 50% | 4 × | 12 | 10 | 0.05 | |||
| 67% | 100% | 7 | 2 × | 12 | 30 | 0.05 | ||
| 67% | 50% | 8 | 5 × | 12 | 15 | 0.05 | ||
| 67% | 50% | 4 × | 12 | 15 | 0.05 | |||
| 100% | 100% | 9 | 5–64 × + | 12 | 30 | 0.2 | ||
| 100% | 100% | 10 | 20 × | 12 | 30 | 0.05 | ||
- ↑ a b c The enchantment is chosen randomly from the "Common" enchantments listed on the table below according to the biome of the villagers. Every levels of these enchantment has equal chance to be chosen, meaning high-level enchantments are as likely as low-level enchantments. It is possible for a librarian to sell the same book more than once.
- ↑ In Java Edition only one is requested per trade because of MC-248042 — Librarian's book and quill trade is always discounted to 1 since they are unstackable.
- ↑ The enchantment is set from the "Special" enchantments listed on the table below according to the biome of the villagers. Unlike common enchantments, the level of enchantment is also defined.
The price of a book in emeralds depends on the enchantment level and "treasure" status. The minimum price of a book is given by 2 + 3 * (enchantment level), while the maximum price is 6 + 13 * (enchantment level), capped at 64. The possible values are 5–19 emeralds for Lvl I, 8–32 for Lvl II, 11–45 for Lvl III, 14–58 for Lvl IV, and 17–64 for Lvl V. For treasure enchantments the price is doubled (but still capped at 64). All values are equally probable.
- All enchantments used for the crossbow, fishing rod, trident, and mace have been removed from trading.
Available tradable enchantments Category Desert Plains Savanna Snow Taiga Jungle Swamp Special Efficiency III Protection III Sharpness III Silk Touch Fortune II Unbreaking II Mending Common Fire Protection
Thorns
InfinityPunch
Smite
Bane of ArthropodsKnockback
Curse of Binding
Sweeping EdgeAqua Affinity
Looting
Frost WalkerBlast Protection
Fire Aspect
FlameFeather Falling
Projectile Protection
PowerDepth Strider
Respiration
Curse of Vanishing
- Changed trades of armorers:
- Buying diamond armor now also requires a small amount of diamonds.
- Most master-level armorers buy iron blocks and pay 4 emeralds for them.
- Chainmail armor is exclusively sold by jungle and swamp armorers.
- The savanna armorer sells cursed diamond armor at reduced prices.
- The taiga armorer can swap one piece of diamond armor for another. Damaged, enchanted, and cursed armor are accepted, making 8 the minimum number of diamonds required for a full set.
Desert Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Iron Boots12 5 0.05 50% — — 5 ×
Emerald
Iron Helmet12 5 0.05 50% — — 7 ×
Emerald
Iron Leggings12 5 0.05 50% — — 9 ×
Emerald
Iron Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert50% — — 8 ×
Emerald
Enchanted Iron Boots[t 1]3 15 0.05 50% — — 9 ×
Emerald
Enchanted Iron Helmet[t 1]3 15 0.05 50% — — 11 ×
Emerald
Enchanted Iron Leggings[t 1]3 15 0.05 50% — — 13 ×
Emerald
Enchanted Iron Chestplate[t 1]3 15 0.05
Master67% — — 16 ×
Emerald
+ 4 ×
Diamond
Enchanted Diamond Chestplate[t 1]3 30 0.05 67% — — 16 ×
Emerald
+ 3 ×
Diamond
Enchanted Diamond Leggings[t 1]3 30 0.05 67% — —
Block of Iron4 ×
Emerald12 30 0.05
Jungle Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Chainmail Boots12 5 0.05 50% — — 5 ×
Emerald
Chainmail Helmet12 5 0.05 50% — — 7 ×
Emerald
Chainmail Leggings12 5 0.05 50% — — 9 ×
Emerald
Chainmail Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert50% — — 8 ×
Emerald
Enchanted Chainmail Boots[t 1]3 15 0.05 50% — — 9 ×
Emerald
Enchanted Chainmail Helmet[t 1]3 15 0.05 50% — — 11 ×
Emerald
Enchanted Chainmail Leggings[t 1]3 15 0.05 50% — — 13 ×
Emerald
Enchanted Chainmail Chestplate[t 1]3 15 0.05
Master67% — — 9 ×
Emerald
Enchanted Chainmail Helmet[t 2]3 30 0.05 67% — — 8 ×
Emerald
Enchanted Chainmail Boots[t 3]3 30 0.05 67% — —
Block of Iron4 ×
Emerald12 30 0.05
Plains Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Iron Boots12 5 0.05 50% — — 5 ×
Emerald
Iron Helmet12 5 0.05 50% — — 7 ×
Emerald
Iron Leggings12 5 0.05 50% — — 9 ×
Emerald
Iron Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert50% — — 8 ×
Emerald
Enchanted Iron Boots[t 1]3 15 0.05 50% — — 9 ×
Emerald
Enchanted Iron Helmet[t 1]3 15 0.05 50% — — 11 ×
Emerald
Enchanted Iron Leggings[t 1]3 15 0.05 50% — — 13 ×
Emerald
Enchanted Iron Chestplate[t 1]3 15 0.05
Master67% — — 16 ×
Emerald
+ 3 ×
Diamond
Diamond Leggings[t 1]3 30 0.05 67% — — 16 ×
Emerald
+ 2 ×
Diamond
Diamond Boots[t 1]3 30 0.05 67% — —
Block of Iron4 ×
Emerald12 30 0.05
Savanna Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Iron Boots12 5 0.05 50% — — 5 ×
Emerald
Iron Helmet12 5 0.05 50% — — 7 ×
Emerald
Iron Leggings12 5 0.05 50% — — 9 ×
Emerald
Iron Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert50% — — 2 ×
Emerald
Enchanted Iron Boots[t 1]3 15 0.05 50% — — 3 ×
Emerald
Enchanted Iron Helmet[t 1]3 15 0.05 50% — — 5 ×
Emerald
Enchanted Iron Leggings[t 1]3 15 0.05 50% — — 7 ×
Emerald
Enchanted Iron Chestplate[t 1]3 15 0.05
Master67% — — 6 ×
Emerald
+ 2 ×
Diamond
Enchanted Diamond Helmet[t 1]3 30 0.05 67% — — 8 ×
Emerald
+ 3 ×
Diamond
Enchanted Diamond Chestplate[t 1]3 30 0.05 67% — —
Block of Iron4 ×
Emerald12 30 0.05
Snowy Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Iron Boots12 5 0.05 50% — — 5 ×
Emerald
Iron Helmet12 5 0.05 50% — — 7 ×
Emerald
Iron Leggings12 5 0.05 50% — — 9 ×
Emerald
Iron Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert100% — — 8 ×
Emerald
Enchanted Iron Boots[t 1]3 15 0.05 100% — — 9 ×
Emerald
Enchanted Iron Helmet[t 2]3 15 0.05
Master67% — — 12 ×
Emerald
+ 2 ×
Diamond
Enchanted Diamond Boots[t 1]3 30 0.05 67% — — 12 ×
Emerald
+ 3 ×
Diamond
Enchanted Diamond Helmet[t 2]3 30 0.05 67% — —
Block of Iron4 ×
Emerald12 30 0.05
Swamp Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Chainmail Boots12 5 0.05 50% — — 5 ×
Emerald
Chainmail Helmet12 5 0.05 50% — — 7 ×
Emerald
Chainmail Leggings12 5 0.05 50% — — 9 ×
Emerald
Chainmail Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert50% — — 8 ×
Emerald
Enchanted Chainmail Boots[t 1]3 15 0.05 50% — — 9 ×
Emerald
Enchanted Chainmail Helmet[t 1]3 15 0.05 50% — — 11 ×
Emerald
Enchanted Chainmail Leggings[t 1]3 15 0.05 50% — — 13 ×
Emerald
Enchanted Chainmail Chestplate[t 1]3 15 0.05
Master67% — — 9 ×
Emerald
Enchanted Chainmail Helmet[t 2]3 30 0.05 67% — — 8 ×
Emerald
Enchanted Chainmail Boots[t 3]3 30 0.05 67% — —
Block of Iron4 ×
Emerald12 30 0.05
Taiga Armorer Economic TradesLevel Java Edition Bedrock Edition Villager wants Player receives Trades in
stockVillager
experiencePrice
multiplierProbability Probability Slot
Novice100% — — 15 ×
Coal
Emerald12 2 0.05 100% — — 5 ×
Iron Ingot
Emerald12 2 0.05
Apprentice50% — — 4 ×
Emerald
Chainmail Boots12 5 0.05 50% — — 5 ×
Emerald
Chainmail Helmet12 5 0.05 50% — — 7 ×
Emerald
Chainmail Leggings12 5 0.05 50% — — 9 ×
Emerald
Chainmail Chestplate12 5 0.05
Journeyman67% — —
Lava Bucket
Emerald12 20 0.05 67% — — 5 ×
Emerald
Shield12 10 0.05 67% — — 36 ×
Emerald
Bell12 10 0.2
Expert50% — — 4 ×
Emerald
+
Diamond Boots
Diamond Leggings3 15 0.05 50% — — 4 ×
Emerald
+
Diamond Leggings
Diamond Chestplate3 15 0.05 50% — — 2 ×
Emerald
+
Diamond Chestplate
Diamond Helmet3 15 0.05 50% — — 4 ×
Emerald
+
Diamond Helmet
Diamond Boots3 15 0.05
Master67% — — 18 ×
Emerald
+ 4 ×
Diamond
Diamond Chestplate[t 1]3 30 0.05 67% — — 18 ×
Emerald
+ 3 ×
Diamond
Diamond Leggings[t 1]3 30 0.05 67% — —
Block of Diamond42 ×
Emerald12 30 0.05
Former changes
These changes were previously part of the experiment, but were fully implemented in Java Edition 1.21.5 and Bedrock Edition 1.21.70.
- Added seven new maps which cartographers can sell, depending on the biome they come from.[note 1]
- Village maps point to a village in a specific biome. Jungle explorer map points to a jungle pyramid. Swamp explorer map points to a swamp hut.


A graph showing where each type of cartographer's maps leads to
Available new tradable maps Desert Jungle Plains Savanna Snow Swamp Taiga Group 1 Savanna Village Map Savanna Village Map Savanna Village Map Desert Village Map Plains Village Map Snowy Village Map Plains Village Map Group 2 Plains Village Map Desert Village Map Taiga Village Map Plains Village Map Taiga Village Map Taiga Village Map Snowy Village Map Group 3 Jungle Explorer Map Swamp Explorer Map – Jungle Explorer Map Swamp Explorer Map Jungle Explorer Map Swamp Explorer Map
| Level | Java Edition | Bedrock Edition | Villager wants | Player receives | Trades in stock | Villager experience | Price multiplier | |
|---|---|---|---|---|---|---|---|---|
| Probability | Probability | Slot | ||||||
| 100% | 100% | 1 | 24 × | 16 | 2 | 0.05 | ||
| 100% | 100% | 2 | 7 × | 12 | 1 | 0.05 | ||
| 50% | 100% | 3 | 11 × | 16 | 10 | 0.05 | ||
| 100% | 100% | 4 | 8 × + | 12 | 5 | 0.2 | ||
| 67% | 50% | 5 | 12 | 10 | 0.05 | |||
| 67% | 50% | 13 × + | 12 | 10 | 0.2 | |||
| 67% | 100% | 6 | 12 × + | 12 | 10 | 0.2 | ||
| 12% | 100% | 7 | 7 × | 12 | 15 | 0.05 | ||
| 100% | 100% | 8 | 3 × | Any color Banner[t 3] | 12 | 15 | 0.05 | |
| 100% | 100% | 9 | 8 × | 12 | 30 | 0.05 | ||
| 100% | 100% | 10 | 14 × + | 12 | 30 | 0.2 | ||
- ↑ The structure that the map leads to depends on the biome the villager is from. See the table above for more details. Each of the three possible maps are counted as independent trades, so a villager trading multiple maps is possible.
- ↑ a b In Java Edition, all copies of the map traded by a particular villager lead to the same structure. In worlds that do not have the structure, this trade is not offered. In Bedrock Edition, cartographers adopting the profession in the Nether or the End do not offer explorer maps.
- ↑ The list of possible offers contains individual offers for each color, so multiple colors may be offered by the same villager as separate trades.
- Changed the wandering trader trades.
- Trade list now made up by following trades, in order:
- Buying Trade (new) × 2
- Special Selling Trade × 2
- Ordinary Selling Trade × 5
- Added new buying trades, some selling trades, and changed some existing selling trades:
- Trade list now made up by following trades, in order:
History
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.20.2 | 23w31a | Added the "Villager Trade Rebalance" experimental data pack. | |||||
| Librarians from different biomes now sell different enchanted books. | |||||||
| Each village biome has one special enchantment that is available only from master-level librarians, and players must visit all seven village biomes to get all the enchanted books available from trading. | |||||||
| Some enchanted book trades are exclusive to jungle and swamp villagers, which do not spawn natually, unless villagers are brought to and bred in jungle and swamp biomes. Zombie Villagers that spawn in these biomes convert into the respective villager variant. | |||||||
| Enchantments for tridents, crossbows and fishing rods are no longer obtainable from trading, and must be acquired by other means. | |||||||
| Wandering traders now sell more items, and buy certain items from the player. | |||||||
| Some of the existing trades from wandering traders have reduced prices. | |||||||
| 1.20.2 Pre-release 1 | Added seven new maps which cartographers can sell. | ||||||
| Buying diamond armor from armorers now also requires a small amount of diamonds. | |||||||
| Most master-level armorers buy iron blocks and pay 4 emeralds for them. | |||||||
| Chainmail armor is exclusively sold by jungle and swamp armorers. | |||||||
| The savanna armorer sells cursed diamond armor at reduced prices. | |||||||
| The taiga armorer can swap one piece of diamond armor for another. | |||||||
| 1.20.5 | 24w03a | Villagers who buy armor now ignore durability and can buy damaged armor. | |||||
| 1.21.5 | 25w07a | Updated trades for cartographers and wandering traders have been fully implemented and are no longer hidden behind the "Villager Trade Rebalance" experimental toggle. | |||||
| Bedrock Edition | |||||||
| 1.20.30 | Preview 1.20.30.20 | Added the "Villager Trade Rebalancing" experimental toggle. | |||||
| Librarians from different biomes now sell different enchanted books. | |||||||
| Librarians now sell, as their only master-level trade, enchanted books with a special enchantment that depends on the biome they spawned in (as shown by their garments). This is the only way to obtain these enchantments via trading. | |||||||
| Since jungle and swamp villagers do not spawn naturally, the only way to obtain the special enchanted books from these librarians is to bring in villagers from outside, get them to mate, and arrange for their babies to become librarians. Zombie Villagers that spawn in these biomes convert into the respective villager variant. | |||||||
| Enchantments for tridents, crossbows and fishing rods are no longer obtainable from trading, and must be acquired by other means. | |||||||
| Wandering traders now sell more items, and buy certain items from the player. | |||||||
| Some of the existing trades from wandering traders have reduced prices. | |||||||
| 1.20.40 | Preview 1.20.40.20 | Added seven new maps which cartographers can sell. | |||||
| Buying diamond armor from armorers now also requires a small amount of diamonds. | |||||||
| Most master-level armorers buy iron blocks and pay 4 emeralds for them. | |||||||
| Chainmail armor is exclusively sold by jungle and swamp armorers. | |||||||
| The savanna armorer sells cursed diamond armor at reduced prices. | |||||||
| The taiga armorer can swap one piece of diamond armor for another. | |||||||
| 1.21.70 | Preview 1.21.70.23 | Updated trades for cartographers and wandering traders have been fully implemented and are no longer hidden behind the "Villager Trade Rebalancing" experimental toggle. | |||||
Notes
- ↑ a b Villages do not generate naturally in jungle or swamp biomes, but they rarely expand into these biomes when generated in the border(s) of other biomes. Usually, players must breed villagers or cure zombie villagers in these biomes to access their trades.
References
- ↑ "Minecraft Snapshot 23w31a" – Minecraft.net, August 2, 2023.