Sapience

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.

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.

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.

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.

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.