Custom Villager Trades (Fabric)
Vanilla villagers are predictable. Once you have seen one librarian, you have seen them all. Custom Villager Trades (Fabric) changes that completely by handing modpack authors and datapack tinkerers a JSON-driven system for rewriting what every villager offers. Whether you want a farmer who sells enchanted golden carrots or a cleric who trades randomized potions, this mod gives you the tools to build it.
What Custom Villager Trades (Fabric) Actually Does
At its core, the mod reads JSON configuration files from the config/custom villager trades directory. The first time you launch the game, that folder is generated automatically with an example file inside, giving you a working template to copy and adapt. From there, you create one file per profession, and the mod intercepts the vanilla trade loading event to inject your custom entries. If you enable the option, it can also strip out the original trades entirely.
The result is total control. You are no longer limited to what Mojang shipped in the base game.
Key Features for Modpack Authors
Profession and Global Trade Files
Each config file is named after a profession, so farmer.json only affects farmers and librarian.json only affects librarians. The nitwit is excluded, as expected. If you want a trade to appear on every villager that can trade, name the file all.json and it becomes a global entry. Trades can also be gated by villager level, so you can reserve your best offers for master-level traders.
Randomization and Blacklists
Enchantments can be applied to any trade item, which opens the door to strange, powerful gear that never appears through normal gameplay. You can randomize enchantments in three different ways, and you can blacklist specific enchantments so they never roll. The same random-and-blacklist system applies to potions, tipped arrows, and suspicious stew, and custom potions and arrows can even be given custom colors.
Beyond Standard Trades
- Custom treasure map trades with support for modded structures
- Custom NBT data, both basic and advanced
- Modded items, blocks, and even modded professions from other mods
- Vanilla wandering trader trades can be modified or replaced
- Adjustable trade experience, discounts, and trade counts per level
In-Game Commands
Several experimental commands speed up testing: /reloadCVT reloads your configs without restarting, /exportCVT dumps available trades, /addCVT adds new trades live, and /removeCVT removes only CVT-generated trades. These are marked experimental, so back up your world before leaning on them heavily.
Supported Versions and Loader
Custom Villager Trades (Fabric) is built for the Fabric loader, as the name suggests. It targets modern Minecraft releases, and the exact supported versions are listed on the mod's download page, since they shift as Minecraft updates roll out. If you are running an older build, some features described here may not exist yet, so always check the wiki for the JSON specification that matches your version.
If you would rather skip manual file juggling, the foxygame.net launcher bundles Custom Villager Trades (Fabric) into a searchable add-on catalog, so you can install it alongside matching Fabric versions in a single click without hunting for the right build.
How to Install Custom Villager Trades (Fabric)
Installation is straightforward for anyone comfortable with Fabric modding:
- Install the Fabric loader for your Minecraft version.
- Place the Fabric API jar in your
modsfolder, since the mod depends on it. - Drop the Custom Villager Trades (Fabric) jar into the same folder.
- Launch the game once to generate the config directory and example file.
- Edit or create your profession JSON files, then reload with
/reloadCVTor restart.
When you download Custom Villager Trades (Fabric), confirm that the mod version matches your Minecraft version and that Fabric API is present. Mismatches are the most common cause of a silent failure where no custom trades appear at all.
Final Thoughts
Custom Villager Trades (Fabric) for Minecraft is one of those quiet utility mods that reshapes an entire system once you understand it. The learning curve is real, mostly because JSON syntax punishes typos, but the payoff is a villager economy built exactly to your modpack's design. Read the wiki, start with a single profession, and expand from there.
===ARTICLE===