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	- Measure how many z-levels the pump stack should span.
6	- 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.
7	- 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.
8	- 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.
9	- 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.
10	- 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.
11	- 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).
12
13	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.
14
15	See the wiki for more info on pump stacks: https://dwarffortresswiki.org/index.php/Screw_pump#Pump_stack
16	#dig label(digSN) start(2;4;on access stairs) hidden() for a pump from south level
17	#dig label(digNS) start(2;4;on access stairs) hidden() for a pump from north level
18	#meta label(dig2SN) start(at the bottom level on the access stairs) 2 levels of pump stack - bottom level pumps from the south
19	/digSN
20	#<
21	/digNS
22	#build label(buildSN) start(2;4;on access stairs) hidden() for a pump from south level
23	#build label(buildNS) start(2;4;on access stairs) hidden() for a pump from north level
24	#meta label(build2SN) start(at the bottom level on the access stairs) 2 levels of pump stack - bottom level pumps from the south
25	/buildSN
26	#<
27	/buildNS