diff --git a/README.md b/README.md
index fd96346..d40796e 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,46 @@
-# Fabric Example Mod
+# Passive Piglins
 
-## Setup
+### Pacify Piglins while holding a specific item!
 
-For setup instructions please see the [fabric wiki page](https://fabricmc.net/wiki/tutorial:setup) that relates to the IDE that you are using.
+Gold armour be gone! You can wear whatever you like while conversing with Piglins.
 
-## License
+Just make sure to be holding a Piglin totem! (configurable in JSON).
 
-This template is available under the CC0 license. Feel free to learn from it and incorporate it in your own projects.
+### Trade in style!
+Piglins are no longer satisfied with gold alone.
+
+Craft one gold ingot into a Piglin coin.
+
+### A new tier of trades for our piggy friends!
+There's a new tier of trade!
+
+Give a Piglin the gift of a lifetime and they'll give you some powerful items in return.
+
+## configuration
+### Trade item
+In a datapack, create ``piglin_barter_item.json'`` at ``data/minecraft/tags/items/``.
+
+Edit this file and enter a tag full of any items you want! This will overwrite the default alternate trade item.
+
+PLEASE NOTE that Piglins will only pick up items that are in the vanilla Minecraft 'piglin_loved.json' tag.
+
+Any custom trade item must be in this tag for Piglins to accept it.
+
+### Alternate trade item
+In a datapack, create ``piglin_optrade.json`` at ``data/minecraft/tags/items/``.
+
+Edit this file and enter a tag full of any items you want! This will overwrite the default alternate trade item.
+
+PLEASE NOTE that Piglins will only pick up items that are in the vanilla Minecraft 'piglin_loved.json' tag.
+
+Any custom trade item must be in this tag for Piglins to accept it.
+
+### Alternate trade result
+In a datapack, create ``piglin_optrades.json`` at ``data/minecraft/loot_tables/gameplay/``.
+
+Edit this file and enter the loot table of your dreams! This will overwrite the default alternate trades.
+
+### Pacifier item
+In a datapack, create ``piglin_respected.json`` at ``data/minecraft/tags/items/``.
+
+Edit this file and enter a tag full of any items you want! This will overwrite the default respected item.