Description

## 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](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)