Villager Brain Config
A lightweight, highly optimized mod that makes villager pathfinding behavior fully configurable
Features
-
Per-block malus control
Customize how villagers treat different blocks in pathfinding. Blocks are configurable to any malus, block and item tags supported -
Profession-based malus
Configure different path preferences per villager profession. -
Global block penalty caching
Pathfinding results are cached for maximum efficiency across multiple villagers -
Native modded support The config file supports any modded blocks or professions
Example Use Cases
- Prevent villagers from walking into trap blocks like campfires or magma
- Make water paths viable for fishermen only
- Design custom village layouts with optimized navigation paths
- Prevent villagers from wandering off paths
- Add personality to each profession type
Pathfinding Visualizations


Planned features
- Per-villager-type rules (eg. plains villagers, taiga villagers)
Performance
Villager Brain Config is designed to be almost invisible in impact or even faster than vanilla
Test case
- 250 villagers
- Each pathing to a unique workstation in a grid
- Compared vanilla to modded using Spark profiler
Results
Vanilla Logic

Modded Logic

Mod total

Configuration
All settings are in a villager-brain-config.json file in the config folder.
{
"walk_on_block_penalties": {
"minecraft:grass_block": 4.0,
"minecraft:dirt_path": 0.0,
"default": 5.0
},
"walk_through_block_penalties": {
"minecraft:lava": -1.0,
"minecraft:tall_grass": 20,
"default": 0.0
},
"actions_penalties": {
"jump": 10.0
},
"professions": {
"minecraft:farmer": {
"walk_on_block_penalties": {
"minecraft:farmland": 0.0,
"minecraft:grass_block": 2.0
}
},
"minecraft:fisherman": {
"walk_on_block_penalties": {
"minecraft:water": 0.0
},
"walk_through_block_penalties": {
"minecraft:water": 0.0
}
}
},
"avoids": [
{
"block": "minecraft:lava",
"radius": 3,
"penalty": -1.0
}
]
} How to Install Villager Brain Configuration (Mod)
Villager Brain Configuration by joshieman is verified for Fabric, Neoforge across Minecraft versions 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 (latest release: 1.0.1, file size: 59 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8) and platform (Fabric, Neoforge).
- Make sure you have the compatible loader or environment installed for Fabric, Neoforge.
- Move the downloaded Villager Brain Configuration file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version- Fixed a bug where villagers walked diagonally over
-1.0malus blocks ([#3](https://github.com/joshie-app/villager-brain-config/issues/3)) - Fixed a bug where villagers could not jump ([#4](https://github.com/joshie-app/villager-brain-config/issues/4))
- Fixed a bug where villagers walked diagonally over
-1.0malus blocks ([#3](https://github.com/joshie-app/villager-brain-config/issues/3)) - Fixed a bug where villagers could not jump ([#4](https://github.com/joshie-app/villager-brain-config/issues/4))
- Added support for versions
1.21.2and1.21.3
- Fixed a bug where villagers walked diagonally over
-1.0malus blocks ([#3](https://github.com/joshie-app/villager-brain-config/issues/3)) - Fixed a bug where villagers could not jump ([#4](https://github.com/joshie-app/villager-brain-config/issues/4))
- Added support for
1.21.2and1.21.3
- Fixed a bug where villagers walked diagonally over
-1.0malus blocks ([#3](https://github.com/joshie-app/villager-brain-config/issues/3)) - Fixed a bug where villagers could not jump ([#4](https://github.com/joshie-app/villager-brain-config/issues/4))
- Added support for versions
1.21.5->1.21.8
- Fixed a bug where villagers walked diagonally over
-1.0malus blocks ([#3](https://github.com/joshie-app/villager-brain-config/issues/3)) - Fixed a bug where villagers could not jump ([#4](https://github.com/joshie-app/villager-brain-config/issues/4))
- Added support for versions
1.21.5->1.21.8
- Fixed a bug where villagers walked diagonally over
-1.0malus blocks ([#3](https://github.com/joshie-app/villager-brain-config/issues/3)) - Fixed a bug where villagers could not jump ([#4](https://github.com/joshie-app/villager-brain-config/issues/4))