dfhack/data/blueprints/dreamfort.csv

1	#notes label(help) run me for the dreamfort walkthrough
2	Welcome to Dreamfort! These blueprints will help you build a functional, secure, fully self-sustaining fortress that you can use as-is or extend to build the fortress of your dreams!
3
4	It can be difficult to apply a set of blueprints that you did not write yourself. This walkthrough will guide you through the high-level steps of building Dreamfort. Run "gui/quickfort dreamfort /checklist" (or, if you're looking at the online version, switch to the "checklist" sheet) for a compact list of the blueprints you'll be applying. Each level also has its own mini-walkthrough with more details.
5
6	The final fort will have a walled-in area on the surface for livestock, trading, aboveground farming, and military training. One z-level down is the farming level, with related workshops and vents up to the surface for miasma prevention. The farming level also has a miniature dining hall and dormitory for use until you get the services and housing levels set up.
7
8	Beyond those two, the other layers can be built in any order, at any z-level, according to your preference and the layout peculiarities of your embark site:
9	- The industry level has a compact, but complete set of workshops and stockpiles (minus what is already provided on the farming level).
10	- The services level has dining, hospital, marksman barracks, and justice services. It has a well system and is 4 z-levels deep.
11	- The guildhall level has large rooms for building libraries, temples, and guildhalls, with optional furniture layouts.
12	- The suites level has fancy rooms for your nobles with the furniture that they require.
13	- The apartments levels have small but well-furnished bedrooms for your other dwarves.
14	- The crypt level houses your dead.
15
16	Run each level's "help" blueprint (e.g. "gui/quickfort dreamfort /surface_help") for more details.
17
18	Dreamfort has a central stairs-based design. For all Dreamfort levels, place the cursor on the center (undug) tile of the 3x3 stairs area when you apply the blueprints for that level. The first surface blueprint will designate a column of stairs that you can use as a guide. If you need to extend the stairs down further to lower levels, run "gui/quickfort dreamfort /central_stairs" and set the repeat option to go down however many levels you need (each repetition is 2 levels). Apply it with the cursor on the z-level below the lowest current stairs.
19
20	Dreamfort blueprints take care of everything to get the fort up and running. You don't need to clear any extra trees or create any extra buildings or stockpiles (though of course you are free to do so). Blueprints that do require manual steps, like 'assign minecart to hauling route', will leave a message telling you so when you run them. Note that blueprints will designate buildings to build even if you don't have the materials needed to build them. You can use the "o" hotkey to automatically create the manager orders for all the needed items when you have a blueprint loaded in gui/quickfort. Make sure your manager is available to validate all the incoming work orders!
21
22	There are some tasks common to all forts that Dreamfort doesn't specifically handle for you. For example, Dreamfort sets up a barracks, but managing squads is up to you. Here are some other common tasks that may need to be done manually (or with some other tool):
23	- Exploratory mining for specific resources like iron (see gui/design for help with this)
24	- Filling the well system with water (if you have a light aquifer, see library/aquifer_tap.csv for help with this)
25	- Bringing magma up to the industry level to power magma forges/furnaces (see library/pump_stack.csv for help with this)
26	- Manufacturing trade goods
27	- Custom stockpile setups to assist with, for example, encrusting only high-quality items
28
29	Dreamfort works best at an embark site that is relatively flat and has at least one soil layer. New players should avoid embarks with aquifers if they are not prepared to deal with them. Bring picks for mining, an axe for woodcutting, and an anvil for a forge. Bring a few blocks to speed up initial workshop construction as well. That's all you really need, but see the example embark profile in the online spreadsheets for a more complete setup.
30
31	Other DFHack tools also work very well with Dreamfort, such as autofarm. See the /setup_help blueprint for a suggested list to turn on in the DFHack gui/control-panel.
32
33	Once you have your starting surface workshops up and running, you might want to configure buildingplan to only use blocks for constructions so it won't use your precious wood, boulders, and bars to build floors and walls. If you bring at least 7 blocks with you on embark, you can set this to be your default in the Autostart tab of gui/control-panel.
34
35	Directly after embark, run "gui/quickfort dreamfort /setup_help" to get some advice on initial settings, and get started building your fort with "gui/quickfort dreamfort /surface1" on the surface (see /surface_help for how to select a good spot). Read the walkthroughs for each level to understand what's going on and follow the checklist to keep track of where you are in the building process. Good luck, and have fun building an awesome Dreamfort-based fort!
36
37	The dreamfort.csv file distributed with DFHack is generated from online spreadsheet files. If you want to look at how these blueprints are put together, it is easier to look at the online spreadsheets than the giant .csv. You can view them at: https://drive.google.com/drive/folders/1dsmvnzbOKsyFS3DCj0F8ibSnMhVHEjdV
38	You are welcome to copy the Dreamfort spreadsheets and make your own modifications!
39
40	If you like, you can download a fully built Dreamfort-based fort from https://dffd.bay12games.com/file.php?id=15434 and explore it interactively.
41	# The dreamfort.csv distributed with DFHack is generated with the following command: for fname in dreamfort*.xlsx; do xlsx2csv -a -p '' "$fname"; done | sed 's/,*$//'
42	#notes label(checklist) command checklist
43	Here is the recommended order for Dreamfort commands. Each line is a blueprint that you run with gui/quickfort (default keybinding: Ctrl-Shift-Q), except where we use other tools as noted. If you set "dreamfort" as the filter when you open gui/quickfort, you'll conveniently only see Dreamfort blueprints to choose from. See the walkthroughs (the "help" blueprints) for context and details. You can also copy text from this spreadsheet online and paste it in gui/launcher with Ctrl-V.
44	If the checklist indicates that you should generate orders, that means to hit the "o" hotkey when the blueprint is loaded in gui/quickfort. You'll get a popup saying which orders were generated. Also remember to read the messages the blueprints display after you run them so you don't miss any important manual steps!
45
46	-- Preparation (before you embark!) --
47	Optionally copy the premade Dreamfort embark profile from the online spreadsheets to the prefs/embark_profiles.txt file.
48	Run gui/control-panel and enable settings on the Autostart tab. See the /setup_help notes for details.
49
50	-- Set settings and preload initial orders --
51
52	-- Find a good starting spot on the surface --
53
54	-- Dig --
55
56	-- Core fort (should finish at about the third migration wave) --
57
58	-- Plumbing --
59	If you haven't done it already, this is a good time to fill your well cisterns, either with a bucket brigade or by routing water from a freshwater stream or an aquifer (see the aquifer_tap library blueprint for help with this).
60	Also consider bringing magma up to your services level so you can replace the forge and furnaces on your industry level with more powerful magma versions. This is especially important if your embark has insufficient trees to convert into charcoal. Keep in mind that moving magma is a tricky process and can take a long time. Don't forget to continue making progress through this checklist!
61
62	-- Mature fort (fourth migration wave onward) --
63	The order of steps in this section is not important. Feel free to reorder as per the needs of your fort. Once you have about 50 dwarves, you can queue up as much as you want and your haulers will be able to keep your stonecutters supplied. You can even build another two Stonecutter's workshops to speed things along. You might need to dig a quarry on an unused level to get enough stone, though.
64
65	See this checklist online at https://docs.google.com/spreadsheets/d/13PVZ2h3Mm3x_G1OXQvwKd7oIR2lK4A1Ahf6Om1kFigw/edit#gid=1459509569
66	#notes label(setup_help)
67	These are Dreamfort's suggestions for adjustments to settings and initial setup.
68
69	You can save some time by setting up your settings in gui/control-panel before you embark.
70	Beyond the bugfix tools that are enabled by default, we recommend enabling the following DFHack tools in gui/control-panel (but they are not required if you prefer to do these things manually):
71
72	On the gui/control-panel "Autostart" tab, enable:
73	"Automation" subtab:
74	- autobutcher
75	- autobutcher target 10 10 14 2 BIRD_GOOSE
76	- autochop
77	- autofarm
78	- autofarm threshold 150 grass_tail_pig
79	- autofish
80	- automilk
81	- autonestbox
82	- autoshear
83	- autoslab
84	- ban-cooking all
85	- buildingplan set boulders false
86	- buildingplan set logs false
87	- cleanowned
88	- nestboxes
89	- orders-sort
90	- prioritize
91	- seedwatch
92	- suspendmanager
93	- tailor
94	- work-now
95	"Gameplay" subtab:
96	- dwarfvet
97	- warn-stranded
98	Note that if you've already started your fort and have missed the "new fort" trigger, you can enable these tools on the "Enabled" tab instead. You can run the one-time commands (like ban-cooking all) manually from gui/launcher.
99
100	Now, after you've arrived at your embark site, open the nobles screen and:
101	- Assign dwarves to at least manager, chief medical dwarf, broker, and bookkeeper noble roles (they can all be the same dwarf)
102
103	On the work details screen (Labor -> Work details)
104	- Specialize your miners (click the hammer-lock button so it turns red) and make your miners also engravers (they'll need something to do once the mining is done)
105	- Deselect fishing from all dwarves -- you have enough food to get started and you'll need their time for hauling
106
107	In standing orders (Labor -> Standing orders):
108	- Change "Automatically weave all thread" to "No automatic weaving" so the hospital always has thread -- we'll be managing cloth production with automated orders
109	- On the "Other" tab, change "Everybody harvests" to "Only farmers harvest"
110	#meta label(dig_all) start(central stairs on industry level) dig industry, services, guildhall, suites, apartments, and crypt levels. does not include farming.
111	# Note that this blueprint will only work for the unified dreamfort.csv. It won't work for the individual .xlsx files (since #meta blueprints can't cross file boundaries).
112
113	/industry1
114	#>
115	/services1
116	#>4
117	/guildhall1
118	#>
119	/suites1
120	#>
121	/apartments1 repeat(down 3)
122	#>3
123	/crypt1
124	#ignore
125	Here are the most important skills for getting Dreamfort up and running, along with suggestions for how to distribute them.
126
127
128	The most time-consuming tasks in early Dreamfort are: mining, chopping down trees, and making blocks. Starting with at least two miners, two woodcutters (assuming your embark has trees), and two stonecutters helps keep the fort from stalling. If you have to smooth walls to prevent a light aquifer from flooding your fort, starting with a few engravers saves a ton of time.
129
130	We suggest bringing at least:
131
132	Also bring logs for beds if embarking in an area without many trees.
133
134	See ldog's Dreamfort embark profile for a more advanced (and more thoroughly explained!) approach:
135	https://drive.google.com/file/d/1Et42JTzeYK23iI5wrPMsFJ7lUXwVBQob/view?usp=sharing
136	#ignore Add these lines to the bottom of your "prefs/embark_profiles.txt" file to make the "Dreamfort" profile available in-game. Also see ldog's dreamfort embark profile for a more advanced, dwarfy approach.
137	[PROFILE]
138	[TITLE:Dreamfort]
139	[SKILL:1:STONECRAFT:1]
140	[SKILL:1:MECHANICS:5]
141	[SKILL:1:JUDGING_INTENT:1]
142	[SKILL:1:APPRAISAL:1]
143	[SKILL:1:ORGANIZATION:1]
144	[SKILL:1:RECORD_KEEPING:1]
145	[SKILL:2:MINING:5]
146	[SKILL:2:ENGRAVE_STONE:4]
147	[SKILL:2:SWIMMING:1]
148	[SKILL:3:MINING:5]
149	[SKILL:3:ENGRAVE_STONE:4]
150	[SKILL:3:SWIMMING:1]
151	[SKILL:4:MASONRY:2]
152	[SKILL:4:MILITARY_TACTICS:5]
153	[SKILL:4:CUT_STONE:3]
154	[SKILL:5:FORGE_WEAPON:5]
155	[SKILL:5:FORGE_ARMOR:5]
156	[SKILL:6:WOODCUTTING:5]
157	[SKILL:6:CARPENTRY:5]
158	[SKILL:7:PLANT:5]
159	[SKILL:7:CUT_STONE:5]
160	[ITEM:10:CLOTH:NONE:CREATURE_MAT:SPIDER_CAVE:SILK]
161	[ITEM:100:WOOD:NONE:PLANT_MAT:WILLOW:WOOD]
162	[ITEM:30:BLOCKS:NONE:INORGANIC:QUARTZITE]
163	[ITEM:21:SEEDS:NONE:PLANT_MAT:MUSHROOM_HELMET_PLUMP:SEED]
164	[ITEM:21:SEEDS:NONE:PLANT_MAT:GRASS_TAIL_PIG:SEED]
165	[ITEM:21:SEEDS:NONE:PLANT_MAT:GRASS_WHEAT_CAVE:SEED]
166	[ITEM:21:SEEDS:NONE:PLANT_MAT:POD_SWEET:SEED]
167	[ITEM:20:SEEDS:NONE:PLANT_MAT:BUSH_QUARRY:SEED]
168	[ITEM:20:SEEDS:NONE:PLANT_MAT:MUSHROOM_CUP_DIMPLE:SEED]
169	[ITEM:1:ANVIL:NONE:INORGANIC:IRON]
170	[ITEM:2:WEAPON:ITEM_WEAPON_AXE_BATTLE:INORGANIC:COPPER]
171	[ITEM:2:WEAPON:ITEM_WEAPON_PICK:INORGANIC:COPPER]
172	[ITEM:20:DRINK:NONE:PLANT_MAT:GRASS_TAIL_PIG:DRINK]
173	[ITEM:20:DRINK:NONE:PLANT_MAT:MUSHROOM_HELMET_PLUMP:DRINK]
174	[ITEM:20:DRINK:NONE:PLANT_MAT:POD_SWEET:DRINK]
175	[ITEM:20:DRINK:NONE:PLANT_MAT:GRASS_WHEAT_CAVE:DRINK]
176	[ITEM:30:PLANT:NONE:PLANT_MAT:MUSHROOM_HELMET_PLUMP:STRUCTURAL]
177	[ITEM:45:BOULDER:NONE:INORGANIC:QUARTZITE]
178	[ITEM:20:THREAD:NONE:CREATURE_MAT:SPIDER_CAVE:SILK]
179	[ITEM:4:CHAIN:NONE:CREATURE_MAT:SPIDER_CAVE:SILK]
180	[PET:2:DOG:FEMALE:STANDARD]
181	[PET:1:DOG:MALE:STANDARD]
182	[PET:2:CAT:FEMALE:STANDARD]
183	[PET:1:CAT:MALE:STANDARD]
184	[PET:2:BIRD_GOOSE:FEMALE:STANDARD]
185	[PET:2:BIRD_GOOSE:MALE:STANDARD]
186	#notes label(surface_help)
187	Sets up a protected entrance to your fort in a flat area on the surface.
188	Screenshot: https://drive.google.com/file/d/1dlu3nmwQszav-ZaTx-ac28wrcaYBQc_t
189
190	Features:
191	- A starting set of workshops and stockpiles (which you can later remove once you establish your permanent workshops and storage)
192	- Livestock grazing area, nestbox zones, and beehives
193	- Walls, roof, and lever-controlled gates for security
194	- Barracks (with prisoner processing quantum dump)
195	- Trap-filled hallways for invaders
196	- Optional extended trap hallways (to handle larger sieges with a smaller/no military)
197	- Protected trade depot, with separate trade goods stockpiles for organics and inorganics (for easy elven trading)
198	- A grid of small farm plots for lucrative surface farming
199	- A burrow named "Inside+" that grows with your fort as you dig it out. It is pre-registered as a civilian alert burrow so you can use it to get your civilians to safety during sieges.
200	- A burrow named "Clearcutting area" that is automatically registered with autochop (if you have it enabled) to keep the area around your fort clear of trees
201
202	Manual steps you have to take:
203	- Assign grazing livestock to the large pasture, dogs to the pasture over the central stairs, and male birds to the zone between the rows of nestboxes (DFHack's autonestbox will auto-assign the female egg-laying birds to the nestbox zones)
204	- Connect levers to the drawbridges that match the names of the levers
205	- Assign minecarts to the trade goods and prisoner processing quantum stockpile hauling routes with assign-minecarts all
206
207	Be sure to choose an embark site that has a flat area on the surface large enough to use these blueprints!
208
209	Surface Walkthrough:
210	1) Choose a tile for your central fortress stairs. The terrain around that tile should be perfectly flat. Trees are ok, but no slopes, rivers, or ponds. To be sure that the tile you've chosen is in a good spot, run "gui/quickfort dreamfort /perimeter". This will show you the eventual boundaries of the fort. Some wall segments might be missing due to existing trees, but that's ok. Make sure the area within the exterior wall is flat. Cancel out of the preview. You don't actually need to apply this blueprint.
211
212	2) With the cursor on the chosen tile, run /surface1 to clear surrounding trees and set up your pastures. Deconstruct your wagon to get it out of the way of our upcoming walls and floors. Remember to assign your dogs to the pasture around the staircase and your grazing animals to the large pasture. Your egg-layers will automatically get assigned to nestbox zones once the nestboxes are built, so you don't need to worry about them. You can let your cats roam free to chase vermin.
213
214	3) Once the marked trees have been cleared, run /surface2 to setup starting workshops/stockpiles, channel out the miasma vents for the farming level, and start clearing trees from a larger area. If you haven't done it already, now is a good time to configure buildingplan to only build buildings with blocks, not logs or raw boulders. Generate manager orders for /surface2.
215
216	4) Once the channels are dug out and the trees are cleared, start digging the farming level one z-level down. Once you have run /farming2, come back to the surface and run /surface3 to cover the vents and build an enclosure around your central stairs. Although the vents will be covered with flooring, they will still work to prevent miasma on the farming level. Generate manager orders for /surface3.
217
218	5) Once all walls and floors have been constructed around the stairwell, run /surface4 to build floors and walls to support upcoming buildings and furniture. Generate manager orders for /surface4.
219
220	6) Once walls and floors have been constructed (including the small roof segment one z-level up over the barracks), run /surface5 to build furniture, gates, and the permanent trade depot. Remember to deconstruct the temporary trade depot once nobody is using it. Generate manager orders for /surface5.
221
222	7) Once all marked trees are cleared, run /surface6 to build the security perimeter and remaining flooring. Generate manager orders for /surface6.
223
224	8) Once you have enough dwarves to do a lot of building without starving other important tasks, run /surface7 to build the roof. Generate manager orders for /surface7.
225
226	9) For extra security, you can run /surface8 any time after /surface7 to extend the trap corridors. Generate manager orders for /surface8.
227
228	10) Once your industry and farming levels are set up and running, you can disassemble the surface workshops and remove the surface stockpiles. Disassembling a workshop scatters the items stored within it and cancels any pending jobs that happen to use those items. In order to avoid job cancellations, first set the surface workshops to not accept general work orders (click on the building, select the "Work orders" tab, and set the "General work orders allowed" to 0). Then check to see if any items in a workshop are marked as being part of an active job. Once no items in the workshop have that marker, you are free to disassemble that workshop.
229
230	Sieges and Prisoner Processing:
231	Here are some tips and procedures for handling seiges -- including how to clean up afterwards!
232
233	- Your "Inside+" burrow will automatically grow with your fort and should include only safe areas of your fort. In particular, it should not include the "atrium" area (where the "siege bait" pasture is) or the trapped hallways.
234
235	- When a siege begins, set your civilian alert (attach the alert to your "Inside+" burrow if it isn't already) to ensure all your civilians stay out of danger. Immediately pull the lever to close the outer main gate. It is also wise to close the trade depot and inner main gate as well. That way, if enemies get past the traps, they'll have to go through the soldiers in your barracks (assuming you have a military).
236
237	- During a siege, you can use the levers to control how attackers path through the trapped corridors. If there are more enemies than cage traps, time your lever pulling so that the inner gates snap closed before your last cage trap is sprung. Then the remaining attackers will have to backtrack and go through the other trap-filled hallway. You can also choose *not* to use the trap hallways and meet the siege with your military. It's up to you!
238
239	- If your cage traps fill up, ensure your hallways are free of uncaged attackers, then close the trap hallway outer gates and open the inner gates. Clear the civilian alert and allow your dwarves to reset all the traps -- make some extra cages in preparation for this! Then re-enable the civilian alert and open the trap hallway outer gates.
240
241	- Once the last attacker is caged, open all the gates and unset the civilian alert. Life is normal again!
242
243	After a siege, you can use the caged prisoners to safely train your military. Here's how:
244
245	- Once the prisoners are hauled to the "prisoner quantum" stockpile in the barracks, run "stripcaged all" in DFHack's gui/launcher.
246
247	- After all the prisoners' items have been confiscated, bring your military dwarves to the barracks (if they aren't already there).
248
249	- Assign a group of prisoners to the pasture that overlaps the prisoner quantum stockpile
250
251	- Hauler dwarves will come and release prisoners one by one. Your military dwarves will immediately pounce on the released prisoners and chop them to bits, saving the hauler dwarves from being attacked. Repeat until all prisoners have been "processed". Some prisoners are not directly hostile (like cavern-caught gorlaks) and you may need to be target them explicitly to get your soldiers to attack them.
252	#dig label(central_stairs_odd) start(2;2) hidden() carved spiral stairs odd levels
253	#meta label(central_stairs_even) hidden() carved spiral stairs even levels
254	/central_stairs_odd transform(cw)
255	#meta label(central_stairs) two levels of carved spiral stairs (repeat down as needed)
256	/central_stairs_odd
257	#>
258	/central_stairs_even
259	#build label(central_stairs_odd_constructed) start(2;2) hidden() constructed spiral stairs odd levels
260	#meta label(central_stairs_even_constructed) hidden() constructed spiral stairs even levels
261	/central_stairs_odd_constructed transform(cw)
262	#meta label(central_stairs_constructed) two levels of constructed spiral stairs (repeat down as needed)
263	/central_stairs_odd_constructed
264	#>
265	/central_stairs_even_constructed
266	#meta label(perimeter) start(central stairs) message(If you accidentally applied this blueprint to the map, run quickfort undo on this blueprint to clean up.) show the eventual perimeter of the surface fort; useful for location scouting
267	walls/surface_walls
268	corridor_gates/surface_corridor_gates
269	corridor/surface_corridor
270	corridor_traps/surface_corridor_traps
271
272	#meta label(surface1) start(central stairs) message(Once the central stairs are mined out deeply enough, you should start digging the industry level in a non-aquifer rock layer. You'll need the boulders from the digging to make blocks. If your wagon is within the fort perimeter, deconstruct it to get it out of the way. Once the marked trees are all chopped down (if any), continue with /surface2.) clear trees and set up pastures
273	clear_small/surface_clear_small
274	burrow_start/surface_burrow_start
275	zones/surface_zones
276	#>
277	central_stairs/central_stairs repeat(down 10)
278
279	#meta label(surface2) start(central stairs) message(Remember to enqueue manager orders for this blueprint. Once the channels are dug out and the marked trees are cleared, continue with /surface3.) set up starting workshops/stockpiles, channel miasma vents, and clear more trees
280	place_start/surface_place_start
281	build_start/surface_build_start
282	channel/surface_channel
283	clear/surface_clear
284
285	#meta label(surface3) start(central stairs) message(Remember to enqueue manager orders for this blueprint. Once the walls and floors around the staircase have been constructed, continue with /surface4.) Cover vents and protect the central stairs.
286	cover_vents/surface_cover_vents
287	cover_stairs/surface_cover_stairs
288
289	#meta label(surface4) start(central stairs) message(Remember to enqueue manager orders for this blueprint. Once the bits of flooring have been constructed, continue with /surface5. Be sure to check one z-level above the surface to ensure the roof segment above the future barracks has been finished.) build walls and flooring to support upcoming buildings and furniture
290	stairs_doors/surface_stairs_doors
291	pre_building/surface_pre_building
292
293	#meta label(surface5) start(central stairs) message(Remember to enqueue manager orders for this blueprint. Disassemble the temporary trade depot in the pasture once the new one is constructed (and no merchants are using the old one). Once the marked trees are cleared, continue with /surface6.) build gates, furniture, and trade stockpile/depot
294	traffic/surface_traffic
295	place/surface_place
296	build/surface_build
297	clear_large/surface_clear_large
298
299	#meta label(surface6) start(central stairs) message(Remember to enqueue manager orders for this blueprint. Continue with /surface7 sometime after the walls are completed and any marked trees are chopped down, whenever you have enough dwarves to build the roof without starving other important construction tasks.) build traps and remaining walls/floors
300	walls/surface_walls
301	floors/surface_floors
302	traps/surface_traps
303	clear_large/surface_clear_large
304
305	#meta label(surface7) start(central stairs (on ground level)) message(Remember to enqueue manager orders for this blueprint. For extra security, you can run /surface8 at any time to extend the trap corridors.) expand Inside+ burrow to safe surface areas and build roof
306	burrows/surface_burrows
307	#<
308	roof/surface_roof
309	roof2/surface_roof2
310	roof3/surface_roof3
311	roof4/surface_roof4
312
313	#meta label(surface8) start(central stairs) message(Remember to enqueue manager orders for this blueprint.) build extended trap corridors
314	corridor_gates/surface_corridor_gates
315	corridor/surface_corridor
316	corridor_traps/surface_corridor_traps
317	#dig label(surface_clear_small) start(19; 19) hidden() clear trees for starting workshops and stockpiles
318	#burrow label(surface_burrow_start) start(19; 19) hidden() create safety burrow that will grow with your fort
319	#zone label(surface_zones) start(19; 19) hidden() message(Remember to assign your dogs to the pasture surrounding the central stairs, your grazing animals to the large pasture, and your male birds to the zone between the rows of nestboxes. If your wagon is far away, you can let your animals wander closer to the fort before pasturing them to save hauling time.) pastures and training areas
320	#place label(surface_place_start) start(19; 19) hidden() starting stockpiles
321	#build label(surface_build_start) start(19; 19) hidden() starting workshops
322	#dig label(surface_channel) start(19; 19) hidden() channel miasma vents
323	#dig label(surface_clear) start(19; 19) hidden() clear trees so the farming level can be dug without fear of generating surface holes
324	#build label(surface_cover_vents) start(19; 19) hidden() cover the miasma vents
325	#build label(surface_cover_stairs) start(19; 19) hidden() protect the central stairs
326	#build label(surface_stairs_doors) start(19; 19) hidden()
327	#<
328	#build label(surface_pre_building) start(19; 19) hidden() flooring and anchoring walls for future buildings/doors
329	#<
330	#>
331	#dig label(surface_traffic) start(19; 19) hidden() set traffic designations
332	#place label(surface_place) start(19; 19) hidden() message(Remember to assign minecarts to the trade goods and prisoner processing quantum stockpiles (run "assign-minecarts all"). Feel free to adjust the configuration of the "trade goods" feeder stockpile so it accepts the item types you want to trade away. If those items types are also accepted by other stockpiles, configure those stockpiles to give to the "trade goods" stockpile. You might also want to set the "trade goods quantum" stockpile to autotrade.) remaining surface stockpiles
333	#build label(surface_build) start(19; 19) hidden() message(Use autofarm to manage farm crop selection. Remember to connect the levers to the gates once they are built.) gates, barracks, farm area, and trade area
334	#dig label(surface_clear_large) start(19; 19) hidden() clear wider area of trees
335	t1(37x33)
336	#build label(surface_walls) start(19; 19) hidden() build remaining walls
337	#build label(surface_floors) start(19; 19) hidden() build remaining flooring
338	#build label(surface_traps) start(19; 19) hidden()
339	#burrow label(surface_burrows) start(19; 19) hidden() extend safety burrow to newly safe surface areas and set up surrounding clearcutting area
340	#build label(surface_roof) start(19; 19) hidden() roof hatch and adjacent tiles
341	#build label(surface_roof2) start(19; 19) hidden() lower half of the roof
342	#build label(surface_roof3) start(19; 19) hidden() upper half center of the roof
343	#build label(surface_roof4) start(19; 19) hidden() upper half remainder of the roof
344	#build label(surface_corridor_gates) start(19; 19) hidden() message(Remember to connect the levers to the new external trap gates.) gates for the longer trap hallways
345	#build label(surface_corridor) start(19; 19) hidden() longer trap hallway walls
346	#<
347	#build label(surface_corridor_traps) start(19; 19) hidden() traps for the longer trap hallways
348	#notes label(farming_help)
349	Sets up farming, food storage, and related industries. Also provides post-embark necessities that can later be disassembled.
350	Screenshot: https://drive.google.com/file/d/1vDaedLcgoexUdKREUz75ZXQi0ZSdwWwj
351
352	Features:
353	- Pairs with the surface blueprints for vents that prevent miasma
354	- Farm plots (can be managed by DFHack autofarm)
355	- Plentiful food storage
356	- Refuse/corpse quantum stockpile
357	- Starter dormitory, dining room, and tomb for use until more permanent versions are ready
358	- Offices for your manager and bookkeeper
359
360	Workshops:
361	- Kitchen
362	- Brewery
363	- Butcher
364	- Fishery
365	- Tannery
366	- Farmer's Workshop
367	- Quern
368	- Screw Press
369
370	Manual steps you have to take:
371	- Assign a minecart to your refuse quantum stockpile hauling route (you can run "assign-minecarts all" to do this)
372
373	Farming Walkthrough:
374	1) Wait until you have channeled the miasma vents and cleared trees on the surface before digging out the farming level on the z-level below the surface, otherwise you will end up with extra ramps on the farming level and unprotected holes through the surface when you later chop down trees growing above empty space.
375
376	2) Start digging with /farming1 and get started on manufacturing furniture by generating manager orders for /farming2
377
378	3) Once the level is dug out, run /farming2 to designate zones, build workshops and stockpiles, and place furniture. Remember to assign a minecart to the newly-designated quantum refuse dump with assign-minecarts all.
379
380	4) Once your fort has enough free time to build the remaining doors, run /farming3. Generate manager orders for /farming3.
381
382	5) You can disassemble the dining room and dormitory once the services and apartments levels are up and running, if you like.
383	#dig label(farming1) start(16; 18; central stairs) message(Once the area is dug out, continue with /farming2.)
384	# this level is dug at priority 2 since it is dug in soil. it's worth the miner's time to
385	# stop digging the industry level and quickly dig out this one.
386	#meta label(farming2) start(central stairs) message(Remember to enqueue manager orders for this blueprint. Once furniture has been placed, continue with /farming3.) workshops, stockpiles, and important furniture
387	zone/farming_zone
388	place/farming_place
389	build/farming_build
390	traffic/farming_traffic
391
392	#meta label(farming3) start(central stairs) message(Remember to enqueue manager orders for this blueprint.) build remaining doors
393	doors/farming_doors
394	#zone label(farming_zone) start(16; 18) hidden() rooms
395	#place label(farming_place) start(16; 18) hidden() message(remember to assign a minecart to the refuse quantum stockpile (run "assign-minecarts all")
396	#build label(farming_build) start(16; 18) hidden() workshops and important furniture
397	#dig label(farming_traffic) start(16; 18) hidden() keep hungry dwarves away from the crops and food stores so they prefer the prepared meals
398	#build label(farming_doors) start(16; 18) hidden() remaining doors
399	#notes label(industry_help)
400	Sets up workshops for all non-farming industries
401	Screenshot: https://drive.google.com/file/d/1c8YTHxTgJY5tUII-BOWdLhmDFAHwIOEs
402
403	Features:
404	- Compact layout that covers all workshops
405	- Manager orders that automate basic fortress maintenance
406	- Space available underneath the forge and smelters for magma, allowing the starting forge and smelters to be eventually replaced by magma versions.
407	- Quantum stockpiles for compact storage
408	with separate stockpiles for:
409	- A reserve of uncut gems for strange moods that the jeweler's workshop cannot take from
410	- Wood, iron bars, steel bars, flux, and coal so you can see at a glance if you're low on stock
411	- Items that cannot be quantum stockpiled (e.g. lye, dye, and sand bags)
412	- Meltable weapons and armor
413
414	Workshops:
415	- 2x Stonecutter
416	- 4x Craftsdwarf
417	- 1x Jeweler
418	- 1x Mechanic
419	- 4x Smelter
420	- 1x Forge
421	- 1x Glassmaker
422	- 1x Kiln
423	- 4x Wood furnace
424	- 1x Ashery
425	- 1x Soap maker
426	- 1x Carpenter
427	- 1x Siege workshop
428	- 1x Bowyer
429	- 1x Dyer
430	- 1x Loom
431	- 1x Clothier
432
433	Manual steps you have to take:
434	- Assign minecarts to your quantum stockpile hauling routes. The assign-minecarts all command will do it for you.
435
436	Optional manual steps you can take:
437	- If desired, set one or both stockpiles in the bottom left to auto-melt. This results in melting all weapons and armor that are inferior to masterwork. This is great for upgrading your military, but it takes a *lot* of fuel unless you have first replaced the forge and smelters with magma versions. If you enable automelt and you don't have magma forges and magma smelters, be sure to be in a forested area, set up autochop, and keep your coal stocks high.
438
439	Industry Walkthrough:
440	1) Start digging out /industry1 as soon as you find a non-aquifer stone layer at least two layers beneath the surface so the boulders can be used by your starting workshops. The services level is intended to be dug beneath this one, and there is space on that level to route magma underneath your furnaces so you can replace the furnaces on this level with magma-powered equivalents.
441
442	2) Generate manager orders for /industry2. You brought an anvil with you (right??), so you can remove the unneeded anvil work order from the manager orders screen. Note that stockpiles that accept containers may claim the barrels you need to build the Dyer's Workshop and Ashery. If you see those two buildings not being constructed, build a few extra barrels or run combine all to free up some existing ones.
443
444	3) Once the area is dug out, run /industry2 to build replacements for your starter workshops up on the surface. Remember to assign minecarts to to your quantum stockpile hauling routes with assign-minecarts all.
445
446	4) After the initial workshops are constructed, run /industry3 to build the remaining workshops.
447
448	5) Once you have enough dwarves to do maintenance tasks (that is, after the first or second migration wave), run "orders import library/basic" to use the provided manager orders to take care of your fort's basic needs, such as food, booze, and raw material processing.
449
450	6) If you want to automatically melt goblinite and other low-quality weapons and armor, mark the south-west stockpiles for auto-melt. If you don't have a high density of trees to make into charcoal, though, be sure to route magma to the level beneath this one and replace the forge and furnaces with magma equivalents.
451
452	7) Once you have magma furnaces (or abundant fuel) and more dwarves, run "orders import library/furnace", "orders import library/military", and "orders import library/smelting" (in that order) to import the remaining fort automation orders. The military orders are optional if you are not planning to have a military, of course.
453
454	8) At any time, feel free to build extra workshops or designate custom stockpiles in the remaining open space. The space is there for you to use! Note the area in the bottom right can be used for additional magma-powered furnaces and workshops since there is space reserved for magma in those spots in the services level beneath.
455	#dig label(industry1) start(18; 18; central stairs) message(Once the area is dug out, continue with /industry2.)
456	#meta label(industry2) start(central stairs) message(Remember to enqueue manager orders for this blueprint.) stockpiles and high-priority workshops
457	traffic/industry_traffic
458	place/industry_place
459	build/industry_build
460	#meta label(industry3) start(central stairs) message(Remember to enqueue manager orders for this blueprint.) remaining workshops
461	build2/industry_build2
462	#dig label(industry_traffic) start(18; 18; central stairs) hidden() traffic patterns
463	#place label(industry_place) start(18; 18) hidden() message(remember to: - assign minecarts to to your quantum stockpile hauling routes (use "assign-minecarts all") - if you want to automatically melt goblinite and other low-quality weapons and armor, mark the south-east stockpiles for auto-melt - once you have enough dwarves, run "orders import library/basic" to automate your fort's basic needs (see /industry_help for more info on this file)) industry stockpiles
464	#build label(industry_build) start(18; 18) hidden() workshops to build first
465	#build label(industry_build2) start(18; 18) hidden() remaining workshops
466	#notes label(services_help)
467	Sets up public services (dining, hospital, etc.)
468	Screenshot: https://drive.google.com/file/d/1RQMy_zYQWM5GN7-zjn6LoLWmnrJjkxPM
469
470	Features:
471	- Spacious dining room/tavern (tavern is restricted to citizens and residents only by default)
472	- Large prepared food and drink stockpiles
473	- Well cistern system (route or carry your own water)
474	- Hospital (also restricted to residents by default) with a well for washing
475	- Well-appointed jail cells for happy prisoners
476	- Bolt-recycling archery range for your marksdwarves
477	- Interrogation room (office) for your Captain of the Guard
478	- Garbage dump
479	- Empty space for magma to power forges and smelters in the industry level above
480
481	Manual steps you have to take:
482	- If you want to tavern to attract visitors, change the restriction in the location configuration screen.
483	- Fill the cisterns with water, either with a bucket brigade or by plumbing flowing water. Fill so that there are two z-levels of 7-depth water to prevent muddiness. If you want to fill with buckets, you can use the pre-designated pond zones on the level below the main floor. If you feel adventurous and are experienced with water pressure, you can instead route (depressurized!) water to the second-to-bottom level (the one above the up staircases).
484	- If you are filling the wells with a bucket brigade and at least one well is already constructed, you'll run into issues with the dwarves stealing water from one well to fill another. Temporarily deconstruct the wells or temporarily build grates beneath the wells to block the buckets to avoid this issue. Remember to rebuild the wells or remove the grates afterwards, though!
485
486	Services Walkthrough:
487	1) Start this level when your fort grows to about 30 dwarves so everyone has a place to eat.
488
489	2) Start digging with /services1. Note that this digs out the main level and three levels below for the well cisterns.
490
491	3) Once the area is dug out, start populating the rooms with /services2. Generate manager orders for /services2.
492
493	4) Fill the wells with either bucket brigades or by carefully routing flowing water.
494
495	5) When your fort has grown some more, or you start needing a jail, run /services3 to extend the rooms a bit more. Generate manager orders for /services3.
496
497	6) When your fort is more mature and you need to expand the rooms, run /services4 to finish everything up. If you didn't have a Sheriff/Captain of the Guard to automatically assign to the interrogation room when you ran /services2, you can manually assign the office now. Generate manager orders for /services4.
498	#dig label(services1) start(18; 18; central stairs) message(Once the area is dug out, continue with /services2.)
499	#>
500	#>
501	#>
502	#meta label(services2) start(central stairs) message(Once furniture has been built, continue with /services3.) zones and minimally functional hospital and dining hall
503	traffic/services_traffic
504	zones/services_zones
505	place/services_place
506	build/services_build
507
508	#meta label(services3) start(central stairs) message(Once furniture has been built, continue with /services4.) expand furnishings
509	place2/services_place2
510	build2/services_build2
511
512	#meta label(services4) start(central stairs) complete furnishings
513	place3/services_place3
514	build3/services_build3
515	#dig label(services_traffic) start(18; 18) hidden() keep lollygaggers out of the cisterns and justice areas
516	#>
517	#>
518	#>
519	#zone label(services_zones) start(18; 18) hidden() message(Don't forget to assign a doctor to the hospital! If you'd like to fill your wells via bucket brigade, activate the inactive pond zones one level down from where the wells will be built.) garbage dump, hospital, taverrn, barracks, archery range, and pond zones
520	#>
521	#place label(services_place) start(18; 18) hidden()
522	#build label(services_build) start(18; 18) hidden() message(Remember to enqueue manager orders for this blueprint. Assign a minecart to the training ammo quantum dump with "assign-minecarts all") build basic hospital, dining room, and barracks
523	#place label(services_place2) start(18; 18) hidden() jail food and booze
524	#build label(services_build2) start(18; 18) hidden() message(Remember to enqueue manager orders for this blueprint.) expand each room
525	#place label(services_place3) start(18; 18) hidden() remaining jail food and booze
526	#build label(services_build3) start(18; 18) hidden() message(Remember to enqueue manager orders for this blueprint.) finalize furniture
527	#notes label(guildhall_help)
528	Eight 7x7 rooms for guildhalls, temples, libraries, etc.
529	Screenshot: https://drive.google.com/file/d/1mt66QOkfBqFLtw6AJKU6GNYmhB72XSJG
530
531	Features:
532	- Big rooms, optionally pre-furnished. Double-thick walls to ensure engravings add maximum value. Declare locations from the pre-created meeting zones as needed.
533
534	Guildhall Walkthrough:
535	1) Dig out the rooms with /guildhall1.
536
537	2) Once the area is dug out, choose a /guildhall2 variant based on your needs. For your first copy of this level, you probably want /guildhall2_default, which includes temple and library zones. For later copies you probably want to create all locations yourself, so you should choose /guildhall2_no_locations if you want the default furnishings or /guildhall2_custom for just the zones and doors, leaving the furnishings up to you. Generate manager orders for your chosen variant.
538
539	Note that the default temple and library are created "Citizens and Long-Term Residents only", but you can change this in the location configuration screen if you want them to attract visitors. If you need more rooms, you can dig another /guildhall1 in an unused z-level.
540	#dig label(guildhall1) start(15; 15; central stairs) message(Once the area is dug out, continue with /guildhall2.)
541	#meta label(guildhall2_default) furnished with default temple and library
542	locations/guildhall_locations
543	doors/guildhall_doors
544	furnish/guildhall_furnish
545
546	#meta label(guildhall2_no_locations) fully furnished and zoned but no locations
547	zones/guildhall_zones
548	doors/guildhall_doors
549	furnish/guildhall_furnish
550
551	#meta label(guildhall2_custom) only zones and doors
552	zones/guildhall_zones
553	doors/guildhall_doors
554
555
556	#zone label(guildhall_locations) start(15; 15; central stairs) hidden() message(The library and temple are restricted to residents only by default. If you'd like them to attract vistors, please go to the location screen and change the restrictions.) declare a library and temple
557	#zone label(guildhall_zones) start(15; 15; central stairs) hidden() designate zones, ready for custom locations to be assigned
558	#build label(guildhall_doors) start(15; 15; central stairs) hidden() message(Remember to enqueue manager orders for this blueprint.) build doors
559	#build label(guildhall_furnish) start(15; 15; central stairs) hidden() furnish 4 guildhalls, 3 temples, and a library
560	#notes label(beds_help)
561	Suites for nobles and apartments for the teeming masses
562	Suites screenshot: https://drive.google.com/file/d/16XRb1w5zFoyVq2LBMx_aCwOyjFq7GULc
563	Apt. screenshot: https://drive.google.com/file/d/16-NXlodLIQjeZUMSmsWRafeytwU2dXQo
564
565	Features:
566	- Well-appointed suites to satisfy nobles or citizens with a need for opulence
567	- Suite rooms are multi-functional. Any suite can be zoned as a bedroom, office, dining hall, or tomb. If a noble requires a fancier version than what one room can provide, include multiple rooms in the zone. A suites level can fully satisfy a monarch if each zone covers four (engraved) rooms.
568	- Apartments with beds and storage to keep dwarves happy and the fortress clean
569
570	Suites Walkthrough:
571	1) Dig out the suites layer with /suites1.
572
573	2) Once the area is dug out, furnish the suites with /suites2. The rooms are left unzoned so you can configure them for the needs of specific nobles. Generate manager orders for /suites2.
574
575	Apartments Walkthrough:
576	1) Dig out one layer of apartments with /apartments1, or 3 layers at once (180 bedrooms total) by configuring gui/quickfort to repeat down 3 levels.
577
578	2) Once a layer is dug out, build furniture with /apartments2. Generate manager orders for /apartments2.
579	#dig label(suites1) start(18; 18; central stairs) message(Once the area is dug out, run /suites2) noble suites
580	#meta label(suites2) start(central stairs) message(Remember to enqueue manager orders for this blueprint. rooms are left unzoned so you can configure them for specific nobles.) build furniture and set traffic patterns
581	traffic_suites/suites_traffic
582	build_suites/suites_build
583	#dig label(suites_traffic) start(18; 18; central stairs) hidden() don't path through other dwarves' rooms
584	#build label(suites_build) start(18; 18; central stairs) hidden()
585	#dig label(apartments1) start(18; 18; central stairs) message(Once the area is dug out, continue with /apartments2.) apartment complex
586	#meta label(apartments2) start(central stairs) zone rooms and build furniture
587	zone_apartments/apartments_rooms
588	build_apartments/apartments_build
589	#zone label(apartments_rooms) start(18; 18; central stairs) hidden() zone rooms
590	#build label(apartments_build) start(18; 18; central stairs) hidden() message(Remember to enqueue manager orders for this blueprint.) build furniture
591	#notes label(crypt_help)
592	Places to rest your dead
593	Screenshot: https://drive.google.com/file/d/16iT_ho7BIRPD_eofuxdlVQ4FunR1Li23
594
595	Features:
596	- Staged crypt expansion that grows with your, um, need
597	- 52 tombs in stage 1
598	- 160 additional tombs in stage 2 (212 tombs total)
599	- Extendable in any direction by applying the blueprints multiple times
600
601	Crypt Walkthrough:
602	1) Dig out the layer with /crypt1.
603
604	2) Once the area is dug out, add initial tombs with /crypt2.
605
606	3) If/when you need additional tombs, apply /crypt3.
607	#dig label(crypt1) start(18; 18; central stairs) message(Once the area is dug out, continue with /crypt2.) crypt complex
608	#meta label(crypt2) start(central stairs) small crypt that can be extended later
609	zone/crypt_zone
610	build/crypt_build
611
612	#meta label(crypt3) start(central stairs) crypt extension
613	zone_extended/crypt_extended_zone
614	build_extended/crypt_extended_build
615	#zone label(crypt_zone) start(18; 18; central stairs) hidden() zone tombs
616	#build label(crypt_build) start(18; 18; central stairs) hidden() message(Remember to enqueue manager orders for this blueprint.) build urns
617	#zone label(crypt_extended_zone) start(18; 18; central stairs) hidden() zone more tombs
618	#build label(crypt_extended_build) start(18; 18; central stairs) hidden() message(Remember to enqueue manager orders for this blueprint.) build more urns