add walkthroughs for each dreamfort level

data/blueprints/library/dreamfort.csv

@@ -1,26 +1,28 @@
 #notes label(help) run me for the dreamfort walkthrough
 Welcome to the Dreamfort Walkthrough!
-It can be difficult applying a set of blueprints that you did not write yourself. This walkthrough will guide you through the high-level steps of building Dreamfort.
+It can be difficult applying a set of blueprints that you did not write yourself. This walkthrough will guide you through the high-level steps of building Dreamfort. Each level also has its own mini-walkthrough with specific steps for that level.
 ""
-"The final fort will have a walled-in area on the surface for livestock, trading, and military. Be sure to bring some blocks with you for the initial set of workshops! One z-level down is the farming level, with related workshops and vents up to the surface for miasma control. The farming level also has a miniature dining hall and dormitory for use until you get the services and beds levels set up."
+"The final fort will have a walled-in area on the surface for livestock, trading, and military. One z-level down is the farming level, with related workshops and vents up to the surface for miasma control. The farming level also has a miniature dining hall and dormitory for use until you get the services and housing levels set up."
 ""
 "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:"
-"- The industry level has a compact, but complete set of workshops and stockpiles (minus what is already provided on the farming level)"
+"- The industry level has a compact, but complete set of workshops and stockpiles (minus what is already provided on the farming level)."
 "- The services level has dining, hospital, and justice services, including a well system. This level is 4 z-levels deep."
-"- The guildhall level has many empty rooms for building libraries, temples, and guildhalls"
+"- The guildhall level has many empty rooms for building libraries, temples, and guildhalls."
-- The suites level has fancy rooms for your nobles
+- The suites level has fancy rooms for your nobles.
-- The apartments level(s) has small but well-furnished bedrooms for your other dwarves
+- The apartments level(s) has small but well-furnished bedrooms for your other dwarves.
 ""
-"Run the ""help"" blueprints for each level for more details."
+"Run each level's ""help"" blueprint (e.g. /surface_help) for more details."
 ""
-"Dreamfort has a central staircase-based design. Choose a tile for your staircase on the surface in a nice, flat area. For all blueprints, the cursor will start on this tile on the z-level where you want to apply the blueprint."
+"Dreamfort has a central staircase-based design. For all Dreamfort levels, place the cursor on the center staircase tile when you apply the blueprints. The first surface blueprint will designate a column of staircases that you can use as a guide."
 ""
-"Blueprints that require manual steps (like 'assign minecart to hauling route') will leave a message telling you so after you apply them. Blueprints will also leave messages with hints when you might want to run ""quickfort orders"" on specific blueprints to start manufacturing needed items."
+"Dreamfort blueprints take care of everything to get the fort up and running. You don't need to clear any 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 apply them. Blueprints will also leave messages with hints when you might want to run ""quickfort orders"" to start manufacturing needed items."
 ""
-"Directly after embark, apply /surface1 on a flat area on the surface and /industry1 somewhere underground (but not immediately below the surface -- that will be for the farming level). Work your way through the steps for those levels: apply /surface2 when /surface1 is done, /industry2 when /industry1 is done, etc. Once you channel out parts of the surface with /surface3, you can start the farming sequence with /farming1. You can start the services, guildhall, suites, and apartments sequences as your fort needs those levels."
+"Dreamfort works best at an embark site that is flat and has at least one soil layer. New players should also avoid aquifers if they are not prepared to deal with them. Bring picks for mining, an axe for woodcutting, and about 10 blocks (of any material) to speed up construction of starting workshops."
+""
+"Directly after embark, apply /surface1 on the surface (see /surface_help for how to select a good spot) and /industry1 at least two z-levels underground (the z-level immediately below the surface is reserved for the farming level). The walkthroughs for those levels will guide you. Once you channel out parts of the surface with /surface3, you can start the farming sequence on the z-level below the surface with /farming1. You can start the services, guildhall, suites, and apartments sequences as your fort needs those levels."
 ""
 "This .csv file is generated from source .xlsx files. If you want to look at how these blueprints are put together, it will be easier to look at the online spreadsheets than this giant .csv. You can view them at: https://drive.google.com/drive/folders/1iS90EEVqUkxTeZiiukVj1pLloZqabKuP"
-You are welcome to copy those files and make your own modifications!
+You are welcome to copy those spreadsheets and make your own modifications!
 "#dreamfort.csv is generated with the following command:
   for fname in dreamfort*.xlsx; do xlsx2csv -a -p '' $fname; done | sed 's/,*$//'"
 #notes label(surface_help)
@@ -28,7 +30,8 @@ You are welcome to copy those files and make your own modifications!
 ""
 Features:
 A starting set of workshops and stockpiles (which you can later remove once you establish your permanent workshops and storage)
-Walls and lever-controlled gates for security
+Trade depot area
+"Walls, roof, and lever-controlled gates for security"
 Trap-filled hallways for invaders
 Livestock grazing area with nestbox zones and beehives
 A grid of 1x1 farm plots (meant to be managed with DFHack autofarm)
