Java Edition:Pre-1.8 Villager

Villager Enchant Trade.png

1.8 saw the replacement of nearly the entire trading system, changing many trades, introducing careers, and changing how trades were unlocked. Due to this, from 12w32a (a 1.4 snapshot) to 1.7.10, many trades were available that are not possible in later versions. There are many possibilities of trades due to both randomized item counts and randomized trade ordering. For trades before 12w32a, see Pre-1.4 Trades.

Mechanics

As villagers worked quite differently in these versions, their trade mechanics can be somewhat unintuitive and confusing. This section serves as a brief overview for unfamiliar players.

Villagers will attempt to generate a new trade in two ways. The first is upon initial spawning, and the second is when the villager restocks. When the villager restocks, the following occurs:

  1. All currently locked trades will have 2 to 12 maxUses added, restocking them.
  2. Each possible trade has a weighted chance based on the amount of trades the villager has to be added to a list. This weighting causes rarer trades to be more likely with more trades generated and vice versa.[notes 1]
  3. After each possible trade has been iterated through, the game will check if the list is empty. If it is, it will insert a gold buy trade for 8-9 gold ingots for 1 emerald.
  4. A random trade is selected from the list.
  5. The villager's current trade list will be searched for a trade that has the following properties:
    • The first buy slot items have the same ID.
    • If the second buy slot is empty, the count of the first buy slot of the new trade is less than the found trade.
    • If the second buy slot is not empty, the IDs of the second buy slot items match and the count of the second buy slot of the new trade is less than the found trade.
  6. If a matching trade is found, the new trade replaces it. Otherwise, the new trade is added to the end of the trade list.

Whenever the player makes a trade with a villager, the following occurs:

  1. The trade's uses value is increased by one.
  2. If the trade is the last trade in the villager's list, the villager queues a trade generation in 40 ticks.
  3. If the trade's uses is equal to its maxUses, it will be locked.

When the player leaves the trading GUI, the trade generation counter will begin to count down. When it reaches 0, a trade generation will occur. Villagers do not allow infinite trading anymore, as trade locking has been introduced to replace the 1.3 trade removal mechanic.

Additionally, a bug with how villager data was serialized to NBT allowed for any trade generation that was queued to be forgotten. If the villager is unloaded and saved to disk before the trade generation counter reaches 0, the villager will not process the trade generation. This will result in the villager not gaining any trades or restocking, which can potentially softlock the villager by locking the last trade.

Possible Trades

These are all of the trades from the five professions. The 1.8 - 1.13 and 1.14 - 25w42a (present) status reveals if the specific trade was possible during that span of villager trades.

Legend

Availability Meaning
Unavailable The items of the trade are not obtainable
Quantities Unavailable The items of the trade are available but only in different counts than the trades available pre-1.8
Certain Quantities The items of the trade are available and some of the quantities are available but other quantities are not
Available The trade, including its quantities, are fully obtainable
Other Special cases, check reference for more information

Professions

When updating farmers to 1.8 and beyond, they have a random chance of being assigned to either a farmer, fisherman, fletcher, or shepherd when a trade generation is performed. When updated to 1.14 and beyond without a trade generation being performed, they will always be farmers.

