dfhack/data/blueprints/aquifer_tap.csv

1	#notes label(help)
2	This blueprint will help you get a safe, everlasting source of fresh water from a light aquifer.
3
4	Here's the procedure:
5
6	1) Dig a tunnel from where you want the water to end up (e.g. your well cistern) off to an unused portion of the map that has an aquifer above it. Be sure to dig a one-tile-wide diagonal segment in this tunnel so water that will eventually flow through the tunnel is depressurized.
7
8	2) From the end of that tunnel, dig a staircase straight up to the lowest aquifer level. Erase the top staircase tile (the down-only stairs) so your miners don't dig it yet. We'll be adding it back with the aquifer_tap blueprint. Also dig the staircase column down one z-level below the tunnel level.
9
10	3) From the bottom of the staircase (the z-level below where the water will flow to your cisterns), dig a straight, one-tile wide tunnel to the closest edge of the map. This is your emergency drainage tunnel. Smooth the map edge tile and carve a fortification. The water can flow through the fortification and off the map, allowing the dwarves to dig out the aquifer tap without drowning.
11
12	4) Place a lever-controlled floodgate in the drainage tunnel and open the floodgate. Place the lever somewhere else in your fort so that it will remain dry and accessible.
13
14	5) If you want, haul away any boulders in the tunnels and/or smooth the tiles. You won't be able to access any of this area once it fills up with water!
15
16	6) Apply this blueprint (gui/quickfort aquifer_tap /dig) to the z-level above the top of the staircase, inside the lowest aquifer level. Do not unpause until after the next step.
17
18	7) Damp tiles cancel dig designations if the tile is currently hidden, so to avoid having to re-apply this blueprint after every tile your dwarves dig, position the keyboard cursor straight up (north) of the left-most tile designated for digging and straight left (west) of the topmost designated tile and run the following commands in the DFHack console:
19	tiletypes-command f any ; f designated 1 ; p any ; p hidden 0 ; r 23 23 1
20	tiletypes-here
21
22	8) Unpause and dig out the tap. You can haul away any boulders and remove the ramps if you like. The water will safely flow down the staircase, through the open floodgate, down the drainage tunnel, and off the map as long as the floodgate is open.
23	9) Once everything is dug out and all dwarves are out of the waterways, close the floodgate. Your cisterns will fill with water. Since the waterway to your cisterns is depressurized, the cisterns will stay forever full, but will not flood.
24
25	A diagram might be useful. Here is a vertical view through the z-levels. This blueprint goes at the top:
26
27	j <- down stairs, center of this blueprint
28	i
29	... <- up/down stairs, make this as tall as you need
30	i
31	i <- cistern outlet level
32	u <- up stairs, drainage level
33
34	Good luck! If done right, this method is the safest way to supply your fort with clean water.
35	#dig label(dig) start(13 13 center of tap) light aquifer water collector