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

| Option | Default | Effect |
| — | — | — |
| trading.maxUsesMultiplier | 1.0 | Multiplies how many times a trade can be used before it locks. Set it to 4.0 and a trade that ran out after 12 uses now lasts 48. |
| restocking.restocksPerDay | 2 | How many times a villager may restock per day. |

Breeding

| Option | Default | Effect |
| — | — | — |
| breeding.ignoreBedRequirement | false | Let villagers breed even when no free bed is available. |
| breeding.cooldownTicks | 6000 | How long parents wait before breeding again. 0 removes the cooldown. |
| breeding.maxBreedsPerDay | -1 | Cap breeds per villager per day. -1 = unlimited. |
| breeding.babyGrowthTicks | 24000 | How long a newborn stays a baby. |

Curing

| Option | Default | Effect |
| — | — | — |
| curing.conversionTimeMultiplier | 1.0 | How long curing a zombie villager takes. |
| curing.discountMultiplier | 1.0 | How large the permanent cure discount is. 0.0 removes it. |

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 | Fabric Loader | Java |
| — | — | — |
| 1.21 – 1.21.1 | 0.16.0+ | 21 |
| 1.21.9 – 1.21.11 | 0.16.0+ | 21 |
| 26.2 | 0.19.3+ | 25 |

Fabric API is required on every version.

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.