Villager

Villagers are intelligent passive NPCs that the player can trade with. Villagers wear clothing according to one of many different careers.

Natural generation
Villagers spawn inhabiting their villages, which spawn in several biomes such as plains, snowy tundras, savannas, deserts, taigas, and snowy taiga.

A priest villager and priest zombie villager spawn locked up in the basements of igloos, under the carpet of the floor. In Bedrock Edition, the villager and zombie villager inside igloo basements have random professions instead of always being priests.

Baby villagers
Villagers will breed autonomously, but need doors(beds) and need to be willing in order to spawn baby villagers. After exactly 20 minutes, the baby villager will grow up to an adult. See this section for more information.

Curing
Villagers will spawn if a player uses a splash potion of weakness on a zombie villager and then feeds it a regular golden apple. It will then shake and turn into a villager within 2-5 minutes. During the change, the zombie villager can still burn in the sun.

Zombie villagers
When a zombie kills a villager, it can turn the villager into a zombie villager, depending on the difficulty: 0% chance on easy, 50% chance on normal and 100% chance on hard. Zombie villagers also spawn naturally in the Overworld in the same conditions as a normal zombie.

Illagers


Illagers are hostile villager-like mobs that spawn in woodland mansions as well as pillager outposts, illager patrols, or raids. There are four kinds: vindicators, evokers, pillagers, and illusioners, along with two associated mobs: vexes and ravagers. Illagers are considered to be outcasts from villages. In addition to attacking players, they will also attack villagers, wandering traders and iron golems.

Witches
Witches are hostile villager-like mobs, which spawn in the Overworld according to the usual mob spawning rules. They can also spawn exclusively in witch huts, or spawn from a villager struck by lightning. Witches may also spawn as a part of raids.

Wandering trader
Wandering traders spawn randomly around the world, or in Bedrock Edition periodically in villages gathering site with 2 trader llamas. Like villagers, wandering traders can trade with players. They are also attacked by most zombie variants, illagers, ravagers, and vexes.

NPC
NPCs are villager-like mobs in Education Edition and Bedrock Edition

Drops
Villagers drop nothing upon death.

Movement patterns
Upon spawning, villagers will leave their homes and begin to explore the village. Generally, they wander aimlessly inside the village during the day. They may go indoors or outdoors. Occasionally, two villagers may stop and turn to look at each other, in a behavior called socializing, in which they will stare at another villager for 4-5 seconds at a time. In the case of players, they will continuously stare at them as long as the player is close enough, unless the villager tries to get into a house at night, farm food, or flee from a zombie. When a player attacks a villager, the villager will not run away, but anger particles will fly out from the villager if it is in a village.

In Bedrock Edition, villagers do not stop continuously in front of players. They will also sprint away if the player attacks them.

Villagers, like other mobs, will find paths around obstructions and will avoid some harmful blocks and walking off cliffs. However, in crowded situations it's possible for one villager to push another off a cliff or into harm.

At night or during rain, villagers will run inside, closing doors behind them, and staying indoors until morning. In the morning they will head outside and resume normal behavior.

Villagers will run away from zombies, vindicators and vexes within 8 blocks, and evokers within 12 blocks.

If a villager finds itself outside the village boundary, or a villager without a village detects a village boundary within 32 blocks, it will move quickly back within the boundary. A villager taken more than 32 blocks away from its village boundary will forget the village within about 6 seconds. Whether in a village or not, a villager is never prone to despawning.

Villagers cannot open trapdoors, fence gates, or iron doors.

There is evidence that villagers are prone to overcrowding certain areas of a village while leaving other areas completely empty. When moving inside, the AI prefers doors within 16 blocks (Euclidean distance). It also tends to prefer doors with fewer villagers nearby, however "nearby" in this case is only 1.5 blocks and, when moving inside, villagers prefer to move 2.5 blocks inside when the inside is to the south or east and therefore will be out of range of this check. During the day, it has been observed that villagers will tend to cluster near a trapped villager or any existing large cluster of villagers, likely due to the "socialize" AI routine overriding their inclination to wander.

Schedules
In Java Edition 1.14and Bedrock Edition 1.10.0, villagers have set schedules: villagers with the basic schedule will wander around, gather items, wander around some more, go home, and then sleep. Children will play and then go home and sleep. Jobless villagers will wander around and then go home and to bed. Villagers with set jobs will go to their place of work. For instance, farmers will tend to the crops, librarians will go to their library, and clerics will spend most of their time standing in front of brewing stands. Villagers will let off green particles when they start pathfinding to their job site. Sometimes unemployed villagers (villagers without a profession overlay) transform into other professions after the green particles appear.

