diff --git a/README.md b/README.md
index 7e9de0b..bf0f2a8 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,37 @@
 # adventure_core
 A Minetest Core Adventure Modpack
+
+
+### Quick description:
+
+4 Elements, each are a floating entity in game world, physicaly interact
+These spawn as player walks thourghout world. More spawn on newly generated chunks, especially farther from spawn. 
+They spawn by biome in default. Otherwise, they spawn anywhere. They are right-clicked to capture. 
+They also make sound, this is how you normally find them. They produce a small amount of light. 
+
+Used in a crafting shop kind of block. It lets a player search by mod-pack the node (mesh) came from, by name, or all packages.
+The player then is able to "buy" that node using the stacked elements (which are tracked by player).
+
+All players start with the adventure_guidebook, and adventure_purse. One explains the system, the other displays the current total number of elements you have.
+
+------Default
+
+In default, the player crafts the adventure_shop via normal crafting. This can also be disabled via setting, and a server owner can decide where to place the shop(s) via creative mode. 
+In default, the player can also craft the adventure_guidebook, and adventure_purse. 
+
+--------
+
+Without default, the player can do a command to bring up the formspec for both purse and guidebook:
+/adventure_guidebook
+/adventure_purse
+
+Without default, the shop can be crafted with the /make_shop command, which requires 10 of each element to create. 
+
+--------
+
+For both, when a player captures one element, the player gets a small text dialog showing them how much of element they have captured. Without default, they are told to type /adv_guide to learn more. 
+
+
+
+
+