Villager Overhaul

Welcome to Villager Overhaul. This mod adds a bunch of QoL features to trading, farming, adds Villager combat mechanics as well telling your villagers to do something (via a chat message).

Why this mod? Simply put:

• Mojang clearly forgot about Villagers 🥲
• Each Villager is unique, giving the player new ideas to make use of its skills
• Make villagers more alive and give them a purpose other than being prisoners at Steve's mercy
• Villagers will now turn your areas into living, breathing cities

Trading features consume emeralds. The default configuration tries to be balanced, but everything is fully configurable, of course.

For now, this mod only supports NeoForge 1.21.1 and beyond, due to the complexity of the mod’s architecture. I may investigate porting to 1.20.1 in the future, but there are no plans as of now.

Wiki

Please visit: https://z2six.github.io/VillagerOverhaul

Chat commands

• Teach your villager to do stuff by showing them what to do
• Save the sequence of actions (like a macro) and set a chat message
• Type the chat message, if the Villager is in range it will do what you taught it
• Shout "help" or "follow" to make nearby villagers stop what they're doing and do what they're told!

Guard Features

Vitality | Agility | Strength | Armor

• Give villagers fully functioning equipment (armor, sword, shield)
• Each villager spawns with 4 randomized custom Combat stats
• Villagers return to normal jobs (like farming) when not on guard duty
• Assign patrol routes to villagers
• Tell villagers to follow you or stop moving
• Villagers eat food to regenerate HP
• Fully customize when villagers engage in combat (individually or globally)
• Customize each villager’s combat AI

Merchant features

Generosity | Timeliness| Intellect | Hoarder

• Reroll trades at any villager level in exchange for emeralds
• Lock specific trades so they won’t get rerolled
• Automatically reroll until a specific item is found while you're away (RMB on reroll button)
• Automatic trading (example: quickly trade all paper for emeralds) (CTRL+Click on a sell-type trade)
• Each villager spawns with 4 randomized custom Merchant stats

Farming Features

Motivation | Efficiency | Plant Whisperer | Ranger

• Manual Farming mode: smarter than vanilla farming, works with any modded item that requires Farmland (Nether Wart + Soul Sand is supported too, though)
• Instruct your villager to only farm one specific thing. It will ignore everything else
• Villager can use Hoe (with Fortune enchant)
• Register a deposit and withdrawal chest for each villager
• Villager's will place/take items in the registered chest, based on its settings
• Register a "workstation" and a range in which the villager works (around its workstation, which can be any block)
• Villagers will turn Dirt into Farmland within their working range (if you turn that on in Farm Settings GUI)
• Configure when/what to deposit/withraw
• Configure what items to pick up
• Villagers will take Bonemeal from Withdraw chest and use it on crops
• Planting seeds gives EXP
• Villager auto-crafting is disabled (e.g. turning Wheat into Bread)
• Each villager spawns with 4 randomized custom Farming stats

General Features

• Turn off/on any of this mod's modules completely: Merchants, Guards, Farmers.
• Villagers can be respawned
• Other players cannot run commands, rerolls, etc. on villagers you recruited
• Villager information GUI showing stats, history, attributes, and more
• Localized chat with shouting and whisper function, due to incompatibility with the popular (and very cool) mod.
• Server config is hot-loaded — no server restart required

How to Use

1. 📝 Read the wiki! 😉
2. 👪 Find a villager (or breed one)
3. 💎 Right-click to recruit it (if you like its stats)
4. 🖱️ Right-click it again — the mod’s buttons will now appear
5. 📊 Configure villageroverhaul-server.toml to rebalance everything
6. ⚙️ Press K to set default villager combat AI settings
7. 👻 Perfect villager died? Right-click a Respawn Anchor while holding an emerald

Important incompatibilities

1. Localized Chat (hence, this mod adds the same features)