
Custom Villager Trades
Create your own villager trades
About this Mod

About
Custom Villager Trades is designed to give modpack authors the ability to expand upon the vanilla villager trades. It is packed with fresh features that allow you to have specific control over what is available, as well as the ability to randomize items, amounts, enchantment and more!
This mod works by reading JSON config files from the config/custom villager trades directory. When you first launch the mod, the directory will be created with an example file inside. It is up to you to create the rest! There should be 1 file per-profession.
After loading the trades and checking their validity, the mod will intercept the trade loading event and inject the custom trades in (and if you have enabled the option, it can also remove other trades).
Features
- A fully customizable trade creation system where you can define basic or advanced trades using JSON.
- Modify trades for any profession using a simple named config file (excluding the nitwit).
- You can set "global" trades, these will be applied to any villager that can trade (call the config file "all.json").
- Trades can be applied based on level.
- All aspects of the trade can be modified (trade experience, discounts, etc.)
- Enchantments can be applied to any trade item. This allows for whacky unique items that can't be acquired via normal (vanilla) means.
- Enchantments can now be randomized in 3 ways, read below.
- Enchantments can be blacklisted, usable with random enchantment feature.
- Modded item and block support.
- Modded profession support - you can add trades to other people's villagers.
- Remove all vanilla trades - you can do this per-profession.
- Vanilla wanderer trades can be modified/replaced.
- Custom potion trades, including random and blacklisted.
- Custom suspicious stew trades.
- Custom treasure map trades (with modded structure support).
- Custom tipped arrow trades (with modded potion effect support). Includes random and blacklisted.
- Custom potions and tipped arrows can be coloured.
- Custom NBTs (basic and advanced).
- Mod support.
- /reloadCVT command to use ingame - EXPERIMENTAL FEATURE
- /exportCVT command to export available trades - EXPERIMENTAL FEATURE
- /addCVT command to add new trades ingame - EXPERIMENTAL FEATURE
- /removeCVT command to remove CVT ONLY trades ingame - EXPERIMENTAL FEATURE
Wiki
You can access the wiki here. It contains a full JSON specification for the latest version of Custom Villager Trades.
Warning: If you are not using the latest version of this mod, some features may not be available to you.
Help!
Before asking for help, please consult the wiki.
If you still need further help, you can open an issue here or ask on the discord.
Modpacks
You can use this mod in your modpack.
My Mods
If you like this mod, check out my other mods!

Available Versions
How to Install Custom Villager Trades on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.4).
Install Mod
Open the mod browser in the dashboard and search for "Custom Villager Trades". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.4, 1.20.3, 1.20.2 (+4 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Custom Villager Trades server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.4). You can switch loaders with one click in the panel.
Is Custom Villager Trades compatible with fabric and forge?
Custom Villager Trades officially supports fabric, forge for Minecraft 1.20.4, 1.20.3, 1.20.2. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Custom Villager Trades – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Custom Villager Trades consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Custom Villager Trades with just one click on your server.





