Custom Villager Trades
by SpaceCat97
With Custom Villager Trades installed on a server, modpack authors can define new trades for any villager profession through JSON files.
What it does
The mod lets a modpack author change the trades offered by villagers. Basic and advanced trades are written in JSON, and each profession has its own named config file, except the nitwit. A file called all.json holds global trades that apply to every villager able to trade. Trades can be tied to a villager level, and each part of a trade, including its experience reward and discounts, can be adjusted. The mod checks the trade definitions when they load and then injects them into the vanilla trade loading event. An optional setting also lets it remove existing trades.
Enchantments can be attached to any trade item, which makes it possible to offer enchanted items that cannot be obtained through normal vanilla means. Enchantments can be randomized in three ways, and a blacklist keeps chosen enchantments out of the random selection. Custom Villager Trades requires Architectury API. The mod is published for Fabric and Forge across seven game versions, and it is server-side only, so players join without installing it. The code is not open source; it is licensed as All rights reserved.
Key features
JSON trade definitions
Basic or advanced trades are described in JSON, with control over which items and amounts are offered.
Per-profession config files
Each profession has a named config file, so trades for one profession can be changed without touching the others.
Global trades
Trades placed in all.json apply to any villager that can trade, regardless of profession.
Level-based trades
Trades can be assigned to a specific villager level, so offers change as villagers advance.
Enchanted trade items
Enchantments can be set on any trade item, including enchantments unavailable through vanilla means.
Randomized enchantments
Enchantments can be randomized in three ways, and a blacklist excludes chosen enchantments from the random pool.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Modpack trade tuning
Authors of modpacks can change what villagers sell so trades match the progression and item balance of their pack.
Unique rewards
Villagers can offer enchanted items that the vanilla game does not provide, giving a pack its own reward structure.
Who it’s for: Modpack authors and server owners who want to control villager trades in detail. Players only need it on the server.
How it compares
Trade Uses is client-side only and is released under the MIT License, with files for 1.18 – 26.1 on Fabric, Forge, NeoForge and Quilt. Data Trades is server-side only, released under CC0 1.0 Universal, and runs on Fabric, Forge and NeoForge for 1.19.2 – 1.21.1. Custom Villager Trades is server-side only, all rights reserved and not open source, with files on Fabric and Forge.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Custom Villager Trades | Fabric and Forge | 1.16.5 – 1.20.4 | Server-side only | 2024-05-30 |
| Trade Uses | Fabric, Forge, NeoForge and Quilt | 1.18 – 26.1 | Client-side only | 2026-04-03 |
| Data Trades | Fabric, Forge and NeoForge | 1.19.2 – 1.21.1 | Server-side only | 2024-08-20 |
Questions
Does Custom Villager Trades need Architectury API?
Do players need to install Custom Villager Trades?
Which loaders and versions are supported?
In the catalog
Custom Villager Trades is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,907 mods support Minecraft 1.20.4.
More from SpaceCat97
Similar mods
What the author says
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…
Official listing
- Modrinth page
- modrinth.com/mod/custom-villager-trades
- Owner
- SpaceCat97
- Published
- 2023-11-02
- Updated on Modrinth
- 2024-05-30
- Facts verified
- 2026-10-15