@@ -36,20 +39,29 @@ An extra room near the entrance for a barracks (once you get your military going
 Miasma vents for the farming level that is intended to be built in the layer directly beneath the surface
 ""
 Manual steps you have to take:
-Assign grazing livestock to the large pasture and dogs to the pasture over the stairwell (DFHack's autonestbox will manage the nestbox zones)
+Assign grazing livestock to the large pasture and dogs to the pasture over the stairwell (DFHack's autonestbox can manage the nestbox zones)
 Connect levers to the gates
 ""
 "All blueprints are managed by the meta blueprints in the ""meta"" sheet. Each stage is meant to be applied after the previous stage is completely finished. For example, you can't build furniture until all the flooring has been constructed."
 ""
 Be sure to choose an embark site that has an area flat enough to use these blueprints!
+""
+Surface Walkthrough:
+"1) Choose a tile for your central staircase. The terrain around that tile should be perfectly flat. Trees are ok, but no slopes, rivers, or lakes. To be sure that the tile you've chosen is in a good spot, set the cursor over that tile and run ""quickfort run library/dreamfort.csv -n /surface4"". 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 walls is flat. Run ""quickfort undo library/dreamfort.csv -n /surface4"" to clean up."
+"2) With the cursor on the chosen tile, run /surface1 to clear surrounding trees and set up your pastures. Remember to assign your dogs to the pasture around the staircase and your grazing animals to the large pasture. You can let your cats roam free."
+"3) Once the trees have been cleared, run /surface2 to set up starting workshops/stockpiles and clear trees from a larger area. Run ""quickfort orders"" for /surface4, /surface5, and /surface6 to get a head start manufacturing items for those blueprints. If you want a consistent color for your walls and floors, remember to set the rock material in the buildingplan UI and in the manager orders for the blocks."
+"4) Once the trees have been cleared from the larger area, run /surface3 to channel out the miasma vents for the farming level."
+"5) When the channels have been dug, run /surface4 to build the protective walls and flooring. You can also start digging out the sub-surface farming level (/farming1) at this point. Although the vents will be covered with flooring, they will still work to prevent miasma."
+"6) Once all the constructions are built, run /surface5 build gates, furniture, the trade depot, and traps."
+"7) When at least the beehives are in place, run /surface6 to configure the hives and construct a roof."
 "#meta label(surface1) start(staircase center)
 message(This would be a good time to start digging the industry level.
-Once the area is clear, continue with /surface2.) clear an area and set up pastures"
+Once the area is clear of trees, continue with /surface2.) clear trees and set up pastures"
 clear_small/surface_clear_small
 zones/surface_zones
 ""
 "#meta label(surface2) start(staircase center) message(This would be a good time to queue manager orders for /surface4, /surface5, and /surface6. If you want a consistent color for your walls, remember to set the rock material in the buildingplan UI and in the manager orders for blocks.
-Once the whole area is clear, continue with /surface3.) set up starting workshops/stockpiles and clear a larger area. if you didn't bring blocks, temporarily turn off the buildings_use_blocks setting so you can use wood or boulders"
+Once the whole area is clear of trees, continue with /surface3.) set up starting workshops/stockpiles and clear a larger area"
 build_start/surface_build_start
 place_start/surface_place_start
 query_start/surface_query_start
