diff --git a/map-warps.md b/map-warps.md
new file mode 100644
index 0000000..7942576
--- /dev/null
+++ b/map-warps.md
@@ -0,0 +1,44 @@
+## Warping across maps, using [[WARP nodes|nodes]]
+
+Let's say we have 3 maps, **map1**, **map2** and **map3**, and we want to put "doors" to warp from one map to another:
+
+![Warping between maps](https://web.archive.org/web/20120226002024im_/http://aquariawiki.ryanballantyne.name/wiki/images/Warp.png)
+
+* For the door on the right of map1, you need to put a node: _warp map2 r_ (because the door is on the right of the map)
+* For the door on the left of map2, you need to put a node: _warp map1 l_ (because the door is on the left of the map)
+* For the door on the bottom of map2, you need to put a node: _warp map3 d_ (because the door is **down**)
+* For the door on top of map3, you need to put a node: _warp map2 u_ (because the door is **up**) 
+
+The doors are automatically connected according to their location (right<->left, up<->down).
+
+You will wrap as soon as the node is entered, and be placed on the opposing edge just outside of the node.
+
+## Warping across maps, using WARPNODE nodes
+
+Works the same way, except you can specify where you want to go on the map. Naija will be placed on the node you specify:
+
+```
+warpnode map2 myNode r
+```
+
+Just place a _myNode_ node somewhere on the map and you will warp to it. The node name should be unique on that map.
+
+## Local Warping on a single maps, using WARPLOCALNODE nodes
+
+This is used for houses or entrances to small caves, where the warp target lies on the same map.
+
+```
+warplocalnode 1in in
+warplocalnode 1out out
+```
+
+A picture says more than 1000 words:
+
+![Local warps explanation](http://fg.wzff.de/pub/aquaria/wikidata/localwarps.png)
+
+Here, **1in** and **1out** are (arbitrarily chosen) names of warp target nodes, and the last word (**in**/**out**) specifies whether the warp goes inside a cave or back out into the open world.
+
+While inside a local cave, the game enters a special mode where your world map position does not change, you'll still be displayed as if you were at the entrance location of the cave. This is because local caves are typically omitted from the world map, and it makes sense to lock your location this way.
+
+If you don't need the distinction between inside and outside, use "out".
+