About Villager Brain Configuration
From ModrinthA highly optimized server-sided mod that allows full configuration of villager pathfinding malus
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
}
]
}Highlights
From source dataGame versions
Supports 8 Minecraft versions, the newest being 1.21.8.
Loaders
Runs on Fabric and NeoForge.
Footprint
Rated a light load on a server.
Villager Brain Configuration on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Fabric, NeoForge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.0.1, released 2025-08-11
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Fabric | 1.21.1 to 1.21.8 (8 versions) | 1.21.8 |
| NeoForge | 1.21.1 to 1.21.4 (4 versions) | 1.21.4 |
From 5 recorded builds of Villager Brain Configuration.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.0.1 | 2025-08-11 | 1.21.1 | Fabric |
| 1.0.1 | 2025-08-11 | 1.21.1 | NeoForge |
| 1.0.1 | 2025-08-11 | 1.21.2 to 1.21.4 (3 versions) | Fabric |
| 1.0.1 | 2025-08-11 | 1.21.2 to 1.21.4 (3 versions) | NeoForge |
| 1.0.1 | 2025-08-11 | 1.21.5 to 1.21.8 (4 versions) | Fabric |
Dependencies
- Required: modrinth project P7dR8mSH (modrinth, not in our catalogue)
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run Villager Brain Configuration on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogCreatures & NPCs
Adds or changes creatures, NPCs and how they behave.
Runs on your server
From source side supportModrinth lists Villager Brain Configuration as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- FabricNeoForge
- Runs on
- Serverrequired on the server
- Game versions
- 1.21.8 and 7 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-17Open ↗
- ✓Authorjoshieman, as published on Modrinth
- ✓LicenseMITFree