@@ -121,7 +133,34 @@ build_roof/surface_roof
 ,,,,,,,,,,,,,,,,,,,`,`,`,`,`,`,`
 
 
-
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
+#>
+i
 #zone label(surface_zones) start(23; 25) hidden() message(remember to assign your dogs to the staircase pasture and your grazing animals to the large pasture) use the meta blueprints for normal application
 
 
@@ -847,6 +886,12 @@ Manual steps you have to take:
 Assign the office to your manager
 Assign a minecart to your quantum garbage stockpile hauling route
 "If the industry level is already built, configure the jugs, pots, and bags stockpiles to take from the ""Goods"" quantum stockpile on the industry level"
+""
+Farming Walkthough:
+"1) Wait until you have completed /surface3 before digging out the farming level on the z-level below the surface, otherwise you will likely get caveins as your miners channel out the miasma vents over empty space."
+"2) Start digging with /farming1 and get started on manufacturing furniture by running ""quickfort orders"" on /farming2."
+"3) Once the level is dug out, run /farming2 to build workshops and build and configure stockpiles. Remember to assign a minecart to the newly-designated quantum garbage dump. There are also jugs, pots, and bags stockpiles on this level that should be configured to ""take"" from the industry level stockpiles once we get the industry level built."
+"4) When the furniture is in place, run /farming3 to designate your temporary dining room and dormitory. The blueprint also attempts to assign the office to your manager, but double-check this assignment in case your dwarves are in an unexpected order."
 "#dig label(farming1) start(23; 25; staircase center) message(This would be a good time to queue up manager orders for /farming2. Once the area is dug out, continue with /farming2.)"
 
 
@@ -1154,6 +1199,12 @@ Manual steps you have to take:
 Assign minecarts to your quantum stockpile hauling routes
 "Give from the ""Goods"" quantum stockpile to the jugs, pots, and bags stockpiles on the farming level"
 "If desired, set the stockpiles in the bottom right to auto-melt. This results in melting all weapons and armor that are not masterwork steel. This is great for your military, but it takes a *lot* of fuel. If you enable this, be sure you're in a heavily forested area, enable auto-chop, and set up manager orders to keep your coal stocks high."
+""
+Industry Walkthrough:
+1) You can start digging out /industry1 immediately after embark. It is best to choose a stone layer at least two layers underground so the boulders can be used by your starting workshops to manufacture needed items.
+"2) Queue up manufacturing by running ""quickfort orders"" on /industry2."
+"3) Once the area is dug out, run /industry2. Remember to assign minecarts to to your quantum stockpile hauling routes, and if the farming level is already built, give from the ""Goods"" quantum stockpile to the jugs, pots, and bags stockpiles on the farming level."
+"4) If you want to automatically melt goblinite and other low-quality weapons and armor, mark the south-east stockpiles for auto-melt."
 "#dig label(industry1) start(18; 18; staircase center) message(This would be a good time to queue manager orders for /industry2. Once the area is dug out, continue with /industry2.)"
 
 
@@ -1309,8 +1360,8 @@ query/industry_query
 "Sets up public services (dining, hospital, etc.)"
 ""
 Features:
-Spacious dining room (can be declared a tavern)
+Spacious dining room (also usable as a tavern)
-Food and drink stockpiles
+Prepared food and drink stockpiles
 Well system (bring your own water)
 Public baths with soap stockpiles
 Three well-appointed jail cells
@@ -1321,7 +1372,14 @@ Manual steps you have to take:
 "If you want to declare the dining room as a tavern, the bedrooms at the top can be assigned to the tavern as rented rooms."
 "Configure the soap stockpiles to take from the industry level ""Metalworker"" quantum stockpile (which holds all the bars)"
 "Activate the bath pond zones when you are ready to fill them with 3-depth water. This is the only really fiddly bit, since you have to carefully disable the pond zone again when the final bucket to bring the water to an even 3-depth is on the way."
-"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. If you want to fill with buckets, designate a pond zone 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)."
+"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, designate a pond zone 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)."
+""
+Services Walkthough:
+1) Start this level before your fort grows beyond around 50 dwarves so everyone has a place to eat.
+"2) Start digging with /services1. Note that this digs out the main level and three levels below for the well plumbing. Start manufacturing with ""quickfort orders"" on /services2."
+"3) Once the area is dug out, set up the furniture, stockpiles, and hospital and garbage dump zones with /services2. Fill your soap stockpiles around the bath channels by configuring them to take from the bar quantum stockpile (the one on the right near the forge) on the industry level."
+"4) When all furniture is placed, run /services3 to configure your dining room and jail."
+5) Fill the bath and wells with either a bucket brigade or by carefully routing flowing water to them.
 "#dig label(services1) start(23; 22; staircase center) message(This would be a good time to queue manager orders for /services2. Once the area is dug out, continue with /services2.)"
 
 
@@ -1639,7 +1697,12 @@ query_stockpiles/services_query_stockpiles
 "Multiple 7x7 rooms for guildhalls, temples, libraries, etc."
 ""
 Features:
-"Big empty rooms. Double-thick walls to ensure engravings are on the ""correct"" side. Fill with furniture and assign as needed."
+"Big empty rooms. Double-thick walls to ensure engravings add value to the ""correct"" side. Fill with furniture and assign as needed."
+""
+Guildhall Walkthrough:
+"1) Dig out the rooms with /guildhall1 and queue up manufacturing by running ""quickfort orders"" on /guildhall2."
+"2) Once the area is dug out, add in generic furniture with /guildhall2."
+"3) Furnish individual rooms as you need specific guildhalls, libraries, and temples."
 "#dig label(guildhall1) start(25; 25; staircase center) message(This would be a good time to queue manager orders for /guildhall2. Once the area is dug out, continue with /guildhall2.)"
 
 
@@ -1747,6 +1810,15 @@ Features:
 Well-appointed suites to satisfy most nobles
 Apartments with beds and storage to keep dwarves happy
 Meta blueprint included for designating 6 levels of apartments for a full 200+ dwarves
+""
+Suites Walkthrough:
+"1) Dig out the suites layer with /suites1 and queue up manufacturing by running ""quickfort orders"" on /suites2."
+"2) Once the area is dug out, furnish the suites with /suites2. The rooms are left unconfigured so you can set them up as needed room types and assign them to specific nobles. Each room can serve as a bedroom, a dining hall, an office, or a tomb."
+""
+Apartments Walkthrough:
+"1) Dig out one layer of apartments with /apartments1, or 6 layers at once (enough for 200 dwarves) with /apartments1_stack. Run ""quickfort orders"" for /apartments2 once for every apartments layer that you are digging."
+"2) Once a layer is dug out, furnish it with /apartments2."
+"3) Once the beds are in place (the other furniture can still be unbuilt), configure the rooms with /apartments3. Once the urns are all in place, run ""burial -pets"" to set them all to accept burials."
 "#dig label(suites1) start(18; 18; staircase center) message(This would be a good time to queue manager orders for /suites2. Once the area is dug out, continue with /suites2) noble suites"
 
 ,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d