Dwarf Fortress Wiki - User contributions [en]

Utility:Overseer

2011-03-03T08:02:38Z

Thewonderidiot:

[[File:overseer.png|thumb|right|Overseer Screenshot]]
==Fortress Overseer==
Fortress Overseer is a full 3D DF2010 visualizer by thewonderidiot and sexymustard. More information can be found in the [http://www.bay12forums.com/smf/index.php?topic=63484.msg2037888#msg2037888 bay12forums topic], and Overseer itself can be downloaded from [http://dffd.wimbli.com/file.php?id=3882 its page on DFFD] or [https://github.com/downloads/mikestewart/Overseer/Overseer0.50.exe the github mirror]. The currently outdated) linux version can be downloaded [http://dffd.wimbli.com/file.php?id=3291 here.]

Overseer uses Ogre3D in conjunction with the DFHack library.

==Adding Custom Content==
===Models===
Models are stored in the /models/ directory. Models use Ogre's .mesh format. Exporters can be downloaded from the Ogre wiki for various 3D modelling programs.

===Materials===
Ogre has a very robust material system. More information can be found in [http://www.ogre3d.org/docs/manual/manual_14.html the Ogre manual]. The included generateMaterials.py script will populate the material scripts using info from the diffuse and normal texture directories, generating colors for other techniques from the colors directory (thanks to Japa for use of his stonesense colors).
====Images====
Images for a material must have the same name the material has in the raws. Diffuse textures are found in /materials/images/diffuse. Their dimensions should be a power of two. If they have an accompanying normal map, it needs to be named with the same name as the diffuse texture but with an n on the end (eg, if native_gold.bmp is the diffuse texture, native_goldn.bmp is its normal map). The normal maps go in /materials/images/normal. Of course, this layout can be changed as long as the resources.cfg file in the root Overseer directory is updated accordingly.

[[Category:Utilities]]

v0.31:Utilities

2010-09-29T04:46:56Z

Thewonderidiot: /* 3D Visualizers */

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

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [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.

=== 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.

== 3D Visualizers ==

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

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].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly cusomizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum thread] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

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

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

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

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

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.


===[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, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.2 is out (September 13, 2010). This version supports DF builds up to 0.31.14.

''NOTE'': This project is currently seeking a new maintainer.

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

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.5 is out for Windows, currently supporting 0.31.12. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and letters (runes) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 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.4.0.7b) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 legacy versions and 0.31.04-0.31.12 SDL 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 :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [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.

"Blueprints" can be created using many interfaces, the easier being graphically based. TO design rooms on a website [http://www.irritablegourmet.com/dwarf/index.htm] a web based blueprint maker is the most simple to use.

=== [[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. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

== 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 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.

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [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.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

v0.31:Utilities

2010-09-29T04:45:38Z

Thewonderidiot: /* 3D Visualizers */

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

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [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.

=== 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.

== 3D Visualizers ==

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

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].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
[[File:overseer.png|208px|thumb|right|Overseer Screenshot]]
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly cusomizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum thread] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

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

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

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

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

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.


===[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, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.2 is out (September 13, 2010). This version supports DF builds up to 0.31.14.

''NOTE'': This project is currently seeking a new maintainer.

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

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.5 is out for Windows, currently supporting 0.31.12. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and letters (runes) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 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.4.0.7b) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 legacy versions and 0.31.04-0.31.12 SDL 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 :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [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.

"Blueprints" can be created using many interfaces, the easier being graphically based. TO design rooms on a website [http://www.irritablegourmet.com/dwarf/index.htm] a web based blueprint maker is the most simple to use.

=== [[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. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

== 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 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.

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [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.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

v0.31:Utilities

2010-09-29T04:44:17Z

Thewonderidiot: /* 3D Visualizers */

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

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [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.

=== 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.

== 3D Visualizers ==

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

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].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
[[File:overseer.jpg|208px|thumb|right|Overseer Screenshot]]
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly cusomizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum page] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

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

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

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

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

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.


===[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, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.2 is out (September 13, 2010). This version supports DF builds up to 0.31.14.

''NOTE'': This project is currently seeking a new maintainer.

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

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.5 is out for Windows, currently supporting 0.31.12. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and letters (runes) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 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.4.0.7b) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 legacy versions and 0.31.04-0.31.12 SDL 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 :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [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.

"Blueprints" can be created using many interfaces, the easier being graphically based. TO design rooms on a website [http://www.irritablegourmet.com/dwarf/index.htm] a web based blueprint maker is the most simple to use.

=== [[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. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

== 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 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.

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [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.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

File:Overseer.png

2010-09-29T04:39:02Z

Thewonderidiot:

Utility:Overseer

2010-09-29T04:37:55Z

Thewonderidiot: Created page with 'Overseer Screenshot ==Fortress Overseer== Fortress Overseer is a full 3D DF2010 visualizer by thewonderidiot and sexymustard. The generated mode…'

[[File:overseer.png|thumb|right|Overseer Screenshot]]
==Fortress Overseer==
Fortress Overseer is a full 3D DF2010 visualizer by thewonderidiot and sexymustard. The generated model can be exported to several popular 3D formats(eg .obj). More information can be found in the [http://www.bay12forums.com/smf/index.php?topic=63484.0 bay12forums topic], and Overseer itself can be downloaded from [http://dffd.wimbli.com/file.php?id=2922 its page on DFFD].

Overseer uses OpenSceneGraph in conjunction with the DFHack library.

==Adding Custom Content==
===Models===
Models are stored in the /models/ directory. For now, they must be in the OSG IVE format. Many model types can be converted to IVE via the osgconv tool included with the binary OSG distributions, available [http://www.openscenegraph.org/projects/osg/wiki/Downloads here]. IVE bundles textures with the model, so textures used on the model need not be included when distributing the IVE.

Currently only the included IVE's can be swapped out for new things. In the near future, Overseer will load in models sharing the name as the item/construction name.

For most things that can be different kinds of materials in the game, textures should not be included in the IVE. Rather, if the IVE contains texture coordinates, Overseer will simply assign the proper material type to it, using the same textures, normals, and shaders as the world geometry.
===Textures===
All textures are detected live. Overseer looks for a texture file with the same name as the material's name in the raws, and uses it if it exists. If not, it defaults to a rough-stone-looking texture blended with Japa's colors for Stonesense (stored in /colors/).
====Images====
Images for a material must have the same name the material has in the raws. Diffuse textures are found in /materials/images. Their dimensions should be a power of two. If they have an accompanying normal map, it needs to be named with the same name as the diffuse texture but with an n on the end (eg, if native_gold.bmp is the diffuse texture, native_goldn.bmp is its normal map). The normal maps go in /materials/normals.
====Shaders====
Shaders for Overseer are written in GLSL. The included shader is defaulted to when a normal map for a texture is found -- it provides simple bumpmapping. If there is a program found that shares the same name as the material's raw name, however, it prefers to use that instead. This way, each material can have its own shader programs.

Shaders are somewhat limited right now and can only take in the parameters used in the default shaders. This will be threshed out more in the future.

[[Category:Utilities]]