Villager Optimizer

By
SatD

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

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.