Wiki 9Minecraft Wiki 9Minecraft

Custom Villager Trades Wiki & Guide

Guides 5FAQ 6Related mods 60

Allows players to create and customize their own villager trades.

DownloadCustom Villager Trades

Get the files on 9Minecraft

Contents (6)
  1. Overview
  2. Guides
  3. Frequently asked questions
  4. Dependencies
  5. Gallery
  6. You May Also Like

Overview

Custom Villager Trades lets you rewrite what villagers and wandering traders sell, using plain configuration files instead of code or datapacks. Every profession can be given its own set of trades, and every trade is described in a small, readable file that you can edit by hand.

A trade can be as simple as "one emerald for one diamond" or as elaborate as an enchanted, renamed weapon that costs a specific combination of items. You decide the price, the reward, how many times the trade can be used before it locks, how much experience the villager earns from it, and which of the villager's five career levels it appears at. You can add trades alongside the villager's normal ones, or clear the defaults and replace them entirely.

Because everything is defined in files, the same configuration can be dropped into any world or shared with anyone. Nothing needs to be crafted, and no new items are added to the game — the mod only changes what the traders you already have will offer.

Custom Villager Trades lets you rewrite what villagers and wandering traders sell, using plain configuration files instead of code or datapacks. Every profession can be given its own set of trades, and every trade is described in a small, readable file that you can edit by hand.

A trade can be as simple as "one emerald for one diamond" or as elaborate as an enchanted, renamed weapon that costs a specific combination of items. You decide the price, the reward, how many times the trade can be used before it locks, how much experience the villager earns from it, and which of the villager's five career levels it appears at. You can add trades alongside the villager's normal ones, or clear the defaults and replace them entirely.

Because everything is defined in files, the same configuration can be dropped into any world or shared with anyone. Nothing needs to be crafted, and no new items are added to the game — the mod only changes what the traders you already have will offer.

Guides

Step-by-step, in-game.

Adding To or Replacing Default TradesEach profession file chooses whether your trades sit beside the villager's normal offers or replace them. Leave…Building a Trade in Custom Villager TradesA single trade is made of two halves: what the player pays and what the villager gives back. Offer — the item the…Configuring Custom Villager TradesEditing Trades with Text Files Custom Villager Trades stores its configuration in simple text files, so you can…How Custom Trades Are OrganisedWhen the mod first runs it creates a folder for its configuration and writes a fully working example inside it. Each…Wandering Trader TradesThe wandering trader is handled separately from the professions , because it does not belong to a village and does…

Frequently asked questions

What does the Custom Villager Trades Mod let me change?
It lets you change what villagers and wandering traders sell using simple text files. You can set any cost and reward for every job without writing code or datapacks.
Do I need to write code or datapacks to use this mod?
No, all trades are configured through simple text files. You can set costs and rewards for every profession without any coding.
Can I use any item as a trade payment or reward?
Yes, the mod accepts any item in the game for both trade payments and trade rewards. This makes it possible to build fully custom shops.
Can I keep the default villager trades and just add my own?
Yes, you can add new trades alongside the default offers. Alternatively, you can wipe the default trades completely and replace them.

See all 6 Custom Villager Trades questions ›

Dependencies

Other mods required (or optional) to run this mod.

Architectury API (required)