Skip to content

Villager Overhaul

Villager Overhaul is a NeoForge mod that adds three big systems for recruited villagers:

  • Merchants: reroll, lock, auto-search, and auto-trade villager offers (with server-balanced costs).
  • Guards: equip villagers with real gear and configure combat behavior.
  • Farmers: deposit/withdraw logistics + a manual-farming AI that works with modded crops.

Getting started (2 minutes)

  1. Install NeoForge 1.21.1 and Villager Overhaul.
  2. In-game, find an unemployed villager (profession = none).
  3. Right-click the villager to open the Recruit screen.
  4. Pay the emerald cost to recruit (ownership is enforced server-side).
  5. Open the villager again: the mod's UI (commands, settings, info) becomes available.

Start here

Recruiting & Ownership

Choose your module

  • Merchants: trading QoL + balance (rerolls, locking, auto-search).
  • Guards: combat modes, triggers/filters, gear, blocking, eating.
  • Farmers: chests logistics and manual farming automation.
  • Custom Commands: teach villagers action sequences and trigger them from chat.

Server owners

Server config is hot-reloaded from config/villageroverhaul-server.toml.

See: Server Config