SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedCreatures & NPCs

Villager Brain Configuration

by joshieman · for Minecraft

A highly optimized server-sided mod that allows full configuration of villager pathfinding malus

4.4KDownloads
16 mo agoLast updated
MITLicense
Fabric · NeoForgeLoaders

About Villager Brain Configuration

From Modrinth

A 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

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
    }
  ]
}

Highlights

From source data

Game 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

LoaderGame versionsNewest
Fabric1.21.1 to 1.21.8 (8 versions)1.21.8
NeoForge1.21.1 to 1.21.4 (4 versions)1.21.4

From 5 recorded builds of Villager Brain Configuration.

Recent builds

BuildReleasedGame versionsLoaders
1.0.12025-08-111.21.1Fabric
1.0.12025-08-111.21.1NeoForge
1.0.12025-08-111.21.2 to 1.21.4 (3 versions)Fabric
1.0.12025-08-111.21.2 to 1.21.4 (3 versions)NeoForge
1.0.12025-08-111.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 catalog
Listed on Modrinth as “Mods”

Creatures & NPCs

Adds or changes creatures, NPCs and how they behave.

Runs on your server

From source side support

Modrinth 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

Villager Brain Configuration, answered

Generated from the mod’s own source data.

Do my players need to install Villager Brain Configuration?

Modrinth lists Villager Brain Configuration as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric and NeoForge.

Is it free?

Yes. Villager Brain Configuration is free to download from Modrinth. Its license is MIT.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Villager Brain Configuration on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Villager Brain Configuration in one click.