View source for Minecraft:Villager/Upstream

{{distinguish|Pillager|Illager}}
{{about|the current villagers|the documentation of villagers prior to [[Minecraft:Village & Pillage]]|Villager (old)|other uses|Villager (disambiguation)}}
{{Redirect|Merchant}}
{{Infobox entity
| *-1size = 150px
| *-2size = 62px
| group1 = Plains
| *-1caption = Adult
| *-2caption = Baby
| 1-1 = Plains Villager Base.png
| 1-2 = Plains Baby Villager.png
| group2 = Desert
| 2-1 = Desert Villager Base.png
| 2-2 = Desert Baby Villager.png
| group3 = Savanna
| 3-1 = Savanna Villager Base.png
| 3-2 = Savanna Baby Villager.png
| group4 = Taiga
| 4-1 = Taiga Villager Base.png
| 4-2 = Taiga Baby Villager.png
| group5 = Snowy
| 5-1 = Snowy Villager Base.png
| 5-2 = Snowy Baby Villager.png
| group6 = Jungle
| 6-1 = Jungle Villager Base.png
| 6-2 = Jungle Baby Villager.png
| group7 = Swamp
| 7-1 = Swamp Villager Base.png
| 7-2 = Swamp Baby Villager.png
| extratext = View [[#Gallery|all renders]]
| invimage = Villager Spawn Egg
| health = {{hp|20}}
| behavior = Passive<ref group="note" name="passive">Can unintentionally hurt the player with a [[Minecraft:firework rocket]] after a [[Minecraft:raid]] is defeated.</ref>
| damage = '''{{ItemLink|Firework Rocket}}:'''<br>
''Damage decreases with distance:''<br>
'''{{IN|Java}}:'''<br>
Easy: {{hp|5}}<br>
Normal: {{hp|8}}<br>
Hard: {{hp|12}}<br>
'''{{IN|Bedrock}}:'''<br>
{{hp|7}}
| size = '''{{IN|Java}}:'''<br>
'''Adult:'''<br>Height: 1.95 blocks<br>Width: 0.6 blocks<br>
'''Baby:'''<br>Height: 0.99 blocks<br>Width: 0.49 blocks<br>
'''{{IN|Bedrock}}:'''<br>
'''Adult:'''<br>Height: 1.9 blocks<br>Width: 0.6 blocks<br>
'''Baby:'''<br>Height: 0.95 blocks<br>Width: 0.3 blocks
| speed = 0.5
| spawn = *{{EnvLink|Village}} <br> 
*{{EnvLink|Igloo}} basement <br> 
* When a zombie villager is cured
* Upon successful breeding
}}
'''Villagers''' are humanoid [[Minecraft:passive mob]]s that inhabit [[Minecraft:village]]s, work at their professions (see [[Minecraft:Villager professions]]), [[Minecraft:breed]], and interact with each other. Their outfit varies according to their occupation and [[Minecraft:biome]], and a [[Minecraft:player]] can [[Minecraft:trade]] with them using [[Minecraft:emerald]]s as currency, with their prices affected by reputation.

== Spawning ==
Each villager spawns with an empty [[#Picking up items|inventory]]. Villagers never spawn with [[Minecraft:armor]] or other equipment, but {{in|java}} a [[Minecraft:dispenser]] can be used to equip armor on a villager.

=== Natural generation ===
Villagers can be found in [[Minecraft:village]]s, which spawn in several [[Minecraft:biome]]s such as [[Minecraft:plains]], [[Minecraft:snowy plains]], [[Minecraft:savanna]]s, [[Minecraft:desert]]s, [[Minecraft:taiga]]s, and [[Minecraft:snowy taiga]]s{{only|bedrock}} and can cut into other biomes such as [[Minecraft:swamp]]s and [[Minecraft:jungle]]s. When the [[Minecraft:village]] is generated, unemployed villagers spawn in them, the number of which depends on the buildings in that village, as some buildings generate villagers inside and some do not.

[[Minecraft:Igloo]] basements always generate with one villager in the left cell and one [[Minecraft:zombie villager]] in the right cell.
* {{IN|Java}}, the generated villager is always unemployed.<ref>{{bug|MC-150296|||WAI}}</ref> The villager cannot pathfind to the [[Minecraft:brewing stand]] or [[Minecraft:cauldron]] to take on a profession unless some of the blocks confining them are broken. The generated zombie villager always has the profession of cleric and becomes unemployed once cured.
** Both mobs are the plains variant. See {{Slink||Appearance}}.
* {{IN|Bedrock}}, the villager has a random profession and the zombie villager is unemployed.
** Both mobs are the snowy variant.
** The villager can change its professions to cleric or leatherworker, due to the presence of the brewing stand and cauldron. The zombie villager can do the same after being cured.
** Changing profession takes time. If the player manages to trade with the villager before it changes its profession, the villager keeps its initial profession.
** The zombie villager is unemployed immediately after being cured, so the player cannot lock in its profession.

=== Curing ===
{{see also|Zombie Villager#Curing}}
Giving a [[Minecraft:zombie villager]] the [[Minecraft:Weakness]] effect and then feeding it a [[Minecraft:golden apple]] starts the curing process. After five minutes, it transforms into a villager, displaying purple [[Minecraft:Nausea]] status effect particles for 10 seconds after being cured.

The villager retains the profession it had, if it had one before turning into a zombie villager. If employed, a cured villager offers discounts on most of its trades.

{{IN|bedrock}}, if the zombie villager is spawned by a player, it adopts a randomly chosen profession. The villager can also be a nitwit, but it becomes a normal unemployed villager when cured.

{{IN|java}}, curing a [[Minecraft:zombie villager]] riding a [[Minecraft:chicken]] results in the villager riding a chicken. Eventually, the villager grows up and gains a profession while still being on the chicken.

== Drops ==
Farmers using [[Minecraft:bone meal]] when [[Minecraft:Farmer#Farming|farming]] have an 8.5% chance to drop it when killed by a player or tamed wolf.<!-- This is because in UseBonemeal.java, setItemSlot is used directly instead of calling the displayAsHeldItem function of ShowTradesToPlayer.java --> Each level of [[Minecraft:Looting]] increases the chance by 1% per level. Adult<ref>{{Bug|MC-201107|Baby villager not dropping armor}}</ref> villagers can drop armor equipped through [[Minecraft:dispenser]]s. Otherwise, a villager, whether it is an adult or a baby, does not drop any [[Minecraft:item]]s or [[Minecraft:experience]] when killed.

When a villager dies or is converted to a zombie villager, any items in its hidden inventory slots are lost (see {{Slink||Picking up items}}).

If a villager is displaying a trade item to offer a trade, it will not drop it when it dies. Villagers also do not drop any other [[Minecraft:trading]]-related items.

Upon successful trading, a villager drops {{xp|3|6}}.

Upon successful trading, while willing to [[Minecraft:breed]], {{xp|8|11}} is dropped.

Curing a [[Minecraft:zombie villager]] with any [[Minecraft:armor]] or held [[Minecraft:item]]s causes it to drop them as items.

=== Hero of the Village ===
{{Main|Hero of the Village}}
{{IN|java}}, a villager can drop various items, depending on its profession, by throwing a gift toward a nearby player with the [[Minecraft:Hero of the Village]] effect. The gift is randomly selected from a list of items for the villager's individual profession, and there is a random cooldown before the villager can throw another gift.

== Behavior ==
=== Movement patterns ===
==== Socializing ====
Nitwit and unemployed villagers leave their homes at day and begin to explore the village. Generally, they wander inside the village during the day. They may go indoors or outdoors, periodically making mumbling sounds. Occasionally, two villagers may stop and turn to look at each other, in a behavior called socializing, during which they stare at another villager for 4–5 seconds at a time. They continuously stare at a nearby player unless the villager is trying to get into a house at night, farm food, work, or flee from a zombie or illager. Baby villagers may jump on beds and play tag with each other, similarly to how baby [[Minecraft:piglin]]s and baby [[Minecraft:hoglin]]s play tag.

{{IN|bedrock}}, baby villagers do not stop in order to stare at players, and thus continue moving as if the player is not there.

A villager tries not to travel far from its bed in a large village unless the job site or the nearest gossip site ([[Minecraft:bell]]) is far away.

Villagers emit green [[Minecraft:particles]] if they join a village, set a bed, or acquire a job site/profession.

Villagers run inside at night or during rain, closing doors behind them. They attempt to sleep at night, but if they cannot claim a bed, they stay indoors near a bed until morning. In the morning, they head outside and resume normal behavior. However, some villagers, such as nitwits, stay outside later than others unless being chased by an [[Minecraft:illager]] or [[Minecraft:zombie]].

==== Migration ====
If a villager finds itself outside the village boundary, or a villager without a village detects a village boundary within 32 blocks, it quickly moves back within the boundary. A villager taken more than 32 blocks away from its village boundary forgets the village within about 6 seconds. Whether in a village or not, a villager never [[Minecraft:despawn]]s.

==== Pathfinding ====
Villagers, like most other mobs, can find paths around obstructions, avoid walking off cliffs of heights greater than 3 blocks, and avoid some blocks that cause harm. However, in crowded situations, one villager can push another off a cliff or into harm's way.

Villagers can open all wooden and copper doors and find paths to blocks of interest behind the doors. However, they cannot open any trapdoors, fence gates, or iron doors. Villagers can climb [[Minecraft:ladders]], but do not recognize them as paths and do not deliberately use them. Any climbing of ladders seems to be a side effect of them being pushed into the block by another mob (usually by other villagers). Climbing a ladder can leave a villager stranded on the second floor and roof of some village structures, as they lack the necessary AI to intentionally ''descend'' ladders.

==== Getting attacked ====
Like other passive mobs, villagers sprint away when attacked, but they also flee from some nearby mobs even before being attacked.

[[Minecraft:Zombie]]s, [[Minecraft:zombie villager]]s, [[Minecraft:husk]]s, [[Minecraft:drowned]] and [[Minecraft:zoglin]]s attack villagers and cause them to flee.

[[Minecraft:Pillager]]s, [[Minecraft:vindicator]]s, [[Minecraft:evoker]]s, [[Minecraft:illusioner]]s and [[Minecraft:ravager]]s cause villagers to flee but only attack adults. [[Minecraft:Vex]]es also cause villagers to flee but only attack adults when spawned by an [[Minecraft:evoker]].

[[Minecraft:Pufferfish]], [[Minecraft:warden]]s and [[Minecraft:wither]]s attack villagers but don't cause them to flee until actually attacked.

==== Preferred path ====
{{Exclusive|Bedrock|section=1}}
When [[Minecraft:pathfinding]], villagers prefer to stay on low cost blocks, such as [[Minecraft:dirt path]]s, [[Minecraft:cobblestone]], [[Minecraft:bricks]], and [[Minecraft:planks]]. They do this by trying to minimize the '''path cost''' of all of the blocks they walk across. They also avoid jumping, because it has a high path cost, but babies don't avoid it as much.

<!-- try to break into no more than 2 columns if more than (1 + 1) * 20em = 40em of width is available -->
<div style="max-width: 40em; column-width: 20em; column-count: 3">
{| class="wikitable collapsible" data-description="Preferred blocks" style="break-inside: avoid“
|-
! colspan="2" rowspan="2" {{tc|planned|Preferred path blocks}} !! colspan="2" {{tc|planned|Path cost}}
|-
! Adult villager !! Baby villager
|-
| colspan="2" | {{BlockLink|Dirt Path}}
| colspan="2" style="text-align: center;" | 0
|-
| style="border-right-color:transparent;" |
{{BlockLink|Block of Diamond}}<br>
{{BlockLink|Block of Emerald}}<br>
{{BlockLink|Block of Lapis Lazuli}}<br>
{{BlockLink|Block of Gold}}<br>
{{BlockLink|Block of Redstone}}<br>
{{BlockLink|Bricks}}<br>
{{BlockLink|Cobblestone}}<br>
{{BlockLink|Chiseled Sandstone}}<br>
{{BlockLink|Chiseled Red Sandstone}}<br>
{{BlockLink|Cut Sandstone}}<br>
{{BlockLink|Cut Red Sandstone}}<br>
{{BlockLink|End Stone Bricks}}<br>
{{BlockLink|Glass}}<br>
{{BlockLink|Glazed Terracotta}}<br>
|
{{BlockLink|Glowstone}}
{{BlockLink|Mossy Cobblestone}}<br>
{{BlockLink|Nether Bricks}}<br>
{{BlockLink|Planks|id=oak planks}}<br>
{{BlockLink|Prismarine}}<br>
{{BlockLink|Red Nether Bricks}}<br>
{{BlockLink|Red Sandstone}}<br>
{{BlockLink|Sandstone}}<br>
{{BlockLink|Slabs}}<br>
{{BlockLink|Smooth Sandstone}}<br>
{{BlockLink|Smooth Red Sandstone}}<br>
{{BlockLink|Stained Glass}}<br>
{{BlockLink|Stone}}<br>
{{BlockLink|Stone Bricks}}<br>
| colspan="2" style="text-align: center;" |1
|-
| style="border-right-color:transparent;" |
{{BlockLink|Barrel}}<br>
{{BlockLink|Beds}}<br>
{{BlockLink|Blast Furnace}}<br>
{{BlockLink|Brewing Stand}}<br>
{{BlockLink|Cartography Table}}<br>
{{BlockLink|Cauldron}}<br>
{{BlockLink|Composter}}<br>
|
{{BlockLink|Fletching Table}}<br>
{{BlockLink|Grindstone}}<br>
{{BlockLink|Lectern}}<br>
{{BlockLink|Loom}}<br>
{{BlockLink|Smithing Table}}<br>
{{BlockLink|Smoker}}<br>
{{BlockLink|Stonecutter}}
| colspan="2" style="text-align: center;" | 50
|-
| colspan="2" | Other
| 3
| 1.5
|-
! colspan="2" | Jump cost
| 20
| 5
|}
</div>

=== Job site blocks ===
{{for|a list of job site blocks and the professions they are required for|#Professions}}

Unemployed villagers (other than babies and nitwits) seek employment at job site blocks (also referred to as workstations), and employed villagers use job site blocks to refresh their trades (see {{slink||Working}}). Villagers who have made their first trade must claim a site block that corresponds with their profession, whereas tradeless villagers may change their profession to match a site block. 

{{IN|java}}, an unemployed villager claims job site blocks by searching for the nearest unclaimed site in a 48-block sphere. When a suitable site block is detected, the villager starts pathfinding to it, staking a provisional claim. This can occur only while the villager is awake. A provisional claim is released if the villager cannot reach the block within 60 seconds, however the villager may try again immediately.<ref>{{bug|MC-257069||Trapped villager can prevent any other villagers from claiming a jobsite}}</ref> To fully claim the site and change profession, the villager must approach within a 2-block radius of the job site's center. When a job site block is fully claimed, its owner emits green particles, and no other villager can claim the block unless the owner relinquishes it. 

{{IN|Bedrock}}, all villagers in a village search for unclaimed job sites in a 16 block radius and 4 block height. If a site block is found, it is added to a shared list of valid job site blocks for the whole village. An unemployed villager with a bed claims the first site block on that list and immediately acquires the profession to match, regardless of the distance or accessibility to the site block.<ref>{{bug|MCPE-63311||Villagers claim workstations and beds that are too far away and/or get stuck unemployed}}</ref> The villager can even claim the site block while sleeping. When a job site block is claimed, both the block and the villager making the claim emit green particles and the site block is removed from the list. If a villager cannot pathfind to its claimed site, both the site block and villager emit anger particles. The site block may need to be broken or interacted by a piston before the villager unclaims it.{{Verify|Incredibly inconsistent, needs further testing|edition=bedrock}}

=== Gossiping ===
{{anchor|Reputation}}
{{for|the formula to calculate the exact price based on gossips|Trading#Sale prices}}
[[File:Gossping.png|alt=|thumb|A desert villager and a plains villager gossiping.]]

Villagers can store positive and negative memories about players and share them with other villagers. A player's reputation is determined by these memories, and can be changed by trading with, curing, attacking and killing villagers, which influences [[Minecraft:Trading#Sale prices|trading prices]] and the hostility of [[Minecraft:iron golem]]s.

{| class="wikitable"
|-
! Source
! Internal name
! Gain
! Decay
! Sharing cost
! Maximum
! Multiplier
|-
| Each trade
| {{cd|trading}}
| 2
| 2
| 20
| 25
| 1
|-
| rowspan="2" | Curing the villager
| {{cd|major_positive}}
| 20
| 0
| 100
| 20
| 5
|-
| {{cd|minor_positive}}
| 25
| 1
| 5
| 25
| 1
|-
| Attacking the villager
| {{cd|minor_negative}}
| 25
| 20
| 20
| 200
| -1
|-
| Killing a nearby villager
| {{cd|major_negative}}
| 25
| 10
| 10
| 100
| -5
|}

Killing a villager increases the value of the corresponding gossip for all villagers whom it has a line of sight inside a box extending 16 blocks from the villager in all coordinate directions. [[Minecraft:Trading]] with, [[Minecraft:curing]] or attacking a villager only increases the value of the corresponding gossips for the targeted villager. Attacks and kills only result in negative gossip when villagers can determine their source, so indirect methods like [[Minecraft:fire]], [[Minecraft:lava]] and suffocation from [[Minecraft:falling block]]s can be used to kill villagers without losing reputation.

Villagers can share gossip by talking to each other, though the shared gossip's value will be decreased by the sharing cost. Because the cost of sharing the major gossip gained from curing is greater than its maximum, it can never be shared.

Every 20 minutes, all gossips of a villager decays by the amount in the "Decay" column. This rate does not depend on the time of day and cannot be sped up by sleeping. Because the decay of the major gossip gained from curing is 0, the gossip is permanent.

A player's total reputation with a villager is determined by multiplying each gossip's value by its respective multiplier and adding the results together.

When [[Minecraft:trading]], villagers will [[Minecraft:Trading#Sale prices|change prices]] based on reputation. {{IN|bedrock}} negative reputation can only cancel out positive reputation and other price discounts but not increase the price.

[[Minecraft:Iron golem]]s that were not built by players become hostile toward all players whose reputation is -100 or lower with any villager within a box centered on the golem and extending 10 blocks in every horizontal and 8 in both vertical directions.

=== Picking up items ===
Each villager has eight hidden inventory slots, which are initially empty when the villager is spawned. A villager can fill its inventory slots with items it picks up.

{{IN|bedrock}}, a villager does not intentionally seek out items to pick up, but does collect any [[Minecraft:bread]], [[Minecraft:carrot]]s, [[Minecraft:potato]]es, [[Minecraft:wheat]], [[Minecraft:wheat seeds]], [[Minecraft:beetroot]], [[Minecraft:beetroot seeds]], [[Minecraft:torchflower seeds]], [[Minecraft:pitcher pod]]s, and [[Minecraft:bone meal]] within reach.{{info needed|How far can villagers reach items?}} {{IN|java}}, a villager seeks out these items within 4 blocks. The listed items are the only items villagers can pick up, although the {{cmd|item replace}} command can put any arbitrary item into a villager's inventory. Bone meal can be picked up only by a farmer villager. In ''Bedrock Edition'', only farmers can pick up seeds and wheat.

If a player and a villager are in the pickup range of an item at the same time, the player always picks it up first. If several villagers are next to an item, the same one picks up the item every time. This behavior prevents villagers from successfully sharing food or breeding in a small space.

When killed or converted to a zombie villager, any inventory item of the villager is lost, even when {{cmd|/gamerule keepInventory}} is set to <code>true</code>.<!-- How is keep inventory relevant to this at all? I'm confused! -->

If {{cmd|/gamerule mob_griefing}} is <code>false</code>, villagers cannot pick up items, and farmer villagers cannot plant or harvest crops.

Like other mobs, villagers have four slots for worn [[Minecraft:armor]], separate from their inventory slots. An adjacent dispenser can equip armor, [[Minecraft:elytra]], [[Minecraft:mob head]]s or [[Minecraft:carved pumpkin]]s to a villager{{only|java}}<ref>{{bug|MCPE-109608|"Villagers cannot be equipped with anything by a dispenser, but that would be a separate issue and a feature request rather than a bug."|Cannot dispense armor or mob heads onto villagers or zombies|Cannot Reproduce}}</ref>, but the armor is not rendered (except for carved pumpkins and mob heads). The equipment functions as normal; for example, a villager wearing an armor piece enchanted with [[Minecraft:Thorns]] can inflict Thorns damage to attackers, and a villager wearing [[Minecraft:Frost Walker]] [[Minecraft:boots]] is able to create [[Minecraft:frosted ice]]. If a villager is converted into a zombie villager, the armor it was wearing is dropped, though it may be able to pick it up and equip it again. A villager with Thorns III deals more damage to zombies that attacked the villager than the villager takes damage.

=== Sharing food ===
[[File:Villager Sharing Food MCPE 1.14.60.png|thumb|right|Villagers sharing carrots.]]

{{IN|Java}}, villagers collect bread, carrots, potatoes, beetroots, wheat seeds, beetroot seeds, and wheat. If a villager has at least 24 of these items, it gives the extra amount to a villager with 4 or fewer of each of these food items. That other villager can also do this until all villagers have shared all items they could (for example, on a group of three villagers one receives 60 bread, then it shares 36 to another villager to keep 24<ref>{{Bug|MC-181525}}</ref>, and that same villager then shares 12 to the third villager).

In the case of wheat, villagers have a distinct behavior. They do the same as other crops, but if a villager has at least 32 wheat, it tries to give half of it to another villager, making both have 16 wheat.

If a villager has 8 full{{verify|Full? Meaning stackable every item is stacked to 64?}} stacks of any kind of food or seeds and then tries to share with another villager, it leaves at least 24 items in each stack. Thus it can never empty inventory slots to pick up other items, unless it uses the items when trying to breed or when farming if it is a farmer villager.<ref>{{Bug|MC-178019}}</ref><ref>[https://www.reddit.com/r/technicalminecraft/comments/lozawc/villager_food_sharing_java_116/ Villager food sharing (java 1.16)] - Only the last part and the bugs are relevant</ref> A bait villager can be used in a farm taking advantage of this mechanic to have a farmer villager collect and deposit crops.

{{IN|Bedrock}}, 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, 12 carrots, 12 potatoes, or 12 beetroots for non-farmers; 15 bread, 60 carrots, 60 potatoes, or 60 beetroots, or 45 wheat for farmers), the villager may decide to share food with that villager.

To share, a villager finds its 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 ===
{{main|Farmer#Farming}}
[[File:Villagerpickingup.gif|thumb|Farmer villager picking and planting carrots.]]
Farmer villagers can tend planted [[Minecraft:wheat]], [[Minecraft:carrot]]s, [[Minecraft:potato]]es, and [[Minecraft:beetroot]]s, harvesting them if they are fully grown or [[Minecraft:bonemealing]] them if possible.

=== Breeding ===
{{for|tutorials on breeding mechanics|Village mechanics#Breeding and population cap|Tutorial:Legacy village mechanics}}

Adult villagers breed depending on the time of the day and need to be willing to spawn {{section link||Baby villagers}}, who require [[Minecraft:bed]]s with at least two empty blocks above their heads. Job sites are not required for villagers to breed.

Breeding depends on the number of valid beds. If a villager is "willing" (see {{slink||Willingness}} below), villagers breed as long as there are unclaimed beds available within the limits of the village. All baby villagers are initially unemployed.

{{IN|java}}, two villagers nearby one another periodically enter mating mode if both have enough food and are not on cooldown. Breeding fails (with angry villager particles displayed) if no unclaimed bed can be reached via pathfinding within a 48-block radius. The appearance of the child is randomly determined by either the biome type of the parents or by the biome where the breeding occurred.

{{IN|bedrock}}, a census is periodically taken to determine the current population of the village. All villagers within the horizontal boundary of the village are 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 the ''spherical'' boundary of the village attempts 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 breed and produce a child. The [[#Appearance|appearance]] is determined by the biome where the breeding occurs {{in|bedrock}}.

==== Willingness ====
[[File:VillagerInLove.png|thumb|right|Two villagers willing to breed.]]

Villagers must be willing to breed. Willingness is determined by the amount of food items a villager has. Becoming willing consumes the villager's food stock; therefore, after mating, villagers cease to be willing for 5 minutes, at which point they must gather a sufficient stock of food items to breed again.

Villagers must have enough beds within village bounds{{only|je}}/loaded terrain{{only|be}}{{verify|edition=bedrock}} for baby villagers to spawn. The villager must be able to path-find to the bed from its current position. (Note that mobs view certain blocks, such as slabs, trapdoors, etc., as full blocks for pathfinding, so putting these types of blocks above a bed invalidates the bed.)

Villagers can become willing by having either 3 [[Minecraft:bread]], 12 [[Minecraft:carrot]]s, 12 [[Minecraft:potato]]es, or 12 [[Minecraft:beetroot]]s in one slot in their inventory. Any villager with an excess of food (usually farmers) throws 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 consume the required food upon becoming willing. If {{cmd|gamerule mobGriefing}} is <code>false</code>, villagers don't pick up food or break crops.

=== Baby villagers ===
[[File:Babyvillagers new.png|thumb|Some baby villagers in a village.]]
Baby villagers (sometimes called children, or child villagers) sprint around, entering and leaving houses at will. They sometimes stop sprinting to stare at other villagers, the player{{only|java}}, or an [[Minecraft:iron golem]]. If the iron golem is holding out a [[Minecraft:poppy]], a child may cautiously take the flower from its hands. Baby villagers tend to group and chase one another around the village as if playing tag. They also jump on beds.

[[Minecraft:Illager]]s (except "Johnny" [[Minecraft:vindicator]]s {{in|BE}}) ignore baby villagers until they reach adulthood.

Baby villagers give gifts of [[Minecraft:poppies]] or [[Minecraft:wheat seeds]] to players who have the {{EffectLink|Hero of the Village}} effect {{in|java}}. 

Baby villagers can fit through 1×1 block gaps.

A baby villager becomes an adult 20 minutes after birth, even when in a boat or a minecart. Baby villagers with no AI do not grow up.

[[Minecraft:Golden dandelion]]s do not work on baby villagers.

=== Lightning ===
[[File:Villager becoming Witch.gif|thumb|upright|A villager gets struck by lightning.]]

When [[Minecraft:lightning]] strikes within 3–4 blocks of a villager, the villager is replaced by a [[Minecraft:witch]] that can't despawn. Even a baby villager that is struck by lightning is turned into a two-block-tall witch. 

Iron golems also attack any villagers that turn into witches.

=== Iron golem summoning ===
{{main|Iron Golem#Villages}}

{{IN|java}}, villagers can summon an [[Minecraft:iron golem]] to protect themselves from hostile mobs. This requires either a villager [[#Panicking|panicking]] in a group of 3 villagers or 5 [[#Gossiping|gossiping]] villagers. If they don't find an iron golem within 16 blocks of their location for 30 seconds, another one is summoned.

{{IN|bedrock}}, villagers can summon an iron golem if there are more than 10 villagers per existing golem, the village has at least 20 beds, and 75% of these villagers must have worked in the past day.

=== Panicking ===
[[File:Panicked Villager.gif|thumb|upright|A villager panicking.]]

Villagers sometimes panic during a [[Minecraft:raid]] or a [[Minecraft:zombie siege]] by emitting water particles (sweat) and shaking.

In ''Java Edition'', villagers panic if they see a mob that is hostile toward villagers, like a zombie, zombie villager, husk, drowned, zoglin, illager, vex, wither, or ravager and flee frantically from them, sometimes hiding in houses.

In ''Bedrock Edition'', villagers panic by running around in circles around a bed in a village house, such as when a raid happens or when the player rings the village bell.

''Java Edition'' villagers in panic are more likely to summon iron golems. To see these mobs, the villager must have an unobstructed line of sight to it (eye-level to eye-level), and be within a certain range (spherical distance between feet center bottom-most point of the villager and hostile mob):

{| class="wikitable"
! Mob
! Panic radius
|-
| {{EntityLink|Zombie}}, {{EntityLink|Husk}}, {{EntityLink|Drowned}},<br /> {{EntityLink|Zombie Villager
}}, {{EntityLink|Vex}}
| 8
|-
| {{EntityLink|Vindicator}}, {{EntityLink|Zoglin}}
| 10
|-
| {{EntityLink|Evoker}}, {{EntityLink|Illusioner}}, {{EntityLink|Ravager}}
| 12
|-
| {{EntityLink|Pillager}}
| 15
|}

==== Zombies ====
{{main|Siege|Zombie}}

Zombies, zombie villagers, husks, and drowned seek out and attack villagers within a 35– to 52.5–block radius (depending on [[Minecraft:regional difficulty]]){{only|java}} or a 16-block radius{{only|bedrock}} (even when the villager is invisible). Zombies attempt to break down [[Minecraft:door]]s, but only a fraction of zombies can do so and can succeed only when difficulty is set to hard. Zombies who cannot break doors tend to crowd around a door that separates them from a villager. If a zombie or a drowned comes across a set of doors with one open, it usually tries to go through the closed door.

All zombies either kill villagers or convert them into [[Minecraft:zombie villager]]s. The chance of the villager becoming a zombie villager upon death depends on [[Minecraft:difficulty]], being 0% on Easy, 50% on Normal, and 100% on Hard. Baby villagers can be infected by [[Minecraft:zombie]]s as well, becoming baby zombie villagers. Drowned are able to convert villagers into zombie villagers even when attacking with a [[Minecraft:trident]] from a distance.

==== Raids ====
{{main|Raid}}

During a [[Minecraft:raid]], villagers flee from [[Minecraft:illager]]s and run to the nearest [[Minecraft:Village house|house]], similar to a [[Minecraft:zombie siege]]. For a villager to hide, the house must have a door and at least one bed.<!-- hide poi type=bed-->

Before the first raid wave {{in|java}}, at least one villager rushes to ring the bell in the center of the village (if they are close enough) to warn the other villagers of an incoming raid before going into their house. {{IN|Bedrock}}, the bell rings automatically regardless of whether a villager is nearby. {{IN|java}}, when a bell is rung, all illagers within 48 blocks get the [[Minecraft:glowing]] effect for 3 seconds. 

A villager often stays in the house it first entered, but may exit the house occasionally. The [[Minecraft:player]] can still trade with villagers during a [[Minecraft:raid]].

{{IN|java}}, the villager displays water [[Minecraft:particles]] on random occasions as if sweating.

=== Hero of the Village ===
{{Main|Hero of the Village}}

{{IN|Java}}, once the player gains the [[Minecraft:Hero of the Village]] status after defeating a raid, villagers give them a discount for their trades and throw them gifts related to their profession. {{IN|Bedrock}}, the villagers do not throw the player gifts, but they still give them a discount for their trades.

=== Staring ===
[[File:Villager Staring.png|thumb|A villager staring at the player.]][[File:An Army of Villagers Staring!.png|thumb|Several villagers staring at the player.]]Villagers stare at any player that stares at them, or goes near them, even if they have the [[Minecraft:Invisibility]] effect. This also applies for some mobs, especially [[Minecraft:cat]]s. A villager first turns its head toward the player, then the body. Villagers can keep staring at the player unless a raid happens or a zombie comes and chases them off.

== Schedules ==
Villagers have set schedules depending on their age and employment status. Schedules define the villager's goals, which mostly determine how they behave throughout the day. However, their goals can be interrupted by higher priority behaviors most villagers have, such as fleeing from an attack, trading, and getting out of the rain.

{| class="wikitable" style="text-align: center; -webkit-column-break-inside: avoid; page-break-inside: avoid; break-inside: avoid" data-description="Villager schedules"
|+ Villager schedule {{in|java}}
|-
! Image
! Ticks ([[Minecraft:Daylight cycle#24-hour Minecraft day|time]])
! Employed
! Unemployed/Nitwit
! Baby
|-
| style="background-color: rgb(112 158 239 / 45%);" | {{ClockPhase|10}}
| 00010 (06:00:36) || colspan=2 {{tc|planned|Wander}} || rowspan=2 {{tc|planned|Wander}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|2000}}
| 02000 (08:00:00) || rowspan=3 {{tc|yes|Work}} || rowspan=3 {{tc|planned|Wander}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|3000}}
| 03000 (09:00:00) || rowspan=1 {{tc|rarely|Play}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|6000}}
| 06000 (12:00:00) || rowspan=2 {{tc|planned|Wander}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|9000}}
| 09000 (15:00:00) || colspan=2 rowspan=2 {{tc|neutral|Gather}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|10000}}
| 10000 (16:00:00) || rowspan=2 {{tc|rarely|Play}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|11000}}
| 11000 (17:00:00) || colspan=2 {{tc|planned|Wander}}
|-
| style="background-color: rgb(112 157 237 / 45%);" | {{ClockPhase|12000}}
| 12000 (18:00:00) || colspan=3 {{tc|unknown|Sleep}}
|}

{| class="wikitable" style="text-align: center; -webkit-column-break-inside: avoid; page-break-inside: avoid; break-inside: avoid" data-description="Villager schedules"
|+ Villager schedule {{in|bedrock}}
|-
! Image
! Ticks ([[Minecraft:Daylight cycle#24-hour Minecraft day|time]])
! Employed
! Unemployed
! Baby
! Nitwit
|-
| style="background-color: rgb(112 157 237 / 45%);" | {{ClockPhase|0}}
| 00000 (06:00:00) || rowspan="2" {{tc|yes|Work}} || rowspan=2 {{tc|planned|Wander}} || rowspan=4 {{tc|rarely|Play}} || {{tc|unknown|Sleep}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|2000}}
| 02000 (08:00:00) || colspan=1 rowspan=5 {{tc|planned|Wander}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|8000}}
| 08000 (14:00:00) || colspan="2" {{tc|neutral|Gather}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|10000}}
| 10000 (16:00:00) || {{tc|yes|Work}} || {{tc|planned|Wander}}
|-
| style="background-color: rgb(120 169 255 / 45%);" | {{ClockPhase|11000}}
| 11000 (17:00:00) || colspan="3" {{tc|partial|Home}}
|-
| style="background-color: rgb(112 157 237 / 45%);" | {{ClockPhase|12000}}
| 12000 (18:00:00) || colspan="3" rowspan="3" {{tc|unknown|Sleep}}
|-
| style="background-color: rgb(45 64 97 / 45%);" | {{ClockPhase|13000}}
| 13000 (19:00:00) || {{tc|partial|Home}}
|-
| style="background-color: rgb(0 0 0 / 45%);" | {{ClockPhase|14000}}
| 14000 (20:00:00) || {{tc|unknown|Sleep}}
|}

=== Working ===
Employed villagers spend most of their day standing next to their job site blocks. From time to time, they "gather supplies" by wandering a short distance away, then returning.

Some professions have additional job-specific goals that are part of their work schedule:
* Farmers harvest and sow crops.
* Librarians inspect bookshelves.{{only|bedrock}}

When a villager reaches its job site block, it commences "work". Two times a day, working resupplies any locked trades, even without having a bed or while sitting in a minecart. A villager can "reach" its job site block if the block is in any of the 8 directly adjacent or diagonal block spaces horizontally around it at the height of their feet, or at the 9 blocks below that. Villagers can still "reach" them diagonally, even if they can't see or touch the face of the block.

Employed villagers do not breed with each other during their work schedule. Nitwits and unemployed villagers do not follow this rule, as they can breed with each other and employed villagers that are not working.

Leatherworker villagers can work at any cauldron, not only their job site block. Also, the cauldron does not have to be filled with water in order for the villager to work at it.

=== Wandering ===
All villagers wander from time to time, but for the unemployed and nitwits, they wander for the majority of their day. A wandering villager chooses a random block and walks toward it, then stands there for a variable amount of time before wandering again. If at any time it detects a job site block it can claim, it does so, assumes the skin for the associated profession, and immediately begins following the appropriate schedule.

A villager attempts to claim a job site block by finding a path to a block next to one, showing angry particles when unable to reach it. After a villager fails to reach the job site block several times, it becomes unclaimed, indicated by showing angry particles on it. The villager loses its job site block and eventually becomes unemployed if the villager is at novice-level and no nearby job site block is available. Any other nearby unemployed villager has a chance to become the block's new owner. If there are no unemployed villagers nearby, then the villager who lost the job site block seeks for another unclaimed one or tries to reclaim the same unreachable one in an endless loop (this also happens for claiming beds).

The wander schedule includes a job-specific goal called "exploring the outskirts" that causes villagers to wander near the edges of the village. This enables them to detect new beds, job site blocks, bells, and houses that players have used to extend the village. 

During this time of the day, they may also share items.

=== Gathering ===
Late in the day, adult villagers gather at a meeting place (the area around a [[Minecraft:bell]]). When two villagers encounter one another, they mingle (look at each other and "converse" by humming at other villagers). They may also share food, or breed if both are willing.

If a villager isn't close enough to detect a bell, it wanders randomly, searching for one.

=== Playing ===
[[File:ChildrenTag.png|thumb|Six baby villagers chasing another baby villager.]]

Baby villagers wander randomly around the village. When they encounter another baby villager, the two of them follow each other for a while and sometimes run as if racing or chasing each other. 

{{IN|java}}, they sometimes stop to jump and bounce on a bed or to stare at an iron golem they encounter. {{IN|bedrock}}, if the [[Minecraft:iron golem]] offers them a poppy, the baby villager cautiously accepts it.

=== Returning home ===
All villagers head home a short time before sunset. They roam around until they get near their beds, then target a block beside the bed. The bed's head must be accessible for the villagers to "see" it. Once they reach their beds, they do not go through a door again before sleeping.

A villager who has no bed simply waits inside a house until morning. This includes players stealing a villager's bed to sleep in, mostly the villager stays in the house and doesn't move until sunrise. But sometimes, if they detect an unclaimed bed nearby they walk out of the house and toward the bed.
[[File:How Do You Even Sleep!.png|thumb|A villager pushed on a bed in ''Java Edition''. The villager falls off the bed if it is pushed again.]]
[[File:The Anvil Bounces on a Sleeping Villager.png|thumb|In ''Java Edition'', when a villager is sleeping, the hitbox is reduced to only the half of the bed with the pillow. Therefore, dropping an anvil on the other half of the bed does not hurt the villager nor does it cause the villager to wake up.]]

=== Sleeping ===
[[File:Villager sleeping.png|thumb|A top view of a savanna villager sleeping in a bed at night.]] 

At sunset, villagers lie down in their beds and remain there until morning. Villagers wake early if food is thrown at them{{only|java}}, they are pushed out of bed, or if their bed is destroyed. <!-- Note: This is the current behavior in Bedrock, but some of it may be due to bugs.-->They also wake up when their bed is {{ctrl|used}}, if they are {{ctrl|attacked}}, or when a bell is rung.
If possible, they return to sleeping in a bed after the interruption.

Jumping on a bed with a villager sleeping in it does not cause the villager to get up. 

In ''Java Edition'', a villager can be pushed on its bed and sometimes turn its head. A villager can be pushed off a bed,<ref>{{bug|MC-145707|||WAI}}</ref> but is most likely to go back to sleeping after staring at the player who pushed the villager for a few seconds. 

When sleeping in ''Java Edition'', a villager's hitbox reduces to a cube restricted to the pillow part of the bed. If an anvil is dropped on the hitbox, the villager takes damage and wakes up and the anvil is dropped as an item. 

In ''Bedrock Edition'', dropping an anvil on a villager that is sleeping causes the villager to take damage but remain sleeping in the bed and the anvil remains on top of the bed. 

A villager who has no bed continues wandering in search of a bed to claim.

Villagers follow their Overworld schedules regardless of which dimension they are in. They can sleep in [[Minecraft:the Nether]] or [[Minecraft:the End]], without causing the usual consequences of the bed exploding (See {{slink|Bed|Sleeping}}), if the Overworld's time is correct.<ref>{{bug|MC-146515||Villagers can sleep in all dimensions|WAI}}</ref> This is because the daylight cycle continues in these dimensions, even though it is not normally apparent to the player.

Sometimes when a villager gets in a bed from another direction they turn their body until their head is on the pillow of the bed. Villagers also sleep with their eyes open.

=== Healing ===
A villager gets a brief regeneration effect once leveling up in its profession. Pink regeneration particles ({{EffectSprite|particle-regeneration}}) appear while it is healing.

{{IN|bedrock}}, when a villager successfully sleeps, they immediately heal themselves when waking up at dawn (if they are hurt).

== Professions ==
{{Main|Villager professions}}
[[File:Isometric Render of Job Sites.png|thumb|Job site blocks next to each other.]]
[[File:All Professions In 18w50a.png|thumb|All plains biome variant professions (except unemployed) corresponding to their different job site blocks.]]

{| class="wikitable" style="text-align:left;"
|+ Main articles
|-
| {{EntityLink|Nitwit}} || {{EntityLink|Armorer}}
|-
| {{EntityLink|Butcher}} || {{EntityLink|Cartographer}}
|-
| {{EntityLink|Cleric}} || {{EntityLink|Farmer}}
|-
| {{EntityLink|Fisherman}} || {{EntityLink|Fletcher}}
|-
| {{EntityLink|Leatherworker}} || {{EntityLink|Librarian}}
|-
| {{EntityLink|Mason}} || {{EntityLink|Shepherd}}
|-
| {{EntityLink|Toolsmith}} || {{EntityLink|Weaponsmith}}
|}

Each villager can have a profession except for the nitwit, indicated by their clothing as well as by the title at the top of the [[Minecraft:trading interface]]. A villager can choose their profession by claiming a job site block. When they go to work, they use their daily schedule to get to their claimed job site block. Some professions, like farmers and librarians, do other things. Farmers plant crops, and librarians can inspect bookshelves{{only|be|}}{{verify}}. If an adult villager does not have a profession (either they are unemployed or a nitwit), they wander instead.

A job site block can be claimed only if it is unclaimed. Removal of a claimed job site block causes the owner to switch to another profession or become unemployed, provided that the villager has no prior trades with the player. If the villager has prior trades, it keeps its profession and claims a new job site block that matches its profession if one is available. This means that once a player trades with a villager, the villager keeps its profession forever.

Nitwits and baby villagers cannot change their profession.

{{IN|java}}, villagers summoned by a spawn egg or via command {{cmd|summon}} are always unemployed until they have claimed a job site block. {{IN|bedrock}}, however, villagers summoned in similar ways have a random profession<ref>{{bug|MCPE-46034}}</ref>; their profession can be changed by a job site block, though.

Novice-level villagers who have not yet traded can lose their profession and change into unemployed villagers.

Unemployed adults actively seek for an unclaimed job site block and change into the corresponding profession.

Below is a table listing the various professions, along with the specific job site block that each profession requires (13 jobs in total, not including unemployed/nitwit):
{| class="wikitable sortable collapsible" style="text-align: center" data-description="Professions"
|-
! rowspan="2" |'''Profession'''
! rowspan="2" |'''Job site block / <br>Workstation'''
! colspan=7 | '''Biome'''
|-
! '''Desert'''
! '''Jungle'''<ref group="note" name="biomenote">Natural [[Minecraft:Jungle]] and [[Minecraft:swamp]] villages do not exist, but a village from another biome can intersect with any biome, including jungles and swamps, so jungle and swamp villagers can spawn naturally. These villagers can also be obtained by breeding villagers in the desired biome or by using a [[Minecraft:spawn egg]] in the desired biome, as well as by curing a zombie villager spawned in a jungle or swamp.</ref>
! '''Plains'''
! '''Savanna'''
! '''Snow'''
! '''Swamp'''<ref group="note" name="biomenote" />
! '''Taiga'''
|-
| {{EntitySprite|Villager}} ''Unemployed''
| rowspan="2" |None
| [[File:Desert Villager Base.png|x80px]]
| [[File:Jungle Villager Base.png|x80px]]
| [[File:Plains Villager Base.png|x80px]]
| [[File:Savanna Villager Base.png|x80px]]
| [[File:Snowy Villager Base.png|x80px]]
| [[File:Swamp Villager Base.png|x80px]]
| [[File:Taiga Villager Base.png|x80px]]
|-
| {{EntityLink|Nitwit}}
| [[File:Desert Nitwit.png|x80px]]
| [[File:Jungle Nitwit.png|x80px]]
| [[File:Plains Nitwit.png|x80px]]
| [[File:Savanna Nitwit.png|x80px]]
| [[File:Snowy Nitwit.png|x80px]]
| [[File:Swamp Nitwit.png|x80px]]
| [[File:Taiga Nitwit.png|x80px]]
|-
| {{EntityLink|Armorer}}
| {{BlockLink|Blast Furnace}}
| [[File:Desert Armorer.png|x80px]]
| [[File:Jungle Armorer.png|x80px]]
| [[File:Plains Armorer.png|x80px]]
| [[File:Savanna Armorer.png|x80px]]
| [[File:Snowy Armorer.png|x80px]]
| [[File:Swamp Armorer.png|x80px]]
| [[File:Taiga Armorer.png|x80px]]
|-
| {{EntityLink|Butcher}}
| {{BlockLink|Smoker}}
| [[File:Desert Butcher.png|x80px]]
| [[File:Jungle Butcher.png|x80px]]
| [[File:Plains Butcher.png|x80px]]
| [[File:Savanna Butcher.png|x80px]]
| [[File:Snowy Butcher.png|x80px]]
| [[File:Swamp Butcher.png|x80px]]
| [[File:Taiga Butcher.png|x80px]]
|-
| {{EntityLink|Cartographer}}
| {{BlockLink|Cartography Table}}
| [[File:Desert Cartographer.png|x80px]]
| [[File:Jungle Cartographer.png|x80px]]
| [[File:Plains Cartographer.png|x80px]]
| [[File:Savanna Cartographer.png|x80px]]
| [[File:Snowy Cartographer.png|x80px]]
| [[File:Swamp Cartographer.png|x80px]]
| [[File:Taiga Cartographer.png|x80px]]
|-
| {{EntityLink|Cleric}}
| {{BlockLink|Brewing Stand}}
| [[File:Desert Cleric.png|x80px]]
| [[File:Jungle Cleric.png|x80px]]
| [[File:Plains Cleric.png|x80px]]
| [[File:Savanna Cleric.png|x80px]]
| [[File:Snowy Cleric.png|x80px]]
| [[File:Swamp Cleric.png|x80px]]
| [[File:Taiga Cleric.png|x80px]]
|-
| {{EntityLink|Farmer}}
| {{BlockLink|Composter}}
| [[File:Desert Farmer.png|x80px]]
| [[File:Jungle Farmer.png|x80px]]
| [[File:Plains Farmer.png|x80px]]
| [[File:Savanna Farmer.png|x80px]]
| [[File:Snowy Farmer.png|x80px]]
| [[File:Swamp Farmer.png|x80px]]
| [[File:Taiga Farmer.png|x80px]]
|-
| {{EntityLink|Fisherman}}
| {{BlockLink|Barrel}}
| [[File:Desert Fisherman.png|x80px]]
| [[File:Jungle Fisherman.png|x80px]]
| [[File:Plains Fisherman.png|x80px]]
| [[File:Savanna Fisherman.png|x80px]]
| [[File:Snowy Fisherman.png|x80px]]
| [[File:Swamp Fisherman.png|x80px]]
| [[File:Taiga Fisherman.png|x80px]]
|-
| {{EntityLink|Fletcher}}
| {{BlockLink|Fletching Table}}
| [[File:Desert Fletcher.png|x80px]]
| [[File:Jungle Fletcher.png|x80px]]
| [[File:Plains Fletcher.png|x80px]]
| [[File:Savanna Fletcher.png|x80px]]
| [[File:Snowy Fletcher.png|x80px]]
| [[File:Swamp Fletcher.png|x80px]]
| [[File:Taiga Fletcher.png|x80px]]
|-
| {{EntityLink|Leatherworker}}
| {{BlockLink|Cauldron}}
| [[File:Desert Leatherworker.png|x80px]]
| [[File:Jungle Leatherworker.png|x80px]]
| [[File:Plains Leatherworker.png|x80px]]
| [[File:Savanna Leatherworker.png|x80px]]
| [[File:Snowy Leatherworker.png|x80px]]
| [[File:Swamp Leatherworker.png|x80px]]
| [[File:Taiga Leatherworker.png|x80px]]
|-
| {{EntityLink|Librarian}}
| {{BlockLink|Lectern}}
| [[File:Desert Librarian.png|x80px]]
| [[File:Jungle Librarian.png|x80px]]
| [[File:Plains Librarian.png|x80px]]
| [[File:Savanna Librarian.png|x80px]]
| [[File:Snowy Librarian.png|x80px]]
| [[File:Swamp Librarian.png|x80px]]
| [[File:Taiga Librarian.png|x80px]]
|-
| {{EntityLink|Mason}}
| {{BlockLink|Stonecutter}}
| [[File:Desert Mason.png|x80px]]
| [[File:Jungle Mason.png|x80px]]
| [[File:Plains Mason.png|x80px]]
| [[File:Savanna Mason.png|x80px]]
| [[File:Snowy Mason.png|x80px]]
| [[File:Swamp Mason.png|x80px]]
| [[File:Taiga Mason.png|x80px]]
|-
| {{EntityLink|Shepherd}}
| {{BlockLink|Loom}}
| [[File:Desert Shepherd.png|x80px]]
| [[File:Jungle Shepherd.png|x80px]]
| [[File:Plains Shepherd.png|x80px]]
| [[File:Savanna Shepherd.png|x80px]]
| [[File:Snowy Shepherd.png|x80px]]
| [[File:Swamp Shepherd.png|x80px]]
| [[File:Taiga Shepherd.png|x80px]]
|-
| {{EntityLink|Toolsmith}}
| {{BlockLink|Smithing Table}}
| [[File:Desert Toolsmith.png|x80px]]
| [[File:Jungle Toolsmith.png|x80px]]
| [[File:Plains Toolsmith.png|x80px]]
| [[File:Savanna Toolsmith.png|x80px]]
| [[File:Snowy Toolsmith.png|x80px]]
| [[File:Swamp Toolsmith.png|x80px]]
| [[File:Taiga Toolsmith.png|x80px]]
|-
| {{EntityLink|Weaponsmith}}
| {{BlockLink|Grindstone}}
| [[File:Desert Weaponsmith.png|x80px]]
| [[File:Jungle Weaponsmith.png|x80px]]
| [[File:Plains Weaponsmith.png|x80px]]
| [[File:Savanna Weaponsmith.png|x80px]]
| [[File:Snowy Weaponsmith.png|x80px]]
| [[File:Swamp Weaponsmith.png|x80px]]
| [[File:Taiga Weaponsmith.png|x80px]]
|}

=== Nitwit ===
{{main|Nitwit}}
[[File:Nitwit_refusing.gif|thumb|upright|A nitwit bobbling its head.{{only|java}}]]

Nitwit villagers wear robes that are green on top. They cannot change their profession, [[Minecraft:trade]], or gather around [[Minecraft:bell]]s, but are still able to breed. They are not equipped with a level stone since they cannot trade.

{{IN|java}}, pressing {{control|use}} on a nitwit causes it to grunt and bobble its head at the [[Minecraft:player]]. A nitwit must be born or spawned; no villagers change to nitwit from unemployed or a profession, and vice versa. Due to a bug, nitwits cannot spawn in through breeding.<ref>{{bug|MC-156556}}</ref> As such, they can only be found naturally or by [[#Curing|curing]] naturally spawned zombie villagers. Zombie villagers can also be spawned as babies, so this is the only way to encounter baby nitwits in Survival mode.

{{IN|bedrock}}, every baby villager has a 10% chance to become a nitwit when they become an adult, as well as having a different sleep schedule where they wander around the village for about 2000 ticks (1 minute 40 seconds) after other villagers go to sleep, before seeking a bed. If they can claim a bed, they arise in the morning 2000 ticks after the rest of the village wakes up.

=== Appearance ===
Villagers and [[Minecraft:zombie villager]]s have seven skin types corresponding to the biome they spawn in. 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, iron, gold, emerald, and diamond.

Villagers have different outfits depending on their biome. Naturally generated villagers take on the outfit from the biome they were spawned in. When breeding occurs, the outfit of the child is determined by the biome where the breeding occurs, but {{in|java}}, there is a 50% chance it's inherited from the biome type of the parents (equal chance for both parents). In case the villager's outfit is determined by biome but the biome has no specific villager type, it always becomes a plains villager. The outfits available are the following:

; {{EntitySprite|villager-desert}} Desert
{{columns-list|
* ''{{BiomeLink|Badlands}}''
* '''{{BiomeLink|Desert}}'''<ref group="n" name="village">Villages occur naturally in this biome.</ref>
* ''{{BiomeLink|Eroded Badlands}}''
* ''{{BiomeLink|Wooded Badlands}}''
}}

; {{EntitySprite|villager-savanna}} Savanna
{{columns-list|
* '''{{BiomeLink|Savanna}}'''<ref group="n" name="village"/>
* ''{{BiomeLink|Savanna Plateau}}''
* ''{{BiomeLink|Windswept Savanna}}'' 
}}

; {{EntitySprite|villager-taiga}} Taiga
{{columns-list|
* ''{{BiomeLink|Old Growth Pine Taiga}}''
* ''{{BiomeLink|Old Growth Spruce Taiga}}''
* '''{{BiomeLink|Taiga}}'''<ref group="n" name="village"/>
* ''{{BiomeLink|Windswept Hills}}''
* ''{{BiomeLink|Windswept Forest}}''
* ''{{BiomeLink|Windswept Gravelly Hills}}''
}}

; {{EntitySprite|villager-snowy}} Snowy
{{columns-list|
* ''{{BiomeLink|Deep Frozen Ocean}}''
* ''{{BiomeLink|Frozen Ocean}}''
* ''{{BiomeLink|Frozen Peaks}}''
* ''{{BiomeLink|Frozen River}}''
* ''{{BiomeLink|Grove}}''
* ''{{BiomeLink|Ice Spikes}}''
* ''{{BiomeLink|Jagged Peaks}}''
* '''{{BiomeLink|Snowy Beach}}''
* '''{{BiomeLink|Snowy Plains}}'''<ref group="n" name="village"/>
* ''{{BiomeLink|Snowy Slopes}}''
* '''''{{BiomeLink|Snowy Taiga}}'''''<ref group="n" name="village_be">Villages occur naturally in this biome {{in|Bedrock}}.</ref>
}}

; {{EntitySprite|villager-swamp}} Swamp
{{columns-list|
* ''{{BiomeLink|Mangrove Swamp}}''
* ''{{BiomeLink|Swamp}}''
}}

; {{EntitySprite|villager-jungle}} Jungle
{{columns-list|
* ''{{BiomeLink|Bamboo Jungle}}''
* ''{{BiomeLink|Jungle}}''
* ''{{BiomeLink|Sparse Jungle}}''
}}

; {{EntitySprite|villager-plains}} Plains
{{columns-list|
* '''{{BiomeLink|Meadow}}'''<ref group="n" name="village"/>
* '''{{BiomeLink|Plains}}'''<ref group="n" name="village"/>
* '''''{{BiomeLink|Sunflower Plains}}'''''<ref group="n" name="village_be"></ref>
* every other biome
}}

; Notes
{{reflist|group=n}}

Villagers have '''13 professions and 2 non professions for a total of 15 outfits''':
* '''Farmer''' (straw hat)
** Trades crops and natural foods, such as bread and cookies.
* '''Fisherman''' (fisher hat)
** Trades campfires and fishing items.
* '''Shepherd''' (brown hat with white apron)
** Trades shears, wool, dyes, paintings and beds.
* '''Fletcher''' (hat with feather and quiver on the back)
** Trades bows, crossbows, all types of arrows (except luck) and archery ingredients.
* '''Cleric''' (purple apron and creeper cloak)
** Trades magic items like ender pearls, redstone dust, glowstone dust, and other enchanting or potion ingredients.
* '''Weaponsmith''' (eyepatch and black apron)
** Trades minerals, bells and enchanted melee weapons. The axe enchantments are weapon related, such as [[Minecraft:Sharpness]] or [[Minecraft:Smite]].
* '''Armorer''' (welding mask)
** Trades foundry items and sells chain, iron and enchanted diamond armor tiers.
* '''Toolsmith''' (black apron)
** Trades minerals, bells and harvest tools. The axe enchantments are tool related.
* '''Librarian''' (eyeglasses and a book as a hat)
** Trades enchanted books, clocks, compasses, name tags, glass, ink sacs, lanterns, and book and quills.
* '''Cartographer''' (golden monocle)
** Trades banners, compasses, banner patterns, papers and various maps, including explorer maps.
* '''Leatherworker''' (brown apron and brown gloves)
** Trades scutes, rabbit hide, and leather-related items.
* '''Butcher''' (red headband and white apron)
** Trades meats, sweet berries, rabbit stew, and dried kelp blocks.
* '''Mason''' (black apron and black gloves)
** Trades polished stones, terracotta, clay, glazed terracotta and quartz.
* '''Nitwit''' (green coated, no badge)
** ''No trades, no badge''
* '''Unemployed''' (no overlay, base clothing of biome without any extra features)
** No trades until employed. No badge until employed.
* Villagers have different trades based on the biome in which they spawn.

== Trading ==
{{main|Trading}}
[[File:Villager GUI 1.14.png|thumb|The ''Java Edition'' trading interface, displaying basic novice-level trading options.]]
[[File:Villager GUI Master.png|thumb|Trading options of a max-level weaponsmith.]]
[[File:Minecraft villager level badges.png|thumb|Villager badge changes color depending on the level of the villager.<br>From left to right: stone ('''novice'''), iron ('''apprentice'''), gold ('''journeyman'''), emerald ('''expert'''), and diamond ('''master''').]]

The trading system is a [[Minecraft:gameplay]] mechanic that allows players to buy and sell various [[Minecraft:item]]s to and from villagers, using [[Minecraft:emerald]]s as a currency. Their trades can be valuable or somewhat meaningless, depending on the cost, the [[Minecraft:item]]s the player might get, and how the player treats the villagers.

Only adult villagers with professions can trade; the player cannot trade with nitwits, unemployed villagers, or baby villagers. Attempting to do so causes the villager to display a head-bobbling animation and play the villager's declined trade sound{{only|java}}.

Pressing the {{control|use}} control on an employed villager allows a player to trade, making offers based on the villager's profession and profession level. All offers involve emeralds as a currency, and items related to the villager's profession.

Trading can allow the acquisition of items that would otherwise be difficult or impossible to obtain, such as [[Minecraft:enchanted book]]s with "treasure" enchantments (e.g. [[Minecraft:Mending]]), [[Minecraft:bottles o' enchanting]], or [[Minecraft:Chainmail Armor|chainmail]] [[Minecraft:armor]].

When a villager gets a new trade, they receive 10 seconds of [[Minecraft:Regeneration]] I (totaling to {{hp|4}} of restoration), which emits pink particles. The villager also emits green particles suggesting contentment.

Completing a trade with a villager increases its professional level, and makes the villager drop {{xp|3|6}}; while willing to [[Minecraft:breed]], instead, {{xp|8|11}} is dropped. Some trades grant higher levels to the villager than others. As it advances through its profession, the villager offers additional trades. When a villager unlocks a new trade at a higher level, it almost always grants more experience than lower-level trades.

Villagers have a maximum supply of items and after the player has traded for an item that many times, the villager's supply of the item is exhausted. This results in the trade being temporarily locked. A player can continue to trade for the villager's other available items if any. Exhausted items are restocked when the villager works at a job site, up to twice per [[Minecraft:Daylight cycle|day]].

Clicking {{control|use}} on an unemployed or nitwit villager {{in|Java}} causes it to grunt and bobble their head; doing so {{in|Bedrock}} does nothing.

Using a [[Minecraft:name tag]] on a villager always names the villager instead of opening the trading interface.

{{IN|java}}, using {{keys|space}} inside of the trading interface after one trade was made refills the trading slots with items from the inventory.{{verify|Does this always work, or only when a trade is selected from the trading list? Does this also work on Bedrock Edition?}}

=== Supply and demand ===
{{For|detailed information on Villager economics|Trading#Economics}}
The price of an item can rise and fall with changes in demand. The price of a traded item can rise when next resupplied, or fall from a risen price if not traded. Demand is stored per item, not per villager.

=== Trade offering ===
[[File:VillagerOfferingItems.jpg|thumb|Several villagers offering trade items to a player.|alt=]]

When a [[Minecraft:player]] holds an [[Minecraft:emerald]] or other item near a villager who wants that item, the villager holds up an item it offers in exchange. {{IN|bedrock}}, villagers raise their arms when showing trade items. For example, a farmer villager who buys 20 [[Minecraft:wheat]] for one emerald holds up an emerald, offering it to a player holding wheat.

If the villager has more than one trade for an item, it cycles through the trades, offering a different item every few seconds. This kind of trading interaction makes it easier to find villagers who offer a particular trade, but the player must still open the trading interface to complete the trade. Note that villagers do not hold items to offer trades during their [[#Schedules|gather or sleep phases]], even though it is still possible to trade with them.

Villagers do not offer trades that are currently out of stock.

=== Economic trade ===
Villagers have various professions that progress through experience-based levels, unlocking new trade tiers. 

==== Experience levels ====
{| class="wikitable"
|+
!Name
!Minimum XP level
|-
|Novice
|0
|-
|Apprentice
|10
|-
|Journeyman
|70
|-
|Expert
|150
|-
|Master
|250
|}

* To rank up a villager, the [[Minecraft:player]] needs to trade. Trading with a Novice-level villager adds 1 or 2 XP per trade and each level progressively gains more XP per trade until the Master rank which earns up to 30 XP per trade. To see more, go to [[Minecraft:Trading#Trade offers|Trading]]. 

=== Popularity or reputation ===
{{IN|bedrock}}, villagers increase their prices of trades if a player's [[Minecraft:popularity]] is low, (e.g. from [[Minecraft:Damage/Mobs|damaging]] villagers), and decrease it if their popularity is high (e.g. from trading with multiple villagers). [[#Curing|Curing]] a [[Minecraft:zombie villager]] also increases the player's popularity by 10.

{{IN|java}}, a villager's prices are affected by the player's [[#Gossiping|reputation]] with that villager rather than by village popularity.

=== Hero of the Village ===
{{main|Hero of the Village}}

When a player receives {{EffectLink|Hero of the Village}}, players receive discounted prices on all the items traded by villagers in both editions. The {{EffectLink|Hero of the Village}} also gets gifts.{{only|java}}

Each villager throws gifts related to its profession, and nitwits and unemployed villagers throw wheat seeds instead. These gifts range in value from common (like [[Minecraft:seeds]]) to rare items (like [[Minecraft:chainmail armor]]).

A player's popularity increases by 10 {{in|Java}} and doesn't increase {{in|Bedrock}}. Villagers also shoot off [[Minecraft:fireworks]], with different colored fireworks with no pattern.

== Sounds ==
{{JE}}:
{{SoundTable
| type = java
| {{SoundLine
| sound =Villager idle1.ogg
|sound2=Villager idle2.ogg
|sound3=Villager idle3.ogg
|subtitle=Villager mumbles
|source=neutral
|description=Randomly while awake
|id=entity.villager.ambient
|translationkey=subtitles.entity.villager.ambient
|volume=1.0
|pitch=0.8-1.2<br>(Baby: 1.3-1.7)
|distance=16}}
| {{SoundLine
|sound=Villager trade1.ogg
|sound2=Villager trade2.ogg
|sound3=Villager trade3.ogg
|subtitle=Villager trades
|source=neutral
|description=Randomly while the trade UI on a villager is open
|id=entity.villager.trade
|translationkey=subtitles.entity.villager.trading
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Villager death.ogg
|subtitle=Villager dies
|source=neutral
|description=When a villager dies or becomes zombified
|id=entity.villager.death
|translationkey=subtitles.entity.villager.death
|volume=1.0
|pitch=0.8-1.2<br>(Baby: 1.3-1.7)
|distance=16}}
| {{SoundLine
|sound=Villager hurt1.ogg
|sound2=Villager hurt2.ogg
|sound3=Villager hurt3.ogg
|sound4=Villager hurt4.ogg
|subtitle=Villager hurts
|source=neutral
|description=When a villager is damaged
|id=entity.villager.hurt
|translationkey=subtitles.entity.villager.hurt
|volume=1.0
|pitch=0.8-1.2<br>(Baby: 1.3-1.7)
|distance=16}}
| {{SoundLine
|rowspan=2
|sound=Villager accept1.ogg
|sound2=Villager accept2.ogg
|sound3=Villager accept3.ogg
|subtitle=Villager cheers
|source=neutral
|description=When a villager wins a raid
|id=entity.villager.celebrate
|translationkey=subtitles.entity.villager.celebrate
|volume=1.0
|pitch=0.8-1.2<br>(Baby: 1.3-1.7)
|distance=16}}
| {{SoundLine
|subtitle=Villager agrees
|source=neutral
|description=When a player successfully trades with a villager or when a villager's stock has been updated {{needs testing}}
|id=entity.villager.yes
|translationkey=subtitles.entity.villager.yes
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Villager deny1.ogg
|sound2=Villager deny2.ogg
|sound3=Villager deny3.ogg
|subtitle=Villager disagrees
|source=neutral
|description=When a player trades with either an unemployed villager, a nitwit, or fails to trade with an employed villager due to lack of resources
|id=entity.villager.no
|translationkey=subtitles.entity.villager.no
|volume=1.0
|pitch=0.8-1.2
| distance = 16
}}
}}

==== Working ====
{{SoundTable
| type = java
| {{SoundLine
|sound =Blast Furnace fire crackle1.ogg
|sound2=Blast Furnace fire crackle2.ogg
|sound3=Blast Furnace fire crackle3.ogg
|sound4=Blast Furnace fire crackle4.ogg
|sound5=Blast Furnace fire crackle5.ogg
|subtitle=Armorer works
|source=neutral
|description=Randomly while an {{EntitySprite|villager-armorer}} armorer is working
|id=entity.villager.work_armorer
|translationkey=subtitles.entity.villager.work_armorer
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Smoker fire crackle1.ogg
|sound2=Smoker fire crackle2.ogg
|sound3=Smoker fire crackle3.ogg
|sound4=Smoker fire crackle4.ogg
|sound5=Smoker fire crackle5.ogg
|subtitle=Butcher works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-butcher}} butcher is working
|id=entity.villager.work_butcher
|translationkey=subtitles.entity.villager.work_butcher
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|subtitle=Cartographer works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-cartographer}} cartographer is working
|id=entity.villager.work_cartographer
|translationkey=subtitles.entity.villager.work_cartographer
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Brewing Stand brew1.ogg
|sound2=Brewing Stand brew2.ogg
|subtitle=Cleric works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-cleric}} cleric is working
|id=entity.villager.work_cleric
|translationkey=subtitles.entity.villager.work_cleric
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Composter fill1.ogg
|sound2=Composter fill2.ogg
|sound3=Composter fill3.ogg
|sound4=Composter fill4.ogg
|subtitle=Farmer works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-farmer}} farmer is working
|id=entity.villager.work_farmer
|translationkey=subtitles.entity.villager.work_farmer
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Barrel open1.ogg
|sound2=Barrel open2.ogg
|subtitle=Fisherman works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-fisherman}} fisherman is working
|id=entity.villager.work_fisherman
|translationkey=subtitles.entity.villager.work_fisherman
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Fletching Table1.ogg
|sound2=Fletching Table2.ogg
|subtitle=Fletcher works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-fletcher}} fletcher is working
|id=entity.villager.work_fletcher
|translationkey=subtitles.entity.villager.work_fletcher
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Cauldron dye1.ogg
|sound2=Cauldron dye2.ogg
|sound3=Cauldron dye3.ogg
|subtitle=Leatherworker works
|source=neutral
|description=Randomly while a {{EntitySprite|villager}} leatherworker is working
|id=entity.villager.work_leatherworker
|translationkey=subtitles.entity.villager.work_leatherworker
|volume=0.9
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Page turn1.ogg
|sound2=Page turn2.ogg
|sound3=Page turn3.ogg
|subtitle=Librarian works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-librarian}} librarian is working
|id=entity.villager.work_librarian
|translationkey=subtitles.entity.villager.work_librarian
|volume=2.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Stonecutter use1.ogg
|sound2=Stonecutter use2.ogg
|subtitle=Mason works
|source=neutral
|description=Randomly while a {{EntitySprite|villager}} mason is working
|id=entity.villager.work_mason
|translationkey=subtitles.entity.villager.work_mason
|volume=1.0
|pitch=0.8-1.2 <ref group=sound>Can be multiplied by 1.0 or 0.92 for each sound</ref>
|distance=16}}
| {{SoundLine
|sound=Loom1.ogg
|sound2=Loom2.ogg
|subtitle=Shepherd works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-shepherd}} shepherd is working
|id=entity.villager.work_shepherd
|translationkey=subtitles.entity.villager.work_shepherd
|volume=0.5
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Smithing Table1.ogg
|sound2=Smithing Table2.ogg
|sound3=Smithing Table3.ogg
|subtitle=Toolsmith works
|source=neutral
|description=Randomly while a {{EntitySprite|villager}} toolsmith is working
|id=entity.villager.work_toolsmith
|translationkey=subtitles.entity.villager.work_toolsmith
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
| {{SoundLine
|sound=Grindstone use1.ogg
|sound2=Grindstone use2.ogg
|sound3=Grindstone use3.ogg
|subtitle=Weaponsmith works
|source=neutral
|description=Randomly while a {{EntitySprite|villager-weaponsmith}} weaponsmith is working
|id=entity.villager.work_weaponsmith
|translationkey=subtitles.entity.villager.work_weaponsmith
|volume=0.5
|pitch=0.8-1.2
| distance = 16
}}
}}

{{BE}}:
{{SoundTable
| type = bedrock
| {{SoundLine
| sound =Villager idle1.ogg
|sound2=Villager idle2.ogg
|sound3=Villager idle3.ogg
|source=neutral
|description=Randomly while awake
|id=mob.villager.idle
|volume=1.0
|pitch=0.8-1.2 (Baby: 1.3-1.7)}}
| {{SoundLine
|sound=Villager death.ogg
|source=neutral
|description=When a villager dies or becomes zombified
|id=mob.villager.death
|volume=1.0
|pitch=0.8-1.2 (Baby: 1.3-1.7)}}
| {{SoundLine
|sound=Villager hurt1.ogg
|sound2=Villager hurt2.ogg
|sound3=Villager hurt3.ogg
|sound4=Villager hurt4.ogg
|source=neutral
|description=When a villager is damaged
|id=mob.villager.hit
|volume=1.0
|pitch=0.8-1.2 (Baby: 1.3-1.7)}}
| {{SoundLine
|sound=Villager accept1.ogg
|sound2=Villager accept2.ogg
|sound3=Villager accept3.ogg
|source=neutral
|description=When a player successfully trades with a villager or a player places the required items to make a trade in the trade UI
|id=mob.villager.yes
|volume=1.0
|pitch=0.8-1.2}}
| {{SoundLine
|sound=Villager deny1.ogg
|sound2=Villager deny2.ogg
|sound3=Villager deny3.ogg
|source=neutral
|description=When a player is unable to complete a trade
|id=mob.villager.no
|volume=1.0
|pitch=0.8-1.2}}
| {{SoundLine
|sound=Villager trade1.ogg
|sound2=Villager trade2.ogg
|sound3=Villager trade3.ogg
|source=neutral
|description=Randomly while the trade UI on a villager is open
|id=mob.villager.haggle
|volume=1.0
| pitch = 0.8-1.2
}}
}}

==== Working ====
{{SoundTable
| type = bedrock
| {{SoundLine
| sound =Furnace fire crackle1.ogg
|sound2=Furnace fire crackle2.ogg
|sound3=Furnace fire crackle3.ogg
|sound4=Furnace fire crackle4.ogg
|sound5=Furnace fire crackle5.ogg
|source=block
|description=Randomly while an {{EntitySprite|villager-armorer}} armorer is working
|id=block.blastfurnace.fire_crackle
|volume=3.0
|pitch=0.6}}
| {{SoundLine
|sound=Smoker fire crackle1.ogg
|sound2=Smoker fire crackle2.ogg
|sound3=Furnace fire crackle4.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-butcher}} butcher is working
|id=block.smoker.smoke
|volume=3.0
|pitch=''varies'' <ref group="sound">1.0 for all except <code>fire_crackle4</code> (the last sound), which is 0.8</ref>}}
| {{SoundLine
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-cartographer}} cartographer is working
|id=block.cartography_table.use
|volume=0.8
|pitch=''varies'' <ref group="sound">Can be 1.0 or 0.92 for each sound</ref>}}
| {{SoundLine
|sound=Brewing Stand brew1.ogg
|sound2=Brewing Stand brew2.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-cleric}} cleric is working
|id=random.potion.brewed
|volume=1.0
|pitch=1.0}}
| {{SoundLine
|sound=Composter fill1.ogg
|sound2=Composter fill2.ogg
|sound3=Composter fill3.ogg
|sound4=Composter fill4.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-farmer}} farmer is working
|id=block.composter.fill
|volume=1.3
|pitch=0.8}}
| {{SoundLine
|sound=Barrel open1.ogg
|sound2=Barrel open2.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-fisherman}} fisherman is working
|id=block.barrel.open
|volume=1.0
|pitch=1.0}}
| {{SoundLine
|sound=Wood dig1.ogg
|sound2=Wood dig2.ogg
|sound3=Wood dig3.ogg
|sound4=Wood dig4.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-fletcher}} fletcher is working
|id=dig.wood
|volume=12.0
|pitch=1.0}}
| {{SoundLine
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager}} leatherworker is working
|id=bucket.fill_water
|volume=1.0
|pitch=1.0}}
| {{SoundLine
|sound=Book thump1.ogg
|sound2=Book thump2.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-librarian}} librarian is working
|id=item.book.put
|volume=4.8
|pitch=1.0}}
| {{SoundLine
|sound=Stonecutter use1.ogg
|sound2=Stonecutter use2.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager}} mason is working
|id=block.stonecutter.use
|volume=0.7
|pitch=1.0}}
| {{SoundLine
|sound=Loom1.ogg
|sound2=Loom2.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-shepherd}} shepherd is working
|id=block.loom.use
|volume=0.75
|pitch=1.0}}
| {{SoundLine
|sound=Smithing Table1.ogg
|sound2=Smithing Table2.ogg
|sound3=Smithing Table3.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager}} toolsmith is working
|id=smithing_table.use
|volume=1.0
|pitch=1.0}}
| {{SoundLine
|sound=Grindstone use1.ogg
|sound2=Grindstone use2.ogg
|sound3=Grindstone use3.ogg
|source=block
|description=Randomly while a {{EntitySprite|villager-weaponsmith}} weaponsmith is working
|id=block.grindstone.use
|volume=0.5
| pitch = 1.0
}}
}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|generatetranslationkeys=y
|displayname=Villager
|spritetype=entity
|nameid=villager
|showentitytags=y
|entitytags=cannot_be_age_locked,followable_friendly_mobs
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|generatetranslationkeys=y
|displayname=Villager (old)
|showentityfamily=y
|entityfamily=armorer,butcher,cartographer,cleric,farmer,fisherman,fletcher,leatherworker,librarian,mob,nitwit,shepherd,stone_mason,toolsmith,villager,weaponsmith
|spritetype=entity
|spritename=villager-revision-1
|nameid=villager
|id=15}}
{{ID table
|displayname=Villager (new)
|showentityfamily=y
|entityfamily=armorer,butcher,cartographer,cleric,farmer,fisherman,fletcher,leatherworker,librarian,mob,nitwit,shepherd,stone_mason,toolsmith,villager,weaponsmith
|spritetype=entity
|spritename=villager
|nameid=villager_v2
|id=115
|foot=1}}

=== Entity data ===
Villagers have entity data associated with them that contains various properties.

{{el|java}}:
{{main|Entity format}}
<section begin="entity data" /><div class="treeview">
* {{nbt|compound}} Entity data
** {{nbt inherit/breedable}}
** {{nbt inherit/entity}}
** {{nbt inherit/mob}}
** <section begin="villager base data"/>{{nbt|list|Gossips}}: Pieces of [[Minecraft:Villager#Gossiping|gossip]] that can be exchanged between villagers when they meet. Is not preserved when removed.
*** {{nbt|compound}} A piece of gossip.
**** {{nbt|int|Value}}: The strength of the gossip.
***** for {{code|major_negative}}: weight -5, max 100, +25 if the villager sees you kill another villager, -10 every 20min, -10 when shared
***** for {{code|minor_negative}}: weight -1, max 200, +25 when hit, -20 every 20min, -20 when shared
***** for {{code|major_positive}}: weight 5, max 20, +20 when cured, does not decrease and never shared
***** for {{code|minor_positive}}: weight 1, max 200, +25 when cured, -1 every 20min, -5 when shared
***** for {{code|trading}}: weight 1, max 25, +2 per trade, -2 every 20min, -20 when shared
**** {{nbt|int-array|Target}} The [[Minecraft:UUID]] of the player who caused the gossip, stored as four ints.
**** {{nbt|string|Type}}: An ID value indicating the type of gossip. The possible values are {{cd|major_negative|minor_negative|major_positive|minor_positive|trading|d=and}}.
** {{nbt|compound|Offers}}: Is generated when the trading menu is opened for the first time.
*** {{nbt|list|Recipes}}: List of trade options.
**** {{nbt|compound}} A trade option.
***** {{nbt|compound|buy}}: The first 'cost' item, without the Slot tag.
****** {{nbt inherit/itemnoslot|indent=******}}
***** {{nbt|compound|buyB}}: Optional. The second 'cost' item, without the Slot tag.
****** {{nbt inherit/itemnoslot|indent=******}}
***** {{nbt|int|demand}}: The price adjuster of the first 'cost' item based on demand. Updated when a villager resupply.
***** {{nbt|int|maxUses}}: The maximum number of times this trade can be used before it is disabled. Increases by a random amount from 2 to 12 when offers are refreshed.
***** {{nbt|float|priceMultiplier}}: The multiplier on the {{nbt|int|demand}} price adjuster; the final adjusted price is added to the first 'cost' item's price.
***** {{nbt|byte|rewardExp}}: 1 or 0 (true/false) – Whether this trade provides XP orb drops. All trades from naturally-generated villagers in Java Edition reward XP orbs.
***** {{nbt|compound|sell}}: The item being sold for each set of cost items, without the Slot tag.
****** {{nbt inherit/itemnoslot|indent=******}}
***** {{nbt|int|specialPrice}}: A modifier added to the original price of the first 'cost' item. 
***** {{nbt|int|uses}}: The number of times this trade has been used. The trade becomes disabled when this is greater or equal to maxUses.
***** {{nbt|int|xp}}: How much experience the villager gets from this trade.
** {{nbt|compound|VillagerData}}: Information about the villager’s type, profession, and level.
*** {{nbt|int|level}}: The current level of this villager's profession. Influences the trading options generated by the villager. If it is greater than their profession's maximum level, no new offers are generated. Increments when the villager fills his trading xp bar. Also used for badge rendering.
**** 1: Novice
**** 2: Apprentice
**** 3: Journeyman
**** 4: Expert
**** 5: Master
*** {{nbt|string|profession}}: A [[Minecraft:resource location]] indicating the villager's profession; see {{slink|{{#ifeq:{{PAGENAME}}|Villager||Villager}}|Professions}}.
*** {{nbt|string|type}}: A [[Minecraft:resource location]] indicating the villager's type; see {{slink|{{#ifeq:{{PAGENAME}}|Villager||Villager}}|Appearance}}. Represents the {{DCL|minecraft:villager/variant}} component.
** {{nbt|int|Xp}}: How much experience the villager currently has, increases with trading in various amounts.
*** 0 to 9: Novice
*** 10 to 69: Apprentice
*** 70 to 149: Journeyman
*** 150 to 249: Expert
*** 250 and more: Master<section end="villager base data"/>
** {{nbt|list|Inventory}}: Each compound tag in this list is an item in the villager's inventory, up to a maximum of 8 slots. Items in two or more slots that can be stacked together are automatically condensed into one slot. If there are more than 8 slots, the last slot is removed until the total is 8. If there are 9 slots but two previous slots can be condensed, the last slot returns after the two other slots are combined.
***{{nbt|compound}} An item in the inventory, excluding the Slot tag.
**** {{nbt inherit/itemnoslot|indent=****}}
** {{nbt|long|LastRestock}}: The last tick the villager went to their job site block to resupply their trades.
** {{nbt|long|LastGossipDecay}}: The last tick all gossip of the villager has decreased strength naturally.
** {{nbt|int|RestocksToday}}: The number of restocks a villager has done in 10 minutes from the last restock, or <code>0</code> if the villager has not restocked in the last 10 minutes. When a villager has restocked twice in less than 10 minutes, it waits at least 10 minutes for another restock.
** {{nbt|byte|Willing}}: 1 or 0 (true/false) – true if the villager is willing to mate. Becomes true after certain trades (those that would cause offers to be refreshed), and false after mating.
</div>
{{anchor|Type data values}}
{|class="wikitable mw-collapsible mw-collapsed"
! Type
! Data value
|-
| [[File:Desert Villager Base.png|32px]] [[Minecraft:Desert]]
| <code>minecraft:desert</code>
|-
| [[File:Jungle Villager Base.png|32px]] [[Minecraft:Jungle]]
| <code>minecraft:jungle</code>
|-
| [[File:Plains Villager Base.png|32px]] [[Minecraft:Plains]]
| <code>minecraft:plains</code>
|-
| [[File:Savanna Villager Base.png|32px]] Savanna
| <code>minecraft:savanna</code>
|-
| [[File:Snowy Villager Base.png|32px]] Snowy
| <code>minecraft:snow</code>
|-
| [[File:Swamp Villager Base.png|32px]] [[Minecraft:Swamp]]
| <code>minecraft:swamp</code>
|-
| [[File:Taiga Villager Base.png|32px]] [[Minecraft:Taiga]]
| <code>minecraft:taiga</code>
|}
{{anchor|Profession data values}}
{|class="wikitable mw-collapsible mw-collapsed"
! Profession
! Data value
|-
| [[File:Plains Armorer.png|32px]] Armorer
| <code>minecraft:armorer</code>
|-
| [[File:Plains Butcher.png|32px]] Butcher
| <code>minecraft:butcher</code>
|-
| [[File:Plains Cartographer.png|32px]] Cartographer
| <code>minecraft:cartographer</code>
|-
| [[File:Plains Cleric.png|32px]] Cleric
| <code>minecraft:cleric</code>
|-
| [[File:Plains Farmer.png|32px]] Farmer
| <code>minecraft:farmer</code>
|-
| [[File:Plains Fisherman.png|32px]] Fisherman
| <code>minecraft:fisherman</code>
|-
| [[File:Plains Fletcher.png|32px]] Fletcher
| <code>minecraft:fletcher</code>
|-
| [[File:Plains Leatherworker.png|32px]] Leatherworker
| <code>minecraft:leatherworker</code>
|-
| [[File:Plains Librarian.png|32px]] Librarian
| <code>minecraft:librarian</code>
|-
| [[File:Plains Nitwit.png|32px]] Nitwit
| <code>minecraft:nitwit</code>
|-
| [[File:Plains Villager Base.png|32px]] Unemployed
| <code>minecraft:none</code>
|-
| [[File:Plains Mason.png|32px]] Mason
| <code>minecraft:mason</code>
|-
| [[File:Plains Shepherd.png|32px]] Shepherd
| <code>minecraft:shepherd</code>
|-
| [[File:Plains Toolsmith.png|32px]] Toolsmith
| <code>minecraft:toolsmith</code>
|-
| [[File:Plains Weaponsmith.png|32px]] Weaponsmith
| <code>minecraft:weaponsmith</code>
|}<section end="entity data" />

{{el|bedrock}}:
: See [[Minecraft:Bedrock Edition level format/Entity format]].

== Achievements ==
{{load achievements|The Haggler;Treasure Hunter;Buy Low, Sell High;Master Trader;Star Trader}}

Achievements that apply to all mobs:
{{collapse|content={{load achievements|Overkill;Over-Overkill;Mob Kabob}}
}}

== Advancements ==
{{load advancements|What a Deal!;Surge Protector;Zombie Doctor;Very Very Frightening;Star Trader}}

Advancements that apply to all mobs:
{{collapse|content={{load advancements|Take Aim;Arbalistic;A Throwaway Joke;Adventure;Over-Overkill;Mob Kabob}}
}}

== Videos ==
{{yt|5IQgjIMfQek}}

== History ==
=== Announcement ===
{{HistoryTable
|{{HistoryLine||September 29, 2018|link={{tweet|Minecraft|1046094052414967811}}|The [[Minecraft:Village and Pillage]] update, which improves villagers and [[Minecraft:village]]s, was announced at [[Minecraft:MINECON Earth 2018]].}}
}}

=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.0.0|dev=Beta 1.9 Prerelease|[[File:Farmer.png|x48px]] [[File:Librarian.png|x48px]] [[File:Priest.png|x48px]] [[File:Blacksmith.png|x48px]] [[File:Butcher.png|x48px]] [[File:Nitwit.png|x48px]] Added villagers.
|Villagers share the same [[Minecraft:Mob AI|AI]] as [[Minecraft:pig]]s.
|Villagers have the name "TESTIFICATE" displayed over their heads as [[Minecraft:player]] names are displayed in multiplayer.
|Villages have 5 main professions (0, 1, 2, 3, 4), and other profession numbers were a green-robed unnamed villager.
|''"We added them in 2011, but in the beginning they were completely useless - you couldn't trade with them, they didn't have any sound effects or anything. Their only purpose was to live in the villages. We discussed a lot about what they would do - we knew we wanted trading, but we weren't sure about what would happen with the village itself. Would the player do quests around the village? Would it expand?"'' – [[Minecraft:Jeb]]<ref name="meet-villagers">{{Mcnet|meet-villagers|Meet the Villagers|March 13, 2017|Marsh Davies}}</ref>}}
|{{HistoryLine|||dev=Beta 1.9 Prerelease 2|The "TESTIFICATE" name above villager's heads has been removed.}}
|{{HistoryLine||1.1|dev=11w49a|Added the villager [[Minecraft:spawn egg]] to [[Minecraft:Creative]] mode. However, only farmer villagers are spawned.}}
|{{HistoryLine||1.2.1|dev=12w05a|Villagers now go inside at [[Minecraft:Daylight cycle#Night|night]] and detect houses.
|Villagers can now open and close [[Minecraft:door]]s.}}
|{{HistoryLine|||dev=12w06a|Villagers can now socialize with each other and passive [[Minecraft:mob]]s.
|Villagers are now attacked by and run away from [[Minecraft:zombie]]s.
|Villagers now go inside shelter whenever it [[Minecraft:rain]]s.}}
|{{HistoryLine|||dev=12w07a|[[File:Farmer.png|20px]] [[File:Librarian.png|20px]] [[File:Priest.png|20px]] [[File:Blacksmith.png|20px]] [[File:Butcher.png|20px]] [[File:Nitwit.png|20px]] Added baby villagers.
|Villagers now repopulate [[Minecraft:village]]s by the number of houses there are.
|Villager children now [[Minecraft:sprint]].}}
|{{HistoryLine||1.3.1|dev=12w18a|Villagers spawned via a [[Minecraft:spawn egg]] now have a random profession.}}
|{{HistoryLine|||dev=12w21a|Added [[Minecraft:trading]] with villagers. Leaving a trading window open causes villagers not to wander under normal circumstances.}}
|{{HistoryLine|||dev=12w22a|Villagers now reassign their profession if there is a lack of a specific profession or if the number of villagers in a profession is unbalanced (i.e., if there are many farmer villagers and no blacksmith villagers, one changes its skin, showing it has changed its profession).
|[[Minecraft:Trading]] has also been changed, where an extra input space has been added where tools can be placed for buying [[Minecraft:enchanting|enchantments]] and/or repair.}}
|{{HistoryLine|||dev=12w25a|Villagers may now remove a trade option after it has been used at least 3 times.}}
|{{HistoryLine|||dev=12w26a|Although requiring external tools or modifications to apply, [[Minecraft:monster spawner]]s can now spawn the previously unavailable green robe villagers in unmodified Minecraft clients.}}
|{{HistoryLine||1.4.2|dev=12w32a|Villagers now like and dislike the [[Minecraft:player]], depending on how they react to them.
|Villagers can now be infected by [[Minecraft:zombie]]s, causing them to change their appearance and attack the [[Minecraft:player]] and other villagers.}}
|{{HistoryLine||1.4.4|dev=pre|Villager children can now be spawned easily by right-clicking a villager with a villager [[Minecraft:spawn egg]].}}
|{{HistoryLine||1.6.1|dev=13w22a|Added [[Minecraft:sound]] effects for villagers. They have different sounds for taking [[Minecraft:damage]], talking to villagers, successful [[Minecraft:trading|trades]], and canceled trades.}}
|{{HistoryLine||1.8|dev=14w02a|Added careers to villagers, splitting up the trade offers within a profession. This career is shown in the trading interface. 
|The [[Minecraft:trading]] system has been reworked to be less random; it is now tier-based instead, and several offers may be generated at one time.
|Due to the changes in the trading system, attempting to trade with generic villagers crashes the game.
|Villagers now [[Minecraft:breeding|breed]] only when willing. This limits the number of villagers and prevents infinite breeding [[Minecraft:village]]s.}}
|{{HistoryLine|||dev=14w02c|Villagers that had professions more than 4 now repeat in 0-4.
|Generic villagers can now be spawned only by using negative profession numbers.}}
|{{HistoryLine|||dev=14w03a|Villagers struck by [[Minecraft:lightning]] now turn into [[Minecraft:witch]]es.}}
|{{HistoryLine|||dev=14w04a|Farmer (profession) villagers now harvest fully grown [[Minecraft:crops]].
|Villagers can now be made willing using 3 [[Minecraft:bread]], 12 [[Minecraft:carrot]]s or 12 [[Minecraft:potato]]es.}}
|{{HistoryLine|||dev=14w04b|Villagers now have an NBT [[Minecraft:tag]] that allows control over getting [[Minecraft:experience]] for [[Minecraft:trading]] (reward exp).}}
|{{HistoryLine|||dev=14w20a|The generic villager has been completely removed. However, its texture still exists in the Minecraft files.}}
|{{HistoryLine||1.8.1|dev=pre4|Villagers no longer ignore data tags or damage values.}}
|{{HistoryLine||1.9|dev=15w31a|Farmer villagers now harvest [[Minecraft:beetroot]] crops, but ignore the [[Minecraft:drops]].}}
|{{HistoryLine|||dev=15w38a|Villagers now pick up beetroot and [[Minecraft:beetroot seeds]].
|Villagers now use and share beetroot as [[Minecraft:food]].
|Farmer villagers can now plant beetroot seeds.}}
|{{HistoryLine|||dev=15w39a|Villagers are now slightly taller (1.95 [[Minecraft:block]]s tall rather than 1.8, with babies 0.975 blocks tall rather than 0.9).}}
|{{HistoryLine|||dev=15w43a|A priest villager can now be found caged in an [[Minecraft:igloo]] basement.}}
|{{HistoryLine||1.11|dev=16w32b|[[File:Nitwit.png|x48px]] Generic villagers have been re-added. They are now called Nitwits, as profession 5. However, they can no longer [[Minecraft:trading|trade]], because right-clicking on a generic villager does nothing.}}
|{{HistoryLine|||dev=16w39a|Added a new career for the librarian villager called "Cartographer".}}
|{{HistoryLine|||dev=16w43a|Villagers are now able to draw from their own loot tables.}}
|{{HistoryLine||1.13|dev=17w47a
|The Weapon Smith's career ID has been changed from 3 to 2 and the Tool Smith's from 2 to 3.}}
|{{HistoryLine|||dev=18w11a|Villagers now run away from [[Minecraft:drowned]].}}
|{{HistoryLine||1.14|dev=18w47a|Villagers now hide in houses during [[Minecraft:raid]]s.
|[[File:Panicked Villager.gif|32px]] Villagers don't trade while a [[Minecraft:raid]] is ongoing, right-clicking them instead makes them emit sweat [[Minecraft:particles]].}}
|{{HistoryLine|||dev=18w50a|Added the [[Minecraft:mason]] profession.
|All careers have been split into their own professions.
|Villagers now have different skins based on [[Minecraft:biome]] (including [[Minecraft:swamp]]s and [[Minecraft:jungle]]s, which do not contain [[Minecraft:village]]s), as well as profession.
|[[File:Desert Villager Base.png|x48px]] [[File:Desert Armorer.png|x48px]] [[File:Desert Butcher.png|x48px]] [[File:Desert Cartographer.png|x48px]] [[File:Desert Cleric.png|x48px]] [[File:Desert Farmer.png|x48px]] [[File:Desert Fisherman.png|x48px]] [[File:Desert Fletcher.png|x48px]] [[File:Desert Leatherworker.png|x48px]] [[File:Desert Librarian.png|x48px]] [[File:Desert Mason.png|x48px]] [[File:Desert Nitwit.png|x48px]] [[File:Desert Shepherd.png|x48px]] [[File:Desert Toolsmith.png|x48px]] [[File:Desert Weaponsmith.png|x48px]] Added [[Minecraft:desert]] villagers, which all have unique textures for that biome. These villagers also spawn in [[Minecraft:badlands]] biomes.
|[[File:Jungle Villager Base.png|x48px]] [[File:Jungle Armorer.png|x48px]] [[File:Jungle Butcher.png|x48px]] [[File:Jungle Cartographer.png|x48px]] [[File:Jungle Cleric.png|x48px]] [[File:Jungle Farmer.png|x48px]] [[File:Jungle Fisherman.png|x48px]] [[File:Jungle Fletcher.png|x48px]] [[File:Jungle Leatherworker.png|x48px]] [[File:Jungle Librarian.png|x48px]] [[File:Jungle Mason.png|x48px]] [[File:Jungle Nitwit.png|x48px]] [[File:Jungle Shepherd.png|x48px]] [[File:Jungle Toolsmith.png|x48px]] [[File:Jungle Weaponsmith.png|x48px]] Added [[Minecraft:jungle]] villagers, which all have unique textures for that biome. However, jungles do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|[[File:Plains Villager Base.png|x48px]] [[File:Plains Armorer.png|x48px]] [[File:Plains Butcher.png|x48px]] [[File:Plains Cartographer.png|x48px]] [[File:Plains Cleric.png|x48px]] [[File:Plains Farmer.png|x48px]] [[File:Plains Fisherman.png|x48px]] [[File:Plains Fletcher.png|x48px]] [[File:Plains Leatherworker.png|x48px]] [[File:Plains Librarian.png|x48px]] [[File:Plains Mason.png|x48px]] [[File:Plains Nitwit.png|x48px]] [[File:Plains Shepherd.png|x48px]] [[File:Plains Toolsmith.png|x48px]] [[File:Plains Weaponsmith.png|x48px]] Added [[Minecraft:plains]] villagers, which all have unique textures for that biome.
|[[File:Savanna Villager Base.png|x48px]] [[File:Savanna Armorer.png|x48px]] [[File:Savanna Butcher.png|x48px]] [[File:Savanna Cartographer.png|x48px]] [[File:Savanna Cleric.png|x48px]] [[File:Savanna Farmer.png|x48px]] [[File:Savanna Fisherman.png|x48px]] [[File:Savanna Fletcher.png|x48px]] [[File:Savanna Leatherworker.png|x48px]] [[File:Savanna Librarian.png|x48px]] [[File:Savanna Mason.png|x48px]] [[File:Savanna Nitwit.png|x48px]] [[File:Savanna Shepherd.png|x48px]] [[File:Savanna Toolsmith.png|x48px]] [[File:Savanna Weaponsmith.png|x48px]] Added [[Minecraft:savanna]] villagers, which all have unique textures for that biome.
|[[File:Snowy Villager Base.png|x48px]] [[File:Snowy Armorer.png|x48px]] [[File:Snowy Butcher.png|x48px]] [[File:Snowy Cartographer.png|x48px]] [[File:Snowy Cleric.png|x48px]] [[File:Snowy Farmer.png|x48px]] [[File:Snowy Fisherman.png|x48px]] [[File:Snowy Fletcher.png|x48px]] [[File:Snowy Leatherworker.png|x48px]] [[File:Snowy Librarian.png|x48px]] [[File:Snowy Mason.png|x48px]] [[File:Snowy Nitwit.png|x48px]] [[File:Snowy Shepherd.png|x48px]] [[File:Snowy Toolsmith.png|x48px]] [[File:Snowy Weaponsmith.png|x48px]] Added snowy villagers, which all have unique textures in snowy biomes. These villagers spawn in any snowy [[Minecraft:biome]], including [[Minecraft:frozen river]]s, [[Minecraft:frozen ocean]]s (and their variants) and [[Minecraft:snowy beach]]es.
|[[File:Swamp Villager Base.png|x48px]] [[File:Swamp Armorer.png|x48px]] [[File:Swamp Butcher.png|x48px]] [[File:Swamp Cartographer.png|x48px]] [[File:Swamp Cleric.png|x48px]] [[File:Swamp Farmer.png|x48px]] [[File:Swamp Fisherman.png|x48px]] [[File:Swamp Fletcher.png|x48px]] [[File:Swamp Leatherworker.png|x48px]] [[File:Swamp Librarian.png|x48px]] [[File:Swamp Mason.png|x48px]] [[File:Swamp Nitwit.png|x48px]] [[File:Swamp Shepherd.png|x48px]] [[File:Swamp Toolsmith.png|x48px]] [[File:Swamp Weaponsmith.png|x48px]] Added [[Minecraft:swamp]] villagers, which all have unique textures for that biome. However, swamps do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|[[File:Taiga Villager Base.png|x48px]] [[File:Taiga Armorer.png|x48px]] [[File:Taiga Butcher.png|x48px]] [[File:Taiga Cartographer.png|x48px]] [[File:Taiga Cleric.png|x48px]] [[File:Taiga Farmer.png|x48px]] [[File:Taiga Fisherman.png|x48px]] [[File:Taiga Fletcher.png|x48px]] [[File:Taiga Leatherworker.png|x48px]] [[File:Taiga Librarian.png|x48px]] [[File:Taiga Mason.png|x48px]] [[File:Taiga Nitwit.png|x48px]] [[File:Taiga Shepherd.png|x48px]] [[File:Taiga Toolsmith.png|x48px]] [[File:Taiga Weaponsmith.png|x48px]] Added [[Minecraft:taiga]] villagers, which all have unique textures for the biome. These villagers also spawn in [[Minecraft:giant tree taiga]] and [[Minecraft:windswept hills]] biomes.
|[[File:Desert Villager Base.png|20px]] [[File:Jungle Villager Base.png|20px]] [[File:Plains Villager Base.png|20px]] [[File:Savanna Villager Base.png|20px]] [[File:Snowy Villager Base.png|20px]] [[File:Swamp Villager Base.png|20px]] [[File:Taiga Villager Base.png|20px]] Added baby villagers to [[Minecraft:desert]], [[Minecraft:jungle]], [[Minecraft:plains]], [[Minecraft:savanna]], snowy, [[Minecraft:swamp]] and [[Minecraft:taiga]] biomes. However, jungles and swamps do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|Villagers now have five tiers and show which [[Minecraft:trade]] tier they've unlocked, by a badge of a varying material on their suit. The first trade tier appears as a stone badge, the next iron, then gold, emerald and finally diamond.
|Villagers now run away from and get infected by [[Minecraft:giant]]s.}}
|{{HistoryLine|||dev=19w03a|Villagers no longer run away from nor get infected by giants.}}
|{{HistoryLine|||dev=19w11a|Added many new villager [[Minecraft:trade]]s, for each villager profession.
|Villager trading prices now also depend on the [[Minecraft:player]]'s popularity in the [[Minecraft:village]].
|Villagers now resupply their trades up to two times a day, if they get to work at a job site [[Minecraft:block]].
|The villager trading UI has been updated.
|Villagers now level up in a new way.
|Villagers now have a daily schedule. They go to work and meet up at the village bell. Each villager tries to find its own [[Minecraft:bed]] and job site block. Each profession has a specific [[Minecraft:block]] that works as a job site block for them (e.g. [[Minecraft:lectern]] for the librarian and [[Minecraft:cauldron]] for the leatherworker).
|Villagers now sleep in [[Minecraft:bed]]s at [[Minecraft:night]].
|[[Minecraft:Iron golem]]s now spawn when enough villagers meet.}}
|{{HistoryLine|||dev=19w13a|Villagers can now [[Minecraft:trade]] during [[Minecraft:raid]]s.
|Villagers now sweat during raids.
|Villagers now hide in houses when a [[Minecraft:bell]] is rung by the [[Minecraft:player]].
|Villagers now throw gifts to players with the different [[Minecraft:Hero of the Village]] status effects, with the gift item depending on their profession. Baby villagers throw [[Minecraft:flower|poppies]].}}
|{{HistoryLine|||dev=19w13b|The [[Minecraft:trading]] UI of villagers has been revamped.
|Available trades are now listed in a left sidebar, similar to {{BE}}.
|When [[Minecraft:player]]s have the required materials, clicking on one of the trades now put the [[Minecraft:item]]s into the slots automatically.}}
|{{HistoryLine|||dev=19w14a|[[File:Nitwit refusing.gif|x48px]] [[File:Villager refusing.gif|x48px]] Nitwits and unemployed villagers now bobble their head and grunt if the player tries to [[Minecraft:trade]] with them.}}
|{{HistoryLine|||dev=pre1|Fletcher villagers no longer sell luck [[Minecraft:arrow]]s.
|100% of villager trades are now discounted when the [[Minecraft:player]] has the [[Minecraft:Hero of the Village]] effect.}}
|{{HistoryLine||1.14.3|dev=pre1|Panicking villagers now have a higher chance of spawning [[Minecraft:iron golem]]s.
|Farmer villagers now spend more time farming when they are working.
|Farmer villagers now always give away [[Minecraft:food]] even if other villagers do not need it.}}
|{{HistoryLine|||dev=pre2|Panicked villagers now have to work and sleep, so they cannot be in a state of panic all the time.
|The "last slept" and "last worked" properties for villagers are now saved properly.}}
|{{HistoryLine||1.14.4|dev=pre1|Villagers now voluntarily pick up [[Minecraft:item]]s.}}
|{{HistoryLine|||dev=pre2|Villagers now stock more items, so they now can trade more items before they lock their trades.
|Villagers now remember their gossip after becoming a [[Minecraft:zombie villager]].
|Gossip about [[Minecraft:player]]s who converted a zombie villager now last longer.
|Villagers can now work without also restocking at the same time.
|The performance of villager pathfinding has been improved.}}
|{{HistoryLine||1.15|dev=19w35a|Nitwit villagers no longer have a leveling gemstone in their belt.
|If a [[Minecraft:player]] tries to sleep in a [[Minecraft:bed]] that is occupied by a villager, that villager is now kicked out of the bed.}}
|{{HistoryLine||1.16|dev=20w19a|Villagers can now spawn [[Minecraft:iron golem]]s regardless of their profession status or latest working time.}}
|{{HistoryLine|||dev=20w22a|Villagers no longer try to work at the same workstation.
|When a workstation is placed, the most experienced nearby villager for that corresponding profession claims the workstation.
|Villagers now have to walk to and reach the workstation before they can acquire the profession/work there.
|Villagers can no longer claim workstations/professions during [[Minecraft:raid]]s or [[Minecraft:nighttime]].
|Villagers now check that their workstation is valid at all times of [[Minecraft:day]] as long as they are within 16 [[Minecraft:block]]s of their workstation.}}
|{{HistoryLine||1.16.2|dev=20w28a|Villagers now emit green [[Minecraft:particles]] when joining a [[Minecraft:village]], setting a home [[Minecraft:bed]], or acquiring a job site/profession to match ''[[Minecraft:Bedrock Edition]]''.}}
|{{HistoryLine|||dev=pre1|Villagers now lose their job sites when changing dimension.}}
|{{HistoryLine||1.17|dev=21w11a|[[File:Villager Librarian change 21w11a.gif|x48px]] The overlay texture of the librarian has been changed.}}
|{{HistoryLine|||dev=21w13a|Can now accept a filled [[Minecraft:cauldron]] as a valid workstation.
|Mason villagers can now sell 4 [[Minecraft:dripstone block]]s for an [[Minecraft:emerald]].}}
|{{HistoryLine||1.17.1|dev=?| Villagers no longer drop trading related items they were holding when killed with looting.}}
|{{HistoryLine||1.18|dev=21w37a|Baby villagers are no longer attacked by [[Minecraft:illager]]s.}}
|{{HistoryLine|||dev=21w41a|Tweaked the armorer zombie villager's and weaponsmith zombie villager's textures to remove stray villager pixels.}}
|{{HistoryLine||1.19|dev=22w17a|The model of villagers has been changed. The problem of cut-off hems on costumes for some professions has been resolved by extending the overlay model downward by two pixels. {{more info|Respective renders is required.}}<!-- They are uploaded under names such as "XXXX Vllager Base JE2.png". However, they do not seem to follow the naming system. -->}}
|{{HistoryLine||1.20|dev=23w14a|Torchflower seeds can now be picked up by farmer villagers.}}
|{{HistoryLine|||dev=23w16a|Farmer villagers can now plant [[Minecraft:torchflower seeds]] and [[Minecraft:pitcher pod]]s.}}
|{{HistoryLine||1.20.2|dev=23w31a|Villagers now give {{cd|major_positive}} and {{cd|minor_positive}} reputation only the first time they are cured from a zombie villager. There are no longer multiple stacked discounts if a villager is zombified and cured multiple times.<ref>{{bug|MC-181190||The discount for curing a villager is multiplied if the villager is reinfected and cured again|Fixed}}</ref>
|Existing villagers with multiple curing discounts keep their lowered prices when updating to the new version.}}
|{{HistoryLine||1.20.2|dev=23w31a|exp=Villager Trade Rebalance|Librarians from different biomes now sell different [[Minecraft:enchanted book]]s.
|Each village biome has one special enchantment that is available only from master librarians.
|The player must build two secret villages in biomes where villages do not generate to access their trades.
|Some enchantments have been removed from village trading and must be found in other ways.}}
|{{HistoryLine||1.20.5|exp=Villager Trade Rebalance|dev=24w03a|Villagers who buy armor now ignore durability and can buy damaged armor.}}
|{{HistoryLine||1.21.5|dev=25w07a|The changes to cartographer trades have been moved from [[Minecraft:villager trade rebalance]] and are now available during normal gameplay.}}
|{{HistoryLine||26.1|dev=snap1|Trades offered by villagers and [[Minecraft:wandering trader]]s are now data-driven and can be customized by datapack developers.}}
|{{HistoryLine|||dev=snap7|[[File:Plains Baby Villager JE3 BE2.png|32px]] [[File:Desert Baby Villager JE3 BE2.png|32px]] [[File:Savanna Baby Villager JE3 BE2.png|32px]] [[File:Taiga Baby Villager JE3 BE2.png|32px]] [[File:Snowy Baby Villager JE3 BE2.png|32px]] [[File:Jungle Baby Villager JE3 BE2.png|32px]] [[File:Swamp Baby Villager JE3 BE2.png|32px]] The model and textures of baby villagers have been changed. They now have big heads, matching {{BE}}, and to fit [[Minecraft:Tiny Takeover]].}}
|{{HistoryLine|||dev=snap8|Adjusted the [[Minecraft:hitbox]]es of the baby versions of villagers and their variants to fit in 1 block high or 0.5 block wide spaces.}}
}}

==== Historical renders ====
Baby villagers before [[Minecraft:Tiny Takeover]] ([[Minecraft:Java Edition 26.1]]):
<gallery>
Plains Baby Villager Base JE2.png|Plains baby villager
Desert Baby Villager Base JE2.png|Desert baby villager
Jungle Baby Villager Base JE2.png|Jungle baby villager
Savanna Baby Villager Base JE2.png|Savanna baby villager
Snowy Baby Villager Base JE2.png|Snowy baby villager
Swamp Baby Villager Base JE2.png|Swamp baby villager
Taiga Baby Villager Base JE2.png|Taiga baby villager
</gallery>

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket alpha}}
|{{HistoryLine||v0.9.0|dev=build 1|[[File:Farmer.png|x48px]] [[File:Librarian.png|x48px]] [[File:Priest.png|x48px]] [[File:Blacksmith.png|x48px]] [[File:Butcher.png|x48px]] [[File:Nitwit.png|x48px]] Added villagers.
|[[File:Farmer.png|20px]] [[File:Librarian.png|20px]] [[File:Priest.png|20px]] [[File:Blacksmith.png|20px]] [[File:Butcher.png|20px]] [[File:Nitwit.png|20px]] Added baby villagers.
|Villagers have the same level of AI as [[Minecraft:Java Edition|PC]] version [[Minecraft:Java Edition 1.0.0|1.0.0]], as they cannot [[Minecraft:trading|trade]], harvest [[Minecraft:crops]], breed or open [[Minecraft:door]]s.}}
|{{HistoryLine|||dev=build 2|Villagers now have [[Minecraft:sound]]s. |Villagers are now attacked by and run away from [[Minecraft:zombie]]s.
|Villager children now [[Minecraft:sprint]].}} 
|{{HistoryLine||v0.9.2|Villagers now have sounds on iOS and Fire OS.
|The [[Minecraft:health]] of villagers has been reduced from {{hp|20}} to {{hp|10}}}}
|{{HistoryLine||v0.10.0|dev=build 6|The villager walking animation has been changed.}}
|{{HistoryLine||v0.12.1|dev=build 1|Villagers can now open and close [[Minecraft:door]]s.
|Villagers now go inside at night and detect houses.
|Villagers can now socialize with each other and passive [[Minecraft:mob]]s.
|Farmer villagers now harvest fully grown [[Minecraft:crops]].
|Villagers now repopulate [[Minecraft:village]]s by the number of houses there are.
|Villagers now like and dislike the [[Minecraft:player]], depending on how they react to them.
|Villagers can now be infected by [[Minecraft:zombie]]s, causing them to change their appearance and attack the player and other villagers.}}
|{{HistoryLine|||dev=build 10|Villagers now always become [[Minecraft:zombie villager]]s in Hard [[Minecraft:difficulty]].}}
|{{HistoryLine||v0.13.0|dev=build 2|Villagers now open all wooden [[Minecraft:door]]s (rather than just oak).}}
|{{HistoryLine||v0.14.0|dev=build 1|Villagers struck by [[Minecraft:lightning]] now transform into [[Minecraft:witch]]es.
|Villagers are now slightly taller (1.95 [[Minecraft:block]]s tall rather than 1.8, with babies 0.975 blocks tall rather than 0.9).}}
|{{HistoryLine||v0.15.0|dev=build 1|Villagers now run away from [[Minecraft:husk]]s.}}
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.0|dev=alpha 0.17.0.1|Villagers now spawn in [[Minecraft:igloo]] basements.}}
|{{HistoryLine||1.0.4|dev=alpha 1.0.4.0|Added [[Minecraft:trading]] with villagers.
|[[File:Baby Farmer BE.png|20px]] [[File:Baby Librarian BE.png|20px]] [[File:Baby Priest BE.png|20px]] [[File:Baby Blacksmith BE.png|20px]] [[File:Baby Butcher BE.png|20px]] [[File:Baby Nitwit BE.png|20px]] Baby villagers now have larger-sized heads.
|[[File:Nitwit.png|x48px]] The generic villager has been added for [[Minecraft:resource pack]]s.
|Villagers can now share [[Minecraft:food]] with other villagers.
|Villagers can now be made willing by using 3 [[Minecraft:bread]], 12 [[Minecraft:carrot]]s or 12 [[Minecraft:potato]]es.
|Villagers now [[Minecraft:breeding|breed]] only when willing.}}
|{{HistoryLine||1.1.0|dev=alpha 1.1.0.0|Villagers now run away from [[Minecraft:illager]]s and [[Minecraft:vex]]es.}}
|{{HistoryLine|||dev=alpha 1.1.0.3|Added a new career for librarian villagers called "Cartographer".}}

|{{HistoryLine|bedrock}}
|{{HistoryLine||1.2.13|dev=beta 1.2.13.8|Villagers now run away from [[Minecraft:drowned]].}}
|{{HistoryLine||1.9.0|dev=beta 1.9.0.0|Villagers now run away from [[Minecraft:pillager]]s.}}
|{{HistoryLine||1.10.0|dev=beta 1.10.0.3|exp=Experimental Gameplay|[[Minecraft:Villager (old)|Old villagers]] are automatically changed to new villagers, and old villagers can only be spawned by modifying the world's NBT.|Added nitwit and unemployed villagers.
|Added mason profession, which can be [[Minecraft:trade]]d with.
|Villagers now run away from the new [[Minecraft:ravager]].<!--It may or may not be called an illager beast in this build.-->
|Added a new type of villager, only available with [[Minecraft:Experimental Gameplay]] enabled. Both the old (pre-[[Minecraft:Village & Pillage]]) and new types of villagers are able to be spawned in-game and have different [[Minecraft:spawn egg]]s, although they have the same name and same spawn egg texture.
|Villagers now have different skins based on [[Minecraft:biome]] (including [[Minecraft:swamp]]s and [[Minecraft:jungle]]s, which do not contain villages) as well as professions. However, villagers spawned in [[Minecraft:igloo]] basements still use their old skin.
|[[File:Desert Villager Base.png|x48px]] [[File:Desert Armorer.png|x48px]] [[File:Desert Butcher.png|x48px]] [[File:Desert Cartographer.png|x48px]] [[File:Desert Cleric.png|x48px]] [[File:Desert Farmer.png|x48px]] [[File:Desert Fisherman.png|x48px]] [[File:Desert Fletcher.png|x48px]] [[File:Desert Leatherworker.png|x48px]] [[File:Desert Librarian.png|x48px]] [[File:Desert Mason.png|x48px]] [[File:Desert Nitwit.png|x48px]] [[File:Desert Shepherd.png|x48px]] [[File:Desert Toolsmith.png|x48px]] [[File:Desert Weaponsmith.png|x48px]] Added [[Minecraft:desert]] villagers, which all have unique textures for that biome. These villagers also spawn in [[Minecraft:badlands]] biomes.
|[[File:Jungle Villager Base.png|x48px]] [[File:Jungle Armorer.png|x48px]] [[File:Jungle Butcher.png|x48px]] [[File:Jungle Cartographer.png|x48px]] [[File:Jungle Cleric.png|x48px]] [[File:Jungle Farmer.png|x48px]] [[File:Jungle Fisherman.png|x48px]] [[File:Jungle Fletcher.png|x48px]] [[File:Jungle Leatherworker.png|x48px]] [[File:Jungle Librarian.png|x48px]] [[File:Jungle Mason.png|x48px]] [[File:Jungle Nitwit.png|x48px]] [[File:Jungle Shepherd.png|x48px]] [[File:Jungle Toolsmith.png|x48px]] [[File:Jungle Weaponsmith.png|x48px]] Added [[Minecraft:jungle]] villagers, which all have unique textures for that biome. However, jungles do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|[[File:Plains Villager Base.png|x48px]] [[File:Plains Armorer.png|x48px]] [[File:Plains Butcher.png|x48px]] [[File:Plains Cartographer.png|x48px]] [[File:Plains Cleric.png|x48px]] [[File:Plains Farmer.png|x48px]] [[File:Plains Fisherman.png|x48px]] [[File:Plains Fletcher.png|x48px]] [[File:Plains Leatherworker.png|x48px]] [[File:Plains Librarian.png|x48px]] [[File:Plains Mason.png|x48px]] [[File:Plains Nitwit.png|x48px]] [[File:Plains Shepherd.png|x48px]] [[File:Plains Toolsmith.png|x48px]] [[File:Plains Weaponsmith.png|x48px]] Added [[Minecraft:plains]] villagers, which all have unique textures for that biome.
|[[File:Savanna Villager Base.png|x48px]] [[File:Savanna Armorer.png|x48px]] [[File:Savanna Butcher.png|x48px]] [[File:Savanna Cartographer.png|x48px]] [[File:Savanna Cleric.png|x48px]] [[File:Savanna Farmer.png|x48px]] [[File:Savanna Fisherman.png|x48px]] [[File:Savanna Fletcher.png|x48px]] [[File:Savanna Leatherworker.png|x48px]] [[File:Savanna Librarian.png|x48px]] [[File:Savanna Mason.png|x48px]] [[File:Savanna Nitwit.png|x48px]] [[File:Savanna Shepherd.png|x48px]] [[File:Savanna Toolsmith.png|x48px]] [[File:Savanna Weaponsmith.png|x48px]] Added [[Minecraft:savanna]] villagers, which all have unique textures for that biome.
|[[File:Snowy Villager Base.png|x48px]] [[File:Snowy Armorer.png|x48px]] [[File:Snowy Butcher.png|x48px]] [[File:Snowy Cartographer.png|x48px]] [[File:Snowy Cleric.png|x48px]] [[File:Snowy Farmer.png|x48px]] [[File:Snowy Fisherman.png|x48px]] [[File:Snowy Fletcher.png|x48px]] [[File:Snowy Leatherworker.png|x48px]] [[File:Snowy Librarian.png|x48px]] [[File:Snowy Mason.png|x48px]] [[File:Snowy Nitwit.png|x48px]] [[File:Snowy Shepherd.png|x48px]] [[File:Snowy Toolsmith.png|x48px]] [[File:Snowy Weaponsmith.png|x48px]] Added snowy villagers, which all have unique textures in snowy biomes. These villagers spawn in any snowy [[Minecraft:biome]], including [[Minecraft:frozen river]]s, [[Minecraft:frozen ocean]]s (and their variants) and [[Minecraft:snowy beach]]es.
|[[File:Swamp Villager Base.png|x48px]] [[File:Swamp Armorer.png|x48px]] [[File:Swamp Butcher.png|x48px]] [[File:Swamp Cartographer.png|x48px]] [[File:Swamp Cleric.png|x48px]] [[File:Swamp Farmer.png|x48px]] [[File:Swamp Fisherman.png|x48px]] [[File:Swamp Fletcher.png|x48px]] [[File:Swamp Leatherworker.png|x48px]] [[File:Swamp Librarian.png|x48px]] [[File:Swamp Mason.png|x48px]] [[File:Swamp Nitwit.png|x48px]] [[File:Swamp Shepherd.png|x48px]] [[File:Swamp Toolsmith.png|x48px]] [[File:Swamp Weaponsmith.png|x48px]] Added [[Minecraft:swamp]] villagers, which all have unique textures for that biome. However, swamps do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|[[File:Taiga Villager Base.png|x48px]] [[File:Taiga Armorer.png|x48px]] [[File:Taiga Butcher.png|x48px]] [[File:Taiga Cartographer.png|x48px]] [[File:Taiga Cleric.png|x48px]] [[File:Taiga Farmer.png|x48px]] [[File:Taiga Fisherman.png|x48px]] [[File:Taiga Fletcher.png|x48px]] [[File:Taiga Leatherworker.png|x48px]] [[File:Taiga Librarian.png|x48px]] [[File:Taiga Mason.png|x48px]] [[File:Taiga Nitwit.png|x48px]] [[File:Taiga Shepherd.png|x48px]] [[File:Taiga Toolsmith.png|x48px]] [[File:Taiga Weaponsmith.png|x48px]] Added [[Minecraft:taiga]] villagers, which all have unique textures for the biome. These villagers also spawn in [[Minecraft:giant tree taiga]] and [[Minecraft:mountains]] biomes.
|[[File:Desert Baby Villager BE1.png|20px]] [[File:Jungle Baby Villager BE1.png|20px]] [[File:Plains Baby Villager BE1.png|20px]] [[File:Savanna Baby Villager BE1.png|20px]] [[File:Snowy Baby Villager BE1.png|20px]] [[File:Swamp Baby Villager BE1.png|20px]] [[File:Taiga Baby Villager BE1.png|20px]] Added baby villagers to [[Minecraft:desert]], [[Minecraft:jungle]], [[Minecraft:plains]], [[Minecraft:savanna]], snowy, [[Minecraft:swamp]] and [[Minecraft:taiga]] biomes. However, jungles and swamps do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|Villagers now have three tiers and show which [[Minecraft:trade]] tier they have unlocked, by a badge of a varying material on their suit. The first trade tier appears as an iron badge, then next gold and finally diamond.
|Librarian villagers now inspect [[Minecraft:bookshelves]].
|Villagers can now occupy [[Minecraft:bed]]s to sleep.
|Villagers now have a schedule. Adult and child villagers have a different schedule and fishermen, farmers and librarians have special work schedules.
|Villagers now hold the [[Minecraft:item]] they want to [[Minecraft:trade]].
|Villagers now have behavior to wander [[Minecraft:village]] outskirts.
|Villagers can now mingle in gathering sites.
|Villagers can now work in job sites with the corresponding job site [[Minecraft:block]] and can change professions depending on the available job site blocks in villages.}}
|{{HistoryLine||1.11.0|dev=beta 1.11.0.1|exp=Experimental Gameplay|The farmer job site block has been changed from farmland to [[Minecraft:composter]]s.
|Added economic [[Minecraft:trade]]s, which makes villagers level up and require experience to unlock next tiers, which makes it possible to instantly change their tiers from iron to diamond.
|Villager trades are no longer instantly refreshed as it now requires to resupply, which can be activated only by using {{cmd|resupply}}.
|Old villagers now convert to <code>villager_v2</code> <!-- They actually did not change the old villager. It makes them instantly transform into another entity which is villager_v2, one can use spawn egg with data 15 to test it -->.
|Baby villagers are now ignored by [[Minecraft:illager]]s, including [[Minecraft:ravager]]s and [[Minecraft:vex]]es.}}
|{{HistoryLine||1.11.0|dev=beta 1.11.0.3|Villager now heal themselves upon waking up at dawn.|The new villagers are no longer available only behind Experimental Gameplay.}}
|{{HistoryLine|||dev=beta 1.11.0.4|Villagers now hide in houses during [[Minecraft:raid]]s.
|The villager economy [[Minecraft:trade]]s have been changed.
|The supply and demand feature for villagers now works properly.
|Villagers now make [[Minecraft:sound]]s when they work.}}
|{{HistoryLine||1.13.0|dev=beta 1.13.0.9|Villagers can now heal if they have [[Minecraft:bread]] in their [[Minecraft:inventory]].}}
|{{HistoryLine||1.17.0|dev=beta 1.16.230.54|Mason villagers can now sell 4 [[Minecraft:dripstone block]]s for an [[Minecraft:emerald]].}}
|{{HistoryLine||1.18.10|dev=beta 1.18.10.20|Villagers spawning in the grove biome are now the snowy variant.<ref>{{bug|MCPE-147834|||Fixed}}</ref>}}
|{{HistoryLine||1.18.10|dev=beta 1.18.10.26|Removed the emerald icon above a Villager's head when trading.}}
|{{HistoryLine||1.19.40|dev=Preview 1.19.40.20|Baby villagers again accept flowers from iron golems.}}
|{{HistoryLine|||dev=Preview 1.19.50.21|While playing tag, baby villagers now run at a quicker speed that matches ''Java Edition''.}}
|{{HistoryLine||1.19.60|dev=Preview 1.19.60.20|Villagers now take damage from lightning bolts on Peaceful difficulty, like other mobs.
|Villagers now ensure that rain can pass through the block above them before launching fireworks when celebrating after a raid victory.<ref>{{bug|MCPE-152386|||Fixed}}</ref>}}
|{{HistoryLine|||dev=Preview 1.19.60.22|Fixed an issue that prevented some tripwire hooks from being valid when trading with a fletcher villager.}}
|{{HistoryLine||1.19.80|dev=Preview 1.19.80.20|Villagers now generate green particles when a successful trade is completed.}}
|{{HistoryLine||1.20.10|dev=Preview 1.20.10.20|A zombie villager now drops its armor and held items once cured.
|Farmer villagers can now pick up and plant [[Minecraft:torchflower seeds]] and [[Minecraft:pitcher pod]]s.}}
|{{HistoryLine||1.20.30|dev=Preview 1.20.20.20|Villagers no longer drop items held in their hands when killed by players.}}
|{{HistoryLine||1.20.30|dev=Preview 1.20.30.21|Villagers now give a big discount only the first time they're cured from a zombie villager. There are no longer multiple stacked discounts if a villager is zombified and cured multiple times.}}
|{{HistoryLine||1.21.30|dev=Preview 1.21.30.24|Villagers no longer make any idle sounds when sleeping.}}
|{{HistoryLine||26.10|dev=Preview 26.10.23|[[File:Plains Baby Villager JE3 BE2.png|32px]] [[File:Desert Baby Villager JE3 BE2.png|32px]] [[File:Savanna Baby Villager JE3 BE2.png|32px]] [[File:Taiga Baby Villager JE3 BE2.png|32px]] [[File:Snowy Baby Villager JE3 BE2.png|32px]] [[File:Jungle Baby Villager JE3 BE2.png|32px]] [[File:Swamp Baby Villager JE3 BE2.png|32px]] The model and textures of baby villagers have been changed.}}
|{{HistoryLine|bedrock upcoming}}
|{{HistoryLine||26.20|dev=Preview 26.20.22|The hitboxes of baby villagers have been changed, to closely match {{JE}}.<ref>{{bug|MCPE-236077}}</ref>}}
}}

==== Historical renders ====
Baby villagers before [[Minecraft:Tiny Takeover]] ([[Minecraft:Bedrock Edition 26.10]]):
<gallery>
Plains Baby Villager BE1.png|Plains baby villager
Desert Baby Villager BE1.png|Desert baby villager
Jungle Baby Villager BE1.png|Jungle baby villager
Savanna Baby Villager BE1.png|Savanna baby villager
Snowy Baby Villager BE1.png|Snowy baby villager
Swamp Baby Villager BE1.png|Swamp baby villager
Taiga Baby Villager BE1.png|Taiga baby villager
</gallery>

=== Legacy Console Edition ===
{{HistoryTable
|{{HistoryLine|console}}
|{{HistoryLine||xbox=TU7|xbone=CU1|ps3=1.00|psvita=1.00|ps4=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Farmer.png|x48px]] Added villagers.
|Villagers have the same level of AI as [[Minecraft:Java Edition 1.0.0]], as they cannot [[Minecraft:trading|trade]], harvest [[Minecraft:crops]], breed or open [[Minecraft:door]]s.}}
|{{HistoryLine||xbox=TU11|The [[Minecraft:spawn limit|limit]] for villagers has been increased in a world.}}
|{{HistoryLine||xbox=TU12|[[File:Farmer.png|20px]] Added baby villagers.
|Villagers can now open and close [[Minecraft:door]]s.
|Villagers now go inside at [[Minecraft:Daylight cycle#Night|night]] and detect houses.
|Villagers can now socialize with each other and passive [[Minecraft:mob]]s.
|Villagers are now attacked by and run away from [[Minecraft:zombie]]s.
|Villagers now repopulate [[Minecraft:village]]s by the number of houses there are.
|Baby villagers now [[Minecraft:sprint]].}}
|{{HistoryLine||xbox=TU13|ps3=1.00|psvita=1.00|ps4=1.00|A [[Minecraft:spawn limit|limit]] to the number of villagers spawned by [[Minecraft:breeding]] has been added.
|Added the hearts display when villagers enter 'love mode'.}}
|{{HistoryLine||xbox=TU14|ps3=1.04|psvita=1.00|ps4=1.00|[[Minecraft:Trading]] with villagers has been added.
|[[File:Librarian.png|x48px]] [[File:Priest.png|x48px]] [[File:Blacksmith.png|x48px]] [[File:Butcher.png|x48px]] [[File:Nitwit.png|x48px]] Villagers are now assigned random professions.
|Villagers that are spawned from a [[Minecraft:spawn egg]] now have a random profession.
|Villagers now make [[Minecraft:sound]]s from being [[Minecraft:damage|hurt]], [[Minecraft:trading]] and wandering.
|Baby villagers can now be spawned by using {{xbtn|lt}} on that [[Minecraft:mob]] using its [[Minecraft:spawn egg]].}}
|{{HistoryLine||xbox=TU31|xbone=CU19|ps3=1.22|psvita=1.22|ps4=1.22|wiiu=Patch 3|Villagers now have additional professions and trading schemes.
|Villagers now harvest [[Minecraft:crops]].
|Villagers now [[Minecraft:breeding|breed]] only when willing (and can be made willing by giving them 3 [[Minecraft:bread]], 12 [[Minecraft:carrot]]s or 12 [[Minecraft:potato]]es).
|Villagers turn into [[Minecraft:witch]]es when struck by [[Minecraft:lightning]].}}
|{{HistoryLine||xbox=TU43|xbone=CU33|ps3=1.36|psvita=1.36|ps4=1.36|wiiu=Patch 13|switch=1.0.1|A cleric villager can now be found caged in an [[Minecraft:igloo]] basement.}}
|{{HistoryLine||xbox=TU54|xbone=CU44|ps3=1.52|psvita=1.52|ps4=1.52|wiiu=Patch 24|switch=1.0.4|Added a new career for the librarian villager: "Cartographer".|Nitwit villagers can now spawn.}}
|{{HistoryLine||xbox=TU69|xbone=none|ps3=1.76|psvita=1.76|ps4=1.76|wiiu=Patch 38|switch=none|Added an emerald icon above a Villager's head when trading.|[[File:Baby Farmer BE.png|20px]] [[File:Baby Librarian BE.png|20px]] [[File:Baby Priest BE.png|20px]] [[File:Baby Blacksmith BE.png|20px]] [[File:Baby Butcher BE.png|20px]] [[File:Baby Nitwit BE.png|20px]] Baby villagers now have larger-sized heads.}}
}}

=== ''PlayStation 4 Edition'' ===
{{HistoryTable
|{{HistoryLine|ps4}}
|{{HistoryLine||1.91|Added nitwit and unemployed villagers.
|Added mason villagers, which can be [[Minecraft:trading|traded]] with.
|Villagers have new clothing to indicate their level, profession, and [[Minecraft:biome]].
|[[File:Desert Villager Base.png|x48px]] [[File:Desert Armorer.png|x48px]] [[File:Desert Butcher.png|x48px]] [[File:Desert Cartographer.png|x48px]] [[File:Desert Cleric.png|x48px]] [[File:Desert Farmer.png|x48px]] [[File:Desert Fisherman.png|x48px]] [[File:Desert Fletcher.png|x48px]] [[File:Desert Leatherworker.png|x48px]] [[File:Desert Librarian.png|x48px]] [[File:Desert Mason.png|x48px]] [[File:Desert Nitwit.png|x48px]] [[File:Desert Shepherd.png|x48px]] [[File:Desert Toolsmith.png|x48px]] [[File:Desert Weaponsmith.png|x48px]] Added [[Minecraft:desert]] villagers, which all have unique textures for that biome. These villagers also spawn [[Minecraft:badlands]] biomes.
|[[File:Jungle Villager Base.png|x48px]] [[File:Jungle Armorer.png|x48px]] [[File:Jungle Butcher.png|x48px]] [[File:Jungle Cartographer.png|x48px]] [[File:Jungle Cleric.png|x48px]] [[File:Jungle Farmer.png|x48px]] [[File:Jungle Fisherman.png|x48px]] [[File:Jungle Fletcher.png|x48px]] [[File:Jungle Leatherworker.png|x48px]] [[File:Jungle Librarian.png|x48px]] [[File:Jungle Mason.png|x48px]] [[File:Jungle Nitwit.png|x48px]] [[File:Jungle Shepherd.png|x48px]] [[File:Jungle Toolsmith.png|x48px]] [[File:Jungle Weaponsmith.png|x48px]] Added [[Minecraft:jungle]] villagers, which all have unique textures for that biome. However, jungles do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|[[File:Plains Villager Base.png|x48px]] [[File:Plains Armorer.png|x48px]] [[File:Plains Butcher.png|x48px]] [[File:Plains Cartographer.png|x48px]] [[File:Plains Cleric.png|x48px]] [[File:Plains Farmer.png|x48px]] [[File:Plains Fisherman.png|x48px]] [[File:Plains Fletcher.png|x48px]] [[File:Plains Leatherworker.png|x48px]] [[File:Plains Librarian.png|x48px]] [[File:Plains Mason.png|x48px]] [[File:Plains Nitwit.png|x48px]] [[File:Plains Shepherd.png|x48px]] [[File:Plains Toolsmith.png|x48px]] [[File:Plains Weaponsmith.png|x48px]] Added [[Minecraft:plains]] villagers, which all have unique textures for that biome.
|[[File:Savanna Villager Base.png|x48px]] [[File:Savanna Armorer.png|x48px]] [[File:Savanna Butcher.png|x48px]] [[File:Savanna Cartographer.png|x48px]] [[File:Savanna Cleric.png|x48px]] [[File:Savanna Farmer.png|x48px]] [[File:Savanna Fisherman.png|x48px]] [[File:Savanna Fletcher.png|x48px]] [[File:Savanna Leatherworker.png|x48px]] [[File:Savanna Librarian.png|x48px]] [[File:Savanna Mason.png|x48px]] [[File:Savanna Nitwit.png|x48px]] [[File:Savanna Shepherd.png|x48px]] [[File:Savanna Toolsmith.png|x48px]] [[File:Savanna Weaponsmith.png|x48px]] Added [[Minecraft:savanna]] villagers, which all have unique textures for that biome.
|[[File:Snowy Villager Base.png|x48px]] [[File:Snowy Armorer.png|x48px]] [[File:Snowy Butcher.png|x48px]] [[File:Snowy Cartographer.png|x48px]] [[File:Snowy Cleric.png|x48px]] [[File:Snowy Farmer.png|x48px]] [[File:Snowy Fisherman.png|x48px]] [[File:Snowy Fletcher.png|x48px]] [[File:Snowy Leatherworker.png|x48px]] [[File:Snowy Librarian.png|x48px]] [[File:Snowy Mason.png|x48px]] [[File:Snowy Nitwit.png|x48px]] [[File:Snowy Shepherd.png|x48px]] [[File:Snowy Toolsmith.png|x48px]] [[File:Snowy Weaponsmith.png|x48px]] Added snowy villagers, which all have unique textures in snowy biomes. These villagers spawn in any snowy [[Minecraft:biome]], including [[Minecraft:frozen river]]s, [[Minecraft:frozen ocean]]s (and their variants) and [[Minecraft:snowy beach]]es.
|[[File:Swamp Villager Base.png|x48px]] [[File:Swamp Armorer.png|x48px]] [[File:Swamp Butcher.png|x48px]] [[File:Swamp Cartographer.png|x48px]] [[File:Swamp Cleric.png|x48px]] [[File:Swamp Farmer.png|x48px]] [[File:Swamp Fisherman.png|x48px]] [[File:Swamp Fletcher.png|x48px]] [[File:Swamp Leatherworker.png|x48px]] [[File:Swamp Librarian.png|x48px]] [[File:Swamp Mason.png|x48px]] [[File:Swamp Nitwit.png|x48px]] [[File:Swamp Shepherd.png|x48px]] [[File:Swamp Toolsmith.png|x48px]] [[File:Swamp Weaponsmith.png|x48px]] Added [[Minecraft:swamp]] villagers, which all have unique textures for that biome. However, swamps do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|[[File:Taiga Villager Base.png|x48px]] [[File:Taiga Armorer.png|x48px]] [[File:Taiga Butcher.png|x48px]] [[File:Taiga Cartographer.png|x48px]] [[File:Taiga Cleric.png|x48px]] [[File:Taiga Farmer.png|x48px]] [[File:Taiga Fisherman.png|x48px]] [[File:Taiga Fletcher.png|x48px]] [[File:Taiga Leatherworker.png|x48px]] [[File:Taiga Librarian.png|x48px]] [[File:Taiga Mason.png|x48px]] [[File:Taiga Nitwit.png|x48px]] [[File:Taiga Shepherd.png|x48px]] [[File:Taiga Toolsmith.png|x48px]] [[File:Taiga Weaponsmith.png|x48px]] Added [[Minecraft:taiga]] villagers, which all have unique textures for the biome. These villagers also spawn in [[Minecraft:giant tree taiga]] and [[Minecraft:windswept hills]] biomes.
|[[File:Desert Villager Base.png|20px]] [[File:Jungle Villager Base.png|20px]] [[File:Plains Villager Base.png|20px]] [[File:Savanna Villager Base.png|20px]] [[File:Snowy Villager Base.png|20px]] [[File:Swamp Villager Base.png|20px]] [[File:Taiga Villager Base.png|20px]] Added baby villagers to [[Minecraft:desert]], [[Minecraft:jungle]], [[Minecraft:plains]], [[Minecraft:savanna]], snowy, [[Minecraft:swamp]] and [[Minecraft:taiga]] biomes. However, jungles and swamps do not contain villages, so these villagers spawn only after the [[Minecraft:player]] has created a village for them.
|Villagers now have a schedule. Adult and child villagers have a different schedule.
|Villagers may now wander to the [[Minecraft:village]] outskirts.
|Villagers now attempt to find a [[Minecraft:door]] when it rains during the [[Minecraft:day]] and navigate to their [[Minecraft:bed]] at [[Minecraft:night]].
|The pathfinding of villagers has been updated and improved.
|Villagers now have a visual-based [[Minecraft:trading]] system, and now hold up the [[Minecraft:item]] they wish to [[Minecraft:trade]].
|Villagers now mingle together around gathering sites in the village.
|Librarian villagers now inspect [[Minecraft:bookshelves]].
|Villagers can now switch professions depending on the job site [[Minecraft:block]]s available in the village.
|Villagers now interact with [[Minecraft:bed]]s and corresponding job site blocks.}}
}}

=== ''New Nintendo 3DS Edition'' ===
{{HistoryTable
|{{HistoryLine|new 3ds}}
|{{HistoryLine||0.1.0|[[File:Farmer.png|x48px]] [[File:Librarian.png|x48px]] [[File:Priest.png|x48px]] [[File:Blacksmith.png|x48px]] [[File:Butcher.png|x48px]] [[File:Nitwit.png|x48px]] Added villagers.
|[[File:Farmer.png|20px]] [[File:Librarian.png|20px]] [[File:Priest.png|20px]] [[File:Blacksmith.png|20px]] [[File:Butcher.png|20px]] [[File:Nitwit.png|20px]] Added baby villagers.}}
|{{HistoryLine||1.9.19|Added a new career for the librarian villager: "Cartographer".}}
}}

=== Data history ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.11|dev=16w32b|The entity ID has been changed from <code>Villager</code> to <code>villager</code>}}
|{{HistoryLine||1.13|dev=17w47a|Numeric IDs for entities were presumably deprecated in this version.{{info needed|what was this entity's numeric ID?}}}}
}}

== Issues ==
{{issue list}}

== Trivia ==
* The villagers were inspired by the shopkeepers in ''{{w|Dungeon Master II}}''.<ref>http://www.reddit.com/r/Minecraft/comments/xfzdg/i_am_markus_persson_aka_notch_creator_of/c5m0p26</ref>
* Originally, the mobs populating villages were to be [[Minecraft:pigmen]].<ref>{{tweet|notch|62531431175421952|It's very likely the townspeople will be pigmen {{=}})|April 25, 2011}}</ref>
* When a villager is in love mode, it walks slowly. However, when a villager runs indoors as the night falls, it runs faster than the player's sprinting speed.
* The villager skins added in the [[Minecraft:Village and Pillage]] update were inspired by 2018 fashion shows, such as Gucci's.<ref>{{tweet|Jappa|1101053487268417536|Fun Fact: Most of the villager designs were inspired by 2018 fashion shows like Gucci's.|February 28, 2019}}</ref>
* Villagers are genderless, meaning they are neither male nor female.<ref>{{tweet|HelenAngel|1104097613081526272|Villagers are genderless- they are neither male nor female.|March 8, 2019}}</ref>
* Villagers occasionally sleep in odd ways during the night inside their beds, sometimes hanging halfway off the side of the bed or even glitching into walls.
* Although the villages in [[Minecraft:snowy taiga]] biomes spawn the snowy villager variant {{in|bedrock}}, they use the [[Minecraft:taiga]] village variant.
* {{IN|java}}, when the Programmer Art resource pack is enabled, all villagers wear a green hood on their heads.<ref>{{bug|MC-141075}}</ref> This is because the Programmer Art nitwit texture (which is directly copied from the pre-1.14 vanilla resource pack and had the hood in the texture since its addition) is called the same as the [[Minecraft:Village & Pillage]] base villager texture (<code>...\entity\villager\villager.png</code>).
** {{IN|bedrock}}, when the Classic Textures pack from the [[Minecraft:Marketplace]] is enabled, the villagers still use their default texture instead of the old texture.<ref>{{bug|MCPE-119646|resolution=Invalid}}</ref> This is because the old textures of villager are located in <code>...\entity\villager</code>, while the textures for new villagers are in <code>...\entity\villager2</code>.
* Giving a villager any item (with commands) causes it to hold the item as if offering it, but it cannot be traded.
* Fisherman villagers have been intentionally textured by [[Minecraft:Jasper Boerstra]] to display the long-since-removed raw fish texture.<ref>{{bug|MC-173917|resolution=Works As Intended}}</ref>
* Villagers display their held items differently than most creatures do, using the "ground" parameter instead of the usual hand parameter in model display settings.
* Villagers (and baby villagers) on boats that have claimed a bed can still sleep when the bed is near to them resulting in them sleeping in the boat instead.{{only|bedrock}}
* Ancient villagers have been shown in ''Minecraft Legends'', although they were hinted at in ''Minecraft Dungeons''.
* {{IN|java}}, the [[Minecraft:death messages]] of villagers are recorded in the game's logs.<ref>{{bug|MC-165985||Villager deaths are logged|WAI}}</ref>
* Baby villagers taking poppies from iron golems is a reference to the 1986 Japanese animated movie ''{{W|Castle in the Sky|newtab=1}}'', in which a giant robot covered in vines (inspiration for the iron golem) gives the main characters flowers to put on a memorial.<ref>{{tweet|jonkagstrom|172728720799436801|@scambot Yes, thanks to @pgeuder who sent me inspirational pictures!|February 23, 2012}}</ref>
<!-- Please do not claim that Samuel Åberg created the sounds for the villagers in the game. He did not create the sounds for the villagers, he merely demonstrated how the sounds were made in the video about how Minecraft sounds are made. The villager sounds were made by C418 back in 2013. -->
* Their vocal sounds are performed by [[Minecraft:Daniel Rosenfeld]].<ref>[https://www.20k.org/episodes/minecraft <nowiki>Daniel also used his voice for the villagers who inhabit the strange, isolated towns. Dallas’s Daughter: All they go is “Hmm hmm hmm.” Daniel: I think some sound effects got lost with the villagers, because I originally did the "eh" sounds [sfx: Minecraft villager], but then I also made very contrasting sound effects for the children villagers. They were like, "Hahahaha." Like screechy little kids. And I'm kind of bummed that that never got into the game, because like what they put in the game ultimately was just the “eh” but pitched up, [sfx: Minecraft villager child] which was really bizarre for little children. Like “eeeh.”</nowiki>]</ref>
* If a villager accidentally harms a neutral or hostile mob by setting off a firework, the mob retaliates and attacks the villager. For example, a villager that accidentally damages a player by setting off a firework causes tamed wolves and trusting foxes to attack the villager.

=== April Fools ===
{{main|Easter eggs#2014}}
{{exclusive|java|section=1}}

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 the player's current skin to turn into villager skins, and caused users to be unable to change their skins unless modifying the [[Minecraft: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, since this was a server side update, this update cannot be activated by setting the computer's date to April 1, 2014.

== Gallery ==
=== Renders ===
==== Idle ====
<gallery>
Plains Villager Base.png|Plains villager
Plains Nitwit.png|Plains nitwit
Desert Villager Base.png|Desert villager
Desert Nitwit.png|Desert nitwit
Jungle Villager Base.png|Jungle villager
Jungle Nitwit.png|Jungle nitwit
Savanna Villager Base.png|Savanna villager
Savanna Nitwit.png|Savanna nitwit
Snowy Villager Base.png|Snowy villager
Snowy Nitwit.png|Snowy nitwit
Swamp Villager Base.png|Swamp villager
Swamp Nitwit.png|Swamp nitwit
Taiga Villager Base.png|Taiga villager
Taiga Nitwit.png|Taiga nitwit
</gallery>
{{hidden begin|Baby}}
<gallery>
Plains Baby Villager JE3 BE2.png|Plains baby villager
Desert Baby Villager JE3 BE2.png|Desert baby villager
Jungle Baby Villager JE3 BE2.png|Jungle baby villager
Savanna Baby Villager JE3 BE2.png|Savanna baby villager
Snowy Baby Villager JE3 BE2.png|Snowy baby villager
Swamp Baby Villager JE3 BE2.png|Swamp baby villager
Taiga Baby Villager JE3 BE2.png|Taiga baby villager
</gallery>
{{hidden end}}
{{hidden begin|Asleep}}
<gallery>
Lying Desert Villager.png|Desert Villager
Lying Jungle Villager.png|Jungle Villager
Lying Plains Villager.png|Plains Villager
Lying Savanna Villager.png|Savanna Villager
Lying Snowy Villager.png|Snowy Villager
Lying Swamp Villager.png|Swamp Villager
Lying Taiga Villager.png|Taiga Villager
Lying Desert Armorer.png|Desert Armorer
Lying Jungle Butcher.png|Jungle Butcher
Lying Plains Cartographer.png|Plains Cartographer
Lying Savanna Cleric.png|Savanna Cleric
Lying Snowy Farmer.png|Snowy Farmer
Lying Swamp Fisherman.png|Swamp Fisherman
Lying Taiga Fletcher.png|Taiga Fletcher
Lying Desert Leatherworker.png|Desert Leatherworker
Lying Jungle Librarian.png|Jungle Librarian
Lying Plains Mason.png|Plains Mason
Lying Savanna Nitwit.png|Savanna Nitwit
Lying Snowy Shepherd.png|Snowy Shepherd
Lying Swamp Toolsmith.png|Swamp Toolsmith
Lying Taiga Weaponsmith.png|Taiga Weaponsmith
</gallery>
{{hidden end}}

=== Mojang images ===
<gallery>
New Villagers in Desert.png|Announced New Villagers in MINECON Earth 2018 in desert
Wall Walking Villager.jpeg|Bugged sleeping villager appearing to walk on a wall
Wall Walking Villagers.jpg|Bugged sleeping villagers appearing to walk on walls
A Villager.png|A villager
Villager Transportation.png|A villager in a minecart in a boat near a portal
Farmer Farming.jpg|A villager farming
Villagers in plains village.jpeg
</gallery>

=== Screenshots ===
{{Needs render|Base skin for Tiny Takeover baby villagers.}}
<gallery>
Villager GUI 1.14.png|A trading menu for a villager in [[Minecraft:JE]]
Villager GUI Master.png|A [[Minecraft:Java Edition]] master [[Minecraft:Weaponsmith]]’s trading model
TwoBiomeVillagers.png|Two villagers from a rare multi-biome village (in this case plains and desert) meeting
Villager holding trade item.png|A plains farmer villager holding bread
Villager inspecting bookshelf.png|A librarian inspecting a bookshelf
Villager children playing tag MCEE Beta.png|A group of villager children playing tag
VillagerSweating.png|A villager sweating during a [[Minecraft:raid]]
All Professions In 18w50a.png|All plains biome variant professions (except unemployed) corresponding to their different job site blocks
Villager Skins.png|Every villager skin type per profession and biome
Panicked Villager.gif|A villager panicked
Plains cleric villager with creeper face.png|A [[Minecraft:creeper]] face on the robe of a plains biome cleric villager
Villager Base.png|The base skin for all villagers. This is never seen in-game.
JungleVillagersMinecon.jpg|The new [[Minecraft:Jungle]] villager textures shown at MINECON Earth 2018
UnknownVillagers.jpg|New villager textures, shown at MINECON Earth 2018, announced as the [[Minecraft:Taiga]] biome variants. They are instead used for the [[Minecraft:Snowy Plains]] biome variants
VillagerTypesMinecon.png|The new villager textures as seen during [[Minecraft:MINECON Earth 2018]]
Vindication.png|A vindicator raid captain chasing a villager in a savanna
VillagersTalking.png|A [[Minecraft:Cleric]] villager and a [[Minecraft:Farmer]] villager talking near a well
Baby villigers stare at the other villiger.png|Five baby villagers stare at an adult villager
Humor-villagers.jpg|The particles around villagers change with the player's popularity
Piglin villager farmer.png|A villager (farmer) stands alongside a piglin wielding a netherite sword. Piglins do not attack villagers.
Villager gaining profession.gif|A villager becoming a fletcher upon finding a fletching table in ''Java Edition''
Pillager firing at villager.gif|A pillager firing its crossbow at a panicking villager in ''Java Edition''
</gallery>

=== Textures ===
<gallery class="pixel-image">
Villager (texture).png|The base villager texture file
Desert (villager texture).png|Desert overlay texture file
Jungle (villager texture).png|Jungle overlay texture file
Plains (villager texture).png|Plains overlay texture file
Savanna (villager texture).png|Savanna overlay texture file
Snow (villager texture).png|Snow overlay texture file
Swamp (villager texture).png|Swamp overlay texture file
Taiga (villager texture).png|Taiga overlay texture file
Armorer (texture).png|Armorer overlay texture file
Butcher (texture).png|Butcher overlay texture file
Cartographer (texture).png|Cartographer overlay texture file
Cleric (texture).png|Cleric overlay texture file
Farmer (texture).png|Farmer overlay texture file
Fisherman (texture).png|Fisherman overlay texture file
Fletcher (texture).png|Fletcher overlay texture file
Leatherworker (texture).png|Leatherworker overlay texture file
Librarian (texture).png|Librarian overlay texture file
Mason (texture).png|Mason overlay texture file
Shepherd (texture).png|Sheperd overlay texture file
Toolsmith (texture).png|Toolsmith overlay texture file
Weaponsmith (texture).png|Weaponsmith overlay texture file
Nitwit (texture).png|Nitwit overlay texture file
Stone (villager texture).png|Novice badge overlay texture file
Iron (villager texture).png|Apprentice badge overlay texture file.
Gold (villager texture).png|Journeyman badge overlay texture file
Emerald (villager texture).png|Expert badge overlay texture file
Diamond (villager texture).png|Master badge overlay texture file
Baby Villager (texture).png|The base baby villager texture file
Baby Desert (villager texture).png|Baby desert overlay texture file
Baby Jungle (villager texture).png|Baby jungle overlay texture file
Baby Plains (villager texture).png|Baby plains overlay texture file
Baby Savanna (villager texture).png|Baby savanna overlay texture file
Baby Snow (villager texture).png|Baby snow overlay texture file
Baby Swamp (villager texture).png|Baby swamp overlay texture file
Baby Taiga (villager texture).png|Baby taiga overlay texture file
</gallery>

=== In other media ===
<gallery>
File:Jungle Villager Artwork.jpg|Jungle villager
File:World of Color Update.png|Villagers in promotional artwork for the [[Minecraft:World of Color Update]]
File:Mojang114.jpg|A group of villagers shown in the [[Minecraft:Village and Pillage]] update artwork
File:Learn to Code Update.png|A villager in promotional artwork for [[Minecraft:Education Edition 1.14.50]]
File:Villager Artwork 1.jpg|Artwork of a villager
File:ObjectSlashItemsThatShouldBeRenamedbtw (109).png
File:ObjectSlashItemsThatShouldBeRenamedbtw (108).png
File:ObjectSlashItemsThatShouldBeRenamedbtw (107).png
File:ObjectSlashItemsThatShouldBeRenamedbtw (106).png
File:ObjectSlashItemsThatShouldBeRenamedbtw (105).png
File:LEGO Villager.png|LEGO journeyman plains villager
File:LEGO Desert Villager 1.png|LEGO desert villager
File:LEGO Savanna Villager.png|LEGO savanna villager
File:LEGO AMCM Villager.png|A ''[[Minecraft:LEGO]]'' minifigure of a villager for ''[[Minecraft:A Minecraft Movie]]''
File:Awkward Party Reaction.jpeg|A group of villagers, staring at a player
File:Villager and a laptop.jpeg|A villager in real life
File:Potato villager.png|The potato villager from [[Minecraft:Java Edition 24w14potato|24w14potato]]
File:Traitor Villager.png|The traitor villager from [[Minecraft:25w14craftmine]]
File:15 Year Party Supply Party Villager render.png|Party Villager
File:LEGO Santa Villager.png|A LEGO villager (exclusive version from the "Advent Calendar 2025" set)
File:Villager mindset.jpeg
</gallery>

==== Other appearances ====
<gallery>
File:MCSM2 Nurm.png|{{MCSM|Nurm}}, a villager in {{MCSM}}
File:MCD Villager.png|A villager as it appears in {{MCD}}
File:Villager Render MCL.png|A villager as it appears in {{MCL}}
File:Villager Illager Render MCL.png|Ditto
File:Woodsword Chronicles villager.jpg|A villager as it appears in {{WSC|6|1}}
File:AMCM Villagers.jpeg|Villagers as seen in {{AMCM}}
</gallery>

== See also ==
<!--
    This section exists for disambiguation purposes.
    [[Minecraft:Villager (disambiguation)]] might be a better place to put this content.
-->
* {{EntityLink|Zombie Villager}}
* {{EntityLink|Pillager}}
* {{EntityLink|Evoker}}
* {{EntityLink|Vindicator}}
* {{EntityLink|Villager (old)|id=old-villager}} – the old version of the villager, used before the [[Minecraft:Village & Pillage]] update.

== Notes ==
{{notelist}}

== References ==
{{reflist}}

== Navigation ==
{{Navbox villagers}}
{{Navbox entities|mobs}}
{{Mojang featured|https://www.minecraft.net/en-us/article/minecraft-romantic-enough}}

[[Category:Passive mobs]]
[[Category:Humanoid mobs]]

[[Minecraft:cs:Vesničan]]
[[Minecraft:de:Dorfbewohner]]
[[Minecraft:es:Aldeano]]
[[Minecraft:fr:Villageois]]
[[Minecraft:hu:Falusi]]
[[Minecraft:it:Villico]]
[[Minecraft:ja:村人]]
[[Minecraft:ko:주민]]
[[Minecraft:lzh:鄉民]]
[[Minecraft:nl:Dorpeling]]
[[Minecraft:pl:Osadnik]]
[[Minecraft:pt:Aldeão]]
[[Minecraft:ru:Деревенский житель]]
[[Minecraft:th:ชาวบ้าน]]
[[Minecraft:uk:Селянин]]
[[Minecraft:zh:村民]]