Wandering Merchants

This merchant deals with all things farming.

Trade 1
10 Sweet Berries -> 1 Emerald or
10 Dried Kelp Blocks -> 1 Emerald

Trade 2
5 Pumpkins -> 1 Emerald or
4 Melons -> 1 Emerald

Trade 3
1 Emerald -> 1 Allium
1 Emerald -> 1 Azure Bluet
1 Emerald -> 1 Blue Orchid
1 Emerald -> 1 Cornflower
1 Emerald -> 1 Dandelion
1 Emerald -> 1 Lily of the Valley
1 Emerald -> 1 Orange Tulip
1 Emerald -> 1 Oxeye Daisy
1 Emerald -> 1 Pink Tulip
1 Emerald -> 1 Poppy
1 Emerald -> 1 Red Tulip
1 Emerald -> 1 White Tulip

Trade 4
1 Emerald -> 3 Black Dye
1 Emerald -> 3 Blue Dye
1 Emerald -> 3 Brown Dye
1 Emerald -> 3 Cyan Dye
1 Emerald -> 3 Gray Dye
1 Emerald -> 3 Green Dye
1 Emerald -> 3 Light Blue Dye
1 Emerald -> 3 Light Gray Dye
1 Emerald -> 3 Lime Dye
1 Emerald -> 3 Magenta Dye
1 Emerald -> 3 Orange Dye
1 Emerald -> 3 Pink Dye
1 Emerald -> 3 Purple Dye
1 Emerald -> 3 Red Dye
1 Emerald -> 3 White Dye
1 Emerald -> 3 Yellow Dye

Trade 5
5 Emeralds -> 1 Acacia Sapling
5 Emeralds -> 1 Birch Sapling
5 Emeralds -> 1 Cherry Sapling
5 Emeralds -> 1 Dark Oak Sapling
5 Emeralds -> 1 Jungle Sapling
5 Emeralds -> 1 Oak Sapling
5 Emeralds -> 1 Spruce Sapling
5 Emeralds -> 1 Mangrove Propagule

Trade 6
2 Emerald -> 1 Spore Blossom
1 Emerald -> 2 Small Dripleaf
1 Emerald -> 1 Big Dripleaf

Trade 1
20 String -> 1 Emerald
5 Ink Sac -> 1 Emerald
5 Nautilus Shell -> 1 Emerald

Trade 2
15 Cod -> 1 Emerald
13 Salmon -> 1 Emerald
6 Tropical Fish -> 1 Emerald
4 Pufferfish -> 1 Emerald

Trade 3
2 Emerald -> 5 Glow Ink Sac

Trade 4
3 Emerald -> 1 Luck Potion (5:00)

Trade 5
2 Emerald -> 1 Sea Pickle
3 Emerald -> 1 Brain Coral Block
3 Emerald -> 1 Bubble Coral Block
3 Emerald -> 1 Fire Coral Block
3 Emerald -> 1 Horn Coral Block
3 Emerald -> 1 Tube Coral Block

Trade 6
8 Emerald -> 1 Pufferfish Bucket
8 Emerald -> Cod Bucket

Trade 1
15 Coal -> 1 Emerald
22 Flint -> 1 Emerald
12 Quartz -> 1 Emerald

Trade 2
20 Stone -> 1 Emerald
16 Granite -> 1 Emerald
16 Andesite -> 1 Emerald
16 Granite -> 1 Emerald

Trade 3
1 Emerald -> 8 Sand

Trade 4
1 Emerald -> 4 Red Sand

Trade 5
1 Emerald -> 2 Pointed Dripstone

Trade 6
1 Emerald -> 1 Terracotta

Trade 7
1 Emerald -> 1 Calcite

Trade 1
4 Scute -> 1 Emerald
32 Rotten Flesh -> 1 Emerald
24 Feather -> 1 Emerald

Trade 2
5 Nautilus Shell -> 1 Emerald
22 Nether Wart -> 1 Emerald
24 Paper -> 1 Emerald

Trade 3
3 Emeralds -> 1 Experience Bottle

Trade 4
2 Emeralds -> 5 Glowstone

Trade 5
1 Emerald -> 1 Gunpowder

Trade 6
2 Emerald + 5 Arrow -> 5 Tipped Arrow

This section refers to features that are *coming soon*

The data format for a wandering trader variant is as follows: `{Weight:1,Name:"",TradeTable:[]}`
- `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 - `Name` will be used when announcing that the trader has spawned ("A {name} Has Spawned!").
- `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.

The trade format is as follows:`{Weight:1,TradeData:{}}` - `Weight` (optional) works the same as mentioned earlier - `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.

The contents of `TradeData` follow that of a typical villager trade, with `buy` and `sell` values, and and optional `buyB` value:
`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}}}}}`
- `buy` stores the item being given in exchange for the item in `sell` - `buyB` (optional) is a second item to exchange. (This is used in librarian trades, Emeralds + Book = Enchanted Book).

The `buy`, `buyB`, and `sell` tags each of 3 subtags: - `id` - The string id of the item - `Count` - (optional) the amount of the item. Probably defaults to 1 - `tag` - (optional) NBT data on the item.

This section refers to features that are *coming soon*

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.

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*

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`.

Inside the `new_merchant.mcfunction` we need to initialize the trader and set its trades:

Creating the villager function

``` #This command does the initial setup for the merchant, assigning a name, weight, and setting up the tradetable data modify storage clgd.trader:data NewMerchant append value {Weight:1,Name:"Special Merchant",TradeTable:[]}

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.

#This adds the first set of trade options to the tradetable data modify storage clgd.trader:data NewMerchant.TradeTable append value []

#This adds a trade option to the first set of trades data modify storage clgd.trader:data NewMerchant.TradeTable[-1] append value {TradeData:{buy:{id:"minecraft:coal",Count:48},sell:{id:"minecraft:diamond",Count:1}}}

#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.

#This adds the second set of trade options to the tradetable data modify storage clgd.trader:data NewMerchant.TradeTable append value []

#This adds a trade option to the second set of trades data modify storage clgd.trader:data NewMerchant.TradeTable[-1] append value {TradeData:{buy:{id:"minecraft:diamond",Count:1},sell:{id:"minecraft:emerald",Count:2}}}

#Add a second trade option to the second set of trades data modify storage clgd.trader:data NewMerchant.TradeTable[-1] append value {TradeData:{buy:{id:"minecraft:coal_block",Count:5},sell:{id:"minecraft:emerald",Count:2}}}

#Now that there are 2 trades, the 'data modify storage clgd.trader:data NewMerchant.TradeTable[-1]' refers to the second set of trades

``` This 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

Running the function

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`

So your folder structure should look like: `clgd.trader` -> `tags` -> `functions` -> `set_default_trades.json`

The `set_default_trades.json` should look something like this ```JSON { "values": [ "mypack:new_merchant" ] } ```