@ -1222,19 +1222,18 @@ The Dreamfort blueprints we'll be discussing are available in the library as
:source: `one large .csv file <data/blueprints/library/dreamfort.csv>` :source: `one large .csv file <data/blueprints/library/dreamfort.csv>`
or `online
or `online
<https://drive.google.com/drive/folders/1iS90EEVqUkxTeZiiukVj1pLloZqabKuP> `__ as<https://drive.google.com/drive/folders/1iS90EEVqUkxTeZiiukVj1pLloZqabKuP> `__ as
individual spreadsheets. Either can be read and applied by quickfort, but for us
individual spreadsheets. Either the .csv file or the exported spreadsheet .xlsx
humans, the online spreadsheets are much easier to work with. Each spreadsheet
files can be read and applied by quickfort, but for us humans, the online
has a "Notes" sheet with some useful details. Flip through some of the
spreadsheets are much easier to work with. Each spreadsheet has a "Notes" sheet
spreadsheets and read the `walkthrough
with some useful details. Flip through some of the spreadsheets and read the
<https://docs.google.com/spreadsheets/d/
`walkthrough <https://docs.google.com/spreadsheets/d/13PVZ2h3Mm3x_G1OXQvwKd7oIR2lK4A1Ahf6Om1kFigw/edit#gid=0> `__
13PVZ2h3Mm3x_G1OXQvwKd7oIR2lK4A1Ahf6Om1kFigw/edit#gid=0>`__ to get oriented.
to get oriented. Also, if you haven't built Dreamfort before, try an embark in a
Also, if you haven't built Dreamfort before, try an embark in a flat area and
flat area and take it for a spin!
take it for a spin!
Almost every quickfort feature is used somewhere in Dreamfort, so the blueprints
Almost every quickfort feature is used somewhere in Dreamfort, so the blueprints
as a whole are useful as practical examples. You can copy the blueprints and useare useful as practical examples. You can copy the blueprints and use them as
them as starting points for your own, or just refer to them when you createstarting points for your own, or just refer to them when you create something
something similar.similar.
In this case study, we'll start by discussing the high level organization of the
In this case study, we'll start by discussing the high level organization of the
Dreamfort blueprint set, using the "surface" blueprints as an example. Then
Dreamfort blueprint set, using the "surface" blueprints as an example. Then
@ -1264,34 +1263,26 @@ the toil associated with applying so many blueprints.
The single most effective way to make your blueprint sets easier to use is to
The single most effective way to make your blueprint sets easier to use is to
group them with `meta blueprints <quickfort-meta>`
group them with `meta blueprints <quickfort-meta>`
blueprints, each logical "step" generally takes more than one blueprint. For
blueprints, each logical "step" generally takes more than one blueprint. For
example, setting up pastures with a `` #zone `` blueprint, placing starting
example, with `` #meta `` blueprints, setting up pastures with a `` #zone ``
stockpiles with a #place blueprint, building starting workshops with a
blueprint, placing starting stockpiles with a `` #place `` blueprint, building
`` #build `` blueprint, and configuring the stockpiles with a `` #query `` blueprintstarting workshops with a `` #build `` blueprint, and configuring the stockpiles
can all be done at once. Bundling blueprints like this reduced the number of
with a `` #query `` blueprint can all be done with a single command. Bundling
steps in Dreamfort from 47 to 24, and it also made it much clearer to see which
blueprints with `` #meta `` blueprints reduced the number of steps in Dreamfort
blueprints can be applied at once without unpausing the game. Check out
from 61 to 23, and it also made it much clearer to see which blueprints can be
dreamfort_surface's "`meta
applied at once without unpausing the game. Check out dreamfort_surface's "`meta
<https://docs.google.com/spreadsheets/d/
<https://docs.google.com/spreadsheets/d/1vlxOuDOTsjsZ5W45Ri1kJKgp3waFo8r505LfZVg5wkU/edit#gid=972927200> `__"
1vlxOuDOTsjsZ5W45Ri1kJKgp3waFo8r505LfZVg5wkU/edit#gid=972927200>`__" sheet to
sheet to see how much meta blueprints can simplify your life.
see how much meta blueprints can simplify your life.
You can define `as many blueprints as you want <quickfort-packaging>`
Note that one of the `` #meta `` blueprints just has one line. In this case, the
sheet, but multi-blueprint sheets are especially useful when writing meta
`` #meta `` blueprint isn't strictly necessary. The referenced blueprint couldblueprints. It's like having a bird's eye view of your entire plan in one sheet.
just be applied directly. However, quickfort lists blueprints in the order that
it reads them, and we chose to make a one-blueprint meta blueprint to ensure all
the steps appear in order in the quickfort list output.
By the way, you can define `as many blueprints as you want
<quickfort-packaging> ` on one sheet, but multi-blueprint sheets are
especially useful when writing meta blueprints. It's like having a bird's eye
view of your entire plan in one sheet.
.. topic :: Tip.. topic :: Tip
Keep the blueprint list uncluttered with hidden() markers.
Keep the blueprint list uncluttered by using `` hidden() `` markers.
If a blueprint is bundled into a meta blueprint, it does not need to appear in
If a blueprint is bundled into a meta blueprint, it does not need to appear in
the quickfort list output since you won't be running it directly. Add a
the `` quickfort list `` output since you won't be running it directly. Add a
`hidden() marker <quickfort-hidden>` `hidden() marker <quickfort-hidden>`
output tidy. You can still access hidden blueprints with `` quickfort list
output tidy. You can still access hidden blueprints with `` quickfort list
--hidden`` if you need to -- for example to reapply a partially completed
--hidden`` if you need to -- for example to reapply a partially completed
@ -1324,7 +1315,7 @@ sheet, like in surface's meta sheet.
.. topic :: Tip.. topic :: Tip
Use message() markers to remind yourself what to do next.
Use `` ``
`Messages <quickfort-message>` `Messages <quickfort-message>`
things to include in messages are:
things to include in messages are:
@ -1336,12 +1327,11 @@ things to include in messages are:
zones
zones
These things are just too easy to forget. Adding a `` message() `` can save you
These things are just too easy to forget. Adding a `` message() `` can save you
from time-wasting mistakes. Note that message() markers can still appear on the
from time-wasting mistakes. Note that `` message() `` markers can still appear on
`` hidden() `` blueprints, and they'll still get shown when the blueprint is runthe `` hidden() `` blueprints, and they'll still get shown when the blueprint is
via a `` #meta `` blueprint. For an example of this, check out the `zones sheet
run via a `` #meta `` blueprint. For an example of this, check out the `zones
<https://docs.google.com/spreadsheets/d/
sheet <https://docs.google.com/spreadsheets/d/1vlxOuDOTsjsZ5W45Ri1kJKgp3waFo8r505LfZVg5wkU/edit#gid=1226136256>`__
1vlxOuDOTsjsZ5W45Ri1kJKgp3waFo8r505LfZVg5wkU/edit#gid=1226136256>`__ where the
where the pastures are defined.
pastures are defined.
The farming_ level: fun with stockpiles
The farming_ level: fun with stockpiles
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -1365,11 +1355,13 @@ stockpiles. Note the `careful customization
wsszA1AnFqoxeoehByg/edit#gid=486506218>`__ of the food stockpiles and the
wsszA1AnFqoxeoehByg/edit#gid=486506218>`__ of the food stockpiles and the
stockpile chains set up with the `` give* `` aliases. This is so when multiple
stockpile chains set up with the `` give* `` aliases. This is so when multiple
stockpiles can hold the same item, the largest can keep the smaller ones filled.
stockpiles can hold the same item, the largest can keep the smaller ones filled.
If you have multiple stockpiles holding the same type on different z-levels,
For example the `` give2up `` alias funnels seeds from the seeds feeder pile to
though, this can be tricky to set up with a blueprint. Here, the jugs and pots
the container-enabled seed storage pile. If you have multiple stockpiles holding
stockpiles must be manually linked to the quantum stockpile on the industry
the same type on different z-levels, though, this can be tricky to set up with a
level, since we can't know beforehand how many z-levels away that is. Note how
blueprint. Here, the jugs and pots stockpiles must be manually linked to the
we call that out in the `` #query `` blueprint's `` message() `` .
quantum stockpile on the industry level, since we can't know beforehand how many
z-levels away that is. Note how we call that out in the `` #query `` blueprint's
`` message() `` .
.. topic :: Tip.. topic :: Tip
@ -1377,7 +1369,7 @@ we call that out in the ``#query`` blueprint's ``message()``.
Hauling routes are notoriously fiddly to set up, but they can be automated with
Hauling routes are notoriously fiddly to set up, but they can be automated with
blueprints. Check out the Southern area of the `` #place `` and `` #query ``
blueprints. Check out the Southern area of the `` #place `` and `` #query ``
blueprints for how the quantum garbag e dump is configured with simple aliases
blueprints for how the quantum refus e dump is configured with simple aliases
from the alias library.
from the alias library.
The industry_ level: when not to use aliases
The industry_ level: when not to use aliases
@ -1397,15 +1389,14 @@ It may be tempting to put all query blueprint key sequences into aliases to make
them easier to edit, keep them all in one place, and make them reusable, but
them easier to edit, keep them all in one place, and make them reusable, but
some key sequences just aren't very valuable as aliases.
some key sequences just aren't very valuable as aliases.
`Check out <https://docs.google.com/spreadsheets/d/1gvTJxxRxZ5V4vXkqwhL-
`Check out <https://docs.google.com/spreadsheets/d/1gvTJxxRxZ5V4vXkqwhL-qlr_lXCNt8176TK14m4kSOU/edit#gid=787640554> `__
qlr_lXCNt8176TK14m4kSOU/edit#gid=787640554>`__ the Eastern (goods) and Northern
the Eastern (goods) and Northern (stone and gems) quantum stockpiles -- cells
(stone and gems) quantum stockpiles -- cells I19 and R10. They give to the
I19 and R10. They give to the jeweler's workshop to prevent the jeweler from
jeweler's workshop to prevent the jeweler from using the gems held in reserve
using the gems held in reserve for strange moods. The keys are not aliased since
for strange moods. The keys are not aliased since they're dependent on the
they're dependent on the relative positions of the tiles where they are
relative positions of the tiles where they are interpreted, which is easiest to
interpreted, which is easiest to see in the blueprint itself. Also, if you move
see in the blueprint itself. Also, if you move the workshop, it's easier to fix
the workshop, it's easier to fix the stockpile link right there in the blueprint
the stockpile link right there in the blueprint instead of editing a separate
instead of editing a separate alias definition.
alias definition.
There are also good examples in the `` #query `` blueprint for how to use the
There are also good examples in the `` #query `` blueprint for how to use the
`` permit `` and `` forbid `` stockpile aliases.`` permit `` and `` forbid `` stockpile aliases.
@ -1437,15 +1428,19 @@ However, in quickfort there are no guarantees about which cell will be
processed first. In the example above, we obviously intend for the food
processed first. In the example above, we obviously intend for the food
stockpile to have tallow exclusively permitted, then to add dye. It could happen
stockpile to have tallow exclusively permitted, then to add dye. It could happen
that the two aliases are applied in the opposite order, though, and we'd end up
that the two aliases are applied in the opposite order, though, and we'd end up
with dye being permitted, then everything being forbidden and tallow being
with dye being permitted, then everything (including dye) being forbidden, and,
enabled. To make sure you always get what you want, write order-sensitive
finally, tallow being enabled. To make sure you always get what you want, write
aliases on the same line::
order-sensitive aliases on the same line::
#place Declare a food stockpile
#place Declare a food stockpile
f(3x3)
f(3x3)
#query Properly configure a food stockpile to accept tallow and dye
#query Properly configure a food stockpile to accept tallow and dye
{tallow}{permitdye}
{tallow}{permitdye}
You can see a more complex example of this with the `` meltables `` stockpiles in
the `lower right corner <https://docs.google.com/spreadsheets/d/1gvTJxxRxZ5V4vXkqwhL-qlr_lXCNt8176TK14m4kSOU/edit#gid=787640554> `__
of the industry level.
The services_ level: handling multi-level dig blueprints
The services_ level: handling multi-level dig blueprints
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -1460,15 +1455,18 @@ priorities <quickfort-dig-priorities>`.
Use dig priorities to control ramp creation.
Use dig priorities to control ramp creation.
We can `ensure <https://docs.google.com/spreadsheets/d/1IBy6_pGEe6WSBCLukDz_5I-
We can `ensure <https://docs.google.com/spreadsheets/d/1IBy6_pGEe6WSBCLukDz_5I-4vi_mpHuJJyOp2j6SJlY/edit#gid=962076234> `__
4vi_mpHuJJyOp2j6SJlY/edit#gid=962076234>`__ the bottom level is carved out
the bottom level is carved out before the layer above is channelled by assigning
before the layer above is channelled by assigning the channel designations lower
the channel designations lower priorities (the `` h5 ` ` \s in the third layer --
priorities (row 76). This is easy to do here because it's just one tile and
scroll down).
there is no chance of cave-in.
An alternative is to have a follow-up blueprint that removes any undesired
An alternative is to have a follow-up blueprint that removes any undesired
ramps. We did this on the surface and farming levels with the miasma vents to
ramps. We did this on the
avoid the complication of setting detailed dig priorities over such large areas.
`surface <https://docs.google.com/spreadsheets/d/1vlxOuDOTsjsZ5W45Ri1kJKgp3waFo8r505LfZVg5wkU/edit#gid=1790750180> `__
and
`farming <https://docs.google.com/spreadsheets/d/1iuj807iGVk6vsfYY4j52v9_-wsszA1AnFqoxeoehByg/edit#gid=436537058> `__
levels with the miasma vents since it would be too complicated to synchronize
the digging between the two layers.
The guildhall_ level: avoiding smoothing issues
The guildhall_ level: avoiding smoothing issues
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
lethosor