All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Villager Brain Configuration

Villager Brain Configuration

by joshieman • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

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

Smart villager takes the short path to get to his job site

Smart villager takes the short path to get to his job site


Stupid villager walks off the screen to get to his job site

Stupid villager walks off the screen to get to his job site

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

Vanilla: VillagerEntity.tick(): 7.42

Modded Logic

Modded: VillagerEntity.tick(): 5.68

Mod total

villager-bran-config: 1.75ms

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:

  1. 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).
  2. Make sure you have the compatible loader or environment installed for Fabric, Neoforge.
  3. Move the downloaded Villager Brain Configuration file into your Minecraft .minecraft/mods folder and launch the game.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.21.1
Fabric
last yr. 1
1.21.1
Neoforge
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Neoforge
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Neoforge
last yr. 1
1.21.4
Neoforge
last yr. 1
1.21.4
Fabric
last yr. 1
1.21.1
Fabric
last yr. 1
1.21.1
Neoforge
last yr. 1
[1.0.1] fabric-1.21.1-1.0.1 by joshieman on Aug 11, 2025
Download
### Bug Fixes
[1.0.1] neoforge-1.21.1-1.0.1 by joshieman on Aug 11, 2025
Download
### Bug Fixes
### Features
  • Added support for versions 1.21.2 and 1.21.3
### Bug Fixes
### Updates
  • Added support for 1.21.2 and 1.21.3
### Bug Fixes
### Updates
  • Added support for versions 1.21.5 -> 1.21.8
### Bug Fixes

### Updates
  • Added support for versions 1.21.5 -> 1.21.8
### Bug Fixes

[1.0] neoforge-1.21.1-1.0 by joshieman on Jul 26, 2025
Download
Initial Mod Content
Villager Brain Configuration Icon
Download Villager Brain Configuration
Select game version
Select platform