When villagers are on a gathering schedule they are sent to the village meeting point and ring the bell and will interact with each other. The wandering schedule makes villagers explore the village outskirts. Play schedules have the villagers playing with each other. When villagers have a home schedule they will go home and sleep in their bed.

Sleeping
Villagers can sleep during the night by occupying a bed, which prevents the player from using it. They can claim a nearby bed by emitting green particles. Players cannot trade with sleeping villagers, and zombies or illagers will not attack them, however villagers can be awakened by pressing. Villagers will wake up at dawn, if they are hit, if the player is holding an item they want to trade, or if their bed is destroyed. When villagers successfully sleep, they will heal themselves when waking up at dawn.. Nitwit villagers can sleep during the day.

Wandering
During the day, sometimes villagers can be found wandering around the edge of the village boundary.

Mingling
During the day, villagers will usually mingle around the village gathering site or job site. While mingling, villagers will talk to each other and success trading sounds can be heard. If some trade offers are disabled, the trade offer has a chance to enable again while the villager is mingling, without the player having to trade anything. The amount of items they trade can also change to higher or lower. Sometimes, villagers may show angry particles and the "trading denied" sound can be heard, however it won't anger nearby iron golems.

When they finish their jobs, they go to their bed to sleep. Each crafting block and bed is "claimed" by a villager, meaning that each villager needs their own bed and crafting block, or else they will be homeless and unemployed (a nitwit). Once a villager turns into a nitwit, they cannot gain a profession and will not trade. Sometimes villagers will vary their schedule and mingle instead of doing their work, and sometimes they will work extra during the night. Some villagers decide not to sleep, even though their bed is claimed (it is unknown if this is a bug).

Picking up items
Villagers have eight hidden inventory slots, which start empty whenever the villager is spawned. Villagers will not intentionally seek out items to pick up, but they will collect any bread, carrots, potatoes, wheat, seeds, beetroot and beetroot seeds they happen to come within range of. These are the only items they are able to pick up, though the player may use the command to put an arbitrary item into a villager's inventory. If a player and a villager are in the pickup range of an item at the same time, the player will always pick it up first.

Even when is set to, villagers that are killed with any of the available items above will not drop them once they are killed.

Any items in these slots are lost if a villager becomes a zombie villager; a zombie villager has no inventory slots.

If is , villagers will not pick up items.

A dispenser can be used, if adjacent to a villager, to place armor on it. While not visible in most cases (other than pumpkins and mob heads) the equipment will be fully functional; for example, the Thorns enchantment will hurt zombies that attack a villager with a piece of armor enchanted with the Thorns enchantment equipped.

Sharing food
If a villager has enough food in one inventory stack (6 bread or 24 carrots, potatoes, beetroots, or 18 wheat for farmers only) and sees a villager without enough food in one inventory stack (3 bread or 12 carrots, potatoes or beetroot for non-Farmers; 15 bread, 60 carrots, potatoes, or beetroot, or 45 wheat for Farmers), the villager may decide to share food with that villager.

To share, a villager finds his first inventory stack with at least 4 bread, carrots, potatoes, or beetroot or with at least 6 wheat, and then throws half the stack (rounded down) in the direction of the target villager. When wheat is shared, it is first crafted to bread which may result in 1 or 2 less than half the stack being shared.

Farming
Adult and baby brown-robed villagers or villagers wearing a straw hat will tend crops within the village boundary. Villagers far enough outside the boundary of any village will also tend nearby crops.

Farmland to be tended is found by seeking for certain blocks up to 15 blocks away from the villager in the X and Z coordinates and up to 1 away in the Y coordinate (a 31×31×3 area total).
 * If a brown-robed villager (villager with straw hat) does not have enough food in one stack in his inventory (15 bread, 60 carrots, potatoes, or beetroot, or 45 wheat) and finds fully-grown wheat, carrots, potatoes or beetroot, he will move to the crop block and break it.
 * If a brown-robed villager (villager with straw hat) has any seeds, carrots, potatoes, or beetroot seeds in his inventory and finds an air block above farmland, he will move to it and plant a crop. They will always plant from the first eligible slot in their inventory.
 * If is , villagers will not be able to farm.

