DeerFolia · Features and optimizations

Feature overview

Feature	Default	Main goal	Watch for
Restored vanilla behavior	On	Restore selected vanilla behavior	Changes selected upstream defaults
Dynamic Activation of Brain	On	Reduce AI work for distant entities	Farms and villagers may show delay
Async Pathfinding	On	Reduce pathfinding pressure on region ticks	Too many threads can add GC pressure
Kaiiju Entity Throttling	On	Control high-density entity updates	Low limits affect farms and trading halls
Network Optimizations	On	Reduce packet-processing overhead	Debug one option at a time with proxies
Lithium Optimize	On	Optimize hot server paths	Changes require a restart
POI Optimizations	On	Reduce villager POI and golem-check CPU	Check cadence can change
AFK Network Optimization	On	Reduce downstream traffic for AFK players	Resume depends on resynchronization

Restored vanilla behavior

DeerFolia restores sand-duplication-related vanilla behavior in its Folia environment. It also changes parts of End teleport handling. These changes do not have a separate switch. Test them on a copy when you need upstream Folia behavior.

Dynamic Activation of Brain

DeerFolia reduces AI work for distant entities. It uses distance and a maximum activation interval. See DeerFolia configuration for the keys and tuning steps.

Async Pathfinding

DeerFolia runs selected pathfinding work in a virtual-thread pool. See DeerFolia configuration for thread settings and rollback steps.

Kaiiju Entity Throttling

DeerFolia throttles selected entity types and can remove them gradually in each region. Use this feature for high entity density in a target region. Do not give every entity a low limit. See Entity throttling for the file format.

Network optimizations

DeerFolia optimizes VarInt reads and writes and network frame encoding. These changes should not change gameplay. If a network issue occurs with a proxy, compression plugin, or protocol bridge, disable one option at a time on a test copy.

Lithium-derived optimizations

DeerFolia uses selected Lithium server optimizations. It adapts them to the Paper, Moonrise, and Folia execution models. The groups cover allocations, AI, collections, entities, math, and world paths. It does not copy client-only behavior or code that requires one mutable main thread.

POI optimizations

POI optimization reduces the frequency of villager golem checks, secondary sensors, and village-distance calculations. Start with the default values in a large villager area. If an iron farm depends on timing, compare its output after each change.

AFK network suppression

An AFK player still participates in server world logic. DeerFolia suppresses selected chunk, block, entity, world-effect, and UI data sent to that player. When activity resumes, DeerFolia resynchronizes required chunks and entities. Use /afknetstats with administrator permission to view the saved traffic.

Why everything is on by default

The default values provide a safe starting point. They are not a tuning profile for every server. When behavior changes, do not disable every optimization at once. Change one group. Record the result. Keep only changes that help your workload.