Compatibility
Minecraft: Java Edition
Platforms
Supported environments
90% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Data Trades
This mod adds the ability for players, serverowners or modpack creators to overwrite villager trades using datapacks.
The amount of trades per level and the actual items traded can be customized using json files.
A command for development purposes called /villagers refresh
will manually trigger a re-asign of trades to all loaded villagers.
Folder Structure
Using a datapack, the trades of a specific villager profession can be overwritten by creating a JSON file following this pattern:
data/[namespace]/villager/professions/[path].json
[namespace]
and [path]
should be overwritten by the specific villager professions ID.
For example, to create trades for the minecraft:fletcher
profession,
a file under data/minecraft/villager/professions/fletcher.json
should be created.
It's content should follow the Profession Schema
Similar, the wandering trader can be overwritten by adding a file at
data/minecraft/villager/traders/wandering.json
following the Trader Schema
Examples
Datapacks with examples can be found here.
JSON Schema
The JSON file should contain an object with these properties:
Profession
Property | Type | Default | Description |
---|---|---|---|
levels | map<int,TradeLevel> | {} |
see below |
The levels
object takes the form of a map with numeric keys and object values.
The keys represent the actual villagers level with 1 being Novice until 5 being Master.
Trader
Property | Type | Default | Description |
---|---|---|---|
generic | TradeLevel | null |
generic trades |
rare | TradeLevel | null |
rare trades |
In vanilla minecraft, each wandering trader chooses 5 generic and 1 rare trades once it spawns. Both the trades themselves and their count can be overwritten using the same format as the one used for a villager's level.
TradeLevel
Property | Type | Default | Description |
---|---|---|---|
take | NumberProvider | null |
amount of trades added by this level |
trades | (Trade | string)[] | [] |
list of trades from which the taken ones are randomly choosen |
Trade
Property | Type | Default | Description |
---|---|---|---|
disabled | boolean | false |
disabled trades will be ignored |
sells | TradeIngredient | [] |
item sold to the player |
wants | TradeIngredient[] | [] |
maximum of two items the player has to pay |
uses | int | 0 |
|
maxUses | int | 10 |
|
xp | int | 1 |
|
priceMultiplier | float | 2.0 |
|
demand | int | 0 |
TradeIngredient
Extension of the vanilla Ingredient
with a few extra properties.
They can take the form of an item or tag and specify all properties of the vanilla Ingredient JSON.
Since Villager trades are ItemStack
based that does not mean that a player can pay a #minecraft:stone_tool_materials
with any stone type, but only the one that is randomly selected from the tag each time the trade is used.
Property | Type | Default |
---|---|---|
functions | LootFunction[] | [] |
count | int | null |
The levels
object takes the form of a map with numeric keys and object values.
The keys represent the actual villagers level with 1 being Novice until 5 being Master.
Advanced Usage
Instead of a Trade
object, the TradeLevel trades
property can also contain string IDs referencing an external
trade.
These trades can be saved under the path below to organize & reuse them.
data/[namespace]/villager/trades/[path].json