About Custom Villager Trades
From ModrinthCreate your own villager trades

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!
Highlights
From source dataGame versions
Supports 7 Minecraft versions, the newest being 1.20.4.
Loaders
Runs on Fabric and Forge.
Footprint
Rated a light load on a server.
Custom Villager Trades on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Fabric, Forge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 20.25.0, released 2024-05-30
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Forge | 1.18.2 to 1.20.4 (6 versions) | 1.20.4 |
| Fabric | 1.19.2 to 1.20.4 (5 versions) | 1.20.4 |
From 5 recorded builds of Custom Villager Trades.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 20.25.0 | 2024-05-30 | 1.20.1 to 1.20.4 (4 versions) | Forge |
| 20.25.0 | 2024-05-30 | 1.20.1 to 1.20.4 (4 versions) | Fabric |
| 19.25.0 | 2024-05-30 | 1.19.2 | Forge |
| 19.25.0 | 2024-05-30 | 1.19.2 | Fabric |
| 18.25.0 | 2024-05-30 | 1.18.2 | Forge |
Run Custom Villager Trades on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogCreatures & NPCs
Adds or changes creatures, NPCs and how they behave.
Runs on your server
From source side supportModrinth lists Custom Villager Trades as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- FabricForge
- Runs on
- Serverrequired on the server
- Game versions
- 1.20.4 and 6 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-01Open ↗
- ✓AuthorSpaceCat97, as published on Modrinth
- ✓LicenseLicenseRef-All-Rights-ReservedFree
Custom Villager Trades, answered
Generated from the mod’s own source data.
Do my players need to install Custom Villager Trades?
Modrinth lists Custom Villager Trades as required on the server. Check its Modrinth page to see whether players need it too.
Which loaders does it support?
Fabric and Forge.
Is it free?
Yes. Custom Villager Trades is free to download from Modrinth. Its license is LicenseRef-All-Rights-Reserved.
How do I add it to my Nxeon server?
Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

Run Custom Villager Trades on a Minecraft server.
Deploy in about a minute from $4.99 a month, then add Custom Villager Trades in one click.
