Buy 1 Item Buy 1 Count Buy 2 Item Buy 2 Count Sell Item Sell Count Weight 1.8 - 1.13 Status 1.14 - Present Status
Gold Ingot 2.png Gold Ingot 8-9 Emerald JE1 BE1.png Emerald 1 N/A Unavailable Unavailable
Wheat 1.png Wheat 18-21 Emerald JE1 BE1.png Emerald 1 0.9 Available[Farmer 1] Certain Quantities[Farmer 2]
White Wool 1.png Wool[Farmer 3] 14-21 Emerald JE1 BE1.png Emerald 1 0.5 Certain Quantities[Farmer 4] Certain Quantities[Farmer 5]
Raw Chicken 2.png Raw Chicken 14-17 Emerald JE1 BE1.png Emerald 1 0.5 Unavailable[Farmer 6] Unavailable[Farmer 7]
Cooked Fish.png Cooked Cod[Farmer 3] 9-12 Emerald JE1 BE1.png Emerald 1 0.4 Unavailable Unavailable
Emerald JE1 BE1.png Emerald 1 Bread 2.png Bread 3-4 0.9 Available[Farmer 1] Quantities Unavailable
Emerald JE1 BE1.png Emerald 1 Melon Slice 1.png Melon 5-8 0.3 Unavailable Unavailable
Emerald JE1 BE1.png Emerald 1 Apple 2.png Apple 5-8 0.3 Other[Farmer 8] Quantities Unavailable
Emerald JE1 BE1.png Emerald 1 Cookie 1.png Cookie 8-10 0.3 Other[Farmer 9] Quantities Unavailable
Emerald JE1 BE1.png Emerald 3 Shears 1.png Shears 1 0.3 Available[Farmer 1] Quantities Unavailable
Emerald JE1 BE1.png Emerald 3 Flint and Steel 3.png Flint and Steel 1 0.3 Unavailable Unavailable
Emerald JE1 BE1.png Emerald 1 Cooked Chicken 2.png Cooked Chicken 7-8 0.3 Unavailable[Farmer 6] Unavailable[Farmer 7]
Emerald JE1 BE1.png Emerald 1 Arrow 1.png Arrow 9-12 0.5 Available[Farmer 1] Quantities Unavailable
Gravel 4.png Gravel[Farmer 10] 10 Emerald JE1 BE1.png Emerald 1 Flint 2.png Flint 4-5 0.5 Quantities Unavailable Quantities Unavailable
  1. 1.0 1.1 1.2 1.3 Only available on the farmer career.
  2. The only quantity available in 1.14 - 25w42a (present) is 20 wheat for 1 emerald.
  3. 3.0 3.1 Damage values are ignored when trading in versions before 14w02a (a 1.8 snapshot), meaning all colors of wool and cooked salmon are accepted.
  4. The quantities available in 1.8 - 1.13 are 16-21 wool for 1 emerald. Only available on the shepherd career.
  5. The only quantity available in 1.14 - 25w42a (present) is 18 wool for 1 emerald. Only available on the shepherd career.
  6. 6.0 6.1 This trade is available, but only under the butcher career, which farmers cannot become.
  7. 7.0 7.1 Certain quantities of this trade are available, but only under the butcher career, which farmers cannot become.
  8. The only quantity available from 1.8 to 16w32b (a 1.11 snapshot) was 1 emerald for 5 apples. The quantities available from 16w33a to 1.13 are 1 emerald for 5-7 apples. Both only available on the farmer career.
  9. The only quantity available from 1.8 to 16w32b (a 1.11 snapshot) was 1 emerald for 6 cookies. The quantities available from 16w33a to 1.13 are 1 emerald for 6-10 cookies. Both only available on the farmer career.
  10. The gravel trade was added in 12w22a (a 1.3 snapshot) with the introduction of the second buy slot.

When updating librarians to 1.8 and beyond, they normally can only become librarians upon trade generation, as no variant careers originally existed. However, when cartographers were added in 16w39a (a 1.11 snapshot), pre-1.8 villagers gained the ability to also become cartographers when a trade generation was performed. When updated to 1.14 and beyond without a trade generation being performed, they will always be librarians.