Inspecting bookshelves
Librarian villagers will sometimes inspect bookshelves.

Baby villagers


Baby villagers will sprint around, entering and leaving houses at will. They will sometimes stop sprinting to stare at an Iron Golem. If the Iron Golem is holding a poppy, the children will cautiously take the flower from its hands.

Baby villagers in Bedrock Edition have a slightly bigger head than in Java Edition and Legacy Console Edition; this also can be seen in other baby mobs in the game as well.

Zombies
Zombies will try to find and attack villagers within a 42 block radius (even when the villager is invisible), and will attempt to break down doors. Zombies will only successfully break doors if the difficulty is set to hard, though only a fraction of zombies spawned in hard mode have the capacity to break doors. Villagers will run away from zombies, sometimes hiding in houses. The villager's only "natural" defense are the iron golems, which attack nearby hostile mobs.

Zombies will try to kill villagers, or convert them to zombie villagers. The chance that the villager will become a zombie villager on death is 0% on Easy, 50% on Normal, and 100% on Hard. Baby villagers can be infected by zombies as well.

Villagers will also run from zombie pigmen, though the latter will not attack them.

Drowned will chase and attack villagers in the same way zombies will, and villagers will run from drowned in the same way they run from zombies. Drowned can also convert villagers to zombie villagers, even when attacking from a distance with a trident.

Lightning
When lightning strikes within 3–4 blocks of a villager, it will turn into a witch.

Raids
During a raid, villagers will run away from illagers and run to the nearest house, similar to a zombie siege. For a villager to hide, the house must have a door.

A villager will often stay in the house it ran to, but may exit its house occasionally. The player will not be able to trade with villagers until the raid is over, instead the villager will display water particles as if sweating.

Breeding


Villagers will mate depending on the number of valid doors. If "willing" (see below), villagers will mate as long as the population is less than 35% (Bedrock Edition: 100%) of valid doors, rounded down. The type of villager that spawns is independent of the villager's parents.

A valid door is any door within the village radius where the number of "outside" spaces within 5 blocks in a straight line on one side of the door is not the same as the number of "outside" spaces within 5 blocks on the other side of the door. A space is considered to be "outside" if it has nothing but transparent blocks above it all the way to the sky.

A census is periodically taken to determine the current population of the village. All villagers within the horizontal boundary of the village and within 5 vertical blocks (Bedrock Edition: no apparent height limit) of the center will be counted as part of the population to determine if continued villager mating is allowed. However, any villager within the horizontal boundary of the village and within the spherical boundary of the village will attempt to enter mating mode as long as there is at least one villager within the boundary. If two villagers simultaneously enter mating mode while they are close to one another, they will mate with each other and produce a child.

Willingness
Additionally, villagers must be "willing" in order to breed. After mating, they will no longer be willing, and must be made willing again.

Villagers may become willing when the player trades with them. Willingness is granted the first time a new offer is traded, or at a one-in-five chance on subsequent trades. Green particles will appear if the villager becomes willing by trading. This will not cause them to immediately seek out a mate, however.

Villagers can also become willing by having either 3 bread, 12 carrots, 12 potatoes, or 12 beetroots in one stack in their inventory. Any villager with an excess of food (usually farmers) will throw food to other villagers, allowing them to pick it up and obtain enough food to become willing. The player can also throw bread, carrots, beetroots, or potatoes at the villagers themselves to encourage breeding. Villagers will consume the required food upon becoming willing.

Professions and careers
Each villager has a profession, which can be identified by their clothing. Villagers also have careers specific to their profession. The player can identify a villager's career by reading the title at the top of the trading interface.

Below is a table listing the various villagers, with their careers in relation to their professions, as well as the IDs specifying these. While each profession has a 1 in 6 chance (16.67%) of occurring, the probabilities for individual careers to occur are more diversified. They are listed in the table as well.

When a villager is transformed into a zombie villager, the profession of the zombie villager will remain unchanged. However, the career will be reset and randomly picked again if the zombie villager is cured, allowing for the player to get a villager with a new career and new trade offers. Old trade offers will disappear, even if the same career is chosen again.

Nitwit
"It started because players could summon villagers without a career by using commands: it was the only way to get villagers with green robes. Whenever we discover we have a bug which is used by the community we just see it as 'undefined behaviour' - and 'fix' it by making it a feature. In this case we just needed a profession for the green-robed villager. I don't remember what name we came up with first - I think it was 'unemployed' or something, but it doesn’t really fit in the world, because I don't really think the other villagers are employed by anyone either. So I think the next suggestion was 'village idiot' but I thought 'nitwit' was a more fun name."

