diff --git a/README.md b/README.md
new file mode 100644
index 0000000..84487ed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# Mesecons Windows [`mesecons_window`]
+
+This mod adds 3 glass blocks for the Mesecons modpack.
+They change their transparency when powered with Mesecon energy.
+
+They conduct energy to their 6 direct neighbors.
+
+## Block transparency
+
+    Block                   On       Off
+    Mesecon Window          Full     None
+    Mesecon Filter Glass    Full     Partial
+    Mesecon Filter Window   Partial  None
+
+
+## License of everything
+WTFPL