Dwarf Fortress Wiki - User contributions [en]

User talk:Soundandfury/DF Designer

2012-07-27T00:17:35Z

Soundandfury: /* Compiling on MacOSX */ Thanks for the reports

== Compiling on MacOSX ==

HebaruSan's 0.12 version for OSX didn't run for me, I think because it is a 32-bit executable and my system is 64 (in particular, my SDL libraries are).

So, I decided to try compiling the lastest version myself. I cloned the repository, and checked out the lastest release tag, which is 0.16.3 as of this writing. Without any changes, running `make` gives some errors, but they are actually all benign and the executable ./bin/designer is successfully built and runs perfectly.

* The same dependencies as Linux must be installed, I use [http://mxcl.github.com/homebrew/ Homebrew], but the process should be similar for any other OSX package manager.
** brew install sdl
** brew install sdl_image
** brew install sdl_ttf
* Apple's command line developer tools must also be installed; they are freely available from Apple.

'''Notes'''

* The symlink to ./bin/designer is not created, because the --symbolic option to `ln` is a GNU thing and is not recognized by BSD's `ln`.
** Can be fixed by changing --symbolic to -s in the Makefile
* Lots of errors from mkdir about directories that already exist, which are harmless, but can be squelched by adding the -p option to mkdir.
* A handful of linker errors, which appear to be benign.

:Great, glad to hear it builds OK. I'll incorporate those fixes into the next release, whenever that happens. (DFD development has been dormant for quite a while now) [[User:Soundandfury|soundandfury]] 00:17, 27 July 2012 (UTC)

v0.31:Forbid

2011-04-01T06:16:32Z

Soundandfury: Rated article "Exceptional" using the rating script

{{quality|Exceptional|06:16, 1 April 2011 (UTC)}}
{{av}}

An item that is forbidden will never be handled by your dwarves. It is the opposite of {{L|reclaim}}. For example, {{L|stone}}s that have been forbidden will not appear in the {{L|construction}} menu, and will not be used at {{L|workshop}}s. If a forbidden object is on a build site, the building will be suspended and an announcement will appear informing the player that the build site is blocked.

==Forbidding items==
*In order to forbid a specific item, use {{k|k}} and scroll over the item you wish to forbid. Then press {{k|f}} in order to toggle the forbidden state of the item.

*In order to mass forbid entire swathes of items, use the {{k|d}}-{{k|b}}-{{k|f}} keys and designate items with either the keyboard or the mouse.

*In order to prevent your dwarves from using a specific workshop, press {{k|t}} and forbid the materials that the workshop is made of.

==Uses of forbidding items==
*Dwarves in {{L|strange mood}}s can be directed to materials of your choice by selectively forbidding objects.

*Preventing dwarves from looting the bodies of your enemies (or friends) during a {{L|siege}} by forbidding items on the battlefield is generally a good idea. You can also go to the Forbid orders menu with {{k|o}}-{{k|F}} to make these forbidden by default.

{{Category|Designations}}
{{Category|Fortress mode}}

v0.31:Miasma

2011-04-01T06:14:31Z

Soundandfury: Rated article "Fine" using the rating script

{{quality|Fine|06:14, 1 April 2011 (UTC)}}{{av}}

A cloud of purple stench that makes your {{l|dwarves}} unhappy. Only occurs in subterranean areas. Caused by rotting items such as untanned hides, chunks and dead {{l|vermin}}.
Does not pass through dwarves.

To avoid miasma, either keep anything rotten outside or alternatively have an inside {{l|refuse}} pile on its own in a room with several {{l|door}}s; this should halt the miasma's advance (although the room itself will still stink up). It will also not spread diagonally, so one possible solution is to have the only entrance be diagonal.

Another option is to have a long garbage chute where refuse is {{l|dump}}ed down. If it is long enough the miasma will not be able to reach all the way to the top, preventing your dwarves from getting unhappy thoughts.

A creative way of constructing garbage chutes is to separate the garbage area and dumping area (where dwarves are) with {{l|hatch}}es linked to a {{l|pressure plate}}. That way garbage will land on the hatch, which will open (triggered by dwarf returning to his duties stepping on a plate), letting it fall down and then close, keeping all the miasma inside. This allows one to construct a short, yet non-smelly chute.

Another option for a short non-smelly chute is to let the chute be seperated diagonally from the dumping square(s). Since miasma does not travel across corners, this allows a chute stretching across 2 z-levels to be completly miasma free, without needing additional mechanisms. The simplest form is to dig in one square into the wall, and then channel one square diagonally from this square. Designate the first square as a garbage dump.

Note that all versions of DF2010 have a bug in which dwarves interrupted in the middle of a meal will abandon their food, and food abandoned in this manner can never be interacted with (picked up, stored, or dumped) by any dwarf ever again, including the dwarf who abandoned it. If the food is abandoned underground, it will eventually begin generating miasma. This is an especially frequent occurrence with soldiers, who will often be interrupted while consuming their rations when a training class begins.

v0.31:Multiply value

2011-04-01T06:12:35Z

Soundandfury: Rated article "Fine" using the rating script

{{quality|Fine|06:12, 1 April 2011 (UTC)}}{{av}}

An animal's '''multiply_value''' affects the {{L|item value|value}} of animal products such as meat, raw hides, silk thread, and anything made from these raw materials, including leather or silk clothing. While it's possible for multiply_value to apply to only specific parts of a creature, all non-modded creatures have use SELECT_MATERIAL:ALL, so all parts of the animal are multiplied.

{| class="wikitable" border=1
|-
! multiply_value
! Animal names
|-
|x15||[[Dragon]], [[Roc]]
|-
|x10||[[Hydra]]
|-
|x5||[[Elephant]], [[Sea serpent]], [[Sea monster]], [[Giraffe]], [[Rhinoceros]]
|-
|x4||[[Giant eagle]], [[Voracious cave crawler]], [[Jabberer]], [[Cave dragon]], [[Giant lion]], [[Giant leopard]], [[Giant jaguar]], [[Giant tiger]], [[Giant cheetah]], [[Giant desert scorpion]], [[Unicorn]], [[Cave crocodile]], [[Giant toad]], [[Giant olm]], [[Giant bat]], [[Giant cave spider]]
|-
|x3||[[Grizzly bear]], [[Alligator]], [[Lion]], [[Leopard]], [[Jaguar]], [[Tiger]], [[Cheetah]], [[Saltwater crocodile]], [[Polar bear]], [[Elk bird]], [[Green devourer]], [[Rutherer]], [[Draltha]], [[Blind cave bear]], [[Yeti]], [[Sasquatch]], [[Fire imp]]
|-
|x2||[[Black bear]], [[Cougar]], [[Wolf]], [[Musk ox]], [[Elk]], [[Magma crab]], [[Helmet snake]], [[Giant earthworm]], [[Molemarian]], [[Ice wolf]], [[Beak dog]], [[Strangler]], [[Giant rat]], [[Giant mole]], [[Purring maggot]], [[Giant cave swallow]]
|}

v0.31:Revealed tile

2011-04-01T06:07:20Z

Soundandfury: Rated article "Exceptional" using the rating script

{{quality|Exceptional|06:07, 1 April 2011 (UTC)}}{{av}}

A '''revealed tile''', in {{L|fortress mode}}, is any tile that has a description when loo{{k|k}}ed at.

All {{L|Tile attributes|above ground}} tiles on the map start out revealed, as do all tiles above the surface. All {{L|Tile attributes|subterranean}} tiles must be revealed by {{L|mining|digging}} into them. All tiles adjacent to a revealed tile will also be revealed: you can see what the rock walls adjacent to a mined-out tile are made of, for instance, and you can see the outermost tile of each z-level of a mountain. You can also see the tile immediately below where a downward or up/down {{L|stairs|stairway}} has been placed -- this is because building (or digging) the stairway removes the {{L|floor}} between the levels. Upward stairways do not reveal the level above, because they do not remove the floor/ceiling above the stairs.

Underground features like {{L|cavern}}s and {{L|Magma#Magma_pools|magma pool}}s start out hidden and must be discovered by miners. Upon breaching a feature, a message will be displayed informing the player of the discovery, and a chunk of the new feature "within view" of your dwarves will be revealed. See the Methods of exploration section of the {{L|cavern}}s article for information on safely revealing more of the underground.

[[Category:Map tiles]]

v0.31:Status icon

2011-04-01T06:06:15Z

Soundandfury: Rated article "Fine" using the rating script

{{quality|Fine|06:06, 1 April 2011 (UTC)}}{{av}}

[[Image:icons.gif]]

'''Status icons''' are symbols that flash when a creature is under a certain effect. When a creature has multiple status icons, they will flash in succession.

{{Tile|☺|4:1}}
flashes to...
* {{Tile|☺|4:0}} '''{{L|Legendary}}:''' The dwarf has a skill that has reached Legendary level. Take care of these fellows.

* {{Tile|X|0:1}} '''{{L|Immigration|Migrant}}:''' The dwarf has just arrived at your fortress and is still getting used to the place. They won't do any jobs while in this state, which doesn't last long.

* {{Tile|?|3:1}} '''No Job:''' The creature has no job and no destination. Tame animals will get this while they are being dragged to a {{L|restraint}}, {{L|cage}}, or {{L|butcher's shop}}.

* {{Tile|?|4:1}} '''No Destination:''' The creature has a job, but no destination. They get this when you shut a door on their faces. Also momentarily flashes when they first get a job.

* {{Tile|-|2:1}}{{Tile|\|2:1}}{{Tile|||2:1}}{{Tile|/|2:1}}{{Tile|-|2:1}} '''Multiple Creatures:''' More than one creature is on the same tile. The game will switch between them using this animated line.

* {{Tile|↓|6:0}} '''Hungry:''' Dwarf needs {{L|food}} badly.

* {{Tile|↓|1:1}} '''Thirsty:''' The creature needs {{L|water}} or {{L|alcohol}}.

* {{Tile|↓|7:0}} '''Drowsy:''' The dwarf wants {{L|sleep}}.

* {{Tile|↓|4:1}} '''Unhappy:''' The dwarf's unhappy thoughts are piling up. Not a good sign for a fortress, as this can lead to tantrums.

* {{Tile|Z|0:1}} '''{{L|Sleep|Sleeping}}:''' This dwarf is not going to be productive, and the object it is sleeping on will have an effect on its mood. A dwarf is considered unconscious while sleeping and has all the effects thereof, but not the unconsciousness icon.

* {{Tile|!|7:1}} '''{{L|Strange mood|Fey Mood}}:''' The dwarf will find a workshop, get materials, and make an artifact. After this, it will have a skill increase to {{L|Legendary}}, along with attributes. If it cannot find the required workshop or items, it will wait until it goes insane, berserk, or melancholy.

* {{Tile|!|5:1}} '''Possessed:''' The same thing as {{L|fey mood}}, but without the skill increase.

* {{Tile|!|7:0}} '''Secretive Mood:''' The same thing as {{L|fey mood}}, though with more cryptic clues.

* {{Tile|!|5:0}} '''Fell Mood:''' Similar to a {{L|fey mood}}, though resulting in a dwarf being murdered.

* {{Tile|!|0:1}} '''Macabre Mood:''' Similar to a fell mood, though not requiring the death of a dwarf.

* {{Tile|!|6:1}} '''{{L|Tantrum}}:''' The dwarf has finally had enough, and has lost his temper. The dwarf stops all work, and proceeds to throw things, destroy buildings and hurt other dwarves. This is not a permanent state, but extremely annoyed dwarves will tantrum repeatedly.

* {{Tile|!|3:1}} '''{{L|Insane}}:''' Dwarves may eventually go crazy and babble, leading to this icon (usually because they couldn't complete an artifact). Dwarf moves erratically around while randomly removing and dropping articles of clothing until he/she dies of hunger or thirst. A form of madness.

* {{Tile|!|1:1}} '''{{L|Melancholy}}:''' When a dwarf has sad thoughts for a very long time, it may lead to this. Dwarf sulks around very slowly until he/she dies of hunger or thirst, or tries to kill himself by drowning or chasm. A form of madness.

* {{Tile|!|4:1}} '''{{L|Berserk}}:''' If a dwarf is extremely unhappy for too long, he/she may snap and enter a homicidal rage, attacking everyone in sight. A form of madness, and extremely dangerous.

* {{Tile|!|1:0}} '''Traumatized:''' The creature has experienced things no creature should ever have to experience, and is in a permanent state of shock, endlessly staring off into space.

* {{Tile|!|4:0}} '''Enraged:''' When a creature is faced with insurmountable odds, particularly after another creature nearby is killed, it may become angry and attack with rushes and powerful hits.

* {{Tile|!|2:1}} '''Martial Trance:''' When a single dwarf is being attacked by more than one enemy, it will fall into this state and supposedly focus better. [[Toady One]] has [http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=12&t=000037 said]: ''You have to be a dwarf [to be able to get the martial trance]. It improves all kinds of combat rolls and modifiers (but no direct damage bonus -- 'enraged' does that).'' Dwarves in this state will seek fights with enemy or neutral creatures.

* {{Tile|☺|4:5:1}} '''{{L|Wrestling}}:''' It is grabbing, or attempting to grab, another creature in a fight. Could also be holding on to a part of the opponent as well.

* {{Tile|+|6:7:1}} '''Minor {{L|Wound|Injury}}:''' Any wound that leaves only one hand in working condition, including severings.

* {{Tile|+|4:7:1}} '''Major {{L|Wound|Injury}}:''' Loss of the use of a leg, both arms, or a fatal injury to a vital organ that hasn't killed the dwarf yet. Yellow or worse damage to any of the brain, throat, heart, guts, or both lungs are all mortal wounds. Yellow or worse damage to one lung is typically not fatal, but this status flag will remain on the dwarf permenantly as he goes about his day.

* {{Tile|☼|3:1}} '''[[Combat#Paralysis|Paralyzed]]:''' The creature cannot move. Caused by poison or severe brain damage.

* {{Tile|X|3:1}} '''Stunned:''' Dwarves can be stunned because of pain, and may lead to unconsciousness. Cave spider bites also cause periodic stunning. May also occur from a fall, usually from a dodge or a {{L|cave-in}}, or as a result of minor {{L|cave adaptation}}.

* {{Tile|X|2:1}} '''Nausea:''' Can be caused by {{L|cave adaptation}}, and will cause {{L|vomit}}, or during combat, when one spears another through the vital organs in the abdomen.

* {{Tile|X|7:0}} '''Winded:''' When a dwarf is out of breath, they are winded. This can be caused by being underwater, having a lung pierced or throat torn out.

* {{Tile|X|7:1}} '''Unconscious:''' A bad sign for a dwarf, since (other than sleeping) they usually become unconscious in a fight and will die shortly afterwards. Sometimes, pain or permanent spinal injuries will make a dwarf periodically fall unconscious. Regardless of the cause, any creature that falls unconscious on a {{L|trap}} will trigger it, with messy and/or humorous results.

* {{Tile|X|4:7:1}} '''Fevered:''' This dwarf has a fever. Exact results of a fever are unknown, but may indicate other health problems.

In addition to the above symbols, creatures {{L|hauling}} an object will alternate between their usual icon and the icon of the object they are carrying.

==Non-flashing==

* {{Tile|☺|4:6:1}} '''Prone:''' The creature is lying on the ground. Several prone creatures can be in the same tile; therefore, in tight corridors, dwarves will be constantly lying down and standing so they can go through. Also happens in combat. Make sure to remember to {{k|s}}tand up if this happens in Adventure Mode.

* {{Tile|☺|4:3:1}} '''Airborne:''' The creature has been thrown by a wrestling move, flung into the air by a raising drawbridge, fallen off a cliff, gone over a waterfall or gotten smashed by a blunt weapon and is flying backwards from the force of the blow. It's impossible to {{k|v}}iew a creature in this state (though it is possible to loo{{k|k}}) – but you'd probably be better off covering your eyes, anyway. Creatures that are flying under their own power are displayed normally.

* {{Tile|☺|1:1:1}} '''{{L|Swimmer#Drowning|Drowning}}:''' The creature is drowning. Large {{L|fish}} normally appear this way, except when in shallow water (in which case they are air-drowning).

* {{Tile|☺|4:7:1}} '''Webbed:''' The icon that shows when a creature walks into a {{L|giant cave spider}}'s web.

* {{Tile|☺|0:5:0}} '''Last seen:''' Indicates a hidden tile that contained a creature when last visible. Adventure mode only.

* {{Tile|☺|4:4:1}} '''Dead:''' This dwarf is gone, far away from the horrors of the puppy-cooking, noble-drowning fortress. Legendary dwarves and foes will still alternate colors after death.

{{Game Interface FAQ}}

{{Category|Interface}}
{{Category|Creatures}}
{{Category|Dwarves}}
{{Category|Thoughts}}

v0.31:Steam

2011-04-01T06:03:32Z

Soundandfury: Rated article "Fine" using the rating script

{{quality|Fine|06:03, 1 April 2011 (UTC)}}{{av}}

'''Steam''' is created from the mixing of {{L|magma}} and {{L|water}}. This is distinct from {{L|mist}}, a similar looking product of water falling, or {{L|smoke}}.

Steam is capable of causing massive {{L|wound|injuries}} and death.

Another product of water and magma mixing is {{L|obsidian}}.

[[Category:World]]

v0.31:Tax collector

2011-04-01T06:01:58Z

Soundandfury: Rated article "Fine" using the rating script

{{quality|Fine|06:01, 1 April 2011 (UTC)}}{{av}}

In previous versions the arrival of the Tax collector and [[Baron]] would signal the beginning of the [[Dwarven economy]], a feature that is disabled in DF2010. [[Toady One]] has stated that the Dwarven economy may return after sweeping changes are made.

You can change the raws to allow Tax Collectors to be appointed by others nobles like the mayor, but that still won't activate the Dwarven economy.

{{Noble
| noble= Tax Collector
| office= Office
| quarters= Modest Quarters
| dining= Modest Dining Room
| stands=1
| racks=1
| chests=2
| cabinets=1
}}

{{Nobles}}
{{Category|Entourage}}

v0.31:General

2011-04-01T05:58:56Z

Soundandfury: Rated article "Tattered" using the rating script

{{quality|Tattered|05:58, 1 April 2011 (UTC)}}
{{av}}
{{Noble
| noble= General
| office= Decent Office
| quarters= Quarters
| dining= Dining Room
| tomb= Grave
| stands=3
| racks=3
| chests=2
| cabinets=1
}}

{{Nobles}}

v0.31:Repeater

2011-04-01T05:55:56Z

Soundandfury: Rated article "Exceptional" using the rating script

{{quality|Exceptional|05:55, 1 April 2011 (UTC)}}{{av}}
A '''repeater''' is a device which creates a never-ending cyclic on/off signal. Several designs are possible, and they can be made to operate at varying rates. They (usually) use fluid or creatures to trigger pressure plates to create a cycle, continually trigger the plates, which can then also be linked to automatically and ceaselessly trigger external systems.

Fluid uses the natural flow and varying depths to trigger plates. Creatures use {{L|path|pathing}}, opening and closing doors to attract the creature to step on the plates.

As a general warning, always have a way to turn off the repeater, and/or allow your dwarves later access for repairs or modifications.

===Fluid repeater===

One example {{L|fluid logic}} repeater (described on the [http://www.bay12games.com/forum/index.php?topic=33563.msg495183#msg495183 forum] by [http://www.bay12games.com/forum/index.php?action=profile;u=16168 AncientEnemy]) is as follows:

≈≈≈≈≈ - river or brook
═╗≈╔═ - wall to channel out after construction
╠F╣ - shutoff floodgate ''(linked to exterior lever)''
║#║ - 1-tile drawbridge (linked to pressure plate)
║p┼ - pressure plate (set to 7-7 water), and access door
╠F╣ - floodgate (linked to pressure plate)
╚═╝

This repeater toggles fairly slowly, about once every 300 steps, making it suitable for operating {{L|bridge|bridges}}, {{L|floodgate|floodgates}}, and {{L|Trap#Upright Spear/Spike|upright spikes}}. As an added bonus, the bottom wall (immediately beyond the floodgate) can be removed and connected to a cistern whose water level will be automatically maintained at a level between 3 and 4 deep.

===Goblin repeater===

This is not as regular a repeater, but just as reliable in the long run.

A goblin or creature is placed (via {{L|Activity_zone#Pit.2FPond|pitting}}) in a loosely circular hall with one {{L|door}} and one {{L|bridge#Drawbridges|drawbridge}} leading to a single path out. Beyond these is the bait - an exit, a {{L|restraint|restrained}} animal, or just your fortress in general - something the creature wants1. One path is open, and the goblin heads that way to kill the animal. A pressure plate is stepped on, which shuts one path and opens the other2 (and triggers an exterior system). The goblin reconsiders his path, and heads back around for the other hallway - where the process is repeated.

# For instance, if using a {{L|rhesus macaque}}, some item of value would suffice to attract the creature.
# Doors and drawbridges open alternately when connected to a {{L|trigger}}.

A A = bait animal (or similar)
╔════════════╝ ╚═══════════╗
║ ┼║ ┼ ║ ┼ = access (bridge or door), currently open
║ ╔═════════════════════╗ ║ ┼║= access, currently shut
║ ║ ║ ║
║ ╚═════════════════════╝ ║ P = pressure plate
║ g -> P ║ g = goblin, w/ current path
╚═══════════════════════════╝

The only caveat is to make sure there is enough room between the pressure plate and door/bridge, to give them time to shut well before the goblin gets there. Additional mechanized doors or a cage trap may be desired if you ever wish to "turn off" the repeater without killing the goblin/creature (by safely isolating it).

===Pump-based repeater===

This repeater will send regular signals at a frequency determined by the speed of {{L|pressure plate}} recovery. The basic design consists of 4 {{L|screw pump}}s and 4 {{L|pressure plate}}s but other versions are possible, depending on the number of separate steps you need.

[http://www.bay12games.com/forum/index.php?topic=34407.msg572324#msg572324 Forum thread] with description and explanations.

[http://mkv25.net/dfma/movie-1370-pump-basedautorepeater DFMA movie] showing a pump-based repeater in action.

See also: [[User:MrFake/NStepCyclicRepeater]]

See also: [[User:SL/Logic_Gates#Repeater]] for a more compact single repeater.

{|
|-
|Level 0
|Level -1
|Level -2
|-
|{{diagram|color=#808080|
██████
██[#ff0]☼███
█[#00f]☼[#c0c0c0]☼[#c0c0c0]☼[#808000]═[#808000]═
███[#c0c0c0]☼[#f00]☼█
███[#0f0]☼██
██████}}
|{{diagram|color=#808080|
██████
█[#000]█[#0f0]÷[#008000]÷[#000]██
█[#008000]÷██[#0f0]÷█
█[#0f0]÷██[#008000]÷█
█[#000]█[#008000]÷[#0f0]÷[#000]██
██████}}
|{{diagram|color=#808080|
██████
█[#f00]^██[#0f0]^█
██████
██████
█[#ff0]^██[#00f]^█
██████}}
|}

{{Raw Tile|÷|#0f0|#000}}{{Raw Tile|÷|#008000|#000}} is a screw pump which pumps from the light side to the dark side. {{Raw Tile|^|#f00|#000}} is a pressure plate which disengages gear {{Raw Tile|☼|#f00|#000}} when water of depth 1-7 lands on it. The red, green, blue, and yellow pressure plates and gears are color coded only to show which is linked to which. In the game they'll all look like {{Raw Tile|^|#f0f|#000}} and {{Raw Tile|☼|#c0c0c0|#000}}. Building a pump after the gear which powers it or a gear after the pressure plate which disengages it will introduce a 1-step delay; so, depending on build order, the repeater might have a period between 400 and 408 steps. If the pumps, gears, and pressure plates are built in that order, then this system will repeat every 400 steps, exactly. Start the repeater by using a pond zone to dump 2 buckets of water onto any one of the plates.

{{Category|Constructions}}
{{Category|Computing}}

See also: [[User:Hash/SelfPoweredHaltableRepeater]]

v0.31:Ice

2011-04-01T05:52:41Z

Soundandfury: Rated article "Fine" using the rating script

{{quality|Fine|05:52, 1 April 2011 (UTC)}}{{av}}

== Ice as a stone ==

Ice appears as a light blue stone which can be found by mining through an ice wall (such as that created when a river freezes). Ice boulders and objects made of ice will melt after some time when exposed to warmer temperatures (such as inside a fortress), giving it rather limited use; ice boulders can even melt while being carried by your dwarves, causing them to drop the item and resulting in a smear of water on the floor beneath them.

It is possible to build {{L|construction}}s out of ice, even inside a fortress (provided your dwarves move quickly enough to finish construction before the ice melts). These constructions are then stable even as temperature rises (some expections- archery range) -- pillars of ice walls can even be built within rooms that are later flooded with {{L|magma}} (though the walls become "warm", they will not melt).

Attempts to build {{L|workshop}}s out of ice will usually result in the ice melting immediately, a message "The dwarves were unable to complete the [workshop_name]", and the workshop construction being canceled completely. The exception is when building in a glacier environment the construction can be completed.

Ice cannot be used to craft. It's not possible to create doors, hatches, and other crafts from it.

The game refers to ice boulders as "water." It does not appear in any stockpile options or the manager, so it cannot be moved by designating a stockpile. Ice can be moved by {{L|dump}}ing it.

When ice melts inside a fortress, it becomes water, but the water does not leave mud when it evaporates. Melted ice is of no value as a water source.

Floors and walls made of ice will allow light through.

== Thawing and drowning ==
In fortress mode, frozen {{L|murky pool}}s will, when they thaw, do so instantly. Any dwarf standing on the ice will plunge into the water and drown (unless they have Adequate or better {{L|swimming}} skill, the fall will {{L|status icon|stun}} them). To reduce the chance of this happening, you can use {{L|traffic}} designations: mark the ice as restricted, and put a high traffic ring around the perimeter of the pool. Or, if you don't need to {{L|fish}} from it, you can {{L|construction|construct}} a {{L|wall}} around it or a {{L|floor}} over it.

Running magma under unmined ice will melt the ice. This appears to be the best way to turn large amounts of ice into water to use as a water source when all you have is ice and magma.

== Differences from previous versions ==

Squares which have had constructions built on them do not unfreeze (bug?)

== Constructing around ice ==
Using the smooth stone and carve fortification designations work as normal with ice.
However, if an {{L|aquifer}} or other source of water is present next to your new fortification, it will immediately freeze into an ice wall when the water flows into it.

User:Soundandfury/DF Designer

2011-01-06T01:40:23Z

Soundandfury: Update for 0.16.3 release

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.3 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.3) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12forums.com/smf/index.php?topic=45433.0 Forum thread]

[http://www.bay12forums.com/smf/index.php?topic=45433.90 Tutorial/walkthrough]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The 3-D view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|v}}.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|c}} and {{key|x}} respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,5 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,5 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
Image:Dfd_0_15_newgui.png|The newgui branch, while still experimental
Image:Dfd_0_16.png|After the newgui merge
</gallery>

User:Soundandfury/DF Designer

2010-10-11T12:13:38Z

Soundandfury: 0.16.2 Windows bugfix release

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.0 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.2) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12forums.com/smf/index.php?topic=45433.0 Forum thread]

[http://www.bay12forums.com/smf/index.php?topic=45433.90 Tutorial/walkthrough]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|v}}.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|c}} and {{key|x}} respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,6 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,6 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
Image:Dfd_0_15_newgui.png|The newgui branch, while still experimental
Image:Dfd_0_16.png|After the newgui merge
</gallery>

User:Soundandfury/DF Designer

2010-10-10T22:37:19Z

Soundandfury: 0.16.1, Windows-specific bugfix

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.0 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.1) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12forums.com/smf/index.php?topic=45433.0 Forum thread]

[http://www.bay12forums.com/smf/index.php?topic=45433.90 Tutorial/walkthrough]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|v}}.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|c}} and {{key|x}} respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,6 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,6 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
Image:Dfd_0_15_newgui.png|The newgui branch, while still experimental
Image:Dfd_0_16.png|After the newgui merge
</gallery>

User:Soundandfury

2010-10-10T22:13:03Z

Soundandfury: /* Logic Gates */ These are old now and I've more or less given up

==[[User:Soundandfury/DF_Designer|DF Designer]]==
My fort planning / building design utility

==Logic Gates==
Many months ago, back in 40d, I experimented a bit with dwarfputing. Here are some of the designs I used; I didn't really get very far, and then someone else went and built a whole computer fortress, so there's not much point now. Especially as, in 0.31, it takes all my effort just to Not Die.

===Fast latch gate===
1st
###
~c#
###

2nd
####
#^c#
####

3rd
####
++++.
####

1st c=S (hatch) 
2nd c=R, ^=Q 
Acts as an SR flipflop but without a not-Q output. Can be used in construction of a clocked SR. 

===Clocked SR===
1st
### ### #
~┼c# #c┼~c
### ### #

2nd
###########
#^c#c^#^^c#
###########

3rd
###########
+++++++++++.
###########

left to right: 
1st: ┼=S, c=CLK, c=CLK, ┼=R, c=Q1 
2nd: ^=Q1, c=Q, c=not-Q, ^=Q2, ^=notQ(0-1), ^=Q, c=Q2 
All ^ are 6-7 except where specified (ie. notQ) 
'''TESTED''': WORKS (but Q and not-Q swapped)

User:Soundandfury/DF Designer

2010-10-10T22:06:11Z

Soundandfury: Link to the new Tutorial (in the forum thread)

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.0 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.0) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12forums.com/smf/index.php?topic=45433.0 Forum thread]

[http://www.bay12forums.com/smf/index.php?topic=45433.90 Tutorial/walkthrough]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|v}}.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|c}} and {{key|x}} respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,6 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,6 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
Image:Dfd_0_15_newgui.png|The newgui branch, while still experimental
Image:Dfd_0_16.png|After the newgui merge
</gallery>

User:Soundandfury/DF Designer

2010-10-10T01:05:06Z

Soundandfury: /* Screenshots */ Added screenshots of 0.15-newgui and 0.16

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.0 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.0) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|v}}.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|c}} and {{key|x}} respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,6 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,6 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
Image:Dfd_0_15_newgui.png|The newgui branch, while still experimental
Image:Dfd_0_16.png|After the newgui merge
</gallery>

File:Dfd 0 16.png

2010-10-10T01:03:59Z

Soundandfury: DF Designer 0.16.0, incorporating both the newgui merge and the 0.14.x fixes

DF Designer 0.16.0, incorporating both the newgui merge and the 0.14.x fixes

File:Dfd 0 15 newgui.png

2010-10-10T01:02:43Z

Soundandfury: DF Designer 0.15-newgui, the experimental newgui branch (which has since been merged)

DF Designer 0.15-newgui, the experimental newgui branch (which has since been merged)

User:Soundandfury/DF Designer

2010-10-10T00:28:37Z

Soundandfury: A couple of the keys have changed

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.0 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.0) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|v}}.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|c}} and {{key|x}} respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,6 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,6 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-10-10T00:27:20Z

Soundandfury: Updated - 0.16.0 (includes newgui merge)

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.16.0 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.16.0) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the menu. You can also select tools using the menu system (menus 2 and 3).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing from the View menu (4,6 Shadow).

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice from the View menu (4,6 Shadow).
You might notice that shadowing and semislice both use the same menu button. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this shouldn't matter.

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|?}}.

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Menu item 1,4 (Export) will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Menu item 1,5 (QF-Export) will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-05-26T19:34:34Z

Soundandfury: added link to new git repository

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.13 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.13) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

[http://github.com/ec429/DF-Designer ''git'' repository]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Pressing {{key|y}} will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

File:Soundandfury Obs 6.png

2010-05-26T12:19:35Z

Soundandfury: Soundandfury's updated entry to the Obsidian logo competition (Large size)

Soundandfury's updated entry to the Obsidian logo competition (Large size)

File:Soundandfury Obs 4.png

2010-05-25T17:31:30Z

Soundandfury: Soundandfury's entry to the Obsidian logo competition (Large size)

Soundandfury's entry to the Obsidian logo competition (Large size)

User:Soundandfury/DF Designer

2010-05-23T05:49:25Z

Soundandfury: clarifying that we have ports all over the OS-ing place!

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and started out as a Linux project. However, it has since been ported to Windows and OSX (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.13 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.13) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Pressing {{key|y}} will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-05-23T05:34:37Z

Soundandfury: 0.13 ported to 'Doze (went surprisingly smoothly)

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.13 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.13) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help and updates. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Pressing {{key|y}} will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-05-23T05:27:05Z

Soundandfury: 0.13, with rotatable 3D view

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.13 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.12) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://dffd.wimbli.com/file.php?id=2312 0.12 for Intel Mac] Even less 'official'; HebaruSan compiled it, ask him for help. I don't have a Mac and can't test on one.

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -i, --no-full-3d
|Use the simpler version of the Isometric view (no rotation) - should probably work better on slow machines
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).
Isometric mode is actually a misnomer; it renders in 3D and you can rotate the view in both azimuth ({{key|[}} and {{key|]}}) and elevation ({{key|{}} and {{key|<nowiki>}</nowiki>}}).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Pressing {{key|y}} will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

v0.31:Health care

2010-05-05T22:57:02Z

Soundandfury: /* Bugs */ Surgery doesn't seem broken to me; {{verify}}

{{av}}
{{buggy|bugsection=Bugs}}
{{elven}}
'''Hospitals''' are a zone designated via the zone menu. Hospitals use any beds, tables, traction benches, and boxes/bags that are within these zones. You may also alter how much {{l|thread}}, {{l|cloth}}, {{l|splint}}s, {{l|crutch}}es, {{l|plaster powder}} for casts, {{l|bucket}}s, and {{l|soap}} hospitals use.

'''Doctors''' are dwarves assigned to any of the five medical labors; dressing wounds, diagnosis, surgery, setting bones, and suturing. All doctors in the fortress operate under the instruction of the Chief Medical Dwarf, one of the new appointed {{l|noble}}s, and presumably only perform medicine on a dwarf after treatment has been prescribed by a diagnostician.

All beds within a hospital zone are automatically Hospital beds, where injured dwarves will go to recuperate. Tired healthy dwarves will occasionally camp there too if the hospital is close, even if they have their own bed.

==Medical Skills==
There are five doctor skills - how critical they are is unclear at the moment, but from [[Toady]]'s pre-release comments we can assume they are moderately important to the healing process.
:''(And if you choose "{{L|Starting build|Play Now!}}", one of the 7 dwarves has Adequate (+2) {{L|experience}} in all 5 of these skills - which says something. "What?" is not perfectly clear either, but something.)''

Skill (& Profession)

:* {{l|Diagnosis}} (Diagnostician) This skill is used at the start of the treatment of every wounded; used a lot and also needed by your chief medical

:* {{l|Wound Dressing}} (Wound Dresser) This is also used pretty often; any wound seems to need it

:* {{l|Suturing}} (Suturer) Fairly common; most open wounds (from cutting) seem to need it?
:* {{l|Surgery}} (Surgeon) Somewhat less common; amongst others, wounds to organs seem to require it
:* {{l|Setting Bones}} (Bone Doctor) This is obviously needed for broken bones, but perhaps not for all?

===Non-doctor labors===

"Non"-doctors have 2 {{L|labor}}s that contribute to healthcare:

:* Feed Patients/Prisoners
:* Recover Wounded

Note that these are not {{L|skill}}s - they do not cause experience gain, but merely are activities that can be turned on/off for each dwarf. By default, all dwarfs start with these labors designated.

==Setting up a Hospital==
First, hit the 'i' key, and set up a hospital [[zone]] for the area you plan on having your hospital in. Next place enough beds in that zone to ensure you can keep all wounded dwarves in the hospital plus a few spare that will be occupied by lazy couchsurfers. After this is done, build containers ({{k|b}}-{{k|h}}); bags and/or chests. These are essential since it is where hospital supplies are stashed. You will need several containers (3+) to store all items listed on the {{k|i}}-{{k|H}} menu like thread, cloth and buckets. Note that it's fine to store, say, a wooden crutch in a silk bag. From that menu you are also able to change the maximum amount of supplies in your hospital as well as seeing how many are currently stored in the hospital's chests. This may be a bit buggy as more cloth and thread are often stored than you order. You may want to build tables and a Traction Bench(see below), as both are listed on the {{k|i}}-{{k|H}}ospital screen if present, presumably intended to be used for surgeries and bone setting{{verify}}. Turn on the various healthcare labors on some doctor dwarves, and you should be pretty much set.

Healthcare will also require a source of water to clean wounds. While they are capable of taking a bucket and gathering it from the nearest source, note that swamp water from a murky pool will vastly increase your chance of infection (though {{l|soap}} can offset this to a degree.) It is unknown at the moment whether dwarves will intelligently choose a clean water source when both clean and dirty water are available.

Dwaves will also use soap to clean wounds. In all 0.31 versions so far{{version|0.31.03}}, soap production is only possible by going through the manager screen.

Dwarves will prefer to store and use the most expensive thread and cloth. Yes, that includes '''adamantine strands'''.

==Traction bench / Broken bones==

'''Casts''': ''Not to be confused with [[caste|castes]]''

A '''traction bench''' is used by a {{l|doctor}} in a {{l|Hospital|hospital zone}} to immobilize a dwarf that has sustained complex or overlapping fractures.

It is constructed in the {{l|Mechanic's workshop}}, and requires a {{l|table}}, a {{l|mechanism}}, and a {{l|rope}} to construct.

{|
|Crutches are represented with the symbol
|{{RT0|┬|#770}}
|.
|}

A dwarf that needs to use a crutch/crutches will gain experience in the '''Crutch Walking''' skill, which Toady has stated will reduce the speed penalty for having to use crutches. Presumably, at legendary, they will move just as fast as without crutches. Testing remains to be seen whether using crutches causes any other penalties that this skill might reduce.

Plaster powder is produced at a {{L|kiln}} or {{L|magma kiln}} from {{L|gypsum}}, {{L|alabaster}}, {{L|selenite}}, or {{L|satinspar}} and an empty {{L|bag}} by a dwarf with the furnace operator skill enabled. They can also be bought at embark for 3P per unit - each unit comes with a free {{L|bag}}.

'''See Also:'''
*{{l|plaster powder}}
*{{l|Health screen|z-health screen}}

==Bugs==
{{version|0.31.03}}

* When a patient is diagnosed and treated, some wounds may heal before treatment occurs. If this happens, the surgery/suturing/etc jobs will never complete, and the patient will never be deemed healed. You now have a permanent invalid.
** Unless of course you {{l|Cave-in|somehow}} {{l|Lever|re-injure}}/{{l|Trap_component|poke}} the dwarf. This will cause a new diagnosis to be made and may free the invalid.
** If you remove the bed the dwarf is resting in, he will notice that he is ok and leave the hospital.
* Surgery is broken{{verify}}. It won't work, and {{l|Trap_component|pok}}ing the dwarf won't help either.
* Traction bench is broken.
* Bone setting is broken.
* Gypsum powder is not stored at the hospital.
* Dwarves with healthcare jobs will take supplies from normal stockpiles instead of the hospital to do their work.
* The hospital often stores more materials than are assigned.
* The quality and value of a finished traction bench doesn't account for all of the inputs used to make it.
* Dwarves without a depot will steal hospital items and store them once a trade caravan arrives.

[[Category:Current]]

v0.31 Talk:Health care

2010-05-05T22:55:54Z

Soundandfury: /* Surgery bugged? */ new section

Moved page to df2010, as it shouldn't be in mainspace [[User:Emi|Emi]] 02:33, 31 March 2010 (UTC)

== Rest to death ==

Be aware that once you have a hospital zone defined - all your injured dwarves will immediately run there at top speed and start to "Rest" there. "Rest" job can not be interrupted by any other job because a resting dwarf gains "unconscious" state. If you have no uninjured dwarves to bring food and water all patients will eventually get thirsty and dehydratate to death. Insanity breaks the "rest" job and the mad dwarf will wake up and wander around but it isn't helping.

If all your dwarves are injured to some extent - don't designate hospital zones.

== Starving to death in the hospital? ==

I had a few injured dwarves; they ended up starving to death in the hospital while a surgeon tried to perform surgery. Do I need to put food stockpiles in the hospital? Does it need a well? --[[User:Bombcar|Bombcar]] 16:46, 3 April 2010 (UTC)
:Were all your other dwarves busy? As "bring food/water to injured" is like a well job and will only occur when no other order is deemed more important.[[User:Kenji 03|Kenji 03]] 11:24, 5 April 2010 (UTC)

== Nearby pond/pool of water ==

I think it's very important to make note that a pond or pool be located inside or at least in a room adjacent to the hospital. See my user page if you want details, but the basics is that doctors (and possibly other dwarves) will run to the nearest water source to clean an injured/resting dwarf if they're dirty/muddy/bloody/whatever. The problem is both sieges and distance. During a siege, your doctor's going to get killed, plain and simple. Yeah, other dwarves will get killed bringing water to dwarves, too, so it's important anyway. Another thing is distance. Say you have a bloody dwarf with a badly dented chest, and another dwarf with a mangled, broken head gushing blood. For whatever reason, your doctor decides to diagnose Urist McDentedChest first. The next course of action is cleaning. Your doctor then grabs the nearest bucket from your hospital coffers, runs up the stairs to the nearest murky pool, brook, or river and halfway back to the fortress gate, UristMcGushingBloodOutHisHeadHemmorage bleeds to death.

On another note, dwarves do seem to clot very well now compared to old 40d. UristMcGushingHead in my fort has stopped bleeding, and even gone from extreme pain to faint to pale, and now he's back to only fainting, but if you go into battle with multiple wounded dwarves, you're going to have your doctors making multiple runs outside. Inside water needs to be made an important point. With the irrigation technique required at the moment, it shouldn't be too hard to explain since a similar technique is used. --[[User:Ryun|Ryun]] 21:51, 3 April 2010 (UTC)

Would a well suffice?

::It should, but I have not yet gotten to the point of making a well so I can't say I've tested it. With the abundance of underground pools, it shouldn't be difficult to make. I had suggested a pool initially because they would be easy to set up (except a little difficult to get full) for a new fort. I assume they should, anyhow. Once I bend my head around the technique of getting down to those pools multiple z-levels below, I'll test it.

::After several stupid mining errors ("Let's use the channel ramps to mine instead of digging out the topmost staircase and get stuck forever!") it appears that wells do indeed work for supplying dwarves water. However, I would like a recommendation that the hospital is put on the z-level as closest as possible to an underground pool if that is the water source. Dwarves take a fairly long time to get water when the distance the bucket must travel exceeds greater than 3 z-levels. Prep with multiple wells as well, of course, especially if you must place the well a long distance from the water source.--[[User:Ryun|Ryun]] 22:03, 13 April 2010 (UTC)

::I chose to run stream water down to my hospital. I channeled out a cistern one level deeper than the hospital level, connected ''diagonally'' to a shaft that ran to the stream. The [[DF2010:Pressure#Diagonal_Flow|diagonal connection]] kills the water pressure. I crossed my fingers, channeled out the last tile connecting the shaft to the stream, and it worked perfectly, so I permitted use of the door to the cistern. (I've not flooded a fort since the Second Magma Incident of 2007.) —[[User:0x517A5D|0x517A5D]] 06:11, 18 April 2010 (UTC)

:::A well works fine. Sadly my dwarves don't use my bewdiful balineae right across from the hospital to fill buckets. Maybe because of all the soap in the water. (Okay, I'll be honest, never seen a dwarf with soap there, but they do get nice thougts from 'having a bath') --[[User:Old Ancient|Old Ancient]] 20:27, 18 April 2010 (UTC)

== Traction bench bug? ==

My medical dwarves seem unable to move patients onto the traction bench. I've seen mine spend most of a year on "Place In Traction", standing over the victim, not accomplishing anything. --[[User:DarthCloakedDwarf|DarthCloakedDwarf]] 05:09, 18 April 2010 (UTC)
:I cannot confirm, for I have not even seen any of my hospital workers (with surgery enabled) use the things, and all the wounded recover just fine, regardless. --[[User:Bronzebeard|Bronzebeard]] 00:11, 1 May 2010 (UTC)

== * Dwarves without a depot will steal hospital items and store them once a trade caravan arrives. ==

what does this mean?

:I guess it refers to the more general bug of dwarves not respecting property of caravans in some situations; supposedly they will steal food and booze if thers none in the fortress piles and they r hungry. So in this case they try to fulfill the thread, cloth and so on requests, ordered in the hospital H menu. Haven't encountered this myself though. --[[Special:Contributions/92.202.18.240|92.202.18.240]] 20:33, 27 April 2010 (UTC)

== Surgery bugged? ==

It worked fine for me: it took a heckuva long time because my surgeon was incompetent; several surgery jobs and some ancillary damage later, rediagnosis - no more surgery required! So it looks like a bad surgeon will take lots of attempts to get there but will eventually succeed. [[User:Soundandfury|soundandfury]] 22:55, 5 May 2010 (UTC)

v0.31:Utilities

2010-05-01T13:05:59Z

Soundandfury: DF Designer (is version independent)

{{AV}}
{{human}}
Please only list utilities that are known to work with the newest version here.

Here are third party applications useful for Dwarf Fortress.
__TOC__
== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ==
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] by Jonask, Solifuge and Kaypy ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]

Stonesense is a third party real-time visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

Unofficial build supports v0.31.03 - [http://depositfiles.com/files/lp3p1s1oy can be obtained here].
Be careful, some times it crash.

== [http://dffd.wimbli.com/file.php?id=645 Reveal] ==

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.

There are two versions of Reveal, one for Vista and newer, one for XP and older.

The new version of Reveal.exe (Reveal2) is in public beta, you can find it here [http://dffd.wimbli.com/file.php?id=1044 Reveal2]. Please report problems in [[User_talk:0x517A5D|0x517A5D's Talk page]].

Pasting the following code into reveal2.ini makes it work for the newest (DF2010) version of Dwarf Fortress:

<pre>
;; DF2010 31.02
[4BBDF378]
map_data=0x016ad718
map_x_count=0x016ad738
map_y_count=0x016ad73c
map_z_count=0x016ad740
</pre>
[4BB45F99] can be substituted in for 31.01.

For 31.03, the following works:
<pre>
; .31.03
[4BC3C470]
dwarf_fortress=0x00A5ED94
map_data=0x016AE760
map_x_count=0x016AE780
map_y_count=0x016AE784
map_z_count=0x016AE788
map_data_designation_offset=0x29C
</pre>

However, do '''not''' save your game, it can mess up many things including civilizations (Giant Toad and Cave Crocodile civilizations, you will also embark with those if it should occur.)

==[http://www.bay12games.com/forum/index.php?topic=39229 Dwarf Therapist]==

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 5.1 is out (4/24/10). This version supports DF build 3.01.03.

New dedicated support forum: http://code.google.com/p/dwarftherapist/

==[http://www.bay12games.com/forum/index.php?topic=50643.0 Dfterm]==

Dfterm is a tool to run dwarf fortress via terminals remotely. multiple people can connect and watch or join in.

Main article here: [[Dfterm]].

== [http://www.bay12games.com/forum/index.php?topic=41916.0 DFHack] ==

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.3.1.4) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 versions. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].

=== DFhack tools for DF 2010 ===
==== dfcleanmap ====
Cleans all the bloodsmears that get scattered all over the map.
==== dfliquids ====
Allows creating liquids (water and magma), making them flow or preventing them from flowing. Newly also allows making obsidian walls. It's a command-prompt style utility where you type in very simple commands. Replaces the older magma_create tool.

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Reveals the whole map. Newly can also hide what it revealed. Use with caution, releases HFS! Same warnings as to the original Reveal tool apply.
==== dfvdig ====
Designates a whole vein for digging. When using the '-x' option, it will dig stairs into other z-levels. Point the cursor at a vein and run this thing :)

== DF Map Compressor / DF Map Archive ==

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website]
*[http://mkv25.net/dfma/ Dwarf Fortress Map Archive]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file. The fdf-map file can then be shared with your friends by uploading to the DF Map Archive that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. Extract from the website :
:"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on Markavian's User page.

== [[User:Soundandfury/DF_Designer|DF Designer]] ==
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

== Raw tile tools ==
=== [http://dffd.wimbli.com/file.php?id=2113 Raw tile selector] ===
Provides an easy to use graphical interface to select which tiles and colors should be displayed for plants, stones and small creatures.

Made to ease the job of creators of tilesets with edited raws. It will also be useful for users that dislike decisions made by tileset creators or users that could not find the edited raws for a tileset.

Currently for windows xp only.

=== [http://dffd.wimbli.com/file.php?id=2178 Raw tile merger] ===
Provides an easy to use interface to change the tile and color data of raws to match the data of another set of raw files.

Made to ease the job of creators of tilesets with edited raws when new versions of df are released. The edited raws for your tileset for a new df version can now be created with a few clicks.

== [http://winmerge.org/ WinMerge] ==
Winmerge allows you to compare the contents of folders or files. It highlights any differences between files and allows you to merge them. It is most useful for modders or users of mods. If you compare modified raw files with unmodified ones you can quickly see any differences.

v0.31:Military

2010-04-02T00:56:19Z

Soundandfury: I think you need a separate barracks for each squad.

{{AV}}

Just a quick aid for confused players, please reformat this, anyone who knows more:

You can load dwarves into a squad from the 'm'ilitary screen, after you've defined a military commander.
The squad defaults to training all the time (see its 's'chedule on the military screen).
To actually make them train, though, you need to activate them: 's'quads from the main screen, then press the letter of your squad, then 't' to change it from inactive to active.
You also need to create a barracks from a bed, then assign the squad to train in it with the 't' key. This makes them immediately start to train there.
You may need to have a separate barracks for each squad{{Verify}}.

==Alert levels==

The ''alert level'' is a fundamental concept of military management. In each alert level, you can program instructions for your military and civilian dwarves to follow. The game contains two alert levels by default - 'Inactive' and 'Active/Train'. In 'Inactive', all squads are assigned no orders. In 'Active/Train', all squads are assigned to train the entire year.

Your entire fortress is always set to exactly one 'Civilian alert level'. This restricts where civilians may go. To define the restriction area, you must first create a {{L|Burrow}} encompassing the area you want to restrict your civilians to. Then, go to the alert screen (m then a), create a new alert level (call it something like 'Danger'), highlight it in the left pane, then press enter on the correct burrow in the right pane. You can change the currently active civilian alert level by pressing enter on the correct alert level in the left pane.

Each alert level also carries instructions for military dwarves when it is activated. Unlike the civilian level, which applies to your entire fort, the military alert level can be set individually for each squad. To set a squad to an alert level, either select it from the squad menu (s) and press 't' until the desired alert level is selected, or go to the alert menu (m then a), highlight the correct alert level in the left pane, then highlight the correct squad in the middle pane, then press Shift-Enter.

==Scheduling==

Each squad can be given a schedule to follow for an entire year. Each squad has a separate schedule for each alert level; it can be swapped between these schedules with the procedure outlined in the previous section. The main scheduling screen can be accessed by pressing s from the main military screen.

On the main scheduling page, you will see a list of months on the left side, and a list of all of the squads in your fortress along the top edge. Scheduling is done separately for each alert level; to switch between alert levels use the / and * numpad keys. You can use the + and - numpad keys to scroll through the squads at the top if you have more than will fit on one screen. Use the up/down arrow keys to navigate up and down the month list, and the left/right arrow keys to navigate between the squads. The orders in the currently selected cell are displayed in blue towards the bottom of the screen. When you've highlighted a cell, press Tab to switch focus to this order list. From here, you can press e to edit the orders.

When you press 'e', a screen will come up saying something like 'o: Train'. Press o to change the order's type. This cycles between 'Train', 'Defend Burrow', 'Patrol Route', and 'Station'. To use any of the orders other than Train, you will first need to set up the appropriate {{L|Burrow}}, {{L|Station}}, or {{L|Route}}. When you cycle to the order you want, highlight the burrow, station, or route you want the order to go to and press Enter. It should be highlighted in green. When you are done, press Shift-Enter to save the order and return to the schedule screen.

Note that the text displayed on each cell (like 'Train') is a completely customized text; it does NOT reflect the actual orders in the cell! When you have a cell highlighted, you can press 'n' to edit the label. Don't be confused by the fact that when you edit the orders in a cell, the label does not change to reflect your changes. You need to update the cell text yourself to be consistent with the orders.

To eliminate some of the tedium in scheduling many months, you can copy-paste orders from one cell to another with the c and p keys. Press c in the cell you want to copy from, then go to the cells you want to paste to and press p in each one.

By pressing Shift-Tab in the main military screen, you can flip the rows and columns in the main grid. This allows you to see more squads, but fewer months. This can be useful if you want to see all your squads at the cost of not seeing the entire year's schedule. This change is cosmetic only; the tools still work the same way.

User:Soundandfury/DF Designer

2010-02-07T17:00:38Z

Soundandfury: Oh. Quickfort doesn't have its own page. Have to fix that link.

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.12 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.12) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Pressing {{key|y}} will export the current z-slice as a [[Utilities#Quickfort|Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-02-07T16:58:32Z

Soundandfury: 0.12, Quickfort yxport

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.12 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.12) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

===Quickfort Export===
Pressing {{key|y}} will export the current z-slice as a [[Quickfort]] .csv file. This feature (internally called 'yxport') is still a bit hacky, and you may have to manually tweak the exported .csv files to make them work (eg. large regions of floor are built one tile at a time, which causes access problems).

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-02-07T15:31:45Z

Soundandfury: /* The Basics */ damn zis crazy formatting

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.11.1 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.11.1) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key|&emsp;}} (spacebar).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2010-02-07T15:29:49Z

Soundandfury: 0.11.1, minor change to keys

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.11.1 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.11.1) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively, or toggle with {{key| }} (space).

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

User:Soundandfury/DF Designer

2009-12-31T06:07:38Z

Soundandfury: Version 0.11 (colourful DF-TILES)

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.11 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.11) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 2GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
Image:Dfd_0_11_tiles.png|DF-TILES editing mode in DFD 0.11
</gallery>

File:Dfd 0 11 tiles.png

2009-12-31T06:05:25Z

Soundandfury: DF Designer 0.11 showing off its DF-TILES display mode.

DF Designer 0.11 showing off its DF-TILES display mode.

User:Soundandfury/DF Designer

2009-12-31T00:42:20Z

Soundandfury: 'Doze port updated to 0.10

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.10 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (of 0.10) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 0.5GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-31T00:27:02Z

Soundandfury: Update for 0.10

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.10 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port (0.9) for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM for the default map size; the maximum map size takes 0.5GB.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

The Minimap will ''really crawl'' on large maps.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -h, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=96, max=2048)
|-
| -y=''number''
|Y-Size of world (default=96, max=2048)
|-
| -z=''number''
|Z-Size of world (default=24, max=256)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

Edit has two submodes, COLOURS and DF-TILES, two methods of displaying what's in each tile. Select them with {{key|:}} (colon) and {{key|@}} (at) respectively.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit--COLOURS mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-09T22:20:11Z

Soundandfury: /* Running */ the max sizes are bigger now

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.9 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 15MB of RAM.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -n, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=64, max=256)
|-
| -y=''number''
|Y-Size of world (default=64, max=256)
|-
| -z=''number''
|Z-Size of world (default=24, max=64)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-07T16:22:39Z

Soundandfury: 0.9, BIG maps, minimap.

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.9 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 15MB of RAM.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -n, --no-help
|Don't run the key-help through the console at startup (can still get key-help by pressing {{key|h}})
|-
| -x=''number''
|X-Size of world (default=max=64)
|-
| -y=''number''
|Y-Size of world (default=max=64)
|-
| -z=''number''
|Z-Size of world (default=24)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

There's a minimap for working with big maps (you scroll around with the cursor keys); to see the minimap you have to turn off the console - press {{key|0}} (zero).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

40d:Utilities

2009-12-06T17:47:47Z

Soundandfury: /* DF Designer */ there is a Doze build now

Here are third party applications developed for Dwarf Fortress.
__TOC__
== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ==
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

== 3D Visualizers ==

=== [[Stonesense (visualizer)|Stonesense]] by Jonask, Solifuge and Kaypy ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]

Stonesense is a third party visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

=== [http://www.bay12games.com/forum/index.php?topic=39541.0 Visual Fortress] by Baboonanza ===

This is Baboonanza's 3D visualisation application. It's focused on displaying mega-projects and landscapes accurately and hopefully beautifully. Basically like 3Dwarf, but more advanced.

=== [http://www.bay12games.com/forum/index.php?topic=608.0 3Dwarf Visualizer] ===

This is NOT real time! Dwarvis has the ability to be real time, though 3Dwarf is much more recommended. What this does is read the map out of your computer's memory when Dwarf Fortress is running and save it to a file it can read. It can then open that file and show you your fort in glorious 3D. Still in beta, obviously.

=== [http://www.bay12games.com/forum/index.php?topic=34633.0 Khazad] ===

A related fortress viewing engine utilizing memory extraction and saving similar to 3Dwarf, Khazad uses an Isometric perspective reminiscent of SimCity200 & Transport Tycoon while also allowing very free form camera control in a full 3D environment. Khazad is compatible with 40d and 40d11 and entirely open source being licensed under the GPL, source and binary packages are available at [http://sourceforge.net/projects/khazad/ SourceForge]. Development is active and participation is welcome.

=== [http://code.google.com/p/dwarvis/ Dwarvis/MapExtract] (Outdated) ===

This project is meant as a 3rd party utility for the cult-game dwarf fortress. Its purpose is to eventually provide 3-dimensional visualization of static snapshots of the ingame world of a given fortress.

== Movies, Screenshots, Map Files ==

=== DF Map Compressor / DF Map Archive ===

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website]
*[http://mkv25.net/dfma/ Dwarf Fortress Map Archive]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file. The fdf-map file can then be shared with your friends by uploading to the DF Map Archive that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. Extract from the website :
:"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on Markavian's User page.

=== [http://www.geocities.com/jifodus/CMVPlayer.zip CMVPlayer] ===

First released by Jifodus in April 2007. This application enables playback of the DF movies (.cmv) without starting DF. It also provides some more functionalities, such as :
* Rewind
* Pause
* Play frame per frame

To use, simply unzip the file, and drop and drag the movie on CMVPlayer.exe.

=== [http://dffd.wimbli.com/file.php?id=389 DwarfHeightmap] ===

A utility that imports 24bit greyscale bitmaps into world_gen.txt for use in DF's map generator.

=== Terrain Visualizer ===

View worldmaps in 3D! This utilizes version 0.28.181.39d's built in Legends Mode map exporter and a generic HeightMap terrain visualizer. Nothing super fancy, but neat to look at.
Get the [http://www.alpix.com/3d/TerrainViewer/ 3D Terrain Viewer] here, follow the instructions in the [http://www.bay12games.com/forum/index.php?topic=21468 Bay12Forums Thread] if you need help getting set up.

Or if you want super pretty maps, [http://www.bay12games.com/forum/index.php?topic=21469.0 see this topic], and get [http://www.planetside.co.uk/terragen/download.shtml Terragen]!

==Major Utilities==

=== [[User:Bartavelle/DwarfCompanion|Dwarf Companion]] ===

Created by [[User:Bartavelle|Bartavelle]], the Dwarf Companion is a graphical helper utility for dwarf fortress that aims to fill the gaps in the user interface. It allows for some nefarious cheating. For example, you can now mark your nobles as butcherable, and change possessed dwarves to fey moods.

=== [http://dwarfmanager.sourceforge.net/ Dwarf Manager] ===

Dwarf Manager is inspired by Dwarf Foreman (below) and has a similar overall layout, but improved features. You can not only assign jobs to profession groups but also to individual dwarves; you can view their current skill for a given job displayed handily in the job grid; and you can also change their personal and profession names straight from the interface. The program handles social and military skills as well.
In addition the program can be customized and updated by editing the included .xml files.

=== [http://www.pavlovian.net/foreman/ Dwarf Foreman] ===

Makes switching jobs on and off for large numbers of dwarves simple. Dwarves are grouped by their profession, or custom profession if they have one. By clicking on the graph you can enable any job for all dwarves with that profession. Still in alpha for this version of DF, if it doesn't recognize one of the new professions, check the file '''debug.txt''' in the directory you run foreman from.

Though prone to crashing currently, saving and exiting DF, starting foreman and then starting DF again will usually get it working again. Zorba would also appreciate it if you'd email him the crash log located in the Dwarf Foreman directory when this happens (zorba-foremancrash@pavlovian.net).

Dwarf Foreman currently allows you to change the jobs of visiting merchants, outpost liaisons, children, and any other dwarves that aren't normally controllable. It is unsupported but occasionally hilarious, and allows you to finally put those lazy dwarven children to work.

Source code is available.

To make Foreman compatible with '''v0.28.181.40d''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] for previous versions of DF.
<pre>
check=032e4b67
critter_start=01583224
dwarfidpos=0138f690
profession_start=0474
</pre>

'''Note:''' A Dwarf Foreman-like utility, with an expanded feature set, is also available. See Dwarf Manager above.
=== [http://dffd.wimbli.com/file.php?id=695 Mac Foreman] ===

This is a MacOSX 10.5 port of Dwarf Foreman.

Source code is available.

Dwarf Fortress version: '''v0.28.181.40d'''

=== [http://www.bay12games.com/forum/index.php?topic=39229.0 Dwarf Therapist] ===

Reported to be an improvement over Dwarf Manager.

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory.

=== [http://sun2design.com/quickfort/ Quickfort] ===

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments).

=== [http://www.bay12games.com/forum/index.php?topic=18623.0 Modbase] ===

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings. For version 0.38c.

=== DF Raw Editor ===

DF Raw Editor is a brand new tool created to help edit the raw files.
It is available [http://www.bay12games.com/forum/index.php?topic=40413.0 here].
For version 0.40d

== Minor Utilities ==

=== [[User:Soundandfury/DF_Designer|DF Designer]] ===
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

=== DF Log Parser ===

A perl script written by Mephansteras that parses through the logs to show what civs owned what sites, what their overall populations were, and what the overall population levels of cave critters were. The output file makes it pretty easy to see how the various races are doing.

You will see:
Each Civilization, with overall ruler. Each site in that civ, with the local ruler. A summary of every entity in that civ.
A summary of every civ, by race
A listing of every Ruin
A listing of the total populations of cave critters
A listing of the total populations of civilized creatures

[http://dffd.wimbli.com/file.php?id=299 Raw perl script] - requires perl
[http://dffd.wimbli.com/file.php?id=311 Executable version] - does not require perl

=== [http://dffd.wimbli.com/file.php?id=278 DF World Generator] ===

Swiftly written supplement to the command line world generator. Written in Python, so you have to have Python installed to use this. It must be run from the command line and be in the DF Directory to work. Running the program with no parameters will provoke a short help-me dialog which will explain how to run it properly.
Enjoy!

=== [http://www.bay12games.com/forum/index.php?topic=949.0 Dtil] ===

Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

=== [http://www.bay12games.com/forum/index.php?topic=21351.0 Embark Anywhere] ===

Code based on 0x517A5D's Regional Prospector (above), allows you to embark ANYWHERE, how well that works depends on where you decide to go. Pure water areas are a suggested no as you can't do anything.

=== [http://dffd.wimbli.com/file.php?id=443 Enable Magma Buildings] ===

You need this utility in the case that you used the reveal utility before discovering any subsurface magma, or if you have reclaimed a fortress whose magma source has already been discovered.{{version|0.28.181.40d}} (If the hide utility is ever updated, you could also hide a few magma tiles and then dig them out. That worked in the old version.) Because there is no actual flag that controls whether magma has been seen (the game searches a list, probably a list of notable events), I had to patch the game's code. This means you need to run the utility every time you start dwarfort.exe and you want to build a new magma-using workshop.

This utility has been made version-independent. It is expected to work with future releases of Dwarf Fortress.

=== [http://75.127.91.201/~jifodus/df/justdigitout.zip Just dig it out!] ===

A utility by Jifodus. Disables warning messages about damp stone and hot stone. [http://www.bay12games.com/forum/index.php?topic=21892.0 Thread]

=== [http://www.bay12games.com/forum/index.php?topic=21601.0 Nano Fortress] ===

A utility that will allow embarks to 1x1 locations.

=== [http://angband.org/~erasmus/df/teleport22.zip Teleport] ===

Teleport dwarves and other creatures. Version 2.2 is independent of the DF version. (33c)

Note: This utility may not work on versions of DF 40d and later. If it doesn't work for you, try Dwarf Companion.

Caveat: The teleport utility does not correctly set the occupancy flag for map squares. As a results, dwarves will permanently crawl through the square that you teleported them out of. In addition, you cannot build structures in those squares.

=== [http://dffd.wimbli.com/file.php?id=645 Reveal] ===

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal. Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.

There are two versions of Reveal, one for Vista and newer, one for XP and older.

The new version of Reveal.exe (Reveal2) is in public beta, you can find it here [http://dffd.wimbli.com/file.php?id=1044 Reveal2]. Please report problems in [[User_talk:0x517A5D|0x517A5D's Talk page]].

The Old version of Reveal.exe does not require you install anything (if you are using 0.28.181.40d and the updated memory.ini file), just unzip both files and run reveal.exe while DF is running.

If using [http://www.bay12games.com/forum/index.php?topic=40349.0 the OpenGL accelerated version] of DF (40d16) under XP SP3, the newer version of Reveal is required as the older version can't find it. Reveal2.exe works correctly with this setup.

=== [http://dffd.wimbli.com/file.php?id=1165 UltraFinder] ===

This AHK script generates worlds until it finds one with the desired features as defined in the init file.

This is not an advanced application, it is simply meant to take the task of repeated genning out of your hands.

The concept is that you set the parameters as you see fit, and leave it running while you go about your other business.

READ ALL WARNINGS IN THE INIT FILE!

The readme exists for a reason.

== Miscellaneous ==

These utilities were never designed with Dwarf Fortress in mind, but have been adapted to its use.

=== [[User:Jackard/Accent_Removal|Accent Removal]] ===

Certain tilesets leave a bunch of funky icons in the names of your dwarves! Replacing accented letters with normal ones in the raws fixes this problem.

=== [http://www.autohotkey.com/ AutoHotKey] ===

AHK lets you define global hotkeys to send a sequence of keystrokes. For example, you can have {{key|alt}}+{{key|w}} replace {{key|b}}-{{key|C}}-{{key|w}}-{{key|Enter}}-{{key|Enter}} to make wall building much easier. See [[Macros and Keymaps]] for a how-to and some example scripts. See [[:Category:ahk scripts]] for a list of user submitted scripts.

=== [http://winmerge.org/ Winmerge] ===

This utility allows you to compare folders or files. It highlights anything that does not fit in with the other file, so that you can see if you want to merge them into one file or not..

== Outdated Utilities ==

These programs are for previous versions of Dwarf Fortress, and have been left untouched for some time.

=== [http://dffd.wimbli.com/file.php?id=108 DFWall] ===

An utility for automation of mass constructions. Features three modes:

1. Rectangle rewalling - quickly build a rectangle of walls/floors using:
a) the same saved material every time ([http://mkv25.net/dfma/movie-495-dfwalldemo DEMO])
b) any material with at least 1/10/99 units

2. Quick reselect (for ANY single unit construction) - save that green glass box and never again have to look for it between all the bags!

3. Pattern construction - make a pattern file and have stuff constructed according to it ([http://mkv25.net/dfma/movie-520-dfwalldemo2 DEMO]).

For more details look here: [http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001847 Thread]

=== [http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip Latitudes] ===

Latitudes is a utility that, when on the embark map screen, shows the X/Y coordinates of the current region. Until Toady adds [http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=5&t=002191 proper support], this will do the trick. Works in .32a through at least .33g. Technical notes: uses memory injection, so it may be flagged as a suspicious file by anti-virus programs.

=== [http://angband.org/~erasmus/df/lavasquare.exe Lavasquare] ===

Another quick hack to make a 7/7 unit of lava on the currently selected square. Ignore the random text it spams, as it was quickly adapted from a map query tool, and I didn't bother removing the print statements. Only works with version 33e. To hack this executable for a later version of dwarf fortress see the [[Talk:Utilities#Lavasquare|talk page]].

33g version plus autohotkey script: http://www.sendspace.com/file/xsl6gs

=== [http://www.bay12games.com/forum/index.php?topic=1447.0 StartProfile] ===

Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.

Check the thread on the forums for the latest download link. (Aug 01, 2008)

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

=== [http://angband.org/~erasmus/df/water.exe Water] ===

Quick hack to refill ponds. Run this while your fortress is up, and it'll restore any "murky pool" tiles (i.e. the floor of ponds and lakes) to 7/7 water. If you've tunneled into a pond, it'll still refill but will flow out normally. Only works with version 33e due to its "quick hack" status. Note: If there is lava in a murky pool, it will be raised to depth 7/7.

[[Category:Utilities| ]]

User:Soundandfury/DF Designer

2009-12-06T17:18:32Z

Soundandfury: DLL Hell... I hate doing Windows ports :S But it works now... on my Wine at least...

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.8 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. The DLL-mismatch issues have ''hopefully'' been fixed now.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D
(There were some DLL Hell issues for a while, but I ''think'' they're fixed... for now...)

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -x=''number''
|X-Size of world (default=max=64)
|-
| -y=''number''
|Y-Size of world (default=max=64)
|-
| -z=''number''
|Z-Size of world (default=24)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T16:59:36Z

Soundandfury: Windows build (almost) DOA :(

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.8 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag. It only seems to work on a select few people's boxen; most people report crashes. Still trying to fix.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -x=''number''
|X-Size of world (default=max=64)
|-
| -y=''number''
|Y-Size of world (default=max=64)
|-
| -z=''number''
|Z-Size of world (default=24)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T16:12:59Z

Soundandfury: Danged formattings!

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.8 from DFFD]

[http://dffd.wimbli.com/file.php?id=1660 Port for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM.

The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -x=''number''
|X-Size of world (default=max=64)
|-
| -y=''number''
|Y-Size of world (default=max=64)
|-
| -z=''number''
|Z-Size of world (default=24)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T16:11:48Z

Soundandfury: There is a Windows port now

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and is basically a Linux project right now. However, there is a Windows port (see below). The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.8 from DFFD]
[http://dffd.wimbli.com/file.php?id=1660 Port for Windows users] '''Note: The Windows port is not 'officially' supported; updates may lag.'''

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
DFD uses about 7MB of RAM.
The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling (Linux)===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

===For Windows===
In the Windows build, the libraries are provided as DLLs. It ought to work right out of the box; if it doesn't, get out your C compiler and fix it yourself :D

===Running===

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -x=''number''
|X-Size of world (default=max=64)
|-
| -y=''number''
|Y-Size of world (default=max=64)
|-
| -z=''number''
|Z-Size of world (default=24)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T08:55:21Z

Soundandfury: Version 0.8 (sleep is for the weak)

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and so far only a Linux build is available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.8 from DFFD]

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===System Requirements===
To run DF Designer, you will need Linux, unless some kind person makes a port.
DFD uses about 7MB of RAM.
The Isometric view is executed on CPU (not GPU) so might be slow on older or low-end machines.

===Compiling===
You will (probably) need ''libsdl1.2-dev'', ''SDL_image'', and ''SDL_ttf''. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make. If there's an error about symbolic links, make should ignore that and so can you.

To start DF Designer, run './designer' or double-click on the executable (symlink).
Command-line options:
{| class="wikitable"
|-
| -n, --no-confirm&emsp;
|Don't pop up confirmation windows for non-undoable actions.
|-
| -x=''number''
|X-Size of world (default=max=64)
|-
| -y=''number''
|Y-Size of world (default=max=64)
|-
| -z=''number''
|Z-Size of world (default=24)
|-
| -z0=''number''
|Ground Z-level (default=13)
|}

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing). You can see which tool is currently selected from the icon below the map (although some of the images aren't done yet, so you just get a placeholder).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map). DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

Cunning features of the floor map include condensing of series of identical Z-levels.

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T06:03:21Z

Soundandfury: This formatting is a !!noble!!

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and so far only a Linux build is available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.7 from DFFD]

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===Compiling (optional)===
You will (probably) need libsdl1.2-dev, SDL_image, and SDL_ttf. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)

Then, run make.

'''To start DF Designer''', run './designer' or double-click on the executable (symlink).

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.

You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.

You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).

You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.

Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.

DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.

"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.

"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map) DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T05:58:43Z

Soundandfury: The User's Manual

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and so far only a Linux build is available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.7 from DFFD]

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==User's Manual==
aka, "How the hell do I work this thing?"

===Compiling (optional)===
You will (probably) need libsdl1.2-dev, SDL_image, and SDL_ttf. Working out precisely what is needed, and where to put it, is left as an exercise for the reader ;)
Then, run make.

'''To start DF Designer''', run './designer' or double-click on the executable (symlink).

===The Basics===
DF Designer has two modes, ''Edit'' (top-down slice) and ''Isometric'' (view only). You can switch between these modes with the keys {{key|e}} and {{key|i}} respectively.
You do your actual building in Edit mode. To edit a tile in any way, you move your cursor over it (you should see a little yellow box around the tile you're currently hovering over), and then left-click. You can also click-and-drag, thus allowing you to designate several tiles. To choose /what/ to build, press one of the designation keys (press {{key|h}} for a listing).

===In more detail===
To find out which key does what, press {{key|h}}, and some help will scroll up that fancy console on the left.
You can designate rectangular areas by right-clicking twice. Beware, though, because you can't undo (yet).
You can also do designations by pressing Ctrl-{{key|*}} where {{key|*}} is any designation key. So, for example, Ctrl-{{key|b}} places a bed, as well as selecting ''bed'' as the current tool; {{key|b}} on its own would just select ''bed'', and not actually place one until you left-clicked.
Load and Save with {{key|l}} and {{key|s}}. Suggested extension, ".dfd", though it's up to you.
DF Designer doesn't implement anything near the full ontology of buildings and constructions in DF; however, as the versions go by, it should increase.
'Objects' - beds, chairs, tables, and other stuff - don't appear in Isometric mode right now, because I haven't done any models or anything like that for them yet.
"Shadowing" is DF Designer's way of showing you what's on nearby levels, in Edit mode; fainter versions of the z-levels above and below are superimposed upon the current level. You can toggle shadowing by pressing {{key|m}}.
"Semislice" allows you to choose whether the slice in Isometric mode cuts above or below the floors. You can toggle semislice by pressing {{key|m}}.
You might notice that shadowing and semislice both use the same key. In fact, they are controlled together; whenever one is turned on, the other is turned off. Since only one has any effect at once (they affect different modes), this saves a letter on the keyboard (which is just as well as we're going to run out soon at this rate).

That's basically it. You might wonder what the rules are for placing things on top of other things, and whether what was there before stays there; answer: it's all ad-hoc. Just try stuff; after all, you can always get back to what you had before (though if you've put lots of work in, you might want to save first, because there's no 'undo' feature yet).

===Export Floor Map===
Pressing {{key|x}} will export a floor map. Note: Remember not to export the floor map over the top of the map save; use a different filename! (Suggestion: append '.txt' for the floor map) DF Designer doesn't have a function to import from floor-maps; you don't want to lose your map save, right?

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>

User:Soundandfury/DF Designer

2009-12-06T05:36:10Z

Soundandfury: Version 0.7 (fast release cycle this, ain't it?)

'''DF Designer''', by [[User:Soundandfury|soundnfury]], is a fort layout and building planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and so far only a Linux build is available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent.

[http://dffd.wimbli.com/file.php?id=1652 Download 0.7 from DFFD]

[http://www.bay12games.com/forum/index.php?topic=45433.0 Forum thread]

==Screenshots==

<gallery>
Image:Dfd_05_edit.png|Editing mode in DFD 0.5
Image:Dfd_05_iso.png|Isometric (View) mode in DFD 0.5
</gallery>