Vanilla villagers do not give you much to know. They work, sleep, stare at a wall for a while, and go "hrmm." I made Sapience because I wanted the same villagers to feel like they had an actual life behind their face.
Every villager gets a name, a personality, moods, needs, relationships, and a memory of things that really happened. Feed somebody when they are hungry and they remember who helped. Hurt them and that sticks too. If another villager saw it, the story may travel.
What matters to me is that their behavior has a reason. They do not roll behavioral dice just to create drama. Their choices come from what they know, what they need, how they feel, and who they are dealing with. Spend enough time around one villager and you can start to understand them.
One evening during testing, I watched a villager cross the square, stand beside a grieving neighbor, and stay there for a while. I had written grief and social visits as separate rules. That evening the rules met on their own. That moment is the whole mod to me.
Fabric | Minecraft 1.21.1 | Fabric API required | Java 21 | Install on the server and every client
Sapience is still a beta. Back up any world you care about before installing or updating it.
What you will see right away
Villager becomes Mira Highmeadow, Aldric Stonebrook, or another name that stays with that person after reloads. Somebody who stands out may earn a title too.- Their name color, posture, gaze, and short speech lines give you a read on what is going on with them.
- Farmers farm and replant. Woodcutters finish trees. Miners choose a real site. Builders put up homes, farms, and shared storage when the village actually needs them.
- They react when you greet them, help them, give them something, frighten them, or hurt them.
- They look for beds and shelter at night. Villagers caught outside wake when danger gets close, and the village tries to light unsafe ground.
- Friends spend time together. Enemies keep their distance. Grieving villagers may receive a quiet visit from somebody who cares about them.
One important change: right-click no longer opens the vanilla trade screen. It greets the villager instead. Sneak while holding an item to offer it as a gift. Villagers barter among themselves, but player trading is not ready yet.
What villagers actually do
Work and everyday life
Villagers farm, mine, cut wood, gather materials, craft, share supplies, build, and repair damage. They improve at the work they keep doing. Jobs use claims, so a whole crowd does not fight over the same crop, tree, chest, or block.
Builders check the ground and available materials before starting. Houses fit the terrain instead of floating on dirt pillars, and finished buildings have usable interiors, doors, beds, and light. Construction stops when the settlement has enough essential homes, food, and storage. The village does not keep covering your world in pointless buildings.
At night, people look for a real bed and shelter. Somebody who cannot reach either may settle near the village center instead of wandering forever. Open-ground sleepers are light sleepers. A nearby hostile gets them back on their feet.
A mind behind the work
Every villager has a lasting personality based on the Big Five traits. That temperament affects courage, curiosity, sociability, patience, and the way they react emotionally. They also track hunger, rest, safety, company, comfort, purpose, stress, morale, and longer-lived moods.
Memories are bounded and tied to real events. Villagers remember important people, places, injuries, kindness, loss, danger, and unfinished work. Successful choices can earn a little more confidence later, but current evidence always matters more than an old habit.
Their speech follows the same rule. A villager can talk about the job, danger, person, need, or memory that is actually on their mind. They do not invent a wedding, death, friendship, or pile of food that never existed.
Families, grief, and history
Villagers make friends, rivals, and enemies. They court, marry, and raise children. A child inherits a stable blend of both parents' temperament, along with a small head start from family skills. The child remains their own person.
Grief lasts. Villagers remember the dead by name and comfort people they genuinely care about. After a real visit, the bereaved get some peace instead of attracting an annoying queue of visitors.
In an established settlement, a local death can found a graveyard when terrain changes are enabled and a safe site exists. Later graves fill its rows when space allows. Their epitaphs come from the life that person actually lived.
The village Chronicle records births, marriages, deaths, elections, coups, and other turning points. It becomes a history of that settlement instead of a list of random flavor text.
A village that organizes itself
Once enough villagers are ready to take part, the settlement elects a leader and council. Political pressure can eventually grow into a bloodless coup plot. Guards patrol, train, equip themselves, and respond when the village is threatened.
Community traditions only happen after something gives them a reason. A death can lead to mourning. A genuine harvest surplus can lead to a gathering. Courtship, grief, grave visits, and coup plots are allowed to take time. They are not fired on cue because the player has been waiting ten minutes.
Danger and defense
A brave villager may stand beside a friend. The same villager still retreats when a fight is clearly lost. People call for help, react to nearby threats, use visible tools and armor, and try to reach safer ground.
Combat stays Minecraft-clean with no gore. Ordinary retaliation against players starts disabled. A confirmed villager-killer is the exception: one killing can bring a non-lethal expulsion, while repeated killing within the village's memory can trigger lethal defense. Lethal villager-on-villager feuds also start disabled.
The mod keeps track of identity through supported vanilla transformations. Zombie conversion is prevented by default. If you enable it, a marked zombie villager can recover their original mind when cured. A villager changed by lightning keeps their name, selected trusted bonds, and acceptance in their settlement as a witch. Naturally spawned zombies and witches never inherit somebody else's life.
How villagers remember you
Every opinion belongs to a specific player. On a server, your friend's clean reputation survives whatever you did to yours.
Villagers remember gifts, attacks, apologies, and help. Relationships slowly drift after a long absence, but they do not reset the moment you leave render distance. Witnesses can gossip, although gossip does not make the whole village instantly know everything.
Stay away long enough and a villager who became close to you may notice your return, walk over, and welcome you back. Build something near a curious villager and they may inspect it during free time. If somebody refuses an apology or invitation, they visibly shake their head, so the answer is readable before the speech line disappears.
Following is optional and starts disabled. When enabled, a trusted villager may agree to walk with you for a while, then head home when they have had enough.
What "AI" means in this mod
There is no ChatGPT or other language model inside the released mod. No API key, account, cloud service, generated-dialogue service, or external telemetry. Optional diagnostics stay on your machine and start disabled. Nothing about your village gets sent away.
The brain is ordinary local Java game logic. A villager reads nearby world state and remembered facts, updates their needs and feelings, weighs the goals available to them, and commits to one action. Later, they remember how that action went.
Behavioral decisions do not use randomness. Give the brain the same saved state and the same observed inputs and it resolves the same choice. A whole Minecraft world will never replay frame for frame, of course. Players, vanilla physics, entity collisions, tick order, and other mods can change the situation around the villager.
I chose this method because I want every important action to have a trail behind it. If somebody holds a grudge, you should be able to find the day you earned it.
Performance and distance
Nearby villagers do the most detailed thinking. By default, that active range is 48 blocks from the nearest player. Loaded villagers from 48 to 96 blocks keep their lives moving with less frequent spatial work. Farther away, an entity that Minecraft still keeps loaded runs only inexpensive survival and internal-state updates.
Sapience never loads chunks by itself. Minecraft's own chunk-ticking rules remain the outer limit.
On the exact beta.354 release build, the fixed packed-80 test measured 6.7 ms average, 8.6 ms at the 99th percentile, and 9.8 ms at the slowest sample, under Minecraft's 50 ms tick budget. The separate 250-villager abuse test kept 250 out of 250 villagers and reached a 31 ms peak. That 250-villager run is a stability test, not a recommended normal village size, and results still vary by hardware and modpack.
Commands, settings, and compatibility
Controls and commands
- Right-click: greet a villager.
- Sneak while holding an item: offer it as a gift.
- Sneak with an empty hand: ask a trusted villager to accompany you when following is enabled.
/villager: read the nearest villager's personality, mood, current goal, skills, family, and opinion of you./sapience stats: see the settlement population, leadership, council, and defense state./sapience version: check the installed build./sapience reload: reload the config without restarting. This requires operator permission level 2.
The mod creates config/sapience.json on first run. You can tune or disable building, terrain changes, gathering, combat, marriage, children, traditions, politics, military behavior, names, speech, held items, armor, simulation distance, and performance mode.
Following, ordinary player retaliation, and lethal feuds start disabled. Turn off allowTerrainModification if you do not want villagers placing or breaking blocks.
Compatibility and world safety
- This build supports Fabric on Minecraft 1.21.1 with the matching Fabric API.
- Install the same Sapience jar and Fabric API on the server and every joining client.
- Mods that replace villager behavior, trading, equipment, held-item rendering, or the villager model may conflict. Test the exact pack you plan to use.
- The mod reads ordinary beds, blocks, entities, and Points of Interest. It does not replace POI data, workstations, world generation, dimensions, networking, golem spawning, or general golem AI. One narrow rule stops a golem attacking a village-accepted transformed witch until real betrayal revokes that acceptance.
- Terrain work checks reach, materials, known structures, block entities, water, drops, and nearby protected cells. Ordinary Minecraft blocks do not reliably record who placed them, so the mod cannot identify every player-placed natural log or stone. Disable terrain changes if that matters in your world.
- NeoForge, Sinytra Connector, Minecraft 1.20.1, and unlisted 1.21.x versions are not supported by this build.
The mod is closed source and All Rights Reserved. You may download and play the official build, make videos, streams, screenshots, reviews, and written coverage. Modpacks may include the official unmodified jar with clear credit and a link to the official download page. See the included license for the full terms.
Getting started
- Install Fabric Loader for Minecraft 1.21.1.
- Install the matching Fabric API.
- Put the Sapience Fabric 1.21.1 jar in the
mods folder on the server and every joining client.
- Back up the world, launch, and find a village.
- Watch for ten minutes. Greet somebody, offer a gift, and use
/villager whenever you want to understand why a person did something.
Sapience is free to download and play. I build it in my spare time, and I read the reports. Early players have already led me to real fixes. If you catch something clever, strange, funny, or broken, send it to me through discord (https://modrinth.com/user/aZoOoZeGamer612).
