Overview

Villager Overhaul turns villagers into owned, configurable workers with personalities, economy tools, farm automation, combat behavior, respawning, and teachable commands.

The mod is built around one idea: a villager should be a character you invest in, not a disposable workstation block.

TLDR

Recruit villagers and manage them through the villager screen.
Merchant villagers can lock trades, reroll offers, auto-search for specific results, and auto-trade.
Farmer villagers can deposit, withdraw, plant, harvest, bonemeal, till soil, and clean their inventory.
Combat villagers can flee, defend, attack proactively, use equipment, eat food, block with shields, and follow chat commands.
Custom Commands let you teach a villager a recorded routine and trigger it later through chat.
Stats affect prices, cooldowns, XP, farming range, work time, item usage, combat strength, and more.

First Steps

Install EZ Actions with Villager Overhaul.
Open a villager and recruit it.
Use the added controls in the villager screen to choose movement, combat, farming, trading, or custom-command behavior.
Tune per-villager settings from the same UI.
Use server config if you want to rebalance costs, ranges, module toggles, stats, chat range, and XP.

Note

Villager Overhaul stores most villager data on the villager itself. Stats, ownership, trade locks, farming rules, taught commands, history, registered blocks, and respawn data survive world saves.

In-Game Controls

Villager Overhaul adds compact controls around the vanilla villager flow instead of replacing the whole game screen.

Villager Info Back

⌂

Generosity +42

Strength +28

Ranger +55

History, family, trades

☰ * ¤ ⚔ ⚭ ⌛

The info screen shows identity, module stats, overview rows, family data, trade data, and history through small bottom tabs.

⚐

MovementIdleFollowPatrol

FarmingManualWorkstationSettings

MerchantTradingStorefrontHall

CombatFleeDefendAggressive

CustomTeachListSettings

The commands button opens an EZ Actions radial. It groups movement, merchant, farming, combat, and custom-command actions around the villager you control.

Main Modules

Module	What It Adds
General	Recruitment, ownership, stats, names, family trees, history, localized chat, respawning, admin commands, and the Trading Hall block.
Merchant	Trade locks, paid rerolls, auto-search, auto-trade, merchant stats, payout tracking, and currency integrations.
Farming	Deposit and withdraw logistics, manual farming, workstation-based work areas, farming profiles, and farming stats.
Combat	Movement and combat modes, target filters, loadouts, ranged attacks, shield blocking, eating, patrols, and global combat presets.
Custom Commands	Teachable routines, command phrases, chat relay, chained commands, and player-wide quick chat commands.

Villager Stats

Every supported merchant entity gets twelve stat values from -100 to 100.

Stat	Affects
Generosity	Reroll costs, auto-search hourly costs, and emerald trade prices. Positive values are cheaper for the player.
Timeliness	Manual reroll and auto-search cooldowns. Positive values are faster.
Intellect	Villager XP gained from merchant activity. Positive values increase XP.
Hoarder	Extra or missing merchant offers within the server-configured clamp.
Vitality	Max health.
Agility	Movement speed.
Strength	Attack damage.
Armor	Armor value.
Motivation	Manual farming work-window length.
Efficiency	Chance to save or waste seeds and bonemeal.
Plant Whisperer	Chance for passive nearby crop growth.
Ranger	Maximum manual farming range.

Technical note: stat scaling

Stat points are mapped linearly into server-configured min/max ranges.

Example: if a stat range is -20% to +20%, then -100 maps to -20%, 0 maps to 0%, and 100 maps to +20%.

Ownership Rules

Recruited villagers are owned by the player who recruited them.

Owner-only controls are used for most direct management.
Same-owner recruited villagers are protected from combat targeting.
Respawn, farming settings, combat settings, trade controls, and taught commands are tied to the recruited villager.
Several systems check the server-side owner instead of trusting the client UI.

Navigation

Use the wiki pages in the left sidebar:

General Systems for recruitment, stats, names, chat, history, respawning, and Trading Hall.
Merchant Module for rerolls, auto-search, auto-trade, trade locks, and payment.
Farming Module for storage rules, manual farming, crop priorities, and farming stats.
Combat Module for modes, targeting, equipment, ranged behavior, shields, and food.
Custom Commands for teaching routines and chat-triggered commands.
Configuration for the important server knobs.

Technical note

This wiki avoids version-specific wording on purpose. Villager Overhaul may be ported or updated, and the behavior documented here is about the mod systems rather than one loader/version string.