Configurable Villagers

Configurable Villagers

Villagers, on your terms. Configurable Villagers exposes the parts of villager behaviour that vanilla hardcodes — how much stock a trade holds, how often villagers restock, how fast they breed, how long curing a zombie villager takes — and puts them in a config file you can edit while the server is running.

It runs entirely on the server. Players join with a vanilla client. No mod to install, no version mismatch, nothing to explain in your Discord.

What you can change

Trading

Breeding

Curing

Plus enabled, a master switch that returns everything to vanilla without uninstalling.

Every default reproduces vanilla exactly. Installing the mod changes nothing until you turn a knob.

Configuring it

The config lives at config/configurablevillagers.json and writes its own documentation — a header listing every option, its default and what it does, so you never have to leave the file to look something up.

You can also do it without touching the disk:

/configurablevillagers help                          list every option, default and description
/configurablevillagers status                        current values next to their defaults
/configurablevillagers set breeding cooldownTicks 600
/configurablevillagers reload                        re-read the file after editing it

set saves immediately. All commands need permission level 2.

Requirements

• Minecraft 26.2
• Fabric Loader 0.19.3+
• Fabric API
• Java 25

Works on dedicated servers and in singleplayer. Clients do not need the mod.

Good to know

• trading.maxUsesMultiplier applies when a trade is generated, so the value is baked into the offer and synced to clients — vanilla players see the real stock count instead of the trade greying out early. Villagers keep trades they already rolled; the new multiplier applies to trades generated afterwards. It also affects wandering traders, since they share the same offer type.
• breeding.babyGrowthTicks applies to villagers born from breeding. Babies from spawn eggs or village generation keep the vanilla timer.
• curing.discountMultiplier above 1.0 does nothing — vanilla already grants the maximum the reputation system allows, so only values below 1.0 have a visible effect.
• In 26.2 the trades themselves (what each profession sells, and for how much) are a datapack registry. This mod deliberately does not duplicate that — use a datapack for trade contents and this mod for the mechanics around them.