- Jeb about the Nitwit

The Nitwit villager is a villager that wears a green robe and can not be traded with.

Village and Pillage


Villagers and zombie villagers have seven skin types corresponding to the biome they spawned in. Two of these (the jungle and swamp villagers) can only be spawned with the use of spawn eggs or curing zombie villagers in their corresponding biome. Their appearance also varies based on their profession and their five tiers. They show which trade tier they have unlocked by a badge of a varying material on their belt. A new tier is obtained every time a player trades with a villager and the badge appears as stone, then iron, gold, emerald and finally diamond. In Bedrock Edition villagers only have three badge tiers: iron, gold, and diamond.

Villagers have different outfits depending on the biome where they spawned, which are:


 * Desert outfit: desert and badlands biome and variants
 * Savanna outfit: savanna biome and variants
 * Taiga outfit: taiga, giant tree taiga, and mountains biome and variants
 * Snowy outfit: any snowy biomes (including frozen river and snowy beach) and excluding frozen ocean and variants
 * Swamp outfit: swamp biome and variants
 * Jungle outfit: jungle biome variants (including bamboo jungle)
 * Plains outfit: plains and all other biomes not listed above.

Villagers have 15 professions, which are as follows: Adult villagers have $1⁄20$ chance to spawn as 1 of 15 available profession, while baby villagers have higher chance to spawn as unemployed.
 * Farmer (straw hat)
 * Fisherman (fisher hat)
 * Shepherd (brown hat with white apron)
 * Fletcher (hat with feather and quiver on back)
 * Cleric (purple apron and creeper cloak)
 * Weaponsmith (pirate eyepatch and black apron)
 * Armorer (welding mask)
 * Toolsmith (black apron)
 * Librarian (eyeglasses with book as hat)
 * Cartographer (monocle)
 * Leatherworker (brown apron and brown gloves)
 * Butcher (red headband and white apron)
 * Stone Mason/Mason (black apron and black gloves)
 * Nitwit (green coated)
 * Unemployed (no overlay)

Villagers can sleep in beds, change their profession, work, and mingle, although villagers spawned from igloos still use their old behavior.

Dynamic professions
Villagers can change their profession. They do this by claiming one of the crafting blocks as their work station. Villagers can only claim work stations that are not already picked by another villager if they are inside a village boundary with at least 1 bed. If this station is removed, they will either change to another profession or turn into a nitwit. Farmers don't have a dedicated block; instead, they use farmland and crops. When they go to work, they use their built-in schedule to stand in front of their associated block (lecterns for librarians, barrel for fisherman, etc.) Some professions like farmers, librarians, and nitwits can do more jobs, as farmers plant crops, librarians can inspect bookshelves, and nitwit sleep during daytime.

Below are the 15 villager professions, along with their workstation:

composter Nitwit and unemployed baby villagers cannot change profession. Unemployed adults will actively seek for an unclaimed workstation and change into the corresponding profession. Nitwit villagers sometimes seek for an unclaimed bed to sleep during the day.
 * Farmer: farmland
 * Fisherman: barrel
 * Shepherd: loom
 * Fletcher: fletching table
 * Cleric: brewing stand
 * Butcher: smoker
 * Leatherworker: cauldron
 * Weaponsmith: grindstone
 * Armorer: blast furnace
 * Toolsmith: smithing table
 * Librarian: lectern
 * Cartographer: cartography table
 * Stone Mason: stonecutter
 * Nitwit and Unemployed: n/a (cannot work)

<!--

Trading


"Right click on a villager and you can trade with them, offering them emeralds in exchange for better equipment, maps to notable treasures or food. Unless you are trying to trade with a nitwit, of course, in which case you’re going to get squat. Who’s the nitwit now?"

- Marsh Davies

The trading system is a gameplay mechanic that allows players to trade emeralds for items and vice-versa with villagers. Their trades can be good or bad, depending on what the cost is and what items the player might get. Trading is only available for adult villagers; the player cannot trade with baby villagers or the nitwit villager. If a raid is in progress, the player is unable to trade.

