LazyAI

Overview

Lazy AI dynamically reduces the frequency and precision of mob AI calculations based on their distance from players. Mobs close to players behave normally, while those farther away update their goals, pathfinding, and other goals less often. This ensures smoother performance, especially in mob-heavy worlds.

Lazy AI bases its distance calculations of the simulation distance * distance scaling of your game

Performance difference

Lower ms -> better (target: 50ms or lower per tick)

Vanilla performance

Lazy AI performance

Using AI Optimization Type 'Dynamic' will dynamically switch between the three optimization modes based on TPS

Minimal	Moderate	Agressive

Comparison of Vanilla and LazyAI

TPS comparison in a mob crowded test world

TPS comparison in a giant villager trading hall

Features

• Distance-based AI scaling | Reduces AI updates for mobs that are far from players
• Pathfinding optimization | Simplifies A* path calculations at long distances
• Reduced goal frequency | Look, wander, and tempt goals run less often when distant
• Configurable behavior | Easily balance performance and gameplay through a simple config accessible through mod menu
• Server-wide improvement | Decreases tick load even on servers

Settings

• AI Optimization Type | This settings controls how aggressive the optimizations should be
• Distance Scaling | This setting controls what % range of your simulation distance is considered close and far range
• Mob Tempting Delay | This setting controls how much delay animals have to being tempted by an item
• Disable Zombie Egg Stomping | This setting controls the prevention of zombies wanting to destroy turtle eggs
• Enable Vanilla Mob Ticking (Previously: Never Slow Down Distant Mobs) | This setting controls if distant mobs should tick the same as in a unmodded (vanilla) game. Enabling this reduces the mod's TPS-boosting effect on your game, but can fix mob ticking issues.

FAQ

Can this mod increase my TPS?

Yes, this mod can improve your TPS.

Can this mod increase my FPS?

No, this mod cannot improve your FPS.

Why does the dynamic optimization mode not target below 50ms?

Minecraft runs on a 50ms tick cycle (20 TPS). If the (local) server processing finishes in under 50ms, the game waits for the remaining time. Consequently, any optimization below 50ms yields no increase in normal tick speed. The mod focuses on keeping tick times from exceeding 50ms, as higher values cause entities to move in slow motion. The heavier the (local) server load, the more aggressively the dynamic mode intervenes to maintain 50ms. When the (local) server runs smoothly, the mod scales back its intervention.

Does this mod affect mob farms?

Short awnser: Yes, but only a little bit.

Long awnser: Yes, LazyAI does affect mob farm efficiency, but the throughput impact is minimal. In testing with my iron golem farm, vanilla Minecraft yielded 1023 iron ingots, while with the LazyAI on the aggressive setting yielded 979 iron ingots. That's a difference of ~4.5%.

A few things worth noting:

• This was tested on the aggressive setting, which has the most impact. Using a less aggressive setting will reduce that gap further.
• A ~4.5% decrease is unlikely to be noticeable in normal gameplay.
• Results may vary depending on farm design and server performance.
• The testing were done on LazyAI version 1.6.0.

In practice, you won't notice the mob farm efficiency decrease.

What modloader do I need?

You need Fabric

I installed the mod, but didn't see as much difference?

The preview images are taken in a stress test situation. It can also be because your simulation distance or this mods distance scaling is set too high for your use case.

Where is the config located?

.minecraft/config/lazy-ai.json

Can this mod be used on a server?

Yes, you can use this mod on a server. The mod works on both the server and the client. Vanilla clients can join a server using LazyAI.

Can this mod be used on a client?

Yes, you can use this mod on a client. The mod works on both the server and the client. Clients with LazyAI can join servers without LazyAI.

How does the AI Optimization Type and Distance Scaling work?

See below ↓

How does the AI Optimization Type and Distance Scaling work?

This overview is a simplified explanation.
This mod makes use of additional smaller systems, but AI Optimization Type and Distance Scaling are the two main systems that dictate how the mod behaves.

The percentages and radiuses shown in this explanation are for visual reference and do not reflect the actual numbers.

The following image will be used as a base for the visual references:

AI Optimization Type

This setting controls how aggressive mob AI ticks are reduced across each zone. The percentages represent how much of the original vanilla AI activity remains:

Distance Scaling

This setting controls where the range zone boundaries are positioned relative to your simulation distance and player location.