Editing Villager Trade Rebalance

<!-- {{Needs update|How much of this is no longer experimental as of 25w07a?}} -->
{{wip|Please convert the tables documenting the trades to use TradeTable and TradeLine instead of traditional tables.}}
{{experimental|JE|BE|je=Villager Trade Rebalance|be=Villager Trade Rebalancing}}'''Villager Trade Rebalance''' (called '''Villager Trade Rebalancing''' in ''Bedrock Edition'') is an [[experiment]] available in both {{JE}} and {{BE}} that tweaks the [[trade]]s of several villager [[profession]]s and [[wandering trader]]s in an attempt to make them more fair.

According to [[Mojang Studios|Mojang]]<ref>{{snap|23w31a|August 2, 2023}}</ref>, 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 [[cartographer]]s 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 ===
; [[Tag]]s
* Added the following structure tags:{{only|je}}
** {{cd|#on_desert_village_maps}}: contains {{cd|village_desert}}.
** {{cd|#on_jungle_explorer_maps}}: contains {{cd|jungle_pyramid}}.
** {{cd|#on_plains_village_maps}}: contains {{cd|village_plains}}.
** {{cd|#on_savanna_village_maps}}: contains {{cd|village_savanna}}.
** {{cd|#on_snowy_village_maps}}: contains {{cd|village_snowy}}.
** {{cd|#on_swamp_explorer_maps}}: contains {{cd|swamp_hut}}.
** {{cd|#on_taiga_village_maps}}: contains {{cd|village_taiga}}.

== Changes ==
=== World generation ===
; [[Ancient City]]
* Increases the chance of generating enchanted books with [[Mending]].

; [[Desert Pyramid]]
* Increases the chance of generating enchanted books with [[Unbreaking]] (level I to III).

; [[Jungle Pyramid]]
* Increases the chance of generating enchanted books with [[Unbreaking]] (level I to III).

; [[Mineshaft]]
* Increases the chance of generating enchanted books with [[Efficiency]] (level I to V).

; [[Pillager Outpost]]
* Increases the chance of generating enchanted books with [[Quick Charge]] (level I to III).

=== Gameplay ===
==== [[Trading]] ====
* 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.<ref group=note name=nonatural>Villages do not generate naturally in jungle or swamp biomes. Thus, players must [[Villager#Breeding|breed villagers]] or [[Zombie Villager#Curing|cure zombie villagers]] in these biomes to access their trades.</ref>
** All tradable enchanted books 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.
{{anchor|Librarian}}
{{TradeTable|title=Librarian Economic Trades|profession=Librarian|ignoreUsage=1
|{{TradeLine|lvl=Novice|slot=1|want=Paper|wantQuant=24|multi=0.05|maxTrades=16|xpGain=2}}
|{{TradeLine|lvl=Novice|slot=2|want2=Book|wantQuant=5-64|give=Enchanted Book|giveNote=common-enchanted-book|giveNoteText=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.
The price in emeralds depends on the enchantment level and "treasure" status. The minimum price of a book is given by 2&nbsp;+&nbsp;3&nbsp;*&nbsp;(enchantment level), while the maximum price is 6&nbsp;+&nbsp;13&nbsp;*&nbsp;(enchantment level). 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–71 for Lvl V. For [[treasure enchantment]]s the price is doubled. The cost is capped at 64 emeralds. All values below this cap are equally probable.|multi=0.2|maxTrades=12|xpGain=1}}
|{{TradeLine|lvl=Novice|slot=2|wantQuant=9|give=Bookshelf|multi=0.05|maxTrades=12|xpGain=1}}
|{{TradeLine|lvl=Apprentice|slot=3|want=Book|wantQuant=4|multi=0.05|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Apprentice|slot=4|want2=Book|wantQuant=5-64|give=Enchanted Book|giveNote=common-enchanted-book|multi=0.2|maxTrades=12|xpGain=5}}
|{{TradeLine|lvl=Apprentice|slot=4|give=Lantern|multi=0.05|maxTrades=12|xpGain=5}}
|{{TradeLine|lvl=Journeyman|slot=5|want=Ink Sac|wantQuant=5|multi=0.05|maxTrades=12|xpGain=20}}
|{{TradeLine|lvl=Journeyman|slot=6|want2=Book|wantQuant=5-64|give=Enchanted Book|giveNote=common-enchanted-book|multi=0.2|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Journeyman|slot=6|give=Glass|giveQuant=4|multi=0.05|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Expert|slot=7|want=Book and Quill|wantQuant=2|wantNote=book-and-quill-bug|wantNoteText=In {{JE}} only one is requested per trade because of {{bug|MC-248042||Librarian's book and quill trade is always discounted to 1 since books are unstackable}}.|multi=0.05|maxTrades=12|xpGain=30}}
|{{TradeLine|lvl=Expert|slot=8|wantQuant=5|give=Clock|multi=0.05|maxTrades=12|xpGain=15}}
|{{TradeLine|lvl=Expert|slot=8|wantQuant=4|give=Compass|multi=0.05|maxTrades=12|xpGain=15}}
|{{TradeLine|lvl=Master|slot=9|want2=Book|wantQuant=5-64|give=Enchanted Book|giveNote=special-enchanted-book|giveNoteText=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 in emeralds depends on the enchantment level and "treasure" status. The minimum price of a book is given by 2&nbsp;+&nbsp;3&nbsp;*&nbsp;(enchantment level), while the maximum price is 6&nbsp;+&nbsp;13&nbsp;*&nbsp;(enchantment level). 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–71 for Lvl V. For [[treasure enchantment]]s the price is doubled. The cost is capped at 64 emeralds. All values below this cap are equally probable.|multi=0.2|maxTrades=12|xpGain=30}}
|{{TradeLine|lvl=Master|slot=10|wantQuant=20|give=Name Tag|multi=0.05|maxTrades=12|xpGain=30}}
}}

{{anchor|Enchanted books}}{{anchor|Biome-dependent enchantments}}{{anchor|Biome-dependent librarian enchantments}}
** All enchantments used for the [[crossbow]], [[fishing rod]], [[trident]], and [[mace]] have been removed from trading.
:: {| class="wikitable" style="text-align:center"
|+ 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]]<br>[[Thorns]]<br>[[Infinity]]
| [[Punch]]<br>[[Smite]]<br>[[Bane of Arthropods]]
| [[Knockback]]<br>[[Curse of Binding]]<br>[[Sweeping Edge]]
| [[Aqua Affinity]]<br>[[Looting]]<br>[[Frost Walker]]
| [[Blast Protection]]<br>[[Fire Aspect]]<br>[[Flame]]
| [[Feather Falling]]<br>[[Projectile Protection]]<br>[[Power]]
| [[Depth Strider]]<br>[[Respiration]]<br>[[Curse of Vanishing]]
|}

{{anchor|Armorer}}
* 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.

{| class="wikitable mw-collapsible"
! colspan="8" |Biomes and corresponding armor
|-
![[Villager#Appearance|Appearance]] 
!{{EntitySprite|villager-desert}} Desert
!{{EntitySprite|villager-plains}} Plains
!{{EntitySprite|villager-savanna}} Savanna
!{{EntitySprite|villager-snowy}} Snowy
!{{EntitySprite|villager-taiga}} Taiga 
!{{EntitySprite|villager-jungle}} Jungle
!{{EntitySprite|villager-swamp}} Swamp
|-
! rowspan="4" |Expert 
|{{ItemLink|Iron Leggings}}<br> with [[Thorns]]
|{{ItemLink|Iron Leggings}}<br> with [[Protection]] I
|{{ItemLink|Iron Leggings}}<br> with [[Curse of Binding]]
| rowspan="2" |{{ItemLink|Iron Helmet}}<br> with [[Aqua Affinity]]
|{{ItemLink|Diamond Leggings}}
|{{ItemLink|Chainmail Helmet}}<br> with [[Unbreaking]] I
|{{ItemLink|Chainmail Helmet}}<br> with [[Mending]]
|-
|{{ItemLink|Iron Boots}}<br> with [[Thorns]]
|{{ItemLink|Iron Boots}}<br> with [[Protection]] I
|{{ItemLink|Iron Boots}}<br> with [[Curse of Binding]]
|{{ItemLink|Diamond Boots}}
|{{ItemLink|Chainmail Chestplate}}<br> with [[Unbreaking]] I
|{{ItemLink|Chainmail Chestplate}}<br> with [[Mending]]
|-
|{{ItemLink|Iron Helmet}}<br> with [[Thorns]]
|{{ItemLink|Iron Helmet}}<br> with [[Protection]] I
|{{ItemLink|Iron Helmet}}<br> with [[Curse of Binding]]
| rowspan="2" |{{ItemLink|Iron Boots}}<br> with [[Frost Walker]] I
|{{ItemLink|Diamond Helmet}}
|{{ItemLink|Chainmail Leggings}}<br> with [[Unbreaking]] I
|{{ItemLink|Chainmail Leggings}}<br> with [[Mending]]
|-
|{{ItemLink|Iron Chestplate}}<br> with [[Thorns]]
|{{ItemLink|Iron Chestplate}}<br> with [[Protection]] I
|{{ItemLink|Iron Chestplate}}<br> with [[Curse of Binding]]
|{{ItemLink|Diamond Chestplate}}
|{{ItemLink|Chainmail Boots}}<br> with [[Unbreaking]] I
|{{ItemLink|Chainmail Boots}}<br> with [[Mending]]
|-
! rowspan="3" |Master
|{{ItemLink|Diamond Chestplate}}<br> with [[Thorns]]
|{{ItemLink|Diamond Leggings}}<br> with [[Protection]] I
|{{ItemLink|Diamond Helmet}}<br> with [[Curse of Binding]]
|{{ItemLink|Diamond Helmet}}<br> with [[Aqua Affinity]]
|{{ItemLink|Diamond Chestplate}}<br> with [[Blast Protection]] I
|{{ItemLink|Chainmail Helmet}}<br> with [[Projectile Protection]] I
|{{ItemLink|Chainmail Helmet}}<br> with [[Respiration]] I
|-
|{{ItemLink|Diamond Leggings}}<br> with [[Thorns]]
|{{ItemLink|Diamond Boots}}<br> with [[Protection]] I
|{{ItemLink|Diamond Chestplate}}<br> with [[Curse of Binding]]
|{{ItemLink|Diamond Boots}}<br> with [[Frost Walker]] I
|{{ItemLink|Diamond Leggings}}<br> with [[Blast Protection]] I
|{{ItemLink|Chainmail Boots}}<br> with [[Feather Falling]] I
|{{ItemLink|Chainmail Boots}}<br> with [[Depth Strider]] I
|-
|{{ItemLink|Emerald}}
|{{ItemLink|Emerald}}
|{{ItemLink|Emerald}}
|{{ItemLink|Emerald}}
|{{ItemLink|Emerald}}
|{{ItemLink|Emerald}}
|{{ItemLink|Emerald}}
|}

{{anchor|Desert armorer}}
:: {{TradeTable|title=Desert Armorer Economic Trades|profession=Armorer|ignoreUsage=1
|{{TradeLine|lvl=Novice|want=Coal|wantQuant=15|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Novice|want=Iron Ingot|wantQuant=5|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Apprentice|wantQuant=4|give=Iron Boots|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=5|give=Iron Helmet|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=7|give=Iron Leggings|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=9|give=Iron Chestplate|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Journeyman|want=Lava Bucket|maxTrades=12|multi=0.05|xpGain=20}}
|{{TradeLine|lvl=Journeyman|wantQuant=5|give=Shield|maxTrades=12|multi=0.05|xpGain=10}}
|{{TradeLine|lvl=Journeyman|wantQuant=36|give=Bell|maxTrades=12|multi=0.2|xpGain=10}}
|{{TradeLine|lvl=Expert|wantQuant=8|give=Enchanted Iron Boots|giveNote=thorns-armor|giveNoteText=The armor piece is always enchanted with [[Thorns]] I.|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=9|give=Enchanted Iron Helmet|giveNote=thorns-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=11|give=Enchanted Iron Leggings|giveNote=thorns-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=13|give=Enchanted Iron Chestplate|giveNote=thorns-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Master|wantQuant=16|want2=Diamond|wantQuant2=4|give=Enchanted Diamond Chestplate|giveNote=thorns-armor|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|wantQuant=16|want2=Diamond|wantQuant2=3|give=Enchanted Diamond Leggings|giveNote=thorns-armor|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|want=Block of Iron|giveQuant=4|maxTrades=12|multi=0.05|xpGain=30}}
}}
{{anchor|Jungle armorer}}
:: {{TradeTable|title=Jungle Armorer Economic Trades|profession=Armorer|ignoreUsage=1
|{{TradeLine|lvl=Novice|want=Coal|wantQuant=15|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Novice|want=Iron Ingot|wantQuant=5|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Apprentice|wantQuant=4|give=Chainmail Boots|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=5|give=Chainmail Helmet|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=7|give=Chainmail Leggings|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=9|give=Chainmail Chestplate|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Journeyman|want=Lava Bucket|maxTrades=12|multi=0.05|xpGain=20}}
|{{TradeLine|lvl=Journeyman|wantQuant=5|give=Shield|maxTrades=12|multi=0.05|xpGain=10}}
|{{TradeLine|lvl=Journeyman|wantQuant=36|give=Bell|maxTrades=12|multi=0.2|xpGain=10}}
|{{TradeLine|lvl=Expert|wantQuant=8|give=Enchanted Chainmail Boots|giveNote=unbreaking-armor|giveNoteText=The armor piece is always enchanted with [[Unbreaking]] I.|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=9|give=Enchanted Chainmail Helmet|giveNote=unbreaking-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=11|give=Enchanted Chainmail Leggings|giveNote=unbreaking-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=13|give=Enchanted Chainmail Chestplate|giveNote=unbreaking-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Master|wantQuant=9|give=Enchanted Chainmail Helmet|giveNoteText=The armor piece is always enchanted with [[Projectile Protection]] I.|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|wantQuant=8|give=Enchanted Chainmail Boots|giveNoteText=The armor piece is always enchanted with [[Feather Falling]] I.|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|want=Block of Iron|giveQuant=4|maxTrades=12|multi=0.05|xpGain=30}}
}}
{{anchor|Plains armorer}}
:: {{TradeTable|title=Plains Armorer Economic Trades|profession=Armorer|ignoreUsage=1
|{{TradeLine|lvl=Novice|want=Coal|wantQuant=15|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Novice|want=Iron Ingot|wantQuant=5|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Apprentice|wantQuant=4|give=Iron Boots|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=5|give=Iron Helmet|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=7|give=Iron Leggings|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=9|give=Iron Chestplate|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Journeyman|want=Lava Bucket|maxTrades=12|multi=0.05|xpGain=20}}
|{{TradeLine|lvl=Journeyman|wantQuant=5|give=Shield|maxTrades=12|multi=0.05|xpGain=10}}
|{{TradeLine|lvl=Journeyman|wantQuant=36|give=Bell|maxTrades=12|multi=0.2|xpGain=10}}
|{{TradeLine|lvl=Expert|wantQuant=8|give=Enchanted Iron Boots|giveNote=protection-armor|giveNoteText=The armor piece is always enchanted with [[Protection]] I.|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=9|give=Enchanted Iron Helmet|giveNote=protection-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=11|give=Enchanted Iron Leggings|giveNote=protection-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=13|give=Enchanted Iron Chestplate|giveNote=protection-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Master|wantQuant=16|want2=Diamond|wantQuant2=3|give=Diamond Leggings|giveNote=protection-armor|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|wantQuant=16|want2=Diamond|wantQuant2=2|give=Diamond Boots|giveNote=protection-armor|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|want=Block of Iron|giveQuant=4|maxTrades=12|multi=0.05|xpGain=30}}
}}
{{anchor|Savanna armorer}}
:: {{TradeTable|title=Savanna Armorer Economic Trades|profession=Armorer|ignoreUsage=1
|{{TradeLine|lvl=Novice|want=Coal|wantQuant=15|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Novice|want=Iron Ingot|wantQuant=5|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Apprentice|wantQuant=4|give=Iron Boots|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=5|give=Iron Helmet|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=7|give=Iron Leggings|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=9|give=Iron Chestplate|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Journeyman|want=Lava Bucket|maxTrades=12|multi=0.05|xpGain=20}}
|{{TradeLine|lvl=Journeyman|wantQuant=5|give=Shield|maxTrades=12|multi=0.05|xpGain=10}}
|{{TradeLine|lvl=Journeyman|wantQuant=36|give=Bell|maxTrades=12|multi=0.2|xpGain=10}}
|{{TradeLine|lvl=Expert|wantQuant=2|give=Enchanted Iron Boots|giveNote=cob-armor|giveNoteText=The armor piece is always enchanted with [[Curse of Binding]].|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=3|give=Enchanted Iron Helmet|giveNote=cob-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=5|give=Enchanted Iron Leggings|giveNote=cob-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=7|give=Enchanted Iron Chestplate|giveNote=cob-armor|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Master|wantQuant=6|want2=Diamond|wantQuant2=2|give=Enchanted Diamond Helmet|giveNote=cob-armor|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|wantQuant=8|want2=Diamond|wantQuant2=3|give=Enchanted Diamond Chestplate|giveNote=cob-armor|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|want=Block of Iron|giveQuant=4|maxTrades=12|multi=0.05|xpGain=30}}
}}
{{anchor|Snow armorer}} {{anchor|Snowy armorer}}
:: {{TradeTable|title=Snowy Armorer Economic Trades|profession=Armorer|ignoreUsage=1
|{{TradeLine|lvl=Novice|want=Coal|wantQuant=15|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Novice|want=Iron Ingot|wantQuant=5|maxTrades=12|multi=0.05|xpGain=2}}
|{{TradeLine|lvl=Apprentice|wantQuant=4|give=Iron Boots|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=5|give=Iron Helmet|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=7|give=Iron Leggings|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Apprentice|wantQuant=9|give=Iron Chestplate|maxTrades=12|multi=0.05|xpGain=5}}
|{{TradeLine|lvl=Journeyman|want=Lava Bucket|maxTrades=12|multi=0.05|xpGain=20}}
|{{TradeLine|lvl=Journeyman|wantQuant=5|give=Shield|maxTrades=12|multi=0.05|xpGain=10}}
|{{TradeLine|lvl=Journeyman|wantQuant=36|give=Bell|maxTrades=12|multi=0.2|xpGain=10}}
|{{TradeLine|lvl=Expert|wantQuant=8|give=Enchanted Iron Boots|giveNote=frost-walker-boots|giveNoteText=These boots are always enchanted with [[Frost Walker]] I.|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|wantQuant=9|give=Enchanted Iron Helmet|giveNote=aqua-affinity-helm|giveNoteText=This helmet is always enchanted with [[Aqua Affinity]].|maxTrades=3|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Master|wantQuant=12|want2=Diamond|wantQuant2=2|give=Enchanted Diamond Boots|giveNote=frost-walker-boots|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|wantQuant=12|want2=Diamond|wantQuant2=3|give=Enchanted Diamond Helmet|giveNote=aqua-affinity-helm|maxTrades=3|multi=0.05|xpGain=30}}
|{{TradeLine|lvl=Master|want=Block of Iron|giveQuant=4|maxTrades=12|multi=0.05|xpGain=30}}
}}
{{anchor|Swamp armorer}}
:: {| class="wikitable" style="text-align:center"
|+ Current version of trades for swamp armorers
|-
! Level !! Item wanted !! Default quantity !! Price multiplier !! Item given !! Quantity !! Trades until disabled !! XP to villager
|-
! rowspan=2 | Novice
| {{ItemLink|Coal}} || 15 || 0.05 || {{ItemLink|Emerald}} || 1 || 12 || 2
|-
| {{ItemLink|Iron Ingot}} || 5 || 0.05 || {{ItemLink|Emerald}} || 1 || 12 || 2
|-
! rowspan=4 | Apprentice
| {{ItemLink|Emerald}} || 4 || 0.05 || {{ItemLink|Chainmail Boots}} || 1 || 12 || 5
|-
| {{ItemLink|Emerald}} || 5 || 0.05 || {{ItemLink|Chainmail Helmet}} || 1 || 12 || 5
|-
| {{ItemLink|Emerald}} || 7 || 0.05 || {{ItemLink|Chainmail Leggings}} || 1 || 12 || 5
|-
| {{ItemLink|Emerald}} || 9 || 0.05 || {{ItemLink|Chainmail Chestplate}} || 1 || 12 || 5
|-
! rowspan=3 | Journeyman
| {{ItemLink|Lava Bucket}} || 1 || 0.05 || {{ItemLink|Emerald}} || 1 || 12 || 20
|-
| {{ItemLink|Emerald}} || 5 || 0.05 || {{ItemLink|Shield}} || 1 || 12 || 10
|-
| {{ItemLink|Emerald}} || 36 || 0.2 || {{ItemLink|Bell}} || 1 || 12 || 10
|-
! rowspan=4 | Expert
| {{ItemLink|Emerald}} || 8 || 0.05 || {{ItemLink|Chainmail Boots}} (Mending) || 1 || 3 || 15
|-
| {{ItemLink|Emerald}} || 9 || 0.05 || {{ItemLink|Chainmail Helmet}} (Mending) || 1 || 3 || 15
|-
| {{ItemLink|Emerald}} || 11 || 0.05 || {{ItemLink|Chainmail Leggings}} (Mending) || 1 || 3 || 15
|-
| {{ItemLink|Emerald}} || 13 || 0.05 || {{ItemLink|Chainmail Chestplate}} (Mending) || 1 || 3 || 15
|-
! rowspan=3 | Master
| {{ItemLink|Emerald}} || 9 || 0.05 || {{ItemLink|Chainmail Helmet}} (Respiration I) || 1 || 3 || 30
|-
| {{ItemLink|Emerald}} || 8 || 0.05 || {{ItemLink|Chainmail Boots}} (Depth Strider I) || 1 || 3 || 30
|-
| {{BlockLink|Block of Iron}} || 1 || 0.05 || {{ItemLink|Emerald}} || 4 || 12 || 30
|}
{{anchor|Taiga armorer}}
:: {| class="wikitable" style="text-align:center"
|+ Current version of trades for taiga armorers
|-
! Level !! Item wanted !! Default quantity !! Price multiplier !! Item given !! Quantity !! Trades until disabled !! XP to villager
|-
! rowspan=2 | Novice
| {{ItemLink|Coal}} || 15 || 0.05 || {{ItemLink|Emerald}} || 1 || 12 || 2
|-
| {{ItemLink|Iron Ingot}} || 5 || 0.05 || {{ItemLink|Emerald}} || 1 || 12 || 2
|-
! rowspan=4 | Apprentice
| {{ItemLink|Emerald}} || 4 || 0.05 || {{ItemLink|Iron Boots}} || 1 || 12 || 5
|-
| {{ItemLink|Emerald}} || 5 || 0.05 || {{ItemLink|Iron Helmet}} || 1 || 12 || 5
|-
| {{ItemLink|Emerald}} || 7 || 0.05 || {{ItemLink|Iron Leggings}} || 1 || 12 || 5
|-
| {{ItemLink|Emerald}} || 9 || 0.05 || {{ItemLink|Iron Chestplate}} || 1 || 12 || 5
|-
! rowspan=3 | Journeyman
| {{ItemLink|Lava Bucket}} || 1 || 0.05 || {{ItemLink|Emerald}} || 1 || 12 || 20
|-
| {{ItemLink|Emerald}} || 5 || 0.05 || {{ItemLink|Shield}} || 1 || 12 || 10
|-
| {{ItemLink|Emerald}} || 36 || 0.2 || {{ItemLink|Bell}} || 1 || 12 || 10
|-
! rowspan=4 | Expert
| {{ItemLink|Emerald}}<br>{{ItemLink|Diamond Boots}} || 4<br>1 || 0.05 || {{ItemLink|Diamond Leggings}} || 1 || 3 || 15
|-
| {{ItemLink|Emerald}}<br>{{ItemLink|Diamond Leggings}} || 4<br>1 || 0.05 || {{ItemLink|Diamond Chestplate}} || 1 || 3 || 15
|-
| {{ItemLink|Emerald}}<br>{{ItemLink|Diamond Helmet}} || 4<br>1 || 0.05 || {{ItemLink|Diamond Boots}} || 1 || 3 || 15
|-
| {{ItemLink|Emerald}}<br>{{ItemLink|Diamond Chestplate}} || 2<br>1 || 0.05 || {{ItemLink|Diamond Helmet}} || 1 || 3 || 15
|-
! rowspan=3 | Master
| {{ItemLink|Emerald}}<br>{{ItemLink|Diamond}} || 18<br>4 || 0.05 || {{ItemLink|Diamond Chestplate}} (Blast Protection I) || 1 || 3 || 30
|-
| {{ItemLink|Emerald}}<br>{{ItemLink|Diamond}} || 18<br>3 || 0.05 || {{ItemLink|Diamond Leggings}} (Blast Protection I) || 1 || 3 || 30
|-
| {{BlockLink|Block of Diamond}} || 1 || 0.05 || {{ItemLink|Emerald}} || 42 || 12 || 30
|}

== 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.<ref group=note name=nonatural />
** 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. {{anchor|Forementioned}}
[[File:Villager Trade Reblance Cartographer.png|thumb|500px|An image referring to how the different maps for the different village types are connected.]]
:[[File:Village Graph.png|thumb|A graph showing where each type of cartographer's maps leads to]]
{{anchor|Biome-dependent cartographer trades}}{{anchor|Biome-dependent maps}}{{anchor|Village maps}}{{anchor|Cartographer}}
:: {| class="wikitable" style="text-align:center"
|+ 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 || &ndash; || Jungle Explorer Map || Swamp Explorer Map || Jungle Explorer Map || Swamp Explorer Map
|}
{{TradeTable|title=Cartographer Economic Trades|profession=Cartographer|ignoreUsage=1
|{{TradeLine|lvl=Novice|slot=1|want=Paper|wantQuant=24|multi=0.05|maxTrades=16|xpGain=2}}
|{{TradeLine|lvl=Novice|slot=2|wantQuant=7|give=Empty Map|multi=0.05|maxTrades=12|xpGain=1}}
|{{TradeLine|lvl=Apprentice|slot=3|want=Glass Pane|wantQuant=11|multi=0.05|maxTrades=16|xpGain=10}}
|{{TradeLine|lvl=Apprentice|slot=4|wantQuant=8|want2=Compass|give=Explorer Map|giveSprite=Map|giveNoteText=The structure that the map leads to depends on the biome the villager is from. See [[#Forementioned|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.|multi=0.2|maxTrades=12|xpGain=5|weight=3}}
|{{TradeLine|lvl=Journeyman|slot=5|want=Compass|multi=0.05|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Journeyman|slot=5|want2=Compass|wantQuant=13|give=Ocean Explorer Map|giveNote=explorer_map|giveNoteText={{in|java}}, 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}}, Cartographers adopting the profession in the Nether or the End do not offer explorer maps.|multi=0.2|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Journeyman|slot=6|wantQuant=12|want2=Compass|give=Trial Explorer Map|giveNote=explorer_map|multi=0.2|maxTrades=12|xpGain=10}}
|{{TradeLine|lvl=Expert|slot=7|wantQuant=7|give=Item Frame|maxTrades=12|multi=0.05|xpGain=15}}
|{{TradeLine|lvl=Expert|slot=8|wantQuant=3|multi=0.05|give=Any color Banner|maxTrades=12|xpGain=15|giveNoteText=The list of possible offers contains individual offers for each color, so multiple colors may be offered by the same villager as separate trades.|weight=16}}
|{{TradeLine|lvl=Master|slot=9|wantQuant=8|multi=0.05|give=Globe Banner Pattern|maxTrades=12|xpGain=30}}
|{{TradeLine|lvl=Master|slot=10|wantQuant=14|want2=Compass|multi=0.2|give=Woodland Explorer Map|maxTrades=12|xpGain=30}}
}}

{{anchor|Wandering traders}}
* 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:
:: {| class="wikitable"
|+ New trades of wandering traders
! Category
! Item wanted
! Quantity
! Item given
! Quantity
! Trades until disabled
|-
| Buying
| {{ItemLink|Baked Potato}}
| 4
| {{ItemLink|Emerald}}
| 1
| 1
|-
| Buying
| {{ItemLink|Fermented Spider Eye}}
| 1
| {{ItemLink|Emerald}}
| 3
| 1
|-
| Buying
| {{BlockLink|Hay Bale}}
| 1
| {{ItemLink|Emerald}}
| 1
| 1
|-
| Buying
| {{ItemLink|Milk Bucket}}
| 1
| {{ItemLink|Emerald}}
| 2
| 1
|-
| Buying
| {{ItemLink|Water Bottle}}
| 1
| {{ItemLink|Emerald}}
| 1
| 1
|-
| Buying
| {{ItemLink|Water Bucket}}
| 1
| {{ItemLink|Emerald}}
| 2
| 1
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Acacia Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Birch Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Cherry Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Dark Oak Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 6-20
| {{ItemLink|Iron Pickaxe}} (Enchanted)
| 1
| 1
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Jungle Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Oak Log}}
| 8
| 4
|-
| Special Selling
| {{ItemLink|Emerald}}
| 5
| {{ItemLink|Potion of Invisibility}} (Long)
| 1
| 1
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Spruce Log}}
| 8
| 4
|}
:: {| class="wikitable"
|+ Changed trades of wandering traders
! Category
! Item wanted
! Quantity
! Item given
! Quantity
! Trades until disabled
|-
| Special Selling
| {{ItemLink|Emerald}}
| 1
| {{ItemLink|Gunpowder}}
| 1 → 4
| 8 → 2
|-
| Special Selling
| {{ItemLink|Emerald}}
| 3 → 1
| {{BlockLink|Packed Ice}}
| 1
| 6
|-
| Special Selling → Ordinary Selling
| {{ItemLink|Emerald}}
| 5 → 3
| {{ItemLink|Bucket of Pufferfish}}
| 1
| 4
|-
| Special Selling → Ordinary Selling
| {{ItemLink|Emerald}}
| 5 → 3
| {{ItemLink|Bucket of Tropical Fish}}
| 1
| 4
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Lily Pad}}
| 2 → 5
| 5 → 2
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Brown Mushroom}}
| 1 → 3
| 12 → 4
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Red Mushroom}}
| 1 → 3
| 12 → 4
|-
| Ordinary Selling
| {{ItemLink|Emerald}}
| 1
| {{BlockLink|Vines}}
| 1 → 3
| 12 → 4
|}

== History ==
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.20.2|dev=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 [[trident]]s, [[crossbow]]s and [[fishing rod]]s 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.}}
|{{HistoryLine|||dev=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.}}
|{{HistoryLine||1.20.5|dev=24w03a|Villagers who buy armor now ignore durability and can buy damaged armor.}}
|{{HistoryLine||1.21.5|dev=25w07a|Updated trades for cartographers and wandering traders have been fully implemented and are no longer hidden behind the "Villager Trade Rebalance" experimental toggle.}}

|{{HistoryLine|bedrock}}
|{{HistoryLine||1.20.30|dev=Preview 1.20.30.20|Added the "Villager Trade Rebalance" 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 [[trident]]s, [[crossbow]]s and [[fishing rod]]s 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.}}
|{{HistoryLine||1.20.40|dev=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.}}
|{{HistoryLine||1.21.70|dev=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 Rebalance" experimental toggle.}}
}}

== Notes ==
{{notelist}}

== References ==
{{reflist}}

== Navigation ==
{{Navbox Experiments}}

[[ja:村人の取引の再調整]]
[[pt:Rebalanceamento das trocas dos aldeões]]
[[ru:Балансировка торговли]]
Description	What you type	What you get
Italic	''Italic text''	Italic text
Bold	'''Bold text'''	Bold text
Bold & italic	'''''Bold & italic text'''''	*Bold & italic text*
Description	What you type	What you get
Reference	Page text.<ref>[https://www.example.org/ Link text], additional text.</ref>	Page text.^[1]
Named reference	Page text.<ref name="test">[https://www.example.org/ Link text]</ref>	Page text.^[2]
Additional use of the same reference	Page text.<ref name="test" />	Page text.^[2]
Display references	<references />	↑ Link text, additional text. ↑ Link text