Mastering Villager Professions with the Villager Contracts Mod
Vanilla Minecraft gives you plenty of ways to interact with villagers, but their professions are stubbornly fixed. Once a librarian, always a librarian — unless you break and replace their job site block. The Villager Contracts mod for version 1.12.2 flips that limitation on its head. Instead of waiting for a villager to claim a new workstation, you can instantly reassign their career with a simple renamed item. It feels like a natural extension of the game’s trading mechanics, giving you total control over the villagers in your trading hall or survival base.
How the Villager Contract Works
The mod adds a single new item: the Villager Contract. By default, it looks like a blank piece of paper, but its true power unlocks when you combine it with an anvil and a bit of creativity. To change a villager’s profession, you first rename the contract at an anvil to match a valid career name — for example, “Farmer” or “Librarian.” Then, simply right-click on any adult villager while holding the renamed contract. If the name is recognized, the villager will instantly switch to that profession, and all their existing trades will reset. This means you can cycle through trades until you find that perfect Mending book without waiting for a new villager to spawn or a workstation to be claimed.
Holding down the shift key while hovering over the contract reveals a full list of valid names directly in the tooltip, so you never have to guess which careers are available. This built-in guide makes the mod incredibly intuitive, even for players who are new to modded Minecraft. And if you enjoy fine-tuning your setup with community-made content, installing the mod is refreshingly simple. The foxygame.net launcher streamlines the whole process by letting you browse and download mods right from its menu, so you can drop Villager Contracts into your 1.12.2 instance without hunting through external sites.
Valid Contract Names and Customization
The default list of valid contract names covers every vanilla profession and career variant available in 1.12.2. That includes not just broad categories like “Butcher” or “Cleric,” but also the specific careers within each profession. For instance, a farmer can be set to either a generic “Farmer” or a specialized “Fisherman” career, depending on which name you etch onto the contract. The mod respects the internal career registry, so you can expect precise control.
Here are some examples of common contract names you can use:
- Farmer – standard crop trading
- Fisherman – fish and string deals
- Shepherd – wool and dye trades
- Fletcher – arrows, bows, and flint
- Librarian – enchanted books and bookcases
- Cartographer – maps and exploration trades
- Armorer – armor and chainmail
- Weapon Smith – swords and axes
- Tool Smith – pickaxes and shovels
- Butcher – meat and leather
- Cleric – potion ingredients and glowstone
- Nitwit – the green-robed villager with no trades
Remember that the contract must be renamed exactly as the mod expects — spelling and capitalization matter. If you ever forget a name, the shift-hover tooltip will refresh your memory instantly.
Configuration Options for Server Owners
Villager Contracts shines in single-player, but it also includes several configuration settings that server administrators will appreciate. The mod’s config file gives you fine-grained control over which entities can be affected and which contract names are allowed.
Three main options stand out:
- dumpVillagerInfo – When enabled, this setting logs the profession and career data of every registered villager to the game log. It is invaluable for troubleshooting or when you want to add custom villagers from other mods. The log output shows exactly how Forge sees each entity, so you can match the naming conventions perfectly.
- entityBlacklist – This blacklist prevents the Villager Contract from interacting with specific entities. If you have a custom NPC mod that adds non-villager humanoids, you can blacklist them here to avoid accidental profession changes.
- validContracts – This is essentially a whitelist of allowed contract names, professions, and careers. You can add entries for modded villagers as long as they are correctly registered with Minecraft Forge. The format is straightforward, letting you expand the mod’s functionality to match your modpack’s villager roster.
Adding Support for Modded Villagers
One of the most powerful features of Villager Contracts is its compatibility with other mods. Any villager-like entity that uses the standard Forge profession and career registry can be controlled by the contract. To add a new career, you simply need to know the internal name used by the other mod. The dumpVillagerInfo config option is your best friend here — enable it, load your world, and check the log for the exact profession and career strings. Then, add those strings to the validContracts whitelist, and you can change a modded villager’s career just as easily as a vanilla one.
This opens up enormous possibilities for custom trading halls. Imagine a village populated with beekeepers from Forestry, engineers from Immersive Engineering, or mages from Thaumcraft, all instantly reconfigurable with a renamed piece of paper. The mod becomes a universal remote control for any villager-based economy, making it a staple in kitchen-sink modpacks and specialized progression packs alike.
Practical Uses in Survival and Building
Beyond the obvious convenience of resetting trades, Villager Contracts changes how you approach village design. You no longer need to build elaborate villager breeders or transport villagers across biomes to get the right professions. A single villager can become a farmer one moment and a librarian the next, provided you have enough contracts and an anvil. This flexibility encourages compact, aesthetic trading halls where every villager is exactly the career you need at any given time.
It also removes the frustration of accidental profession locking. In vanilla 1.12.2, if a villager claims a workstation you didn’t intend, you have to break the block and hope they pick the right one next time. With the contract, you simply overwrite their career, and the old workstation becomes irrelevant. The mod respects the villager’s original mechanics — they will still need a valid job site block to restock trades, but the initial assignment is entirely in your hands.
Conclusion
Villager Contracts is a small but transformative mod for Minecraft 1.12.2. It gives you precise, immediate control over villager professions through a simple anvil-and-interact system, while its configuration options let you extend that control to modded villagers. The shift-hover tooltip keeps everything user-friendly, and the blacklist and whitelist features make it server-safe. Whether you are building a massive trading empire or just want to skip the grind of rerolling librarians, this mod delivers a clean, vanilla-feeling solution that fits perfectly into any modpack. Once you try it, you will wonder how you ever managed villagers without a stack of renamed contracts in your hotbar.