Configurable Villagers
Vanilla Minecraft treats villagers like a black box. You can trade with them, breed them, and cure them, but the rules behind those systems are locked away in hardcoded values. The Configurable Villagers mod for Minecraft changes that. It exposes the internal knobs that control villager stock, restocking frequency, breeding cooldowns, and zombie villager curing times, then hands them to you in a simple config file. Want a village economy that runs like a bustling marketplace? Or a slow-burn medieval settlement where trades are rare and precious? Configurable Villagers puts those decisions in your hands.
What Does Configurable Villagers Do?
At its core, this mod is about removing guesswork. Every option in the mod has a default value that perfectly reproduces vanilla behavior. Installing Configurable Villagers changes absolutely nothing until you decide to edit the config. That means you can add it to a server without worrying about breaking your existing world. It is a server-side mod, so players join with a standard vanilla client. No one needs to install anything, and there is no version mismatch to explain in your Discord server.
Trading Options
The trading system is the heart of villager interaction. Configurable Villagers gives you two primary levers to pull here. The trading.maxUsesMultiplier option 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 for 48. This multiplier 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. The restocking.restocksPerDay option controls how many times a villager may restock per day. Lower it for scarcity, raise it for abundance. Note that 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 Options
Population control is a common server headache. Configurable Villagers addresses it with several options. The breeding.ignoreBedRequirement flag lets villagers breed even when no free bed is available. The breeding.cooldownTicks option sets how long parents wait before breeding again; set it to 0 to remove the cooldown entirely. You can cap breeds per villager per day with breeding.maxBreedsPerDay, where -1 means unlimited. Finally, breeding.babyGrowthTicks determines how long a newborn stays a baby. This applies to villagers born from breeding; babies from spawn eggs or village generation keep the vanilla timer.
Curing Options
Zombie villager curing is a high-risk, high-reward mechanic. The curing.conversionTimeMultiplier changes how long curing takes, letting you speed up or slow down the process. The curing.discountMultiplier controls the size of the permanent cure discount. Set it to 0.0 to remove the discount entirely. A value above 1.0 does nothing, since vanilla already grants the maximum the reputation system allows; only values below 1.0 have a visible effect.
How to Configure the Mod
The configuration lives at config/configurablevillagers.json. The file writes its own documentation, including a header listing every option, its default, and what it does. You never have to leave the file to look something up. You can also edit settings without touching the disk using in-game commands. The /configurablevillagers help command lists every option, default, and description. The /configurablevillagers status command shows current values next to their defaults. Use /configurablevillagers set breeding cooldownTicks 600 to change a value on the fly, and /configurablevillagers reload to re-read the file after editing it. The set command saves immediately. All commands require permission level 2.
Supported Versions and Requirements
Configurable Villagers for Minecraft runs on the Fabric loader. It supports Minecraft 1.21 through 1.21.1 with Fabric Loader 0.16.0+ and Java 21. It also supports 1.21.9 through 1.21.11 with the same loader requirements, and version 26.2 requires Fabric Loader 0.19.3+ and Java 25. Fabric API is required on every version. The mod works on dedicated servers and in singleplayer. Clients do not need the mod installed.
If you are looking for a hassle-free way to get started, the foxygame.net launcher offers a one-click install for Configurable Villagers, and its add-on catalog keeps track of version compatibility so you always pick the right build for your Minecraft setup.
A Note on Version 26.2
In version 26.2, the trades themselves (what each profession sells, and for how much) are a datapack registry. Configurable Villagers deliberately does not duplicate that functionality. Use a datapack for trade contents and this mod for the mechanics around them. This separation keeps the mod focused and avoids conflicts.
Why Server Owners Love It
The biggest selling point is simplicity. Since the mod runs entirely on the server, there is no client-side installation. Players join with a vanilla client, and everything just works. The config file is self-documenting, so even a new server admin can understand what each option does. And because every default reproduces vanilla exactly, you can enable the master switch to return everything to vanilla without uninstalling the mod.
How to Install
To install Configurable Villagers, download the mod file from a trusted source and place it in your server's mods folder. Ensure you have the correct Fabric Loader and Fabric API versions installed. After starting the server, the config file will be generated automatically. Then you can edit it or use the in-game commands to adjust settings. The process for how to install is straightforward, and the mod's documentation covers any edge cases.
Final Thoughts
Configurable Villagers is a precision tool for server owners who want control without complexity. It respects vanilla behavior until you choose otherwise, and it gives you live editing capabilities that make balancing a village economy a breeze. Whether you are running a small survival server or a large community, this mod earns its place in your modpack. Everything the developer makes is free and MIT-licensed, so you can use it with confidence. If it saves you time, consider supporting the project. Download Configurable Villagers today and make villagers work for you.