CurseForge · Minecraft mod

Villager Optimizer

An server-side utility that drastically reduces the performance impact of villagers by using intelligent tick-based throttling on their AI.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Villager Optimizer release should I use?

Updated 5 months ago

Latest stable file villageroptimizer-1.0.0.jar

Game version 1.20.1

Loader Forge

Villager Optimizer villageroptimizer-1.0.0.jar targets 1.20.1 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Villager Optimizer required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say

Dedicated server Source doesn’t say

Loader for this release Forge

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

Understand client and server requirements Read the Minecraft installation guide

What else does Villager Optimizer villageroptimizer-1.0.0.jar need?

villageroptimizer-1.0.0.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Villager Optimizer without breaking your instance.

Built for Villager Optimizer villageroptimizer-1.0.0.jar. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use villageroptimizer-1.0.0.jar. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.
02
Bring the mods it needs

This file does not list any required mods. Do not add a library just because a different file uses it.
03
Put it on the correct side

The project page does not say whether this file belongs on the client, dedicated server, or both.
04
Pick the file you checked

Use the “Get this file” button beside villageroptimizer-1.0.0.jar. It opens that exact file at the source.

About this project

What does Villager Optimizer add?

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

Project description from CurseForge.

Pick your setup