HomeJavaModsConfigurable Villagers
Configurable Villagers
ModsJava

Configurable Villagers

by lyszczykooo · on Modrinth

Server-side mod that puts villager trading, restocking and breeding in a config file. No client install needed.

Which Minecraft do you have?

Every version of the game needs its own build. Pick yours, then download — the wrong build installs fine and then does nothing in the game. This mod is built for Fabric only.

⬇ Download for 26.2⬇ Download for 1.21.9–1.21.11⬇ Download for 1.21–1.21.1
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

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

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more