Villager Brain Configuration
by joshieman
Villager Brain Configuration lets server owners set the pathfinding penalties that decide which blocks villagers avoid, per block and per profession.
What it does
The mod changes how villagers route around blocks. Server owners can assign a pathfinding malus to each block, so campfires, magma and similar trap blocks can be kept off villager routes. Penalties can also be set per profession, and a global block penalty cache is kept to reduce the work spent on repeated lookups. Settings are stored in villager-brain-config.json inside the config folder.
Because the behavior is controlled by a single configuration file, a server can tune village paths to suit its own builds. The author describes the impact as almost invisible in vanilla play. Installation needs Fabric API on Fabric, while NeoForge needs nothing beyond the mod itself. Villager Brain Configuration is server-side only, so players join without installing it. It is open source under the MIT License and is published for 1.21.1 – 1.21.8, with Fabric and NeoForge files, both at 1.0.1 for 1.21.8.
Key features
Per-block malus control
Each block can receive its own pathfinding penalty, so villagers avoid chosen blocks while routing elsewhere normally.
Profession-based penalties
Penalties can differ by villager profession, letting fishermen use water paths while other professions stay on land.
Water paths for fishermen
Water routes can be opened only to fishermen, keeping other villagers from wandering into the water.
Keeping villagers on paths
Settings can stop villagers from walking off designed paths and wandering away from their job sites.
Global penalty caching
Block penalty lookups are cached globally, which the author presents as a way to keep the extra work small.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Server owners who run villages and want to control how villagers move. Modpack authors and map builders designing custom village layouts can use the same settings in the config file.
Questions
Does Villager Brain Configuration need Fabric API?
Does the server need the mod, and do players?
Where are the pathfinding settings stored?
In the catalog
Villager Brain Configuration is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 17,695 mods support Minecraft 1.21.8.
More from joshieman
Similar mods
What the author says
A lightweight, highly optimized mod that makes villager pathfinding behavior fully configurable Villager Brain Config is designed to be almost invisible in impact or even faster than vanilla
Official listing
- Modrinth page
- modrinth.com/mod/vbc
- Owner
- joshieman
- Published
- 2025-07-24
- Updated on Modrinth
- 2025-08-11
- Facts verified
- 2026-10-15