diff --git a/README.md b/README.md
index 0f76f40..54ac79f 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,26 @@
 # adventureland
-CODE Documentation for Adventure Land MMORPG
+CODE Documentation for Adventure Land MMORPG https://adventure.land
 
-The game is not launched yet: https://adventure.land
+### Usage / Notes
+* You have to keep the browser focused
+* Otherwise browsers slow down the game
+* Opening the game in a new window might be a good idea
+* Keep in mind that CODE is currently an early prototype
+* CODE runs in an IFrame, feel free to interact with **parent**
+* You are free to inspect the game code in the browser
+* You can freely emulate a regular player
+* It's prohibited to do things normal players can't
 
-This will be the main documentation/reference for character coding
+### Character / Players / Monsters
+
+* Properties
+ * real_x
+ * real_y
+ * hp / max_hp
+ * mp / max_mp
+ * xp / max_xp
+* Inspect the entity for further properties
+
+### Provided Functions
+
+#to be continued ...