dfhack/data/blueprints/library/pump_stack.csv

1	#notes label(help)
2	A pump stack is useful for moving water or magma up through the z-levels.
3
4	To use these blueprints:
5
6	1) Measure how many z-levels the pump stack should span.
7
8	2) Position the cursor on the bottom level of the future pump stack. It should be on the z-level just above the liquid you want to pump. Run "quickfort run library/pump_stack.csv -n /dig2SN" to see where the suction hole will end up. Replace "run" with "undo" in the previous command to clean up.
9
10	3) If you need an East-West pump stack, or if you need the staircase in another spot, use the "--transform" commandline option to alter the blueprint to your needs. For example: "quickfort run library/pump_stack.csv -n /dig2SN --transform rotcw,fliph". If you use a transformation, be sure to use the same option for the remaining commandlines.
11
12	4) Once you have everything lined up, run "quickfort run library/pump_stack.csv -n /dig2SN --repeat up,20" to designate the entire pump stack for digging. Replace that last "20" with the height of your pump stack divided by 2 (since each repetition of /dig2SN is two z-levels high). If the height ends up being one too many at the top, manually undesignate the top level.
13
14	5) Since you do not need to transmit power down below the lowest level, replace the channel designation on the middle tile of the bottom-most pump stack level with a regular dig designation. Likewise, replace the Up/Down staircase designation on the lowest level with an Up staircase designation.
15
16	6) After the stack is dug out, prepare for building by setting the buildingplan plugin material filters for screw pumps (b-M-s-M). If you are planning to move magma, be sure to select magma-safe materials.
17
18	7) Finally, position the cursor back on the access stairs on the lowest level and run "quickfort run library/pump_stack.csv -n /build2SN --repeat up,20" (with 20 replaced with your desired repetition count and with your --transform command, if any).
19
20	Sometimes, a screw pump will spontaneously deconstruct while you are building the stack. This will reduce the efficiency of the stack a little, but it's nothing to worry about. Just re-run the /build2SN blueprint over the entire stack to "fix up" any broken pieces. The blueprint will harmlessly skip over any correctly-built screw pumps.
21
22	See the wiki for more info on pump stacks: https://dwarffortresswiki.org/index.php/Screw_pump#Pump_stack
23	#dig label(digSN) start(2;4;on access stairs) hidden() for a pump from south level
24	#dig label(digNS) start(2;4;on access stairs) hidden() for a pump from north level
25	#meta label(dig2SN) start(at the bottom level on the access stairs) 2 levels of pump stack - bottom level pumps from the south
26	/digSN
27	#<
28	/digNS
29	#build label(buildSN) start(2;4;on access stairs) hidden() for a pump from south level
30	#build label(buildNS) start(2;4;on access stairs) hidden() for a pump from north level
31	#meta label(build2SN) start(at the bottom level on the access stairs) 2 levels of pump stack - bottom level pumps from the south
32	/buildSN
33	#<
34	/buildNS