Buy 1 Item Buy 1 Count Buy 2 Item Buy 2 Count Sell Item Sell Count Weight 1.8 - 1.13 Status 1.14 - Present Status
Gold Ingot 2.png Gold Ingot 8-9 Emerald JE1 BE1.png Emerald 1 N/A Unavailable Unavailable
Paper 1.png Paper 24-35 Emerald JE1 BE1.png Emerald 1 0.8 Available Certain Quantities[Librarian 1]
Book 1.png Book 11-12 Emerald JE1 BE1.png Emerald 1 0.8 Quantities Unavailable Quantities Unavailable
Written Book Icon.gif Written Book 1 Emerald JE1 BE1.png Emerald 1 0.3 Quantities Unavailable Unavailable
Emerald JE1 BE1.png Emerald 3 Bookshelf 2.png Bookshelf 1 0.8 Available[Librarian 2] Quantities Unavailable
Emerald JE1 BE1.png Emerald 1 Glass 3.png Glass 4-5 0.2 Available[Librarian 2] Certain Quantities[Librarian 3]
Emerald JE1 BE1.png Emerald 10-11 Compass 1.png Compass 1 0.2 Available[Librarian 4] Quantities Unavailable
Emerald JE1 BE1.png Emerald 10-11 Clock 2.png Clock 1 0.2 Available[Librarian 2] Quantities Unavailable
Book 1.png Book[Librarian 5] 1 Emerald JE1 BE1.png Emerald 5-71[Librarian 6] Enchanted Book Icon.gif Enchanted Book[Librarian 7] 1 0.07 Certain Quantities[Librarian 8] Unavailable[Librarian 9]
  1. The only quantity available in 1.14 - 25w42a (present) is 24 paper for 1 emerald.
  2. 2.0 2.1 2.2 Only available on the librarian career.
  3. The only quantity available in 1.14 - 25w42a (present) is 1 emerald for 4 glass. Only available on librarian career.
  4. Only available on the cartographer career.
  5. The enchanted book sell trade was added in 12w50a (a 1.4.6 snapshot).
  6. Overstacked Emeralds Buy Trade
  7. A random enchantment and a random level between 1 and the maximum legitimate level is chosen.
  8. The second buy slot count in 1.8 - 1.13 is 5-64. Only available on the librarian career.
  9. Enchanted books are available from librarians in 1.14 - 25w42a (present), but the first and second buy slots are reversed.

When updating priests to 1.8 and beyond, they will always be clerics upon trade generation. When updated to 1.14 and beyond, they will always become clerics.

