Dwarf Fortress Wiki - User contributions [en]

40d Talk:Utilities

2008-08-22T13:36:50Z

Kdonnelly:

__TOC__

=== Dwarf Fortress File Depot ===
Would be great to get the majority of these uploaded to the [http://dffd.wimbli.com/ Dwarf Fortress File Depot (DFFD)]. I'm having trouble with some of the currently linked hosting sites. I've just gotten Regional Prospector, so I'll see about getting that one up. Thanks guys! --[[User:SlMagnvox|SlMagnvox]] 14:33, 25 February 2008 (EST)

<hr>

=== Accent Removal ===
I added the accent removal utility here from [[Accent Removal]], since that's about to be deleted. However, none of Wikipedia's show-hide-box stuff works here (I assumed it would...), so it's a big glob of pre-formatted text in there that should be hidden. Could someone do it? [[User:Zardus|Zardus]] 00:51, 15 May 2008 (EDT)
:[[User:Jackard/Accent_Removal|Accent removal tutorial]] contains detailed instructions on the subject. I think, we could replace the whole thing on utility page with one link. [[User:Nophotoavailable|Nophotoavailable]] 20:58, 1 August 2008 (EDT)

=== AutoHotKey ===
Should autohotkey be added as a utility tool for dwarf fortress? I know a few forum users have used it to do repetitive tasks like room designations, maybe it could have its own page and a few dwarf fortress specific script?--[[User:Thehunterunseen|Thehunterunseen]] 20:43, 31 October 2007 (EDT)

:Ive been looking for a macro program that works within dwarf fortress and thats free. Havent found a good program thats the combination of both. What do you use? --[[User:Mizipzor|Mizipzor]] 20:51, 31 October 2007 (EDT)

::autohotkey <sup>[http://www.autohotkey.com/]</sup> is a program like that --[[User:Thehunterunseen|Thehunterunseen]] 21:13, 31 October 2007 (EDT)

:::That was the program I used. Wierd. For me, when I inputed "6" for moving one step right... it moved like 8 steps right or something. Couldnt figure out why. Any ideas? --[[User:Mizipzor|Mizipzor]] 22:57, 31 October 2007 (EDT)

::::I know that {{k|shift}} + {{k|→}} = 10×{{k|→}}. Could that have something to do with it? --[[User:Savok|Savok]] 23:17, 31 October 2007 (EDT)

:::::I use "Send {LeftArrow}{Enter}{Enter}", as a test to simply have the wall/floor im building to be placed one step to the right instead of where the cursor actually is. As previously said, however, it didnt work. --[[User:Mizipzor|Mizipzor]] 07:05, 1 November 2007 (EDT)

::::::That might be because the {LeftArrow} part isn't right. It's supposed to be just {Left}. I've downloaded the program myself and am not having any issues with it in DF.. I'm running XP, and use it in fullscreen mode, if that helps any. --[[User:Hesitris|Hesitris]] 18:53, 12 November 2007 (EST)

: So could some people who actually know some autohotkey scripts make an article and submit some? --[[User:Thehunterunseen|Thehunterunseen]] 13:37, 6 November 2007 (EST)

::I use it and more or less know how it works but as soon as I use it inside DF it bugs out completely and I have no idea why. --[[User:Mizipzor|Mizipzor]] 17:56, 6 November 2007 (EST)

:::I have a number of scripts that I use, but they randomly bug out for no apparent reason. They will work fine in notepad (ie, output everything exactly as I expect), but be only partially executing and then failing in DF. Again, sometimes they work fine. I could post them and how they work if someone wants. FYI, I am on Vista and that may be an issue. --[[User:Geofferic|Geofferic]] 02:39, 19 November 2007 (EST)

::::I'm not sure how CPU cycles and the buffer interact in Vista. Is your FPS low? Perhaps a key is dropping out of the buffer but DF isn't recognizing it due to lag? Or lag might be making the buffer overflow. It might depend on how autohotkey sends keystrokes, I don't know if it simulates a key press or directly input ssomething into the buffer. You could try a small sleep(50), or the equivalent, in autohotkey and see if that helps. Also, make sure it isn't losing focus for some reason due to background programs (although that would be strange) -Gotthard

:::::I think it's a lag issue in DF. I've yet to figure out exactly what is causing lag for me. I think it's pathing with too many dwarfs and too complex of a hallway system over too many Z levels. Also, I think playing very large maps causes me to lag, as well, but I think that's related to the pathing problem and all those other creatures trying to path. It definitely got better in this version, tho. I will hold off on trying to say definitively what's up with AuthoHotkey until after the next patch. --[[User:Geofferic|Geofferic]] 03:50, 21 November 2007 (EST)

::::::AHK does tend to do wierd stuff in DF, but most of it is predictable. A lot of wierd errors that make no sense can be fixed by explicitely telling the script to focus on the Dwarf Fortress window, as well as generous Sleep statements. I found while rewalling a 30x30 outline, sleep 100 worked fine for the first two sides but posted about half of the second two. Sleep 150 placed the second two somewhat erraticly. Sleep 200 got the second two just fine. --[[User:Knivesu|Knivesu]] 10:22, 23 December 2007 (EST)

=== Dwarf Foreman ===
Foreman is looking at the wrong address for the units... which is not a good sign, since I've seen it in the address it seems to be looking at. I've also seen it bounce around. Definitely not a good sign if the list location isn't static. Or we're just looking at the wrong one completely. --[[User:AzureLightning|AzureLightning]]

:It's pretty easy to find the addresses for this for new versions. Running the program in the directory with the new version gives you the check= value, and the others are moderately easy to suss. Also, I don't know exactly how it works or why it works, but from C->D->E start and pos were incremented 0x1000 each version, so laziness dictates trying that in future. [[User:Qalnor|Qalnor]] 16:37, 9 December 2007 (EST)

Is there any info on what the offsets (dwarfidpos, critter_start, profession_start) actually refer to? I'm capable enough with finding memory addresses, but exactly what profession_start is eludes me. Even dwarfidpos is a little unclear.

dwarfidpos = Address of Dwarf Race ID
critter_start = Start of Main Creature Vector
profession_start = Offset into Main Creature Vector the array of jobs.
[[User:Jifodus|Jifodus]] 00:41, 7 March 2008 (EST)

Does anyone know the values for v0.28.181.39f? --[[User:Aristoi|Aristoi]] 18:18, 10 August 2008 (EDT)

:Still no word on 39f? Perhaps we can get a little write-up on how to discover the appropriate values added to the foreman homepage. That way, when a new version of DF is released, any number of people could search for and contribute the new values, instead of depending on the few people who already know the process. --[[SWSaunders|SWSaunders]] 09:10, 12 August 2008 (ADT)

::Thanks Jerethi50, beat me to it. When I went to enter the values you already had! SWSaunders: What I did (having never done this before) was to download a memory viewer (HxD hexeditor) and then look at the old version vs the new version in memory. In the old version, I found the character at the dwarfidpos address and searched forward till I found that in the new file. For critter_start I went to the old process and found it there, then searched forward in the new process till I found the pattern match (it wasn't too far). The data was different but the pattern was the same. The profession offset hasn't changed so I left it as is. --[[User:Aristoi|Aristoi]] 11:13, 12 August 2008 (EDT)

:::That's exactly how I do it, except I have written a program that does it for me, since it saves time. I also tend to forget to post Dwarf Foreman's new config during updating. Usually I remember to update the tables at http://www.geocities.com/jifodus/tables/ini_jifodus/ and that has all the information you'd need (critter_start=[creature_data].base; profession_start=[creature_data].jobs); however, it seems I didn't update it this last go around. If you wander around my website, you should be able to find enough information posted there (provided you can understand it all) to learn how to update foreman for yourself. --[[User:Jifodus|Jifodus]] 22:22, 14 August 2008 (EDT)

To make Foreman compatible with previous versions of Dwarf Fortress, update the config file as shown below.

==== v0.27.168.33g ====
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

==== v0.27.173.38a ====
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

==== v0.27.176.38a ====
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

==== v0.27.176.38b ====
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

==== v0.27.176.38c ====
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

==== v0.28.181.39a ====
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

==== v0.28.181.39b ====
<pre>
check=01a16957
critter_start=015134f4
dwarfidpos=013201b8
profession_start=0474
</pre>

==== v0.28.181.39c ====
<pre>
check=01b89dbc
critter_start=01513514
dwarfidpos=013201d8
profession_start=0474
</pre>

==== v0.28.181.39d ====
<pre>
check=01b0747e
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

==== v0.28.181.39e ====
<pre>
check=01b76baa
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

==== v0.28.181.39f ====
<pre>
check=036276be
critter_start=01575dec
dwarfidpos=01382690
profession_start=0474
</pre>

==== v0.28.181.40a ====
<pre>
check=03186cb3
critter_start=0158222c
dwarfidpos=0138e698
profession_start=0474
</pre>

40d Talk:Utilities

2008-08-22T13:36:24Z

Kdonnelly: Added 40a to older version foreman values list

40d:Utilities

2008-08-22T13:35:25Z

Kdonnelly: Updated foreman values for 40c

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 [http://www.dwarffortresswiki.net/index.php/User:Janus Janus]; for files related to Dwarf Fortress only.

== 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.bay12games.com/forum/index.php?topic=608.0 3Dwarf Visualizer] ===
This is NOT realtime, that is still a long, long way off. What this does is read the map out of your computer's memory when DF 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.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://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.40c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] for previous versions of DF.
<pre>
check=032e896f
critter_start=0158222C
dwarfidpos=0138E698
profession_start=0474
</pre>

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===
A toolset with many modules for tweaking / editing Dwarf Fortress memory.

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

== Minor Utilities ==
=== 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/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 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, and you had not yet discovered any subsurface magma. (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.

This utility has been made version-independent. It is expected to work with future releases of Dwarf Fortress.

=== [http://www.geocities.com/jifodus/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.geocities.com/jifodus/nanofortress.zip 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)

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.

== 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://code.google.com/p/dwarvis/ Dwarvis/MapExtract] ===
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.

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