Wandering Merchants replaces the vanilla wandering trader with 4 new merchant types: farming, fishing, mining, and treasure. Each merchant has a different set of possible trades and has an equal chance of spawning.<\/p>\n
Compatible with VanillaTweaks Wandering Trades datapack.<\/p>\n This merchant deals with all things farming.<\/p>\n **Trade 1** **Trade 2** **Trade 3** **Trade 4** **Trade 5** **Trade 6** **Trade 1** **Trade 2** **Trade 3** **Trade 4** **Trade 5** **Trade 6** **Trade 1** **Trade 2** **Trade 3** **Trade 4** **Trade 5** **Trade 6** **Trade 7** **Trade 1** **Trade 2** **Trade 3** **Trade 4** **Trade 5** **Trade 6** ## Configs Menu # Planned features<\/p>\n ## Modding<\/p>\n Add your own trader variants<\/p>\n ### This section refers to features that are *coming soon*<\/p>\n The data format for a wandering trader variant is as follows: `{Weight:1,Name:””,TradeTable:[]}` The trade format is as follows:`{Weight:1,TradeData:{}}` The contents of `TradeData` follow that of a typical villager trade, with `buy` and `sell` values, and and optional `buyB` value: The `buy`, `buyB`, and `sell` tags each of 3 subtags: ### This section refers to features that are *coming soon*<\/p>\n Although I tried my best to explain how modding works, it may still be confusing for some of you. This tutorial will take you though the step-by-step process of adding your own custom merchant.<\/p>\n For this tutorial, you must have basic knowledge on how do create a datapack. If you do not know how to create a datapack, you can find plenty online. *TODO: find a good tutorial and link it here*<\/p>\n First you want to create a new datapack with a new function. I’ll call mine `new_merchant.mcfunction` and put it in the namespace `mypack`.<\/p>\n Inside the `new_merchant.mcfunction` we need to initialize the trader and set its trades:<\/p>\n ### Creating the villager function #This adds the first set of trade options to the tradetable #This adds a trade option to the first set of trades #The ‘data modify storage clgd.trader:data NewMerchant.TradeTable[-1]’ means we are modifying the last set of trade options. Since there is only 1 right now, that means we are modifying the first one.<\/p>\n #This adds the second set of trade options to the tradetable #This adds a trade option to the second set of trades #Add a second trade option to the second set of trades #Now that there are 2 trades, the ‘data modify storage clgd.trader:data NewMerchant.TradeTable[-1]’ refers to the second set of trades<\/p>\n “` ### Running the function<\/p>\n Now that we’ve written the function to create the villager, we want to make sure that the function gets run to initialize the trades. This can be done by creating a new namespace called `clgd.trader` then inside that namespace create a new folder called `tags`, another subfolder called `functions` , then a file called `set_default_trades.json`. You’ll also need to create another file called `update_trades.json`<\/p>\n So your folder structure should look like: The `set_default_trades.json` should look something like this A data pack that gives wandering traders professions, many new trades, and much more!<\/p>\n","protected":false},"featured_media":168387,"template":"","meta":{"_minecraft_slug":"wandering-merchants","_minecraft_project_id":"kgPnL2uG","_minecraft_author":"CodingLegend0100","_minecraft_license":"CC-BY-NC-SA-4.0","_minecraft_downloads":4736,"_minecraft_follows":30,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wandering-merchants.zip","_minecraft_size_bytes":55569,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T01:10:20.788576Z","_minecraft_date_created":"2023-07-22T20:02:40.222988Z","_minecraft_date_modified":"2024-01-10T23:01:43.441200Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wandering-merchants","_minecraft_icon_attachment_id":168387,"_minecraft_imported_at":"2026-06-09T19:38:10+00:00","_minecraft_import_hash":"6453cf3f39eaae05725193f2635198bb","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,97,104,89,98],"mod_loader":[86,99,106,100],"minecraft_version":[59,36,60,93,94],"class_list":["post-168386","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-quilt","mod_loader-datapack","mod_loader-fabric","mod_loader-forge","mod_loader-quilt","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4"],"yoast_head":"\nFarming Merchant Trades<\/summary>\n
\n10 Sweet Berries -> 1 Emerald or
\n10 Dried Kelp Blocks -> 1 Emerald<\/p>\n
\n5 Pumpkins -> 1 Emerald or
\n4 Melons -> 1 Emerald<\/p>\n
\n1 Emerald -> 1 Allium
\n1 Emerald -> 1 Azure Bluet
\n1 Emerald -> 1 Blue Orchid
\n1 Emerald -> 1 Cornflower
\n1 Emerald -> 1 Dandelion
\n1 Emerald -> 1 Lily of the Valley
\n1 Emerald -> 1 Orange Tulip
\n1 Emerald -> 1 Oxeye Daisy
\n1 Emerald -> 1 Pink Tulip
\n1 Emerald -> 1 Poppy
\n1 Emerald -> 1 Red Tulip
\n1 Emerald -> 1 White Tulip<\/p>\n
\n1 Emerald -> 3 Black Dye
\n1 Emerald -> 3 Blue Dye
\n1 Emerald -> 3 Brown Dye
\n1 Emerald -> 3 Cyan Dye
\n1 Emerald -> 3 Gray Dye
\n1 Emerald -> 3 Green Dye
\n1 Emerald -> 3 Light Blue Dye
\n1 Emerald -> 3 Light Gray Dye
\n1 Emerald -> 3 Lime Dye
\n1 Emerald -> 3 Magenta Dye
\n1 Emerald -> 3 Orange Dye
\n1 Emerald -> 3 Pink Dye
\n1 Emerald -> 3 Purple Dye
\n1 Emerald -> 3 Red Dye
\n1 Emerald -> 3 White Dye
\n1 Emerald -> 3 Yellow Dye<\/p>\n
\n5 Emeralds -> 1 Acacia Sapling
\n5 Emeralds -> 1 Birch Sapling
\n5 Emeralds -> 1 Cherry Sapling
\n5 Emeralds -> 1 Dark Oak Sapling
\n5 Emeralds -> 1 Jungle Sapling
\n5 Emeralds -> 1 Oak Sapling
\n5 Emeralds -> 1 Spruce Sapling
\n5 Emeralds -> 1 Mangrove Propagule <\/p>\n
\n2 Emerald -> 1 Spore Blossom
\n1 Emerald -> 2 Small Dripleaf
\n1 Emerald -> 1 Big Dripleaf
\n<\/details>\nFishing Merchant Trades<\/summary>\n
\n20 String -> 1 Emerald
\n5 Ink Sac -> 1 Emerald
\n5 Nautilus Shell -> 1 Emerald<\/p>\n
\n15 Cod -> 1 Emerald
\n13 Salmon -> 1 Emerald
\n6 Tropical Fish -> 1 Emerald
\n4 Pufferfish -> 1 Emerald<\/p>\n
\n2 Emerald -> 5 Glow Ink Sac<\/p>\n
\n3 Emerald -> 1 Luck Potion (5:00)<\/p>\n
\n2 Emerald -> 1 Sea Pickle
\n3 Emerald -> 1 Brain Coral Block
\n3 Emerald -> 1 Bubble Coral Block
\n3 Emerald -> 1 Fire Coral Block
\n3 Emerald -> 1 Horn Coral Block
\n3 Emerald -> 1 Tube Coral Block<\/p>\n
\n8 Emerald -> 1 Pufferfish Bucket
\n8 Emerald -> Cod Bucket
\n<\/details>\nMining Merchant Trades<\/summary>\n
\n15 Coal -> 1 Emerald
\n22 Flint -> 1 Emerald
\n12 Quartz -> 1 Emerald<\/p>\n
\n20 Stone -> 1 Emerald
\n16 Granite -> 1 Emerald
\n16 Andesite -> 1 Emerald
\n16 Granite -> 1 Emerald<\/p>\n
\n1 Emerald -> 8 Sand<\/p>\n
\n1 Emerald -> 4 Red Sand<\/p>\n
\n1 Emerald -> 2 Pointed Dripstone<\/p>\n
\n1 Emerald -> 1 Terracotta<\/p>\n
\n1 Emerald -> 1 Calcite<\/p>\n<\/details>\nTreasure Merchant Trades<\/summary>\n
\n4 Scute -> 1 Emerald
\n32 Rotten Flesh -> 1 Emerald
\n24 Feather -> 1 Emerald<\/p>\n
\n5 Nautilus Shell -> 1 Emerald
\n22 Nether Wart -> 1 Emerald
\n24 Paper -> 1 Emerald<\/p>\n
\n3 Emeralds -> 1 Experience Bottle<\/p>\n
\n2 Emeralds -> 5 Glowstone<\/p>\n
\n1 Emerald -> 1 Gunpowder<\/p>\n
\n2 Emerald + 5 Arrow -> 5 Tipped Arrow<\/p>\n<\/details>\n
\nAccessible with `\/function clgd.trader:config\/menu`
\nUsed to configure values related to wandering trader spawn rates.<\/p>\nModding<\/summary>\n
\n– `Weight` (optional) works as weight in a LootTable does, the higher the weight, the more likely that trader will be selected. If missing, the weight defaults to 1
\n– `Name` will be used when announcing that the trader has spawned (“A {name} Has Spawned!”).
\n– `TradeTable` is a list of lists referring to each trade the merchant has. Each sub list is a list of possible trades for the wandering trader to have. The first sublist is a list of possible trades for the first trade slot, the second sublist for the second trade, and so on.<\/p>\n
\n– `Weight` (optional) works the same as mentioned earlier
\n– `TradeData` (optional) contains the information for the trade to be added. This may be left blank if you want a chance of a trade not appearing.<\/p>\n
\n`buy:{id:”minecraft:emerald”,Count:32},buyB:{id:”minecraft:book”,Count:1},sell:{id:”minecraft:enchanted_book”,Count:1,tag:{StoredEnchantments:{id:mending,lvl:1}}}}}`
\n– `buy` stores the item being given in exchange for the item in `sell`
\n– `buyB` (optional) is a second item to exchange. (This is used in librarian trades, Emeralds + Book = Enchanted Book).<\/p>\n
\n– `id` – The string id of the item
\n– `Count` – (optional) the amount of the item. Probably defaults to 1
\n– `tag` – (optional) NBT data on the item.<\/p>\n<\/details>\nTutorial: Adding your own merchant<\/summary>\n
\n“`
\n#This command does the initial setup for the merchant, assigning a name, weight, and setting up the tradetable
\ndata modify storage clgd.trader:data NewMerchant append value {Weight:1,Name:”Special Merchant”,TradeTable:[]}
\n# I recommend changing this value ^^^ to be something unique. If multiple packs use the same value, then there will be issues with one pack overwriting the other. <\/p>\n
\ndata modify storage clgd.trader:data NewMerchant.TradeTable append value []<\/p>\n
\ndata modify storage clgd.trader:data NewMerchant.TradeTable[-1] append value {TradeData:{buy:{id:”minecraft:coal”,Count:48},sell:{id:”minecraft:diamond”,Count:1}}}<\/p>\n
\ndata modify storage clgd.trader:data NewMerchant.TradeTable append value []<\/p>\n
\ndata modify storage clgd.trader:data NewMerchant.TradeTable[-1] append value {TradeData:{buy:{id:”minecraft:diamond”,Count:1},sell:{id:”minecraft:emerald”,Count:2}}}<\/p>\n
\ndata modify storage clgd.trader:data NewMerchant.TradeTable[-1] append value {TradeData:{buy:{id:”minecraft:coal_block”,Count:5},sell:{id:”minecraft:emerald”,Count:2}}}<\/p>\n
\nThis function will create the data for a new merchant with 2 trades. The first trade will always be 48 Coal -> 1 Diamond and the second trade will either be 1 Diamond -> 2 Emeralds or 5 Coal Blocks -> 1 Emerald<\/p>\n
\n`clgd.trader` -> `tags` -> `functions` -> `set_default_trades.json`<\/p>\n
\n“`JSON
\n{
\n “values”: [
\n “mypack:new_merchant”
\n ]
\n}
\n“`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":"