Buy 1 Item Buy 1 Count Buy 2 Item Buy 2 Count Sell Item Sell Count Weight 1.8 - 1.13 Status 1.14 - Present Status
Gold Ingot 2.png Gold Ingot 8-9 Emerald JE1 BE1.png Emerald 1 N/A Available Quantities Unavailable
Emerald JE1 BE1.png Emerald 7-10 Eye of Ender 1.png Eye of Ender 1 0.3 Other[Priest 1] Unavailable
Emerald JE1 BE1.png Emerald 1 Bottle o Enchanting Icon.gif Bottle o' Enchanting 2-4 0.2 Quantities Unavailable Quantities Unavailable
Emerald JE1 BE1.png Emerald 1 Redstone 1.png Redstone 2-4 0.4 Available Certain Quantities[Priest 2]
Emerald JE1 BE1.png Emerald 1 Glowstone 2.png Glowstone 2-3 0.3 Available Quantities Unavailable
Iron Sword 1.png Iron Sword[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Iron Sword Icon.gif Enchanted Iron Sword[Priest 4] 1 0.05 Unavailable Unavailable
Iron Pickaxe 1.png Iron Pickaxe[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Iron Pickaxe Icon.gif Enchanted Iron Pickaxe[Priest 4] 1 0.05 Unavailable Unavailable
Iron Axe 4.png Iron Axe[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Iron Axe Icon.gif Enchanted Iron Axe[Priest 4] 1 0.05 Unavailable Unavailable
Iron Chestplate 1.png Iron Chestplate[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Iron Chestplate Icon.gif Enchanted Iron Chestplate[Priest 4] 1 0.05 Unavailable Unavailable
Diamond Sword 1.png Diamond Sword[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Diamond Sword Icon.gif Enchanted Diamond Sword[Priest 4] 1 0.05 Unavailable Unavailable
Diamond Pickaxe 1.png Diamond Pickaxe[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Diamond Pickaxe Icon.gif Enchanted Diamond Pickaxe[Priest 4] 1 0.05 Unavailable Unavailable
Diamond Axe 1.png Diamond Axe[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Diamond Axe Icon.gif Enchanted Diamond Axe[Priest 4] 1 0.05 Unavailable Unavailable
Diamond Chestplate 1.png Diamond Chestplate[Priest 3] 1 Emerald JE1 BE1.png Emerald 2-4 Enchanted Diamond Chestplate Icon.gif Enchanted Diamond Chestplate[Priest 4] 1 0.05 Unavailable Unavailable
  1. Possible from 14w02a to 15w40b, see Eye of Ender Sell Trade.
  2. The quantity available in 1.14 - 25w42a (present) is 1 emerald for 2 redstone.
  3. 3.0 3.1 3.2 3.3 3.4 3.5 3.6 3.7 Enchantment trades were added in 12w22a (a 1.3 snapshot) with the introduction of the second buy slot. Damage values and NBT data are ignored when trading in versions before 14w02a (a 1.8 snapshot), meaning damaged and enchanted items are accepted.
  4. 4.0 4.1 4.2 4.3 4.4 4.5 4.6 4.7 Enchanted with a random enchanting table level from 5 to 19.

When updating blacksmiths to 1.8 and beyond, they have a random chance of being assigned to either an armorer, toolsmith, or weaponsmith when a trade generation is performed. When updated to 1.14 and beyond without a trade generation being performed, they will always be armorers.

Buy 1 Item Buy 1 Count Buy 2 Item Buy 2 Count Sell Item Sell Count Weight 1.8 - 1.13 Status 1.14 - Present Status
Gold Ingot 2.png Gold Ingot 8-9 Emerald JE1 BE1.png Emerald 1 0.5[Blacksmith 1] Unavailable Unavailable
Coal.png Coal[Blacksmith 2] 16-23 Emerald JE1 BE1.png Emerald 1 0.7 Available Quantities Unavailable
Iron Ingot 2.png Iron Ingot 8-9 Emerald JE1 BE1.png Emerald 1 0.5 Available Quantities Unavailable
Diamond 2.png Diamond 4-5 Emerald JE1 BE1.png Emerald 1 0.5 Certain Quantities[Blacksmith 3] Quantities Unavailable
Emerald JE1 BE1.png Emerald 7-10 Iron Sword 1.png Iron Sword 1 0.5 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 6-7 Iron Axe 4.png Iron Axe 1 0.3 Available[Blacksmith 6] Quantities Unavailable
Emerald JE1 BE1.png Emerald 7-8 Iron Pickaxe 1.png Iron Pickaxe 1 0.5 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 4-5 Iron Shovel 2.png Iron Shovel 1 0.2 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 4-5 Iron Hoe 1.png Iron Hoe 1 0.2 Unavailable Unavailable
Emerald JE1 BE1.png Emerald 12-13 Diamond Sword 1.png Diamond Sword 1 0.5 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 9-11 Diamond Axe 1.png Diamond Axe 1 0.3 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 10-11 Diamond Pickaxe 1.png Diamond Pickaxe 1 0.5 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 7 Diamond Shovel 1.png Diamond Shovel 1 0.2 Unavailable Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 7 Diamond Hoe 1.png Diamond Hoe 1 0.2 Unavailable Quantities Unavailable
Emerald JE1 BE1.png Emerald 4-5 Iron Helmet 1.png Iron Helmet 1 0.2 Available[Blacksmith 7] Certain Quantities[Blacksmith 7][Blacksmith 8]
Emerald JE1 BE1.png Emerald 10-13 Iron Chestplate 1.png Iron Chestplate 1 0.2 Available[Blacksmith 7] Quantities Unavailable
Emerald JE1 BE1.png Emerald 8-9 Iron Leggings 1.png Iron Leggings 1 0.2 Unavailable Quantities Unavailable
Emerald JE1 BE1.png Emerald 4-5 Iron Boots 1.png Iron Boots 1 0.2 Unavailable Certain Quantities[Blacksmith 7][Blacksmith 9]
Emerald JE1 BE1.png Emerald 7 Diamond Helmet 1.png Diamond Helmet 1 0.2 Unavailable Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 16-18 Diamond Chestplate 1.png Diamond Chestplate 1 0.2 Unavailable[Blacksmith 4] Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 11-13 Diamond Leggings 1.png Diamond Leggings 1 0.2 Unavailable Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 7 Diamond Boots 1.png Diamond Boots 1 0.2 Unavailable Unavailable[Blacksmith 5]
Emerald JE1 BE1.png Emerald 5-6 Chainmail Helmet 1.png Chainmail Helmet 1 0.1 Available[Blacksmith 7] Quantities Unavailable
Emerald JE1 BE1.png Emerald 11-14 Chainmail Chestplate 1.png Chainmail Chestplate 1 0.1 Available[Blacksmith 7] Quantities Unavailable
Emerald JE1 BE1.png Emerald 9-10 Chainmail Leggings 1.png Chainmail Leggings 1 0.1 Available[Blacksmith 7] Quantities Unavailable
Emerald JE1 BE1.png Emerald 5-6 Chainmail Boots 1.png Chainmail Boots 1 0.1 Available[Blacksmith 7] Quantities Unavailable
  1. This does not account for the additional chance of the backup gold trade being generated.
  2. Damage values are ignored when trading in versions before 14w02a (a 1.8 snapshot), meaning charcoal and Invalid Data Value Coal are accepted.
  3. The only quantity available in 1.8 - 1.13 is 3-4 diamonds for 1 emerald.
  4. 4.0 4.1 4.2 4.3 4.4 4.5 4.6 These items were available as a trade in 1.8 - 1.13, however they were only available enchanted.
  5. 5.00 5.01 5.02 5.03 5.04 5.05 5.06 5.07 5.08 5.09 5.10 These items are available as a trade in 1.14 - 25w42a (present), however they are only available enchanted.
  6. Only available on the weaponsmith career.
  7. 7.0 7.1 7.2 7.3 7.4 7.5 7.6 7.7 Only available on the armorer career.
  8. The only quantity available in 1.14 - 25w42a (present) is 5 emeralds for 1 iron helmet.
  9. The only quantity available in 1.14 - 25w42a (present) is 4 emeralds for 1 pair of iron boots.

When updating butchers to 1.8 and beyond, they have a random chance of being assigned to either a butcher or a leatherworker when a trade generation is performed. When updated directly to 1.14 and beyond without a trade generation being performed, they will always be butchers.

Buy 1 Item Buy 1 Count Buy 2 Item Buy 2 Count Sell Item Sell Count Weight 1.8 - 1.13 Status 1.14 - Present Status
Gold Ingot 2.png Gold Ingot 8-9 Emerald JE1 BE1.png Emerald 1 N/A Unavailable Unavailable
Coal.png Coal[Butcher 1] 16-23 Emerald JE1 BE1.png Emerald 1 0.7 Unavailable Unavailable
Raw Porkchop 2.png Raw Porkchop 14-17 Emerald JE1 BE1.png Emerald 1 0.5 Available[Butcher 2] Quantities Unavailable[Butcher 2]
Raw Beef 3.png Raw Beef 14-17 Emerald JE1 BE1.png Emerald 1 0.5 Unavailable Quantities Unavailable[Butcher 2]
Emerald JE1 BE1.png Emerald 6-7 Saddle 1.png Saddle 1 0.1 Quantities Unavailable[Butcher 3] Certain Quantities[Butcher 3][Butcher 4]
Emerald JE1 BE1.png Emerald 2-3 Leather Cap 3.png Leather Cap 1 0.3 Unavailable Unavailable[Butcher 5]
Emerald JE1 BE1.png Emerald 4 Leather Tunic 3.png Leather Tunic 1 0.3 Unavailable[Butcher 6] Unavailable[Butcher 5]
Emerald JE1 BE1.png Emerald 2-3 Leather Pants 3.png Leather Leggings 1 0.3 Available[Butcher 3] Unavailable[Butcher 5]
Emerald JE1 BE1.png Emerald 2-3 Leather Boots 3.png Leather Boots 1 0.3 Unavailable Unavailable[Butcher 5]
Emerald JE1 BE1.png Emerald 1 Cooked Porkchop 3.png Cooked Porkchop 6-7 0.3 Available[Butcher 2] Quantities Unavailable[Butcher 2]
Emerald JE1 BE1.png Emerald 1 Steak 3.png Steak 6-7 0.3 Unavailable Unavailable
  1. Damage values are ignored when trading in versions before 14w02a (a 1.8 snapshot), meaning charcoal and Invalid Data Value Coal are accepted.
  2. 2.0 2.1 2.2 2.3 2.4 Only available on the butcher career.
  3. 3.0 3.1 3.2 Only available on the leatherworker career.
  4. The quantity available in 1.14 - 25w42a (present) is 6 emeralds for 1 saddle.
  5. 5.0 5.1 5.2 5.3 This trade is available in 1.14 - 25w42a (present), however the armor will always be dyed. The color will be the combination of 2 random dye colors, which can be the same.
  6. This trade was available in 1.8 - 1.13, however it is only available enchanted.

Retaining

When updating older villagers to newer versions, certain precautions must be taken to preserve their trades. Villagers may mostly be safely be updated from 1.4 to 1.13 without any loss of trades, barring any other miscellaneous entity upgrade issues. Loading villagers from 13w36a to 13w39b (1.7 snapshots) will cause second buy slot removal. When loaded in any version from 19w11a (a 1.14 snapshot) to 1.14 Pre-Release 3, you must trade at least once, as upon updating to 1.14 Pre-Release 4 or newer, villagers that have 0 experience and that do not have a workstation will revert to unemployed villagers, losing their trades. If a villager is directly updated from before 1.14 Pre-Release 4 to 1.14.1 Pre-Release 1 or newer, this step may be skipped if the villager has at least 4 trades or a 1.8 - 1.13 career level above 1.

As a result of the addition of careers in 1.8, pre-1.8 villagers will default to a career ID of 0. From 1.8 to 1.13, they will maintain this until they restock, where they will be assigned a random career.

Upon updating to 19w11a and above, if the villager still has a career ID of 0, they will always have a specific career assigned, as noted in the possible trades section of this page. Additionally, all trades will gain the priceMultiplier:0.0f tag, which is unique to pre-1.14 trades. This means that no discount will ever be applied to these trades.

Uses

Overstacking

The enchantment trades on a priest and a trade on the librarian can be used to overstack the items it enchants. This method works from 19w13b (1.14 snapshot) to 1.14.1. The items that can be overstacked by the priest are iron swords, iron axes, iron pickaxes, iron chestplates, diamond swords, diamond axes, diamond pickaxes, and diamond chestplates. The librarian can overstack written books.

Uncraftable Item Crafted Statistics

Due to a glitch,[1] trades are counted as crafting that item. Because of this, after 17w47a (1.13 snapshot)[test], the villager can be used to get crafting statistics for uncraftable items. The apple, bottle o' enchanting, chainmail helmet, chainmail chestplate, chainmail leggings, chainmail boots, enchanted book, flint, and saddle sell trades all give discontinued statistics.

Combos

Notes

  1. The weighted chance of a trade (a value between 0.0 and 1.0 inclusive, with 0.0 being 0% and 1.0 being 100%) being added to the list is calculated as follows: first, the square root of the size of the trade list multiplied by 0.2, and then added to the hardcoded weight. If this value v is more than 0.9, 0.9 - (v - 0.9) is returned. Otherwise, v is returned.

References

  1. MC-108074. bugs.mojang.com.