[ISSUES]: https:\/\/github.com\/PssbleTrngle\/DataTrades\/issues<\/p>\n
[DOWNLOAD]: https:\/\/www.curseforge.com\/minecraft\/mc-mods\/data-trades\/files<\/p>\n
[CURSEFORGE]: https:\/\/www.curseforge.com\/minecraft\/mc-mods\/data-trades<\/p>\n
[MODRINTH]: https:\/\/modrinth.com\/mod\/data-trades<\/p>\n
# Data Trades <\/p>\n
This mod adds the ability for players, serverowners or modpack creators to overwrite villager trades using datapacks.
\nThe amount of trades per level and the actual items traded can be customized using json files.
\nA command for development purposes called `\/villagers refresh` will manually trigger a re-asign of trades to all loaded villagers.<\/p>\n
## Folder Structure<\/p>\n
Using a datapack, the trades of a specific villager profession can be overwritten by creating a JSON file following this
\npattern:<\/p>\n
“`
\ndata\/[namespace]\/villager\/professions\/[path].json
\n“`<\/p>\n
`[namespace]` and `[path]` should be overwritten by the specific villager professions ID.
\nFor example, to create trades for the `minecraft:fletcher` profession,
\na file under `data\/minecraft\/villager\/professions\/fletcher.json` should be created.
\nIt’s content should follow the [*Profession*](#profession) Schema<\/p>\n
Similar, the wandering trader can be overwritten by adding a file at
\n“`
\ndata\/minecraft\/villager\/traders\/wandering.json
\n“`
\nfollowing the [*Trader*](#trader) Schema<\/p>\n
## Examples<\/p>\n
Datapacks with examples can be found here.<\/p>\n
## JSON Schema<\/p>\n
The JSON file should contain an object with these properties:<\/p>\n
### *Profession*<\/p>\n
| Property | Type | Default | Description | The `levels` object takes the form of a map with numeric keys and object values. ### *Trader*<\/p>\n | Property | Type | Default | Description | In vanilla minecraft, each wandering trader chooses 5 generic and 1 rare trades once it spawns. ### *TradeLevel*<\/p>\n | Property | Type | Default | Description | ### *Trade*<\/p>\n | Property | Type | Default | Description | ### *TradeIngredient*<\/p>\n Extension of the vanilla `Ingredient` with a few extra properties. | Property | Type | Default | The `levels` object takes the form of a map with numeric keys and object values. ## Advanced Usage<\/p>\n Instead of a `Trade` object, the TradeLevel `trades` property can also contain *string* IDs referencing an external “` Allows easy customization of villager trades using datapacks<\/p>\n","protected":false},"featured_media":54452,"template":"","meta":{"_minecraft_slug":"data-trades","_minecraft_project_id":"nm1MuVrD","_minecraft_author":"possible_triangle","_minecraft_license":"CC0-1.0","_minecraft_downloads":10070,"_minecraft_follows":40,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"data-trades.zip","_minecraft_size_bytes":1674633,"_minecraft_version_count":28,"_minecraft_updated_at":"2026-05-16T06:01:11.344774Z","_minecraft_date_created":"2023-08-04T10:10:10.351386Z","_minecraft_date_modified":"2024-08-20T13:30:19.773677Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/data-trades","_minecraft_icon_attachment_id":54452,"_minecraft_imported_at":"2026-06-03T00:52:08+00:00","_minecraft_import_hash":"0e5f54bb2faa2efe583544d6f5d844e6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,97,104,126,158,92],"mod_loader":[99],"minecraft_version":[56,36,37],"class_list":["post-54451","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-fabric","mod_category-forge","mod_category-management","mod_category-neoforge","mod_category-utility","mod_loader-fabric","minecraft_version-1-19-2","minecraft_version-1-20-1","minecraft_version-1-21-1"],"yoast_head":"\n
\n|———-|———————–|———|—————————-|
\n| levels | *map
\nThe keys represent the actual villagers level with *1* being *Novice* until *5* being *Master*.<\/p>\n
\n|———-|————–|———|—————-|
\n| generic | *TradeLevel* | `null` | generic trades |
\n| rare | *TradeLevel* | `null` | rare trades |<\/p>\n
\nBoth the trades themselves and their count can be overwritten using the same format as the one used for a villager’s level.<\/p>\n
\n|———-|—————————————————————————————|———|—————————————————————|
\n| take | *NumberProvider* | `null` | amount of trades added by this level |
\n| trades | (*Trade* | *string*)[] | `[]` | list of trades from which the taken ones are randomly choosen |<\/p>\n
\n|—————–|———————|———|——————————————–|
\n| disabled | *boolean* | `false` | disabled trades will be ignored |
\n| sells | *TradeIngredient* | `[]` | item sold to the player |
\n| wants | *TradeIngredient*[] | `[]` | maximum of two items the player has to pay |
\n| uses | *int* | `0` | |
\n| maxUses | *int* | `10` | |
\n| xp | *int* | `1` | |
\n| priceMultiplier | *float* | `2.0` | |
\n| demand | *int* | `0` | |<\/p>\n
\nThey can take the form of an item or tag and specify all properties of the vanilla Ingredient JSON.
\nSince Villager trades are `ItemStack` based that does not mean that a player can pay a `#minecraft:stone_tool_materials`
\nwith any stone type, but only the one that is randomly selected from the tag each time the trade is used.<\/p>\n
\n|———–|———————————————————————|———|
\n| functions | *LootFunction*[] | `[]` |
\n| count | *int* | `null` |<\/p>\n
\nThe keys represent the actual villagers level with *1* being *Novice* until *5* being *Master*.<\/p>\n
\ntrade.
\nThese trades can be saved under the path below to organize & reuse them.<\/p>\n
\ndata\/[namespace]\/villager\/trades\/[path].json
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"