Mineuniverse
Log in Register
Mods

Villager Optimizer

An server-side utility that drastically reduces the performance impact of villagers by using intelligent tick-based throttling on their AI.
by SatD
Download Claim this project
942 downloads
0 likes
Updated Jul 6, 2026
0 hypes
Performance

Villager Optimizer is an advanced server-side utility for Minecraft Forge designed to mitigate the significant performance impact of villager entities in large-scale environments.


Overview

In servers with large trading halls or densely populated villages, the continuous AI processing of villagers causes massive spikes in CPU usage.

This mod solves this issue by implementing an intelligent tick-based throttling system across various villager AI subsystems. The result is a drastic reduction in Server Milliseconds Per Tick (MSPT) without compromising the core mechanics of trading, breeding, or work cycles.


How It Works

The mod replaces the high-frequency vanilla processing of villager behaviors with a sophisticated interval-based system.

The main engine intercepts the LivingTickEvent and uses individual counters for each villager. Instead of checking complex navigation and detection calculations every tick, the mod distributes these checks over time. At its most aggressive optimization level, the system can completely cancel the native tick event for a villager if none of its tasks require immediate processing.


Features

  • Dynamic AI Throttling: Each behavior subsystem (Brain, Work, Sleep, Breeding) is managed independently, allowing granular control over performance impact.
  • Pathfinding Optimization: Intelligently limits path recalculations, which is one of the primary causes of server lag in confined spaces.
  • Smart Detection: Features a native exclusion system that automatically identifies and manages villagers, allowing specific modded villager types to be excluded from optimization to prevent compatibility issues.
  • Server-Side Only: Can be installed exclusively on the server without requiring modifications to the players' clients.

Configuration & Commands

The mod is designed to work perfectly out of the box with carefully selected default values, which can be modified via the config/villageroptimizer-server.toml file.

Administrators can also manage and monitor the system in-game using the /villageroptimizer command (or the /vo alias).

Available Commands (Requires Operator Level 2):

/vo stats
/vo stats <dimension>
/vo reload
/vo set <pathfinding|brain|work|sleep|breeding|food> <value>

Default Presets:

  • Pathfinding: 100 Ticks (5s)
  • Brain/AI: 40 Ticks (2s)
  • Work/Restock: 200 Ticks (10s)
  • Sleep: 200 Ticks (10s)
  • Breeding: 400 Ticks (20s)
  • Food Share: 200 Ticks (10s)

Compatibility

  • Minecraft Version: 1.20.1
  • Mod Loader: Forge
  • Side: Server-Side

Why This Mod?

Having dozens or hundreds of villagers in a small area is one of the biggest performance killers in multiplayer servers. Unlike solutions that completely remove AI or permanently affect behaviors, Villager Optimizer preserves all essential functionalities. It simply dictates when and how often these logics are calculated, allowing you to maintain massive trading centers with high stability and TPS.


Credits & Support

Author: SatDPhoe

ko-fi

Donate

villageroptimizer-1.0.0.jar
MC 1.20.1, Forge, Server
Release 2026-05-11 Get

More from SatD

Item Editor
587
Magic Team
408
AntiSwap (Attribute Swap Fix)
202
Backstabbing-Fix
173
Infinite Trades
1,417
Babel Core
1,359

You Might Also Like

Better Biome Reblend
Updated version of Better Biome Blend, a mod that improves and fixes biome color blending
9,432,920
Icterine
Advancements optimization (specifically, InventoryChangeTrigger)
9,118,727
- FPS Booster - Lag Killer
powerful client-side performance FPS booster
97,463
Better Pie Chart
This Mod improves the Vanilla Pile Chart perfect for Minecraft SMP servers
9,603
Enhanced Block Entities Backforged
Reduce FPS lag with block entities, as well as customize them with resource packs. Forge 1.16.5 port of EBE
9,451
Unbinilium
Ubinilium is a Minecraft mod designed to optimize performance and enhance gameplay. It stabilizes FPS, renders distant blocks with reduced detail, and efficiently manages memory.
9,364