Right-clicking a villager will allow a player to trade with them, and display their career. Villagers will make offers based on their profession and career, and will only make trades based on whatever offers they are making. Different offers may be viewed by pressing the left and right buttons next to the currently displayed offer. All offers involve emerald as a currency, and some item pertinent to the villager's profession and career. Trading allows the acquisition of rare items that would otherwise be fairly difficult to obtain, such as chain armor. The trading mechanic allows players to get bottle o' enchanting in survival mode. When villagers get a new trade, pink particles and green cross particles appear.

After trading a new offer once, the villager will allow a new tier of offers. After 2-12 times an offer is repeated, the villager will lock the trade offer. That is, the villager will no longer offer this trade. When this happens, the player will have to use another new trade offer in the villager's window once (or several times if it is already used once), and then wait for a short time. If green particles appear, all trades unlock. That is, the villager will start offering all trades. There is a maximum number of tiers each villager can possess, varying by career. Once the villager has unlocked all tiers, it will not open any new ones. However, players will still be able to renew all offers by trading.

Trade offering
As of Java Edition 1.14 and Bedrock Edition 1.10.0 villagers will hold an item they are willing to trade if the player is holding a currency item. For example, if a villager is selling 20 wheat for one emerald and the player is holding an emerald, the villager will hold wheat in their hand, offering it to the player. If the player is holding an emerald and the villager has more than 1 item to exchange with emeralds, the item they hold will switch in a cycle every few seconds.

Regeneration
When a villager gives off particles from a new trade, they get 10 seconds of regeneration I, which gives them.

Commands or external editors can be used to give custom trades to villagers.

Economic trade
In Bedrock Edition 1.11.0 and Java Edition 1.14 villagers have levels and require experience to unlock the next tiers of trade; level 1 is novice, level 2 is apprentice, level 3 is journeyman, level 4 is expert, and level 5 is master. They cannot resupply trades instantly and it can only be done using the command, however, villagers can resupply themselves by working more at their work station. If villagers change their profession, their experience bar and level still remain the same and is saved to their NBT data.

Popularity
Villagers will increase their prices of trades if a players village popularity is low, (e.g from damaging a villager), and decrease it if their popularity is high (e.g from trading with multiple villagers).

Hero of the Village
When a player receives Hero of the Village, players will be instantly discounted on all items traded by villagers.

Entity data
Villagers have entity data associated with them that contain various properties of the mob.

Trivia

 * The villagers were inspired by the shopkeepers in Dungeon Master 2.
 * Originally, the mobs populating villages were to be pigmen.
 * Villagers tend to often cram into houses that are in the southern-eastern area of their village.
 * Name tags used on villagers will always name the villager instead of opening the trading interface.
 * Villagers can see invisible players.
 * After a zombie villager is cured, the villager gets Nausea for 10 seconds (indicated by the purple status effect particles).
 * When a villager is in love mode, it walks very slowly. However, when a villager runs indoors as the night falls, it runs extremely fast, even faster than the player's sprinting speed.
 * The Java Edition 1.6.1 release poster showed a blue-robed villager in the background. Such a villager has never been seen in-game. This texture was taken from the Tinkers' Construct mod.
 * The priest, librarian and nitwit villagers have an unused hood in their textures.
 * $1⁄5$, an emerald will appear above a villager while opening the trading GUI.
 * Villagers run away from vindicators, evokers, pillagers, ravagers vex, zombies, drowned, and zombie villagers.
 * Villagers can wear armor but only using the command or dispenser, and the armor will not appear.
 * The new villager skins added in the Village and Pillage update were inspired by 2018 fashion shows, such as Gucci's.

April fools
On April 1, 2014, Mojang announced that villagers have taken over the skin servers and content delivery networks (CDN) as an April Fools joke. This caused players's current skin to turn into villager skins, and caused users to be unable to change their skins unless modifying the launcher .json file. Different career villager skins were used, including the then-unused nitwit villager (green robe).

Many of the sounds were also changed, supposedly by the villagers. They seem to be similar to a villager talking (with words, rather than their normal sounds). The in-game music has also been altered to include villager like noises, and also features a villager version of the "Game of Thrones" theme on the title screen. The sounds originate from the sound resource pack created by Element Animation, titled The Element Animation Villager Sound Resource Pack (T.E.A.V.S.R.P.), which is based on the villagers appearing in their fan videos. The villagers were voiced by Dan Lloyd, Director of Element Animation.

The skins and the sounds were reverted to the way they were before on April 2, 2014. However, this update cannot be activated by setting the computer's date to April 1, 2014.

Bedrock and Legacy Console Editions are not affected from this April fools' Joke.