diff --git a/readme.txt b/readme.txt
new file mode 100644
index 0000000..aa54043
--- /dev/null
+++ b/readme.txt
@@ -0,0 +1,7 @@
+A simple mod for extending one's underwater excursion time.
+
+Air tanks are crafted from copper, steel, or bronze ingots and are wielded like tools. A compressor is crafted from steel, mese shard, and wood.
+
+Place a compressor in world and click on it with an empty air tank to fill it. Compressors can also recharge partly-used tanks.
+
+When running low on breath use a filled air tank to recharge your breath bar. One use will replenish 5 steps of breath (out of 10). By default a steel air tank will hold 30 uses, a bronze one holds 20, and a copper one holds 10 - these settings can be changed in the mod's section under Advanced Settings. Once a tank runs out of uses it turns into an empty tank, which can be recharged again with a compressor.
\ No newline at end of file