
Configurable Villagers
Server-side mod that puts villager trading, restocking and breeding in a config file. No client install needed.
I don't know my version or loader
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.maxUsesMultiplierapplies 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.babyGrowthTicksapplies to villagers born from breeding. Babies from spawn eggs or village generation keep the vanilla timer.curing.discountMultiplierabove1.0does nothing — vanilla already grants the maximum the reputation system allows, so only values below1.0have 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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21.9, 1.21.10, 1.21.11
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as configurablevillagers-mc1.21.11-0.1.3.jar — drop this file into the mods folder
- Download size: 60 KB
- Download link checked 7 Sept 2026 — working
These come from our own check of the pack file, not from the source page.