diff --git a/README.md b/README.md
new file mode 100644
index 0000000..06dfd20
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# mc-beta-server
+me trying to understand minecraft beta's protocol
+
+Implemented:
+ - Basic flat terrain generation
+ - Terrain sending
+ - Block placement
+ - Block breaking
+ 
+To Implement:
+ - Entities
+ - Inventories
+ - Terrain saving to disk
+ 
+Long Term:
+ - Optimise the shit out of this