# Quickfort blueprint library

This guide contains a high-level overview of the blueprints available in the quickfort blueprint library.

Each file is hyperlinked to its online version so you can see exactly what the blueprints do before you run them. Also, if you use gui/quickfort, you will get a live preview of which tiles will be modified by the blueprint before you apply it to your map.

## Whole fort blueprint sets

These files contain the plans for entire fortresses. Each file has one or more help sections that walk you through how to build the fort, step by step.

- library/dreamfort.csv

- library/quickfortress.csv

### Dreamfort

Dreamfort is a fully functional, self-sustaining fortress with defenses, farming, a complete set of workshops, self-managing quantum stockpiles, a grand dining hall, hospital, jail, fresh water well system, guildhalls, noble suites, and bedrooms for hundreds of dwarves. It also comes with manager work orders to automate basic fort needs, such as food, booze, and item production. It can function by itself or as the core of a larger, more ambitious fortress. Read the high-level walkthrough by running `quickfort run library/dreamfort.csv` and list the walkthroughs for the individual levels by running `quickfort list -l dreamfort -m notes` or `gui/quickfort dreamfort notes`.

Dreamfort blueprints are available for easy viewing and copying online.

The online spreadsheets also include embark profile suggestions, a complete example embark profile, and a convenient checklist from which you can copy the `quickfort` commands.

If you like, you can download a fully built Dreamfort-based fort from dffd, load it, and explore it interactively.

#### Visual overview

Here are annotated screenshots of the major Dreamfort levels (or click here for a slideshow).

##### Surface level

##### Farming level

##### Industry level

##### Services level

###### Example plumbing to fill cisterns

##### Guildhall level

##### Noble suites

##### Apartments

### The Quick Fortress

The Quick Fortress is an updated version of the example fortress that came with Python Quickfort 2.0 (the utility that inspired DFHack quickfort). While it is not a complete fortress by itself, it is much simpler than Dreamfort and is good for a first introduction to quickfort blueprints. Read its walkthrough with `quickfort run library/quickfortress.csv` or view the blueprints online.

## Layout helpers

These files simply draw diagonal marker-mode lines starting from the cursor. They are especially useful for finding the center of the map when you are planning your fortress. Once you are done using them for alignment, use `quickfort undo` at the same cursor position to make them disappear. Since these `#dig` blueprints can only mark undug wall tiles for mining, they are best used underground. They won’t do much on the surface, where there aren’t many walls.

- library/layout-helpers/mark_up_left.csv

- library/layout-helpers/mark_up_right.csv

- library/layout-helpers/mark_down_right.csv

- library/layout-helpers/mark_down_left.csv

## Bedrooms

These are popular bedroom layouts from the Bedroom design page on the wiki. Each file has `#dig`, `#build`, and `#query` blueprints to dig the rooms, build the furniture, and configure the beds as bedrooms, respectively.

- library/bedrooms/48-4-Raynard_Whirlpool_Housing.csv

- library/bedrooms/95-9-Hactar1_3_Branch_Tree.csv

- library/bedrooms/28-3-Modified_Windmill_Villas.csv

## Tombs

These blueprints have burial plot layouts for fortress that expect a lot of casualties.

- library/tombs/Mini_Saracen.csv

- library/tombs/The_Saracen_Crypts.csv

## Exploratory mining

Several mining patterns to choose from when searching for gems or ores. The patterns can be repeated up or down z-levels (via quickfort’s `--repeat` commandline option) for exploring through the depths.

- library/exploratory-mining/tunnels.csv

- library/exploratory-mining/vertical-mineshafts.csv

- library/exploratory-mining/connected-mineshafts.csv

## Miscellaneous

Extra blueprints that are useful in specific situations.

- library/aquifer_tap.csv

- library/embark.csv

- library/pump_stack.csv

### Light aquifer tap

The aquifer tap helps you create a safe, everlasting source of fresh water from a light aquifer. See the step-by-step guide, including information on how to create a drainage system so your dwarves don’t drown when digging the tap, by running `quickfort run library/aquifer_tap.csv -n /help`.

You can see how to nullify the water pressure (so you don’t flood your fort) in the Dreamfort screenshot above.

The blueprint spreadsheet is also available online.

### Post-embark

The embark blueprints are useful directly after embark. It contains a `#build` blueprint that builds important starting workshops (mason, carpenter, mechanic, and craftsdwarf) and a `#place` blueprint that lays down a pattern of useful starting stockpiles.

### Pump stack

The pump stack blueprints help you move water and magma up to more convenient locations in your fort. See the step-by-step guide for using it by running `quickfort run library/pump_stack.csv -n /help`.

The blueprint spreadsheet is also available online.