Dwarf Fortress Wiki - User contributions [en]

40d:Utilities

2009-11-14T17:32:27Z

Jifodus: /* Just dig it out! */ Geocities is gone, new link

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

=== [http://www.bay12games.com/forum/index.php?topic=43260.0 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.

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

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

=== 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:Jifodus

2009-03-11T04:35:15Z

Jifodus:

My work analyzing DF's formats: [[User:Jifodus/Memory research|Memory research]], [[User:Jifodus/CMV file format|CMV file format]], [[User:Jifodus/Dwarf Fortress Utility Framework|Dwarf Fortress Utility Framework]], [[User:Jifodus/Map block|Map block info]]

If you run Mac or Linux and know and can spend time analyzing Dwarf Fortress code, I have a pitiful attempt at creating a cross-platform memory editor library. At the moment I only have a Windows version, I'll be working on a Linux port next.

==Memory==
I'm removing the memory lists since they are now unneeded. For [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak's]] configuration check out http://www.geocities.com/jifodus/tables/dwarvis/. The line you'll need to stick inside DwarfFortress.Versions.xml can be found commented out at the bottom of each core.xml file.

You also may try using my [http://www.bay12games.com/forum/index.php?topic=24897.msg282605#msg282605 Automatic Address & Offset finder], which is capable of generating the configuration for Tweak with little to no knowledge required.

==Tools==
===tile_tool===
I wrote a tool that allows nearly complete editing of a tile's data. It's designed for analyzing a tile's data. Since it's not designed for mass editing, therefore I don't recommend using it for adding more than a couple tiles of water or magma. Or build multiple buildings on top of each other. Use '?' for in-tool help.

http://www.geocities.com/jifodus/tile_tool.zip (61KB)

Mar 04, 2008: http://www.geocities.com/jifodus/auto-update_tile_tool.zip (75KB) - Alternate version that is usable as soon as configuration gets uploaded for it. Source code: http://www.geocities.com/jifodus/tile_tool_src.zip (14KB)

Editable information:
* Liquid Level
* Designation Flags
* Occupancy Flags
* Temperature
* Tile #
* Unknown Values

Additional features:
* Track tile data.
* Compare a tile with a tracked tile.
* Dump the raw bits of Designation, Occupancy, Pathfinding and Unknowns.

===Source Code===
I'm going to be dumping the source code for some of my projects in my new mercurial repository located at: http://75.127.91.201/phg/df/

To clone the repository you'll need a mercurial client which you can get from: http://www.selenic.com/mercurial/wiki/

The repository currently contains the source code to my [http://www.bay12games.com/forum/index.php?topic=24897.msg282605#msg282605 Automatic Address & Offset finder], [http://www.bay12games.com/forum/index.php?topic=22167.msg239976#msg239976 TelnetFortress], and a couple unfinished projects: a help editor, a map editor, and the next version of TelnetFortress which would be contained in an OpenGL wrapper and access the screen buffer directly. I'll probably be adding more of my DF related projects to the repository sometime when I have the time.

If a particular project in the repository doesn't list a license, it is probably going to be under an MIT license. Also PM me on the forums so that I can properly add the license info.

[[Category:Hacking]]

User:Jifodus

2009-03-10T05:42:34Z

Jifodus:

My work analyzing DF's formats: [[User:Jifodus/Memory research|Memory research]], [[User:Jifodus/CMV file format|CMV file format]], [[User:Jifodus/Dwarf Fortress Utility Framework|Dwarf Fortress Utility Framework]], [[User:Jifodus/Map block|Map block info]]

If you use a Mac or Linux and can spend time debugging and analzying Dwarf Fortress dissasembly for said platforms. Please take a look at http://75.127.91.201/phg/df/ and more specifically opengl32. Basically it's my feeble attempt at working towards more cross-platform utilities.

==Memory==
I'm removing the memory lists since they are now unneeded. For [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak's]] configuration check out http://www.geocities.com/jifodus/tables/dwarvis/. The line you'll need to stick inside DwarfFortress.Versions.xml can be found commented out at the bottom of each core.xml file.

You also may try using my [http://www.bay12games.com/forum/index.php?topic=24897.msg282605#msg282605 Automatic Address & Offset finder], which is capable of generating the configuration for Tweak with little to no knowledge required.

==Tools==
===tile_tool===
I wrote a tool that allows nearly complete editing of a tile's data. It's designed for analyzing a tile's data. Since it's not designed for mass editing, therefore I don't recommend using it for adding more than a couple tiles of water or magma. Or build multiple buildings on top of each other. Use '?' for in-tool help.

http://www.geocities.com/jifodus/tile_tool.zip (61KB)

Mar 04, 2008: http://www.geocities.com/jifodus/auto-update_tile_tool.zip (75KB) - Alternate version that is usable as soon as configuration gets uploaded for it. Source code: http://www.geocities.com/jifodus/tile_tool_src.zip (14KB)

Editable information:
* Liquid Level
* Designation Flags
* Occupancy Flags
* Temperature
* Tile #
* Unknown Values

Additional features:
* Track tile data.
* Compare a tile with a tracked tile.
* Dump the raw bits of Designation, Occupancy, Pathfinding and Unknowns.

===Source Code===
I'm going to be dumping the source code for some of my projects in my new mercurial repository located at: http://75.127.91.201/phg/df/

To clone the repository you'll need a mercurial client which you can get from: http://www.selenic.com/mercurial/wiki/

The repository currently contains the source code to my [http://www.bay12games.com/forum/index.php?topic=24897.msg282605#msg282605 Automatic Address & Offset finder], [http://www.bay12games.com/forum/index.php?topic=22167.msg239976#msg239976 TelnetFortress], and a couple unfinished projects: a help editor, a map editor, and the next version of TelnetFortress which would be contained in an OpenGL wrapper and access the screen buffer directly. I'll probably be adding more of my DF related projects to the repository sometime when I have the time.

If a particular project in the repository doesn't list a license, it is probably going to be under an MIT license. Also PM me on the forums so that I can properly add the license info.

[[Category:Hacking]]

User:Jifodus

2009-02-11T08:21:16Z

Jifodus: Link to repository for my project source code

User:Jifodus/Memory research

2008-10-11T18:30:28Z

Jifodus: /* Buildings */

[[Category:Hacking]]
=October 11, 2008=
===Hotkeys===
struct Hotkey {
string name;
word unused; // 0 if used (possibly also mode, since unused is -1)
word padding0; // most likely padding
int x;
int y;
int z;
} // size = 0x2C
===Buildings===
See http://www.bay12games.com/forum/index.php?topic=24897.msg303143#msg303143
0x015838A0
0x015838B0
0x015838F0 - Has fewer elements than the other two. May exclude stockpiles.

===Items===
See http://www.bay12games.com/forum/index.php?topic=24897.msg303143#msg303143
0x015832C8 - A monitoring tool detected items that existed one frame then were gone the next
0x015832D8 - As items disappeared (like above), the index decreased by one. Looks promising as the global item vector.
0x015833B8 - Always has fewer elements than the other two

=v0.27.169.33b=
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x0124A6A0
| class game *
| game_data
| I have not actually determined if this is a class, but I'm reasonably sure that this points to a class.

|}
==Classes==
===class game===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0004
| class df_params *
| start_params
| The starting parameters for a new Dwarf Fortress game.

|}
===class df_params===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | (00DC) 00D8
| std::vector<class dwarf_info>
| dwarf_params
| The starting dwarves.

|-
| align="right" | 010E
| word
| sel_item
| The current selected item in the item list.

|-
| align="right" | 0290
| signed word
| points
| The current amount of points available to spend.

|}
===class dwarf_info===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0070
| signed dword[80]
| skills
| The dwarf's skill levels.

|-
| align="right" | 01C0
| signed dword
| skill_points
| The number of skill levels left that can be assigned to the dwarf.

|}
=v0.27.169.33c=
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x01250698
| class game *
| game_data
| I have not actually determined if this is a class, but I'm reasonably sure that this points to a class.

|}
==Classes==
===class game===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0004
| class df_params *
| start_params
| The starting parameters for a new Dwarf Fortress game.

|}
===class df_params===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | (00DC) 00D8
| std::vector<class dwarf_info>
| dwarf_params
| The starting dwarves.

|-
| align="right" | 010E
| word
| sel_item
| The current selected item in the item list.

|-
| align="right" | 112
| word
| sel_item
| The current selected animal in the pet list.

|-
| align="right" | 7F8
| signed dword
| fortress_name_front
| Fortress Name (Front Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 7FC
| signed dword
| fortress_name_rear
| Fortress Name (Rear Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 800
| signed dword
| fortress_name_first
| Fortress Name (First Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 804
| signed dword
| fortress_name_second
| Fortress Name (Second Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 808
| signed dword
| fortress_name_hypen
| Fortress Name (Hyphen Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 80C
| signed dword
| fortress_name_the
| Fortress Name (The X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 810
| signed dword
| fortress_name_of
| Fortress Name (Of X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 864
| signed dword
| group_name_front
| Group Name (Front Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 868
| signed dword
| group_name_rear
| Group Name (Rear Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 86C
| signed dword
| group_name_first
| Group Name (First Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 870
| signed dword
| group_name_second
| Group Name (Second Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 874
| signed dword
| group_name_hypen
| Group Name (Hyphen Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 878
| signed dword
| group_name_the
| Group Name (The X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 87C
| signed dword
| group_name_of
| Group Name (Of X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 08F0
| signed word
| points
| The current amount of points available to spend.

|}
===class dwarf_info===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0070
| signed dword[80]
| skills
| The dwarf's skill levels.

|-
| align="right" | 01C0
| signed short
| skill_points
| The number of skill levels left that can be assigned to the dwarf.

|}
=v0.27.169.33d=
Everything is the same as [[User:Jifodus/Memory research|v0.27.169.33c]] except the <tt>class game*</tt> is 0x1000 higher than [[User:Jifodus/Memory research|v0.27.169.33c]].
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x01251698
| class game *
| game_data

|}
=v0.27.169.33e=
Everything is the same as [[User:Jifodus/Memory research|v0.27.169.33c]] except the <tt>class game*</tt> is 0x2000 higher than [[User:Jifodus/Memory research|v0.27.169.33c]].
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x01252698
| class game *
| game_data

|}

User:Jifodus/Memory research

2008-10-11T18:27:31Z

Jifodus: Some new stuff I discovered when determining patters to add.

[[Category:Hacking]]
=October 11, 2008=
===Hotkeys===
struct Hotkey {
string name;
word unused; // 0 if used (possibly also mode, since unused is -1)
word padding0; // most likely padding
int x;
int y;
int z;
} // size = 0x2C
===Buildings===
See http://www.bay12games.com/forum/index.php?topic=24897.msg303143#msg303143
0x015838A0
0x015838B0
0x015838F0 - Has fewer elements than the other two
===Items===
See http://www.bay12games.com/forum/index.php?topic=24897.msg303143#msg303143
0x015832C8 - A monitoring tool detected items that existed one frame then were gone the next
0x015832D8 - As items disappeared (like above), the index decreased by one. Looks promising as the global item vector.
0x015833B8 - Always has fewer elements than the other two

=v0.27.169.33b=
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x0124A6A0
| class game *
| game_data
| I have not actually determined if this is a class, but I'm reasonably sure that this points to a class.

|}
==Classes==
===class game===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0004
| class df_params *
| start_params
| The starting parameters for a new Dwarf Fortress game.

|}
===class df_params===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | (00DC) 00D8
| std::vector<class dwarf_info>
| dwarf_params
| The starting dwarves.

|-
| align="right" | 010E
| word
| sel_item
| The current selected item in the item list.

|-
| align="right" | 0290
| signed word
| points
| The current amount of points available to spend.

|}
===class dwarf_info===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0070
| signed dword[80]
| skills
| The dwarf's skill levels.

|-
| align="right" | 01C0
| signed dword
| skill_points
| The number of skill levels left that can be assigned to the dwarf.

|}
=v0.27.169.33c=
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x01250698
| class game *
| game_data
| I have not actually determined if this is a class, but I'm reasonably sure that this points to a class.

|}
==Classes==
===class game===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0004
| class df_params *
| start_params
| The starting parameters for a new Dwarf Fortress game.

|}
===class df_params===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | (00DC) 00D8
| std::vector<class dwarf_info>
| dwarf_params
| The starting dwarves.

|-
| align="right" | 010E
| word
| sel_item
| The current selected item in the item list.

|-
| align="right" | 112
| word
| sel_item
| The current selected animal in the pet list.

|-
| align="right" | 7F8
| signed dword
| fortress_name_front
| Fortress Name (Front Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 7FC
| signed dword
| fortress_name_rear
| Fortress Name (Rear Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 800
| signed dword
| fortress_name_first
| Fortress Name (First Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 804
| signed dword
| fortress_name_second
| Fortress Name (Second Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 808
| signed dword
| fortress_name_hypen
| Fortress Name (Hyphen Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 80C
| signed dword
| fortress_name_the
| Fortress Name (The X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 810
| signed dword
| fortress_name_of
| Fortress Name (Of X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 864
| signed dword
| group_name_front
| Group Name (Front Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 868
| signed dword
| group_name_rear
| Group Name (Rear Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 86C
| signed dword
| group_name_first
| Group Name (First Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 870
| signed dword
| group_name_second
| Group Name (Second Adjective). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 874
| signed dword
| group_name_hypen
| Group Name (Hyphen Compound). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 878
| signed dword
| group_name_the
| Group Name (The X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 87C
| signed dword
| group_name_of
| Group Name (Of X). -1 if not used, otherwise index into the dictionary (which dictionary I don't know).

|-
| align="right" | 08F0
| signed word
| points
| The current amount of points available to spend.

|}
===class dwarf_info===
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Offset (+Hex)
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0070
| signed dword[80]
| skills
| The dwarf's skill levels.

|-
| align="right" | 01C0
| signed short
| skill_points
| The number of skill levels left that can be assigned to the dwarf.

|}
=v0.27.169.33d=
Everything is the same as [[User:Jifodus/Memory research|v0.27.169.33c]] except the <tt>class game*</tt> is 0x1000 higher than [[User:Jifodus/Memory research|v0.27.169.33c]].
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x01251698
| class game *
| game_data

|}
=v0.27.169.33e=
Everything is the same as [[User:Jifodus/Memory research|v0.27.169.33c]] except the <tt>class game*</tt> is 0x2000 higher than [[User:Jifodus/Memory research|v0.27.169.33c]].
==Addresses==
{| width="100%" border="1" cellspacing="0" cellpadding="2"
! width="12%" align="right" | Address
! width="25%" | Type
! width="13%" | Name
! width="50%" | Information

|-
| align="right" | 0x01252698
| class game *
| game_data

|}

User:Jifodus

2008-10-08T01:01:51Z

Jifodus: /* Memory */ Automatic Address & Offset finder

40d:Utilities

2008-09-08T06:54:04Z

Jifodus: /* [http://www.pavlovian.net/foreman/ Dwarf Foreman] */ v0.28.181.40d

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

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

40d:Utilities

2008-08-18T18:28:20Z

Jifodus: /* [http://www.pavlovian.net/foreman/ Dwarf Foreman] */ v0.28.181.40a

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/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 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.39f''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] for previous versions of DF.
<pre>
check=036276be
critter_start=01575dec
dwarfidpos=01382690
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.40a''', update config file as shown below.
<pre>
check=03186cb3
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. [[User:Rick/Tweak|Check the full article for more details]].

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

=== Accent Removal ===
[[Image:Rj-unitlist.png|thumb|right|Replacing accented letters with normal ones in the raws fixes this problem.]]
You can remove accents from your texts - this even works on existing worlds.

1. Download [http://www.inforapid.de/html/searchreplace.htm Inforapid Search and Replace.] 
2. Download [http://myfreefilehosting.com/f/59b18a517f_0.1MB this text file.] 
3. Find the following files in DF\raw\objects: 
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

4. Select them all, right-click and choose 'Search with InfoRapid' from the menu. 
5. Click the Replace tab that shows up in the lower half of the window. 
6. Select your text file from before in the Replace With field, make sure Replace is set to 'Whole Search Expression' and click Start. 
7. A prompt will appear asking for confirmation. Check the Replace All button and click Yes.

When the program stops running you are done. Go ahead and close InfoRapid, no need to save search results.

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

=== Regional Prospector ===
For Dwarf Fortress 28.181.39a and newer: [http://www.bay12games.com/forum/index.php?topic=20643.0]
For older versions: [http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

Dwarf Fortress 0.28.181.39d and newer implement some of the functionality of Regional Prospector.

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

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

40d Talk:Utilities

2008-08-15T02:22:38Z

Jifodus: /* Dwarf Foreman */

== DF 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)

== External Utilities ==
I thinking any Utilities that not made specifically for Dwarf fortress should put together at bottom which I have done. My question should we mark area with header say External utilities? [[User:Omagaalpha|Omagaalpha]] 08:22, 14 February 2008 (EST)

== 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 [http://www.autohotkey.com/] 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)

== Yourfilehost ==

Yourfilehost.com has kind of a lousy reputation, and I can confirm it's blocked on certain college networks. Could someone upload these utilities to a more reputable host? -- Mzbundifund 15:55, 04 November 2007 (EDT)
: Such as? --[[User:Rick|Rick]] 18:03, 4 November 2007 (EST)
:: Megaupload, rapidshare, filefactory, you pick one --[[User:Digger|Digger]] 17:40, 24 February 2008 (EST)
:::Uh, you know there is a special site for uploading DF files now, right? It's linked on the main page. Screw those other guys. --[[User:Jackard|Jackard]] 17:53, 24 February 2008 (EST)
::::I say we scrap this section, then. --[[User:Digger|Digger]] 18:28, 24 February 2008 (EST)

==heal.exe==

heal.exe does not regrow missing limbs. However, "heal -hurt" on the command line brings missing limbs to red status, and "heal" thereafter restores the being to full health.

I propose a -regrow parameter so we don't have to do this workaround, since if it's possible to bring missing limbs from dark grey to red status it's also possible to grow them back.

Also, when using the -hurt parameter, it still says "059E7210 had 31 body parts '''healed'''", when it should probably say "wounded". --[[User:JT|JT]] 17:58, 10 November 2007 (EST)

: Hmm, if it does heal missing limbs then I just need to change my logic slightly for healing. --[[User:Rick|Rick]] 19:01, 10 November 2007 (EST)

==reveal.exe==

From what I've tested, reveal for 33a does not work for 33b. --[[User:Sparksol|Sparksol]] 13:39, 17 November 2007 (EST)

:Correct. It uses hardcoded offsets, which will change every time new code is added to DF.
:I have a version hacked for .33b, which I will not distribute out of respect for Rick.
:However, if you are skilled with a hex editor, here's what to do: change the first 5 occurances of the pattern 85 45 01 to the pattern 95 45 01. (The 6th occurance of the pattern is a coincidental match and should not be changed.) Then change the pattern 8C 33 89 00 to the pattern 8C 43 89 00. —[[User:0x517A5D|0x517A5D]] 02:31, 19 November 2007 (EST)

:Actually, as it happens, it looks like Rick has produced updated versions of his tools for .33b. They were built on the 16th. However he hasn't linked to them. I don't know why. The URL they're at requests that no links be made to them, so I'm not going to tell you. Sorry, you'll just have to do the hexedit. —[[User:0x517A5D|0x517A5D]] 02:45, 19 November 2007 (EST)

:I just havn't mirrored them yet, that's all. --[[User:Rick|Rick]] 03:10, 19 November 2007 (EST)
::Hey, I'm curious why the file sizes ballooned. Reveal went from 52k to 101k, a doubling in size. Heal grew even more. Maybe you didn't strip debugging info? —[[User:0x517A5D|0x517A5D]] 15:42, 19 November 2007 (EST)
:::Usage of std libraries mostly. I made a library for working with DF so I wouldn't have to keep duplicating code through projects, and when writing it I figured I might as well make it more friendly for me to code in, hence usage of std:: stuff. --[[User:Rick|Rick]] 19:00, 19 November 2007 (EST)

:Whenever I try to open reveal.exe, the window will open up for a millisecond and then immedietely close. Is this a problem with the program or my windows? I am assuming its windows since everyone else seems to be able to use it. Has anyone else had this problem?--[[User:Varsashi|Varsashi]] 17:59, 26 November 2007 (EST)

::It hasn't been updated to work with 33c, and doesn't. Hopefully it will be updated soon. If you're using 33b, it should open and close quickly but reveal all allocated squares. To allocate all squares for revealing, I'll repeat the advice I've seen elsewhere: go to the lowest level and designate the entire level for digging, then remove the dig designation and run the reveal utility. --[[User:Janus|Janus]] 20:08, 26 November 2007 (EST)

So how do people feel about deleting this section, and probably the heal.exe section above too? —[[User:0x517A5D|0x517A5D]] 00:56, 23 December 2007 (EST)

Does anybody know which version works with 38b? And can you also give me the link? --[[User:CrazyMcfobo|CrazyMcfobo]] 16:51, 15 April 2008 (EDT)

I went back to look for reveal.exe for the older version of DF I play (I've been sticking to the last good version where we still had the original mountain, 23.13.23a), but the file seems to have been corrupted at that place it's uploaded to. Now when I try to use it it says it's not a valid win32 application, and it's a 0-byte file after unzipping. Is there a good version up somewhere else still? --[[User:KittenyKat|KittenyKat]] 11:52, 16 April 2008 (EDT)

==How to use warp.exe?==
How do you use warp.exe? There's no information on how to use these on the page.--[[User:Demosthenes|Demosthenes]] 02:10, 21 November 2007 (EST)
: <code>warp.exe</code> by itself will list your current cursor position. After you have the position you want to warp a creature to, you do <code>warp.exe <x> <y> <z></code> as arguments, and it will warp the selected creature (selected with 'V'iew) to that destination, if it can. --[[User:Rick|Rick]] 18:10, 21 November 2007 (EST)

==StartProfile==
Perhaps, I don't understand how to use this correctly. I'm using 33e, and the StartProfile linked in the Utils section. I'm supposed to use this util at the Prepare for the Journey screen, correct? I tried testing the export function with the first dwarf, with no skills assigned. startprofile.exe -x 0 test.txt What I got back was: 
<code>
Mining: 1348403210 
Wood Cutter: 1565676876 
Carpenter: 3801123 
Engraving: 34079120 
Record Keepe: 2293770 
Liar: 34341293 
Intimidator: 16843009 
Conversationalist: 16843009 
Comedian: 16843009 
Flatterer: 16843009 
Consoler: 16843009 
Pacifier: 16843009 
</code>
When I try to set a dwarf's skills using StartProfile I end up with huge amounts of either negative or positive points available, with no changes being made to the dwarf's skills. --[[User:Stu72|Stu72]] 09:23, 11 December 2007 (EST)
: The offset for the skills must have changed. I guess I should've actually checked that, and not have assumed that just because the other values were correct, the skills were still correct. I'll check it out and post the appropriate fix. -- [[User:Jifodus|Jifodus]]
: The appropriate fix is redownloading it, when I hex edited the exe I messed it up field. -- [[User:Jifodus|Jifodus]]
:: Thanks, works beautifully. It's a terrific time saver. --[[User:Stu72|Stu72]] 15:30, 14 December 2007 (EST)

How does one use this? The readme isn't very helpful. --[[User:Jackard|Jackard]] 01:08, 27 November 2007 (EST)
: Not knowing exactly what you're having trouble understanding, I'll give examples (the one thing I forgot to add in the readme). <code>startprofile 0 Miner.txt</code> - This will set the skill profile of the first Dwarf, in the list of units, to the skills in Miner.txt <code>startprofile 1 Jeweler.txt</code> - This will set the skills on the second Dwarf, in the list of units, to the skills in Jeweler.txt <code>startprofile -x 3 Customprofile.txt</code> - This will save the set of skills on the fourth Dwarf to Customprofile.txt <code>startprofile -v0.27.169.33b 0 Miner.txt</code> Same as the first example, except it'll work on the previous version of Dwarf Fortress. -- [[User:Jifodus|Jifodus]] 03:28, 27 November 2007 (EST)
::Thanks, I'll try that out. --[[User:Jackard|Jackard]] 21:21, 27 November 2007 (EST)

If you wish to edit the executable, you can modify it so that it works with 0.27.169.33d by making the following changes with a hex editor:
Offset Overwrite With
----------------------------
2A530 | 98 16 25 01 04 00 00 00 DC 00 00 00 F0 08 00 00 70 00 00 00 C0 01 00 00
2A6A6 | 30 2E 32 37 2E 31 36 39 2E 33 33 64
2A77C | 02
-- [[User:Jifodus|Jifodus]] 20:14, 3 December 2007 (EST)
:CBW; PUSH SS; AND EAX, 00000401h; ADD AH, BL; ADD [EAX], AL; ...
:That makes no sense. Must be missing something off the head end.
:3 unknown bytes; ADD [EAX+EAX], EAX; ... No better. Worse, even.
:4 unknown bytes; ADD AL, 00h; ADD [EAX], AL; ... Unh uh. Don't think so.
:8 unknown bytes; ESC-4(00); ... Floating point? Really? No way.
:12 unknown bytes; LOCK OR [EAX], AL ... Insane.
:I don't know what those bytes are, but they're not code.—[[User:0x517A5D|0x517A5D]] 23:23, 3 December 2007 (EST)
::You're right, they're data. First Row is (left to right, 5 dwords): [[User:Jifodus/Memory research#Addresses_3|Start Address]], Offset from address at start address, Dwarf List begin offset, Starting points offset, Skills offset, remaining skill points points. Second row is a character string (15 chars max). Third row is a dword indicating which data index is default.
:: <tt>//Start Addr, O, Lizt, Ponts, Skll, Remain</tt>
:: <tt>{ 0x01251698, 4, 0xDC, 0x8F0, 0x70, 0x1C0 }</tt> - The read/write locations and whatnot
:: <tt>"0.27.169.33d"</tt> - Used for string comparison (-v flag)
:: <tt>2</tt> - The default version to use is the third in the list (what the above just added).
:: Configuration data can be found between 'DATA_SET' and 'TES_ATAD'. The list has enough space for 16 versions (3 are now in use). I'll just say I didn't want to have to recompile it for all the versions -- [[User:Jifodus|Jifodus]] 21:52, 6 December 2007 (EST)
If you wish to edit the executable, you can modify it so that it works with 0.27.169.33e by making the following changes with a hex editor:
Offset Overwrite With
----------------------------
2A550 |"98 26 25 01"04 00 00 00 DC 00 00 00 F0 08 00 00 70 00 00 00 C0 01 00 00
2A6B5 | 30 2E 32 37 2E 31 36 39 2E 33 33"65"
2A77C |"03"

== Patching Lavasquare ==

Due to someone being interested in running lavasquare on version 33g, I determined how to patch the exe to work with later versions. With a hex editor, open lavasquare.exe and find and replace with appropriate values (replace the X's with the values underneath for the version you want). I only tested it for 33f, but I'm assuming that the values for 33g are correct (since I got them off the wiki).

(CursorX)
FIND: EE 57 68 88 E2 8F 00 FF 35
REPLACE: EE 57 68 XX XX XX 0X FF 35
33f 88 F2 8F 0
33g 88 62 90 0
38a 88 F2 92 0

(CursorY)
FIND: EC 57 68 8C E2 8F 00 FF 35
REPLACE: EC 57 68 XX XX XX 0X FF 35
33f 8C F2 8F 0
33g 8C 62 90 0
38a 8C F2 92 0

(CursorZ)
FIND: E6 57 68 90 E2 8F 00 FF 35
REPLACE: E6 57 68 XX XX XX 0X FF 35
33f 90 F2 8F 0
33g 90 62 90 0
38a 90 F2 92 0

(MapBlocks)
FIND: FC 57 68 60 15 46 01 FF 35
REPLACE: FC 57 68 XX XX XX 0X FF 35
33f 68 25 46 1
33g 80 96 46 1
38a CC 29 49 1

(To exit immediately after writing, since I don't want to
verify the other offsets)
FIND: FF 35 5C 80 40 00 E8 88 61 00 00 0F BF 7D
F8 57 0F BF 7D FA 57 8B 7D FC 81 C7 60 06
00 00
REPLACE: FF 35 5C 80 40 00 E8 88 61 00 00 6A FF FF
25 6C B1 40 00 CC CC CC CC CC CC CC CC CC
CC CC
-- [[User:Jifodus|Jifodus]] 02:05, 25 December 2007 (EST)

To modify the above for the same behavior as water:
FIND: 07 00 20 00
REPLACE: 07 00 00 00
-- [[User:Jifodus|Jifodus]] 17:09, 29 December 2007 (EST)

Addresses for 0.27.173.38a:
CursorX 0x0092F288
CursorY 0x0092F28C
CursorZ 0x0092F290
MapBlocks 0x014929CC
Offsets are still the same.
-- [[User:Jifodus|Jifodus]] 19:14, 7 February 2008 (EST)

Addresses for 0.27.173.38c: (These worked for me, but I'm not an expert on this stuff.)
CursorX 0x0094228C
CursorY 0x00942290
CursorZ 0x00942294
MapBlocks 0x014A60A4
--[[User:Dorundain|Dorundain]] 22:21, 6 March 2008 (EST)

Where is the Mapblocks found in the hex code? 0x01461560.MAP_DATA_MEM is the closest thing I can find.

--[[User:Silveron|Silveron]] 08:57, 22 March 2008 (EDT)

----

== Lavasquare Popup? ==

How do I remove the prompt? It is a painful thing for large projects. The macro below helps some, though. --[[User:Jackard|Jackard]] 08:05, 4 January 2008 (EST)

#Persistent
SetTimer, CloseLava, 100
return

CloseLava:
WinClose, lcc runtime
return

del::
IfWinActive Dwarf Fortress
{
send {down}
run C:\Program Files\Dwarf Fortress\Utilities\lavasquare 33g.exe
return
}
else
{
send {del}
return
}

== Lavasquare ==

Why does it seemingly stop working after a while? It runs but summons no magma/lava. --[[User:Spelguru|Spelguru]] 12:28, 18 January 2008 (EST)
:No idea, never run into the problem though I've used it quite thoroughly. --[[User:Jackard|Jackard]] 17:52, 18 January 2008 (EST)
:I've run into this once. Restarting DF fixed the problem. --[[User:SquirrelFarmer|SquirrelFarmer]] 09:50, 29 January 2008 (EST)

== Water ==

Could someone make an updated version? Having to slaughter anyone who gets injured just because the rain-filling-ponds doesn't work properly yet is annoying. -Shadow_archamgi, February 27 2008

==Weatherdwarf==
I can't find the page, but it's a utility that lets you change the temperature of an area and allows for some crazy stuff. Look it up on the forums; I have a community fortress to tend to. --[[User:Penguinofhonor|Penguinofhonor]] 20:18, 3 March 2008 (EST)

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

== DFWall ==

Mostly directed at the author here, but is there any feature that's useful that's not native? --[[User:N9103|Edward]] 00:57, 31 July 2008 (EDT)

40d:Utilities

2008-08-01T08:44:44Z

Jifodus: /* StartProfile */ New update

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
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.

=== 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]!

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] 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.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory. [[User:Rick/Tweak|Check the full article for more details]].

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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.

This handy utility would be an ideal complement to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.28.181.39a''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39b''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01a16957
critter_start=015134f4
dwarfidpos=013201b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b89dbc
critter_start=01513514
dwarfidpos=013201d8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39d''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b0747e
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39e''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b76baa
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.

Check the [http://www.bay12games.com/forum/index.php?topic=1447.0|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]].

----

== [[User:0x517A5D|0x517A5D]]'s utilities ==

Attention! As the host site of these utilities is placing links to amateur pornographic videos on the download pages, these links are currently Not Safe For Work! Please see my [[User_talk:0x517A5D|User Talk]] page for discussion and a blanket permission to take care of this <strike>issue</strike> problem. Sorry about this. —[[User:0x517A5D|0x517A5D]]

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

For Dwarf Fortress 28.181.39a and newer: [http://www.bay12games.com/forum/index.php?topic=20643.0]
For older versions: [http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

Dwarf Fortress 0.28.181.39d and newer implement the functionality of Regional Prospector, making it unnecessary.

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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.




----

== Embark Anywhere ==
*[http://www.bay12games.com/forum/index.php?topic=21351.0 Bay12Forums Thread]
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.

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

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

Download at [http://winmerge.org/].
[[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)
Edit:--[[User:AtomicTroop|AtomicTroop]] 12:15, 23 March 2008 (EDT)

== DFWall ==

An utility for automatisation 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 link]

Get the newest version here: [http://dffd.wimbli.com/file.php?id=108 link]

== Accent Removal ==

This is a batch file compatible with [http://www.inforapid.de/html/searchreplace.htm InfoRapid Search & Replace.]

It is used on the following raws to remove accented letters from translations:
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

This could be useful for character sets that render accents improperly. Please remember to backup your raws before doing crazy things like this.

<pre>
<Command>
<Search>„</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search> </Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>ƒ</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>†</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>…</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>‡</Search>
<Replace>c</Replace>
</Command>
<Command>
<Search>‚</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>Š</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>ˆ</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>‰</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>¡</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search></Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>Œ</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>‹</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>¤</Search>
<Replace>n</Replace>
</Command>
<Command>
<Search>•</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>”</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>“</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>¢</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>—</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>–</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>£</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>˜</Search>
<Replace>y</Replace>
</Command>
</pre>

== Dtil ==
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 Forum Thread]
Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

== Modbase ==

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

== 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.
Follow [http://dffd.wimbli.com/file.php?id=278 this] link to get to the file. 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!

== DF Log Parser ==
Written by Mephansteras

This is a perl script that parses through the logs to show what civs owned what sites, what thier 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

== 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/justdigitout.zip Utility]

== Nano Fortress ==
A utility that will allow embarks to 1x1 locations.
[http://www.geocities.com/jifodus/nanofortress.zip Utility]

User:Jifodus

2008-07-24T17:01:11Z

Jifodus: /* Memory */ removed memory lists & added dumping grounds for Tweak core.xml

40d:Utilities

2008-07-24T16:53:13Z

Jifodus: /* Dwarf Foreman */ v0.28.181.39e config

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
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.

=== 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]!

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] 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.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory. [[User:Rick/Tweak|Check the full article for more details]].

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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.

This handy utility would be an ideal complement to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.28.181.39a''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39b''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01a16957
critter_start=015134f4
dwarfidpos=013201b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b89dbc
critter_start=01513514
dwarfidpos=013201d8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39d''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b0747e
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39e''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b76baa
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

Attention! As the host site of these utilities is placing links to amateur pornographic videos on the download pages, these links are currently Not Safe For Work! Please see my [[User_talk:0x517A5D|User Talk]] page for discussion and a blanket permission to take care of this <strike>issue</strike> problem. Sorry about this. —[[User:0x517A5D|0x517A5D]]

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

For Dwarf Fortress 28.181.39a and newer: [http://www.bay12games.com/forum/index.php?topic=20643.0]
For older versions: [http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

Dwarf Fortress 0.28.181.39d and newer implement the functionality of Regional Prospector, making it unnecessary.

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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.




----

== Embark Anywhere ==
*[http://www.bay12games.com/forum/index.php?topic=21351.0 Bay12Forums Thread]
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.

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

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

Download at [http://winmerge.org/].
[[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)
Edit:--[[User:AtomicTroop|AtomicTroop]] 12:15, 23 March 2008 (EDT)

== DFWall ==

An utility for automatisation 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 link]

Get the newest version here: [http://dffd.wimbli.com/file.php?id=108 link]

== Accent Removal ==

This is a batch file compatible with [http://www.inforapid.de/html/searchreplace.htm InfoRapid Search & Replace.]

It is used on the following raws to remove accented letters from translations:
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

This could be useful for character sets that render accents improperly. Please remember to backup your raws before doing crazy things like this.

<pre>
<Command>
<Search>„</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search> </Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>ƒ</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>†</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>…</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>‡</Search>
<Replace>c</Replace>
</Command>
<Command>
<Search>‚</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>Š</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>ˆ</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>‰</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>¡</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search></Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>Œ</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>‹</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>¤</Search>
<Replace>n</Replace>
</Command>
<Command>
<Search>•</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>”</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>“</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>¢</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>—</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>–</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>£</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>˜</Search>
<Replace>y</Replace>
</Command>
</pre>

== Dtil ==
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 Forum Thread]
Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

== Modbase ==

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

== 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.
Follow [http://dffd.wimbli.com/file.php?id=278 this] link to get to the file. 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!

== DF Log Parser ==
Written by Mephansteras

This is a perl script that parses through the logs to show what civs owned what sites, what thier 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

40d:Utilities

2008-07-23T23:42:39Z

Jifodus: /* Dwarf Foreman */ v0.28.181.39d config

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
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.

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] 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.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory. [[User:Rick/Tweak|Check the full article for more details]].

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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.

This handy utility would be an ideal complement to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.28.181.39a''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39b''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01a16957
critter_start=015134f4
dwarfidpos=013201b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b89dbc
critter_start=01513514
dwarfidpos=013201d8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39d''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b0747e
critter_start=0151f93c
dwarfidpos=0132c1e0
profession_start=0474
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

Attention! As the host site of these utilities is placing links to amateur pornographic videos on the download pages, these links are currently Not Safe For Work! Please see my [[User_talk:0x517A5D|User Talk]] page for discussion and a blanket permission to take care of this <strike>issue</strike> problem. Sorry about this. —[[User:0x517A5D|0x517A5D]]

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

For Dwarf Fortress 28.181.39a and newer: [http://www.bay12games.com/forum/index.php?topic=20643.0]
For older versions: [http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

Dwarf Fortress 0.28.181.39d and newer implement the functionality of Regional Prospector, making it unnecessary.

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

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

Download at [http://winmerge.org/].
[[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)
Edit:--[[User:AtomicTroop|AtomicTroop]] 12:15, 23 March 2008 (EDT)

== DFWall ==

An utility for automatisation 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 link]

Get the newest version here: [http://dffd.wimbli.com/file.php?id=108 link]

== Accent Removal ==

This is a batch file compatible with [http://www.inforapid.de/html/searchreplace.htm InfoRapid Search & Replace.]

It is used on the following raws to remove accented letters from translations:
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

This could be useful for character sets that render accents improperly. Please remember to backup your raws before doing crazy things like this.

<pre>
<Command>
<Search>„</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search> </Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>ƒ</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>†</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>…</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>‡</Search>
<Replace>c</Replace>
</Command>
<Command>
<Search>‚</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>Š</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>ˆ</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>‰</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>¡</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search></Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>Œ</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>‹</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>¤</Search>
<Replace>n</Replace>
</Command>
<Command>
<Search>•</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>”</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>“</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>¢</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>—</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>–</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>£</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>˜</Search>
<Replace>y</Replace>
</Command>
</pre>

== Dtil ==
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 Forum Thread]
Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

== Modbase ==

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

== 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.
Follow [http://dffd.wimbli.com/file.php?id=278 this] link to get to the file. 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!

== DF Log Parser ==
Written by Mephansteras

This is a perl script that parses through the logs to show what civs owned what sites, what thier 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

40d:Utilities

2008-07-17T16:36:54Z

Jifodus: /* Dwarf Foreman */ v0.28.181.39c compatibility

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
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.

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] 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.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory. [[User:Rick/Tweak|Check the full article for more details]].

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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.

This handy utility would be an ideal complement to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.28.181.39a''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39b''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01a16957
critter_start=015134f4
dwarfidpos=013201b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01b89dbc
critter_start=01513514
dwarfidpos=013201d8
profession_start=0474
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

Attention! As the host site of these utilities is placing links to amateur pornographic videos on the download pages, these links are currently Not Safe For Work! Please see my [[User_talk:0x517A5D|User Talk]] page for discussion and a blanket permission to take care of this <strike>issue</strike> problem. Sorry about this. —[[User:0x517A5D|0x517A5D]]

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

For Dwarf Fortress 28.181.39a and newer: [http://www.bay12games.com/forum/index.php?topic=20643.0]
For older versions: [http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

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

Download at [http://winmerge.org/].
[[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)
Edit:--[[User:AtomicTroop|AtomicTroop]] 12:15, 23 March 2008 (EDT)

== DFWall ==

An utility for automatisation 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 link]

Get the newest version here: [http://dffd.wimbli.com/file.php?id=108 link]

== Accent Removal ==

This is a batch file compatible with [http://www.inforapid.de/html/searchreplace.htm InfoRapid Search & Replace.]

It is used on the following raws to remove accented letters from translations:
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

This could be useful for character sets that render accents improperly. Please remember to backup your raws before doing crazy things like this.

<pre>
<Command>
<Search>„</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search> </Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>ƒ</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>†</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>…</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>‡</Search>
<Replace>c</Replace>
</Command>
<Command>
<Search>‚</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>Š</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>ˆ</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>‰</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>¡</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search></Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>Œ</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>‹</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>¤</Search>
<Replace>n</Replace>
</Command>
<Command>
<Search>•</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>”</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>“</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>¢</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>—</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>–</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>£</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>˜</Search>
<Replace>y</Replace>
</Command>
</pre>

== Dtil ==
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 Forum Thread]
Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

== Modbase ==

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

== 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.
Follow [http://dffd.wimbli.com/file.php?id=278 this] link to get to the file. 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!

User:Jifodus

2008-07-17T16:35:55Z

Jifodus: /* Memory */ Addresses and offsets for 0.28.181.39c

My work analyzing DF's formats:

[[User:Jifodus/Memory research|Memory research]]

[[User:Jifodus/CMV file format|CMV file format]]

[[User:Jifodus/Dwarf Fortress Utility Framework|Dwarf Fortress Utility Framework]]

[[User:Jifodus/Map block|Map block info]]

==Memory==
===v0.28.181.39a===
This is the result of a quick analysis, it's incomplete and only partially checked, but it may allow some of the tools to work. It appears that the existing [[User:Rick/Memory research#Tile Block|map data]] offsets are still valid.
<pre>
menu_state == 0x01322D58
focused_creature == 0x00D16C20
cursor_x == 0x009D6284
cursor_y == 0x009D6288
cursor_z == 0x009D628C
map_count_x == 0x01554040
map_count_y == 0x01554044
map_count_z == 0x01554048
map_data == 0x01554028
main_creature_vector == 0x015124F4
dwarf_race_id == 0x0131F1B8
starting_points == 0x00834693
starting_points_offset == 0x00000904
alt-starting_dwarves == 0x008355A4
alt-language_vector == 0x01555FA8
words_vector == 0x01555E88
happiness_offset == 0x00000520
art_defacement_malus == 0x00850135
skill_limit == 0x00831263
start_game_data == 0x01330D98
creature_jobs == 0x00000474
creature_race == 0x0000008C
creature_x == 0x00000094
creature_y == 0x00000096
creature_z == 0x00000098
creature_id == 0x000000F4
dwarf_civ_id == 0x0131F1AC
creature_civ == 0x00000100
creature_bodyparts == 0x000002FC
alt-creature_pain == 0x00000364
creature_exhaustion == 0x00000368
creature_hunger == 0x0000036C
creature_thirst == 0x00000370
creature_drowsiness == 0x00000374
creature_strength == 0x00000438
creature_agility == 0x0000043C
creature_toughness == 0x00000440
creature_skills == 0x00000444
creature_total_xp == 0x000004DC
dwarf_fortress == 0x009623E4
pe_timestamp == 0x00400108
pe_timestampv == 0x487B4E8B
dwarf_foreman_check == 0x01AA9D3A
</pre>
===v0.28.181.39b===
This is the result of a quick analysis, it's only partially checked, but it allows the core Tweak tools and Foreman to work. It appears that the existing [[User:Rick/Memory research#Tile Block|map data]] offsets are still valid.
<pre>
menu_state == 0x01323D58
focused_creature == 0x00D17C20
cursor_x == 0x009D7284
cursor_y == 0x009D7288
cursor_z == 0x009D728C
map_count_x == 0x01555040
map_count_y == 0x01555044
map_count_z == 0x01555048
map_data == 0x01555028
main_creature_vector == 0x015134F4
dwarf_race_id == 0x013201B8
starting_points == 0x00835243
starting_points_offset == 0x00000904
alt-starting_dwarves == 0x00836154
alt-language_vector == 0x01556FA8
words_vector == 0x01556E88
happiness_offset == 0x00000520
art_defacement_malus == 0x00850D35
skill_limit == 0x00831E13
start_game_data == 0x01331D98
creature_jobs == 0x00000474
creature_race == 0x0000008C
creature_x == 0x00000094
creature_y == 0x00000096
creature_z == 0x00000098
creature_id == 0x000000F4
dwarf_civ_id == 0x013201AC
creature_civ == 0x00000100
creature_bodyparts == 0x000002FC
alt-creature_pain == 0x00000364
creature_exhaustion == 0x00000368
creature_hunger == 0x0000036C
creature_thirst == 0x00000370
creature_drowsiness == 0x00000374
creature_strength == 0x00000438
creature_agility == 0x0000043C
creature_toughness == 0x00000440
creature_skills == 0x00000444
creature_total_xp == 0x000004DC
dwarf_fortress == 0x009633E4
pe_timestamp == 0x00400108
pe_timestampv == 0x487C9338
dwarf_foreman_check == 0x01A16957
</pre>
===v0.28.181.39c===
This is the result of a quick analysis, it's unchecked, but it should allow the core Tweak tools and Foreman to work.
<pre>
menu_state == 0x01323D78
focused_creature == 0x00D17C44
cursor_x == 0x009D7284
cursor_y == 0x009D7288
cursor_z == 0x009D728C
map_count_x == 0x01555060
map_count_y == 0x01555064
map_count_z == 0x01555068
map_data == 0x01555048
main_creature_vector == 0x01513514
dwarf_race_id == 0x013201D8
starting_points == 0x008351C3
starting_points_offset == 0x00000904
alt-starting_dwarves == 0x008360D4
alt-language_vector == 0x01556FC8
words_vector == 0x01556EA8
happiness_offset == 0x00000520
art_defacement_malus == 0x00850C65
skill_limit == 0x00831D93
start_game_data == 0x01331DB8
creature_jobs == 0x00000474
creature_race == 0x0000008C
creature_x == 0x00000094
creature_y == 0x00000096
creature_z == 0x00000098
creature_id == 0x000000F4
dwarf_civ_id == 0x013201CC
creature_civ == 0x00000100
creature_bodyparts == 0x000002FC
alt-creature_pain == 0x00000364
creature_exhaustion == 0x00000368
creature_hunger == 0x0000036C
creature_thirst == 0x00000370
creature_drowsiness == 0x00000374
creature_strength == 0x00000438
creature_agility == 0x0000043C
creature_toughness == 0x00000440
creature_skills == 0x00000444
creature_total_xp == 0x000004DC
dwarf_fortress == 0x009633E4
pe_timestamp == 0x00400108
pe_timestampv == 0x487F2F30
dwarf_foreman_check == 0x01B89DBC
</pre>

==Tools==
===tile_tool===
I wrote a tool that allows nearly complete editing of a tile's data. It's designed for analyzing a tile's data. Since it's not designed for mass editing, therefore I don't recommend using it for adding more than a couple tiles of water or magma. Or build multiple buildings on top of each other. Use '?' for in-tool help.

http://www.geocities.com/jifodus/tile_tool.zip (61KB)

Mar 04, 2008: http://www.geocities.com/jifodus/auto-update_tile_tool.zip (75KB) - Alternate version that is usable as soon as configuration gets uploaded for it. Source code: http://www.geocities.com/jifodus/tile_tool_src.zip (14KB)

Editable information:
* Liquid Level
* Designation Flags
* Occupancy Flags
* Temperature
* Tile #
* Unknown Values

Additional features:
* Track tile data.
* Compare a tile with a tracked tile.
* Dump the raw bits of Designation, Occupancy, Pathfinding and Unknowns.

40d:Utilities

2008-07-16T19:06:19Z

Jifodus: /* Dwarf Foreman */ config for v0.28.181.39b

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
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.

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] 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.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory. [[User:Rick/Tweak|Check the full article for more details]].

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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.

This handy utility would be an ideal complement to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.28.181.39a''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

To make Foreman compatible with '''v0.28.181.39b''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01a16957
critter_start=015134f4
dwarfidpos=013201b8
profession_start=0474
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

Attention! As the host site of these utilities is placing links to amateur pornographic videos on the download pages, these links are currently Not Safe For Work! Please see my [[User_talk:0x517A5D|User Talk]] page for discussion and a blanket permission to take care of this <strike>issue</strike> problem. Sorry about this. —[[User:0x517A5D|0x517A5D]]

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

[http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

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

Download at [http://winmerge.org/].
[[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)
Edit:--[[User:AtomicTroop|AtomicTroop]] 12:15, 23 March 2008 (EDT)

== DFWall ==

An utility for automatisation 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 link]

Get the newest version here: [http://dffd.wimbli.com/file.php?id=108 link]

== Accent Removal ==

This is a batch file compatible with [http://www.inforapid.de/html/searchreplace.htm InfoRapid Search & Replace.]

It is used on the following raws to remove accented letters from translations:
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

This could be useful for character sets that render accents improperly. Please remember to backup your raws before doing crazy things like this.

<pre>
<Command>
<Search>„</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search> </Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>ƒ</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>†</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>…</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>‡</Search>
<Replace>c</Replace>
</Command>
<Command>
<Search>‚</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>Š</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>ˆ</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>‰</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>¡</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search></Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>Œ</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>‹</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>¤</Search>
<Replace>n</Replace>
</Command>
<Command>
<Search>•</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>”</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>“</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>¢</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>—</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>–</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>£</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>˜</Search>
<Replace>y</Replace>
</Command>
</pre>

== Dtil ==
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 Forum Thread]
Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

== Modbase ==

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

== 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.
Follow [http://dffd.wimbli.com/file.php?id=278 this] link to get to the file. 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!

User:Jifodus

2008-07-16T18:33:19Z

Jifodus: /* Memory */ Addresses and offsets for new version v0.28.181.39b

My work analyzing DF's formats:

[[User:Jifodus/Memory research|Memory research]]

[[User:Jifodus/CMV file format|CMV file format]]

[[User:Jifodus/Dwarf Fortress Utility Framework|Dwarf Fortress Utility Framework]]

[[User:Jifodus/Map block|Map block info]]

==Memory==
===v0.28.181.39a===
This is the result of a quick analysis, it's incomplete and only partially checked, but it may allow some of the tools to work. It appears that the existing [[User:Rick/Memory research#Tile Block|map data]] offsets are still valid.
<pre>
menu_state == 0x01322D58
focused_creature == 0x00D16C20
cursor_x == 0x009D6284
cursor_y == 0x009D6288
cursor_z == 0x009D628C
map_count_x == 0x01554040
map_count_y == 0x01554044
map_count_z == 0x01554048
map_data == 0x01554028
main_creature_vector == 0x015124F4
dwarf_race_id == 0x0131F1B8
starting_points == 0x00834693
starting_points_offset == 0x00000904
alt-starting_dwarves == 0x008355A4
alt-language_vector == 0x01555FA8
words_vector == 0x01555E88
happiness_offset == 0x00000520
art_defacement_malus == 0x00850135
skill_limit == 0x00831263
start_game_data == 0x01330D98
creature_jobs == 0x00000474
creature_race == 0x0000008C
creature_x == 0x00000094
creature_y == 0x00000096
creature_z == 0x00000098
creature_id == 0x000000F4
dwarf_civ_id == 0x0131F1AC
creature_civ == 0x00000100
creature_bodyparts == 0x000002FC
alt-creature_pain == 0x00000364
creature_exhaustion == 0x00000368
creature_hunger == 0x0000036C
creature_thirst == 0x00000370
creature_drowsiness == 0x00000374
creature_strength == 0x00000438
creature_agility == 0x0000043C
creature_toughness == 0x00000440
creature_skills == 0x00000444
creature_total_xp == 0x000004DC
dwarf_fortress == 0x009623E4
pe_timestamp == 0x00400108
pe_timestampv == 0x487B4E8B
dwarf_foreman_check == 0x01AA9D3A
</pre>
===v0.28.181.39b===
This is the result of a quick analysis, it's only partially checked, but it allows the core Tweak tools and Foreman to work. It appears that the existing [[User:Rick/Memory research#Tile Block|map data]] offsets are still valid.
<pre>
menu_state == 0x01323D58
focused_creature == 0x00D17C20
cursor_x == 0x009D7284
cursor_y == 0x009D7288
cursor_z == 0x009D728C
map_count_x == 0x01555040
map_count_y == 0x01555044
map_count_z == 0x01555048
map_data == 0x01555028
main_creature_vector == 0x015134F4
dwarf_race_id == 0x013201B8
starting_points == 0x00835243
starting_points_offset == 0x00000904
alt-starting_dwarves == 0x00836154
alt-language_vector == 0x01556FA8
words_vector == 0x01556E88
happiness_offset == 0x00000520
art_defacement_malus == 0x00850D35
skill_limit == 0x00831E13
start_game_data == 0x01331D98
creature_jobs == 0x00000474
creature_race == 0x0000008C
creature_x == 0x00000094
creature_y == 0x00000096
creature_z == 0x00000098
creature_id == 0x000000F4
dwarf_civ_id == 0x013201AC
creature_civ == 0x00000100
creature_bodyparts == 0x000002FC
alt-creature_pain == 0x00000364
creature_exhaustion == 0x00000368
creature_hunger == 0x0000036C
creature_thirst == 0x00000370
creature_drowsiness == 0x00000374
creature_strength == 0x00000438
creature_agility == 0x0000043C
creature_toughness == 0x00000440
creature_skills == 0x00000444
creature_total_xp == 0x000004DC
dwarf_fortress == 0x009633E4
pe_timestamp == 0x00400108
pe_timestampv == 0x487C9338
dwarf_foreman_check == 0x01A16957
</pre>

==Tools==
===tile_tool===
I wrote a tool that allows nearly complete editing of a tile's data. It's designed for analyzing a tile's data. Since it's not designed for mass editing, therefore I don't recommend using it for adding more than a couple tiles of water or magma. Or build multiple buildings on top of each other. Use '?' for in-tool help.

http://www.geocities.com/jifodus/tile_tool.zip (61KB)

Mar 04, 2008: http://www.geocities.com/jifodus/auto-update_tile_tool.zip (75KB) - Alternate version that is usable as soon as configuration gets uploaded for it. Source code: http://www.geocities.com/jifodus/tile_tool_src.zip (14KB)

Editable information:
* Liquid Level
* Designation Flags
* Occupancy Flags
* Temperature
* Tile #
* Unknown Values

Additional features:
* Track tile data.
* Compare a tile with a tracked tile.
* Dump the raw bits of Designation, Occupancy, Pathfinding and Unknowns.

User:Jifodus

2008-07-16T17:34:14Z

Jifodus: /* v0.28.181.39a */ My idiotic analysis confused me, all numbers are correct and map data was unchanged.

User:Jifodus

2008-07-15T18:56:40Z

Jifodus: /* v0.28.181.39a */ Update memory locations

40d:Utilities

2008-07-14T21:13:06Z

Jifodus: /* Dwarf Foreman */

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
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.

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] 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.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory. [[User:Rick/Tweak|Check the full article for more details]].

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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.

This handy utility would be an ideal complement to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.28.181.39a''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01aa9d3a
critter_start=015124f4
dwarfidpos=0131f1b8
profession_start=0474
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

Attention! As the host site of these utilities is placing links to amateur pornographic videos on the download pages, these links are currently Not Safe For Work! Please see my [[User_talk:0x517A5D|User Talk]] page for discussion and a blanket permission to take care of this <strike>issue</strike> problem. Sorry about this. —[[User:0x517A5D|0x517A5D]]

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

[http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]''(Careful, download link contains images of pornography as ads.)''

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

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

Download at [http://winmerge.org/].
[[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)
Edit:--[[User:AtomicTroop|AtomicTroop]] 12:15, 23 March 2008 (EDT)

== DFWall ==

An utility for automatisation 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 link]

Get the newest version here: [http://dffd.wimbli.com/file.php?id=108 link]

== Accent Removal ==

This is a batch file compatible with [http://www.inforapid.de/html/searchreplace.htm InfoRapid Search & Replace.]

It is used on the following raws to remove accented letters from translations:
*language_DWARF.txt
*language_ELF.txt
*language_GOBLIN.txt
*language_HUMAN.txt

This could be useful for character sets that render accents improperly. Please remember to backup your raws before doing crazy things like this.

<pre>
<Command>
<Search>„</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search> </Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>ƒ</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>†</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>…</Search>
<Replace>a</Replace>
</Command>
<Command>
<Search>‡</Search>
<Replace>c</Replace>
</Command>
<Command>
<Search>‚</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>Š</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>ˆ</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>‰</Search>
<Replace>e</Replace>
</Command>
<Command>
<Search>¡</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search></Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>Œ</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>‹</Search>
<Replace>i</Replace>
</Command>
<Command>
<Search>¤</Search>
<Replace>n</Replace>
</Command>
<Command>
<Search>•</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>”</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>“</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>¢</Search>
<Replace>o</Replace>
</Command>
<Command>
<Search>—</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>–</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>£</Search>
<Replace>u</Replace>
</Command>
<Command>
<Search>˜</Search>
<Replace>y</Replace>
</Command>
</pre>

== Dtil ==
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001843 Forum Thread]
Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

== Modbase ==

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings.
[http://www.bay12games.com/forum/index.php?topic=18623.0 Get it now!]
For version 0.38c.

== 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.
Follow [http://dffd.wimbli.com/file.php?id=278 this] link to get to the file. 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!

User:Jifodus

2008-07-14T17:08:14Z

Jifodus: Some of the tool addresses

Utility Talk:Adjust Profile

2008-03-26T03:56:44Z

Jifodus:

Hey, looks like a useful tool there. I see you're currently hosting it at Rapidshare; please consider additionally (or alternately) hosting it at the [http://dffd.wimbli.com/about.php DFFD site] to make it easier to download. Anyway, keep up the good work, and thanks. --[[User:Janus|Janus]] 22:30, 23 March 2008 (EDT)
:It's already bundled with the main release of Rick's Tweak so I didn't see a reason to reupload it, I put that link there before Rick suggested he just pack it in with his stuff. If I make a new release I'll put it there. [[User:Rinn|Rinn]] 12:50, 24 March 2008 (EDT)

I notice that you cap the levels at 15, I recommend no cap, due to extra stat point bonuses you can get. --[[User:Jifodus|Jifodus]] 23:56, 25 March 2008 (EDT)

40d Talk:Utilities

2008-03-07T05:41:18Z

Jifodus: /* Dwarf Foreman */

== DF 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)

== External Utilities ==
I thinking any Utilities that not made specifically for Dwarf fortress should put together at bottom which I have done. My question should we mark area with header say External utilities? [[User:Omagaalpha|Omagaalpha]] 08:22, 14 February 2008 (EST)

== 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 [http://www.autohotkey.com/] 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)

== Yourfilehost ==

Yourfilehost.com has kind of a lousy reputation, and I can confirm it's blocked on certain college networks. Could someone upload these utilities to a more reputable host? -- Mzbundifund 15:55, 04 November 2007 (EDT)
: Such as? --[[User:Rick|Rick]] 18:03, 4 November 2007 (EST)
:: Megaupload, rapidshare, filefactory, you pick one --[[User:Digger|Digger]] 17:40, 24 February 2008 (EST)
:::Uh, you know there is a special site for uploading DF files now, right? It's linked on the main page. Screw those other guys. --[[User:Jackard|Jackard]] 17:53, 24 February 2008 (EST)
::::I say we scrap this section, then. --[[User:Digger|Digger]] 18:28, 24 February 2008 (EST)

==heal.exe==

heal.exe does not regrow missing limbs. However, "heal -hurt" on the command line brings missing limbs to red status, and "heal" thereafter restores the being to full health.

I propose a -regrow parameter so we don't have to do this workaround, since if it's possible to bring missing limbs from dark grey to red status it's also possible to grow them back.

Also, when using the -hurt parameter, it still says "059E7210 had 31 body parts '''healed'''", when it should probably say "wounded". --[[User:JT|JT]] 17:58, 10 November 2007 (EST)

: Hmm, if it does heal missing limbs then I just need to change my logic slightly for healing. --[[User:Rick|Rick]] 19:01, 10 November 2007 (EST)

==reveal.exe==

From what I've tested, reveal for 33a does not work for 33b. --[[User:Sparksol|Sparksol]] 13:39, 17 November 2007 (EST)

:Correct. It uses hardcoded offsets, which will change every time new code is added to DF.
:I have a version hacked for .33b, which I will not distribute out of respect for Rick.
:However, if you are skilled with a hex editor, here's what to do: change the first 5 occurances of the pattern 85 45 01 to the pattern 95 45 01. (The 6th occurance of the pattern is a coincidental match and should not be changed.) Then change the pattern 8C 33 89 00 to the pattern 8C 43 89 00. —[[User:0x517A5D|0x517A5D]] 02:31, 19 November 2007 (EST)

:Actually, as it happens, it looks like Rick has produced updated versions of his tools for .33b. They were built on the 16th. However he hasn't linked to them. I don't know why. The URL they're at requests that no links be made to them, so I'm not going to tell you. Sorry, you'll just have to do the hexedit. —[[User:0x517A5D|0x517A5D]] 02:45, 19 November 2007 (EST)

:I just havn't mirrored them yet, that's all. --[[User:Rick|Rick]] 03:10, 19 November 2007 (EST)
::Hey, I'm curious why the file sizes ballooned. Reveal went from 52k to 101k, a doubling in size. Heal grew even more. Maybe you didn't strip debugging info? —[[User:0x517A5D|0x517A5D]] 15:42, 19 November 2007 (EST)
:::Usage of std libraries mostly. I made a library for working with DF so I wouldn't have to keep duplicating code through projects, and when writing it I figured I might as well make it more friendly for me to code in, hence usage of std:: stuff. --[[User:Rick|Rick]] 19:00, 19 November 2007 (EST)

:Whenever I try to open reveal.exe, the window will open up for a millisecond and then immedietely close. Is this a problem with the program or my windows? I am assuming its windows since everyone else seems to be able to use it. Has anyone else had this problem?--[[User:Varsashi|Varsashi]] 17:59, 26 November 2007 (EST)

::It hasn't been updated to work with 33c, and doesn't. Hopefully it will be updated soon. If you're using 33b, it should open and close quickly but reveal all allocated squares. To allocate all squares for revealing, I'll repeat the advice I've seen elsewhere: go to the lowest level and designate the entire level for digging, then remove the dig designation and run the reveal utility. --[[User:Janus|Janus]] 20:08, 26 November 2007 (EST)

So how do people feel about deleting this section, and probably the heal.exe section above too? —[[User:0x517A5D|0x517A5D]] 00:56, 23 December 2007 (EST)

==How to use warp.exe?==
How do you use warp.exe? There's no information on how to use these on the page.--[[User:Demosthenes|Demosthenes]] 02:10, 21 November 2007 (EST)
: <code>warp.exe</code> by itself will list your current cursor position. After you have the position you want to warp a creature to, you do <code>warp.exe <x> <y> <z></code> as arguments, and it will warp the selected creature (selected with 'V'iew) to that destination, if it can. --[[User:Rick|Rick]] 18:10, 21 November 2007 (EST)

==StartProfile==
Perhaps, I don't understand how to use this correctly. I'm using 33e, and the StartProfile linked in the Utils section. I'm supposed to use this util at the Prepare for the Journey screen, correct? I tried testing the export function with the first dwarf, with no skills assigned. startprofile.exe -x 0 test.txt What I got back was: 
<code>
Mining: 1348403210 
Wood Cutter: 1565676876 
Carpenter: 3801123 
Engraving: 34079120 
Record Keepe: 2293770 
Liar: 34341293 
Intimidator: 16843009 
Conversationalist: 16843009 
Comedian: 16843009 
Flatterer: 16843009 
Consoler: 16843009 
Pacifier: 16843009 
</code>
When I try to set a dwarf's skills using StartProfile I end up with huge amounts of either negative or positive points available, with no changes being made to the dwarf's skills. --[[User:Stu72|Stu72]] 09:23, 11 December 2007 (EST)
: The offset for the skills must have changed. I guess I should've actually checked that, and not have assumed that just because the other values were correct, the skills were still correct. I'll check it out and post the appropriate fix. -- [[User:Jifodus|Jifodus]]
: The appropriate fix is redownloading it, when I hex edited the exe I messed it up field. -- [[User:Jifodus|Jifodus]]
:: Thanks, works beautifully. It's a terrific time saver. --[[User:Stu72|Stu72]] 15:30, 14 December 2007 (EST)

How does one use this? The readme isn't very helpful. --[[User:Jackard|Jackard]] 01:08, 27 November 2007 (EST)
: Not knowing exactly what you're having trouble understanding, I'll give examples (the one thing I forgot to add in the readme). <code>startprofile 0 Miner.txt</code> - This will set the skill profile of the first Dwarf, in the list of units, to the skills in Miner.txt <code>startprofile 1 Jeweler.txt</code> - This will set the skills on the second Dwarf, in the list of units, to the skills in Jeweler.txt <code>startprofile -x 3 Customprofile.txt</code> - This will save the set of skills on the fourth Dwarf to Customprofile.txt <code>startprofile -v0.27.169.33b 0 Miner.txt</code> Same as the first example, except it'll work on the previous version of Dwarf Fortress. -- [[User:Jifodus|Jifodus]] 03:28, 27 November 2007 (EST)
::Thanks, I'll try that out. --[[User:Jackard|Jackard]] 21:21, 27 November 2007 (EST)

If you wish to edit the executable, you can modify it so that it works with 0.27.169.33d by making the following changes with a hex editor:
Offset Overwrite With
----------------------------
2A530 | 98 16 25 01 04 00 00 00 DC 00 00 00 F0 08 00 00 70 00 00 00 C0 01 00 00
2A6A6 | 30 2E 32 37 2E 31 36 39 2E 33 33 64
2A77C | 02
-- [[User:Jifodus|Jifodus]] 20:14, 3 December 2007 (EST)
:CBW; PUSH SS; AND EAX, 00000401h; ADD AH, BL; ADD [EAX], AL; ...
:That makes no sense. Must be missing something off the head end.
:3 unknown bytes; ADD [EAX+EAX], EAX; ... No better. Worse, even.
:4 unknown bytes; ADD AL, 00h; ADD [EAX], AL; ... Unh uh. Don't think so.
:8 unknown bytes; ESC-4(00); ... Floating point? Really? No way.
:12 unknown bytes; LOCK OR [EAX], AL ... Insane.
:I don't know what those bytes are, but they're not code.—[[User:0x517A5D|0x517A5D]] 23:23, 3 December 2007 (EST)
::You're right, they're data. First Row is (left to right, 5 dwords): [[User:Jifodus/Memory research#Addresses_3|Start Address]], Offset from address at start address, Dwarf List begin offset, Starting points offset, Skills offset, remaining skill points points. Second row is a character string (15 chars max). Third row is a dword indicating which data index is default.
:: <tt>//Start Addr, O, Lizt, Ponts, Skll, Remain</tt>
:: <tt>{ 0x01251698, 4, 0xDC, 0x8F0, 0x70, 0x1C0 }</tt> - The read/write locations and whatnot
:: <tt>"0.27.169.33d"</tt> - Used for string comparison (-v flag)
:: <tt>2</tt> - The default version to use is the third in the list (what the above just added).
:: Configuration data can be found between 'DATA_SET' and 'TES_ATAD'. The list has enough space for 16 versions (3 are now in use). I'll just say I didn't want to have to recompile it for all the versions -- [[User:Jifodus|Jifodus]] 21:52, 6 December 2007 (EST)
If you wish to edit the executable, you can modify it so that it works with 0.27.169.33e by making the following changes with a hex editor:
Offset Overwrite With
----------------------------
2A550 |"98 26 25 01"04 00 00 00 DC 00 00 00 F0 08 00 00 70 00 00 00 C0 01 00 00
2A6B5 | 30 2E 32 37 2E 31 36 39 2E 33 33"65"
2A77C |"03"

== Patching Lavasquare ==

Due to someone being interested in running lavasquare on version 33g, I determined how to patch the exe to work with later versions. With a hex editor, open lavasquare.exe and find and replace with appropriate values (replace the X's with the values underneath for the version you want). I only tested it for 33f, but I'm assuming that the values for 33g are correct (since I got them off the wiki).

(CursorX)
FIND: EE 57 68 88 E2 8F 00 FF 35
REPLACE: EE 57 68 XX XX XX 0X FF 35
33f 88 F2 8F 0
33g 88 62 90 0
38a 88 F2 92 0

(CursorY)
FIND: EC 57 68 8C E2 8F 00 FF 35
REPLACE: EC 57 68 XX XX XX 0X FF 35
33f 8C F2 8F 0
33g 8C 62 90 0
38a 8C F2 92 0

(CursorZ)
FIND: E6 57 68 90 E2 8F 00 FF 35
REPLACE: E6 57 68 XX XX XX 0X FF 35
33f 90 F2 8F 0
33g 90 62 90 0
38a 90 F2 92 0

(MapBlocks)
FIND: FC 57 68 60 15 46 01 FF 35
REPLACE: FC 57 68 XX XX XX 0X FF 35
33f 68 25 46 1
33g 80 96 46 1
38a CC 29 49 1

(To exit immediately after writing, since I don't want to
verify the other offsets)
FIND: FF 35 5C 80 40 00 E8 88 61 00 00 0F BF 7D
F8 57 0F BF 7D FA 57 8B 7D FC 81 C7 60 06
00 00
REPLACE: FF 35 5C 80 40 00 E8 88 61 00 00 6A FF FF
25 6C B1 40 00 CC CC CC CC CC CC CC CC CC
CC CC
-- [[User:Jifodus|Jifodus]] 02:05, 25 December 2007 (EST)

To modify the above for the same behavior as water:
FIND: 07 00 20 00
REPLACE: 07 00 00 00
-- [[User:Jifodus|Jifodus]] 17:09, 29 December 2007 (EST)

Addresses for 0.27.173.38a:
CursorX 0x0092F288
CursorY 0x0092F28C
CursorZ 0x0092F290
MapBlocks 0x014929CC
Offsets are still the same.
-- [[User:Jifodus|Jifodus]] 19:14, 7 February 2008 (EST)

Addresses for 0.27.173.38c: (These worked for me, but I'm not an expert on this stuff.)
CursorX 0x0094228C
CursorY 0x00942290
CursorZ 0x00942294
MapBlocks 0x014A60A4
--[[User:Dorundain|Dorundain]] 22:21, 6 March 2008 (EST)

== Lavasquare Popup? ==

How do I remove the prompt? It is a painful thing for large projects. The macro below helps some, though. --[[User:Jackard|Jackard]] 08:05, 4 January 2008 (EST)

#Persistent
SetTimer, CloseLava, 100
return

CloseLava:
WinClose, lcc runtime
return

del::
IfWinActive Dwarf Fortress
{
send {down}
run C:\Program Files\Dwarf Fortress\Utilities\lavasquare 33g.exe
return
}
else
{
send {del}
return
}

== Lavasquare ==

Why does it seemingly stop working after a while? It runs but summons no magma/lava. --[[User:Spelguru|Spelguru]] 12:28, 18 January 2008 (EST)
:No idea, never run into the problem though I've used it quite thoroughly. --[[User:Jackard|Jackard]] 17:52, 18 January 2008 (EST)
:I've run into this once. Restarting DF fixed the problem. --[[User:SquirrelFarmer|SquirrelFarmer]] 09:50, 29 January 2008 (EST)

== Water ==

Could someone make an updated version? Having to slaughter anyone who gets injured just because the rain-filling-ponds doesn't work properly yet is annoying. -Shadow_archamgi, February 27 2008

==Weatherdwarf==
I can't find the page, but it's a utility that lets you change the temperature of an area and allows for some crazy stuff. Look it up on the forums; I have a community fortress to tend to. --[[User:Penguinofhonor|Penguinofhonor]] 20:18, 3 March 2008 (EST)

User talk:Rick

2008-03-06T05:26:44Z

Jifodus: /* 0.27.176.38b */ maybe correct STARTING_DWARF_COUNT

== Requests ==
Hey there. Thanks for writing reveal.exe. It's made my dwarves' lives so much easier!

Do you take requests?

And is this the right place to ask? [[User:Runspotrun|Runspotrun]] 20:32, 10 November 2007 (EST)

: Yes, and yes. --[[User:Rick|Rick]] 20:49, 10 November 2007 (EST)

::Excellent! Now, I don't know how many people would use it, but I'd love to see a utility that would allow me to choose the temperature/forest/shrub/surroundings/neighbours when starting out. I like to stick to the same sort of areas, but it can be a pain finding them on the map - if they exist at all. Problem is, I think most people take what they're given, region-wise... so I don't think it'd have much of an audience. What do you think? [[User:Runspotrun|Runspotrun]] 20:55, 10 November 2007 (EST)

:: Er, I haven't just described startpoints.exe, have I? [[User:Runspotrun|Runspotrun]] 21:01, 10 November 2007 (EST)

::Well, if you're not averse to requests... A utility to activate the subterranean flag on indoor areas would be awesome for those of us who'd like to build surface castles in cold/freezing terrain without our dwarves dying of frostbite. -[[User:EarthquakeDamage|EarthquakeDamage]] 22:45, 10 November 2007 (EST)

::I'd like a rock/gem/ore tool. Would be really neat. Especially the ore/gem one. Also, maybe water/magma creation tools if possible?--[[User:Spelguru|Spelguru]] 01:29, 11 November 2007 (EST)

::Something similar to the old skills.exe would be great! --[[User:Vanan|Vanan]] 11:44, 19 November 2007 (EST)

::What I'd like is some way to search for a particular tile on the map. Probably the easiest thing for you to code is to have reveal.exe have an option where it prints the map data to a file in some simple text format (Just a simple list of 'Z,X,Y "tile code"' would be sufficient. mapping what tiles have what value would be nice, but not necessary.) I want to answer the question "Is the raw material for the item the possessed dwarf is asking for somewhere on my map, and if so, where?" --[[User:Warnold|Warnold]] 23:08, 9 December 2007 (EST)

::I would like to request something that teleports items. --[[User:Demosthenes|Demosthenes]] 02:05, 16 December 2007 (EST)

::Is it possible for a utility to remove excess stone? (name and amount in command line) --[[User:Jackard|Jackard]] 07:35, 16 December 2007 (EST)

== Wild Praise ==
Thank you so much for your incredible work! Your applications add so much fun to the game! --[[User:Vanan|Vanan]] 13:56, 17 November 2007 (EST)

Astonishing response time for 33e! --[[User:Geofferic|Geofferic]] 01:04, 9 December 2007 (EST)

== In reply to ==
Your statement to me on my page, "Don't subject your opinion unto others. (Though I think you were just trying to be funny...) --Rick 03:54, 31 October 2007 (EDT)"

Of course I was. But some people have no real sense of humor.

Also, some people believe they can do things they tell others NOT to do. Your statement is a perfect example of this. You tell me not to subject others to MY opinion, but in doing so you are subjecting me to YOUR opinion. Oh yes, you are one of the VIPs in the DF community, because you wrote a couple utilities. So I suppose I should be humble in your presence, and bow to someone so great. I would do that, but when I bow, I do it facing AWAY from that person, and I drop my trousers at the same time. Still want me to bow to your greatness?

I read other contributions here that voice their opinions the same as I did. I wonder if you said the same thing to all of them as well? Tho since I was able to read the pages they wrote, you clearly did not delete their words as you did mine. And while other entries I made were either deleted or edited, as I expected them to be, since I am not a great wiki writer, you were the only one to send me a somewhat nasty note.

Think whatever you like of me, but at least I was contributing, and trying to give a few smiles along the way. Seems to me tho, that DF is fun, and it's wiki should be too. And, from other pages I read, others feel the same way I do. Maybe you should take a look around at some of their pages, and lighten up yourself a bit? Maybe trade with the elves for a tame blue jay, and drop it down your shorts. If that doesnt get a giggle out of you, maybe you should go join the undead at one of their ruins?

: Wow, way to blow up that up, I was just jesting. I think I'll leave your words here, [[User:Darknight|Darknight]]. --[[User:Rick|Rick]] 19:25, 17 November 2007 (EST)

: Oh, and for the record, I did not remove your message, someone else did that. Check the page history. --[[User:Rick|Rick]] 19:29, 17 November 2007 (EST)

== heal.exe bug? ==

Hmm... I've found that heal -hurt doesn't work on fire men, at least in 33b. It sets all their body parts to red, but the fire man just keeps wandering around and scaring my poor witless dwarves. I haven't found a living fire man yet in 33c so I can't check. [[User:Runspotrun|Runspotrun]] 06:59, 28 November 2007 (EST)

: Are firemen immune to pain? Hurt just nukes bodyparts, not kills creatures, most creatures who feel pain will die from that, but I guess ones who don't won't. --[[User:Rick|Rick]] 12:08, 28 November 2007 (EST)

:: Just checked - yes they are. That'd explain it then, ta. [[User:Runspotrun|Runspotrun]] 14:38, 28 November 2007 (EST)

== INI? ==

Does anyone see anything obviously wrong about this? I used various comparisons to come to these values (as well as what the hex fellow posted in the memory hacking section), and editing them as such into the reveal.exe allowed me to get that program to function, but the ini isn't reenabling the executables on its own:

<pre>
[address]
DWARF_FORTRESS=0x0089C414 ; correct
MENU_STATE=0x0124565C ; maybe
FOCUSED_CREATURE=0x00C39548 ; correct
CREATURE_VECTOR=0x01420A48 ; correct
MOUSE_X=0x008FF290 ; pretty sure should be 008FF288
MOUSE_Y=0x008FF294 ; pretty sure should be 008FF28C
MOUSE_Z=0x008FF298 ; pretty sure should be 008FF290
MAP_DATA=0x01462568 ; correct
MAP_X_COUNT=0x01462580 ; correct
MAP_Y_COUNT=0x01462584 ; correct
MAP_Z_COUNT=0x01462588 ; correct
STARTING_DWARF_COUNT=0x0078A54E ; wrong. 0078A554 (value actually is dword at 0078A555)
STARTING_POINT_COUNT=0x00789703 ; correct (value actually is word at 0078970A)

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260 ; dunno
MAP_DATA_OCCUPANCY_OFFSET=0x660 ; dunno
CREATURE_NAME_OFFSET=0x000 ; yes
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308 ; probably
CREATURE_X_OFFSET=0x0094 ; probably
CREATURE_Y_OFFSET=0x0096 ; probably
CREATURE_Z_OFFSET=0x0098 ; probably
</pre>

[[User:Qalnor|Qalnor]] 14:05, 16 December 2007 (EST)

I commented the above. none of the corrections should affect reveal. I don't know what's going wrong. —[[User:0x517A5D|0x517A5D]] 19:53, 16 December 2007 (EST)

:: I made a few mistakes when documenting the existing data, which probably threw you guys off. My user page has been updated for 33f. --[[User:Rick|Rick]] 20:41, 16 December 2007 (EST)

:: Thanks, to both of you. I'll have to go over what I was doing when I get home to try and see where I was going wrong. [[User:Qalnor|Qalnor]] 15:11, 17 December 2007 (EST)

== Possible adjuststart enhancement ==
Hi! Merry culturally-appropriate politically-correct generic holiday!

I have found some interesting addresses that work well with adjuststart.

In .33f, the byte at 0078654B holds a constant that is the upper limit that starting skills can be advanced to. It is normally 5 (proficient). If you change it to 15, skills can be advanced to legendary. If you change it to 20, skills can be advanced to legendary+5.

Also in .33f, there's a pair of bytes at 00786466 and 00786608. If you set both to 0, then the 10 skills per dwarf limit is removed.

I've found equivalant addresses for all the .33 releases. They're in the memory hacking subpages.

—Preceding unsigned comment added by [[User:0x517A5D|0x517A5D]] ([[User talk:0x517A5D|talk]]{{!}}[[Special:Contributions/0x517A5D|contribs]]) {{{2|}}}

:Did I not sign that? Oops. Well, I was tired. Thank you, VengefulDonut. —[[User:0x517A5D|0x517A5D]] 22:02, 19 December 2007 (EST)

::Very cool, I'll probably add these for the next release then. --[[User:Rick|Rick]] 04:18, 20 December 2007 (EST)

== Update of utilities ==

So how much longer do you suppose it might take to transition the utilities to 33f?--[[User:Heliopios|Heliopios]] 13:04, 19 December 2007 (EST)
:With the .ini method there isnt really a need to rebuild the utilities for 32f. [[User:VengefulDonut|VengefulDonut]] 15:25, 19 December 2007 (EST)

:And how exactly do you use memory.ini? I've created a new ini file (yes, it's a .ini, not a .ini.txt) and pasted everything under [code] tags for .33f, and lugged it into the dir. with the required executable (heal.exe in this case) but when I run it it still says it was built for .33e. Should I put it somewhere else? In any case, instructions for use are either inexistent or pretty well hidden here in the wiki.
:Cheers. [[User:N35t0r|N35t0r]] 21:45, 19 December 2007 (EST)
::Did you name it "memory.ini"? This worked for me with reveal.exe [[User:VengefulDonut|VengefulDonut]] 01:52, 20 December 2007 (EST)

== Possible INI file syntax change ==

I would like to suggest a change to the format of MEMORY.INI. Instead of the [generic], [address], and [offset] sections (which in my opinion buy you nothing), I would suggest using sections keyed off the PE header timestamp. (You have previously indicated that you plan to convert to that method anyway.) So a sample .INI file might look like this:

<pre>; .33e
[475B7526]
MENU_STATE=0x01244654
FOCUSED_CREATURE=0x00C38540
CREATURE_VECTOR=0x0141FA40
MOUSE_X=0x008FE288
MOUSE_Y=0x008FE28C
MOUSE_Z=0x008FE290
MAP_DATA=0x01461560
MAP_X_COUNT=0x01461578
MAP_Y_COUNT=0x0146157C
MAP_Z_COUNT=0x01461580
STARTING_DWARF_COUNT=0x007893C5
STARTING_POINT_COUNT=0x0078857A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098

; .33f
[4763710C]
MENU_STATE=0x0124565C
FOCUSED_CREATURE=0x00C39548
CREATURE_VECTOR=0x01420A48
MOUSE_X=0x008FF288
MOUSE_Y=0x008FF28C
MOUSE_Z=0x008FF290
MAP_DATA=0x01462568
MAP_X_COUNT=0x01462580
MAP_Y_COUNT=0x01462584
MAP_Z_COUNT=0x01462588
STARTING_DWARF_COUNT=0x0078A555
STARTING_POINT_COUNT=0x0078970A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098</pre>

The main reason to do this is to allow data for multiple versions to be in the .INI file. —[[User:0x517A5D|0x517A5D]] 18:22, 21 December 2007 (EST)

: Agreed, will do this. --[[User:Rick|Rick]] 15:28, 22 December 2007 (EST)

== 33g memory.ini ==

0x517A5D looked these up and put them on the 33g memory hacking page, but did not actually put them in here. He copied/pasted from 33f. Mistake? I looked up the dwarf fortress tag and used his values for the ones I could see on the other page he posted (33g memory hacking page) and updated them. It works for reveal, but it's missing FOCUSED_CREATURE and CREATURE_VECTOR because I can't find them.
--[[User:Paul|Paul]] 15:05, 22 December 2007 (CST)
:I just cross-referenced those 2 values with the 33f memory location page and updated them. Should work now, though I haven't tested. --[[User:Janus|Janus]] 16:27, 22 December 2007 (EST)
::The currently listed FOCUSED_CREATURE and CREATURE_VECTOR values don't appear to work. --[[User:Zurai|Zurai]] 22:20, 22 December 2007 (EST)
:::Hi Zurai. Do to my blunder, there was a short period where those two values were incorrect. You probably hit that window. Check the values in your copy against the ones shown now. —[[User:0x517A5D|0x517A5D]] 22:59, 22 December 2007 (EST)
::::Heal.exe and warp.exe (only when trying to warp a creature - warp to find the coords of a tile works fine) both give me "An error has occured: please select a unit in 'view units' mode" using FOCUSED_CREATURE=0x00C40540 and CREATURE_VECTOR=0x01427B60, which are the values listed at the time of this writing. I've redownloaded both executables and re-made the ini from scratch, copy-pasting the values from the 33g listing, and it still occurs. Is anyone else having the same issue? Maybe my computer doesn't like heal or warp any more. Reveal works fine, though. --[[User:Zurai|Zurai]] 18:45, 23 December 2007 (EST)
:::::I found the problem. It was MENU_STATE. Yes, anyone else who tried to use these utils would experience the same problem. I have now edited the .33g memory.ini section again, and verified that warp.exe, heal.exe -hurt, and heal.exe all work. I'm really, really sorry for the mess up. —[[User:0x517A5D|0x517A5D]] 22:39, 23 December 2007 (EST)
::::::I'm having this pop up with the new memory.ini info for warp.exe: "An error has occured:failed to read block pointer for to block". --[[User:Corbine|Corbine]] 03:19, 24 December 2007 (EST)
:::::::Well, let's go down the checklist. Due to a blunder on my part, the .33g memory.ini file was wrong for several hours. One of the mistakes causes that error message. Try deleting memory.ini and making a new one with the [[User:Rick#v0.27.169.33g|current data]]. —[[User:0x517A5D|0x517A5D]] 14:29, 24 December 2007 (EST)
::::::::Deleted the memory.ini, made a new one and threw the new info into it, still same error. --[[User:Corbine|Corbine]] 01:28, 25 December 2007 (EST)
:::::::::Corbine, are you still experiencing this? I just realized I've left this hanging for a week. Sorry. Okay, next. Previous versions of warp have worked for you with previous versions of DF? Do other of Rick's utilities work for you? My tentative diagnosis is that part of your INI file is wrong. If the whole thing was wrong, it would merely complain that it was built for version .33e. I don't know which particular key being wrong gives that error, and I don't have a .33g test fort at the moment, so I can't easily check right now. But I could when I have time. Really, I'm puzzled. —[[User:0x517A5D|0x517A5D]] 03:47, 31 December 2007 (EST)
:Yes, mistake. Arrgh. I must have copied from the wrong editor window. Thank you both. —[[User:0x517A5D|0x517A5D]] 17:08, 22 December 2007 (EST)
::No worries, and thanks for posting the new memory locations in the first place. I personally was looking forward to that info so I could use reveal.exe to examine potential fortress locations in newly created 33g worlds, so it is much appreciated. --[[User:Janus|Janus]] 18:07, 22 December 2007 (EST)
::I was all excited when I saw the 33g info up, then went to paste it into my ini and realised the data was the same... I figured you just accidentally pasted the wrong thing in. The only thing I could figure out how to look up was the Dwarf Fortress tag location, so it is appreciated that you looked all the rest up. With the world generation changing, it's nice to have reveal available to search for new sites. [[User:Paul|Paul]] 21:20, 22 December 2007 (EST)

==38a==

How would we update this? --[[User:Squeegy|Squeegy]] 20:22, 5 February 2008 (EST)

we can start by finding the relevant mem locations for 88a 

<blockquote>
[generic] 
DWARF_FORTRESS=0x00C11218 
 
[address] 
 
MENU_STATE= 
FOCUSED_CREATURE= .
CREATURE_VECTOR= 
MOUSE_X=0x0092f288 
MOUSE_Y=0x0092f28c 
MOUSE_Z=0x0092f290 
MAP_DATA= 
MAP_X_COUNT=0x014929F0 
MAP_Y_COUNT=0x014929F4 
MAP_Z_COUNT=0x014929F8 
STARTING_DWARF_COUNT= 
STARTING_POINT_COUNT= 
</blockquote>

those are the easy ones.
if we had map data and confirmed that the offset was correct at least Reveal.exe would work but I'm out of time today. --[[User:Shadetree|Shadetree]] 22:23, 6 February 2008 (EST)

I've found the other addresses. I won't guarantee that the offsets other than MAP_DATA_DESIGNATION_OFFSET, MAP_DATA_OCCUPANCY_OFFSET, and CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET are correct.
[generic]
DWARF_FORTRESS=0x00C11218

[address]
STARTING_POINT_COUNT=0x007AF4FA
STARTING_DWARF_COUNT=0x007B0345
MENU_STATE=0x0127599C
FOCUSED_CREATURE=0x00C69888
CREATURE_VECTOR=0x01450E98
MOUSE_X=0x0092F288
MOUSE_Y=0x0092F28C
MOUSE_Z=0x0092F290
MAP_DATA=0x014929CC
MAP_X_COUNT=0x014929E4
MAP_Y_COUNT=0x014929E8
MAP_Z_COUNT=0x014929EC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
If I understand how Rick's tools work, the offsets I've verified are the only offsets necessary.
-- [[User:Jifodus|Jifodus]] 20:05, 7 February 2008 (EST)

confirmed that this works with Reveal.exe --[[User:Shadetree|Shadetree]] 18:41, 8 February 2008 (EST)

warp.exe and heal.exe do not work with this configuration. --[[User:Markham|Markham]] 11:28, 9 February 2008 (EST)

The reason the creature tools will work is due to some issue with how FOCUSED_CREATURE now behaves. Assuming the address is correct, and I'm 99.9% positive it's the correct address, a new method will have to be determined which unit is focused. Also, did your map have existing creatures? -- [[User:Jifodus|Jifodus]] 17:39, 9 February 2008 (EST)

Confirmed that adjuststart.exe works with this. --[[User:Squeegy|Squeegy]] 23:44, 10 February 2008 (EST)

==176-38a==

Any love on new offsets with version df_27_176_38a? What do you all use to dig up the offsets? A debugger running trace on particular strings?

I use IDA Pro Free, and do a binary match.
<pre>
[generic]
DWARF_FORTRESS=0x008D8B08

[address]
STARTING_POINT_COUNT=0x007B995A
STARTING_DWARF_COUNT=0x007BA7B3
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC00
CREATURE_VECTOR=0x01450E9C
MOUSE_X=0x00941288
MOUSE_Y=0x0094128C
MOUSE_Z=0x00941290
MAP_DATA=0x014A4EAC
MAP_X_COUNT=0x014A4EC4
MAP_Y_COUNT=0x014A4EC8
MAP_Z_COUNT=0x014A4ECC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Heal & Warp won't work due to FOCUSED_CREATURE not working properly. -- [[User:Jifodus|Jifodus]] 04:00, 17 February 2008 (EST)

== 0.27.176.38b ==

<pre>
[generic]
DWARF_FORTRESS=0x008D8A58

[address]
MAP_DATA=0x014A50A4
MAP_X_COUNT=0x014A50BC
MAP_Y_COUNT=0x014A50C0
MAP_Z_COUNT=0x014A50C4
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC04
STARTING_DWARF_COUNT=0x007BBCA4
STARTING_POINT_COUNT=0x007BAE4A
MOUSE_X=0x0094128C
MOUSE_Y=0x00941290
MOUSE_Z=0x00941294
CREATURE_VECTOR=0x01463574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 23:08, 24 February 2008 (EST)

Are you sure that's right? Reveal.exe isn't working for me with this.--[[User:Eiba|Eiba]] 00:19, 25 February 2008 (EST)

Seems you got the starting points right for AdjustStart, but not the dwarf count. [[User:MikeWulf|MikeWulf]]

A little late, but my finder program didn't spit out the correct address for vectors. -- [[User:Jifodus|Jifodus]] 02:26, 4 March 2008 (EST)

== 0.27.176.38c ==

<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
STARTING_POINT_COUNT=
STARTING_DWARF_COUNT=
MENU_STATE=
FOCUSED_CREATURE=
CREATURE_VECTOR=
MOUSE_X=
MOUSE_Y=
MOUSE_Z=
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Only reveal works with this memory.ini. Offsets are copied from version 176.38a. --[[User:DFD|DFD]] 11:53, 29 February 2008 (EST)

No guarantee's (I used an automated program to find these), don't expect any of the creature tools to work.
<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4
MENU_STATE=0x01288D14
FOCUSED_CREATURE=0x00C7CC04
STARTING_DWARF_COUNT=0x007BBDB5
STARTING_POINT_COUNT=0x007BAF5A
MOUSE_X=0x0094228C
MOUSE_Y=0x00942290
MOUSE_Z=0x00942294
CREATURE_VECTOR=0x01464574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 02:28, 4 March 2008 (EST)

STARTING-DWARF_COUNT is wrong again apparently. :< [[User:MikeWulf|MikeWulf]] 21:04, 4 March 2008 (EST)

User talk:Rick

2008-03-06T05:25:40Z

Jifodus: /* 0.27.176.38c */ maybe correct STARTING_DWARF_COUNT

== Requests ==
Hey there. Thanks for writing reveal.exe. It's made my dwarves' lives so much easier!

Do you take requests?

And is this the right place to ask? [[User:Runspotrun|Runspotrun]] 20:32, 10 November 2007 (EST)

: Yes, and yes. --[[User:Rick|Rick]] 20:49, 10 November 2007 (EST)

::Excellent! Now, I don't know how many people would use it, but I'd love to see a utility that would allow me to choose the temperature/forest/shrub/surroundings/neighbours when starting out. I like to stick to the same sort of areas, but it can be a pain finding them on the map - if they exist at all. Problem is, I think most people take what they're given, region-wise... so I don't think it'd have much of an audience. What do you think? [[User:Runspotrun|Runspotrun]] 20:55, 10 November 2007 (EST)

:: Er, I haven't just described startpoints.exe, have I? [[User:Runspotrun|Runspotrun]] 21:01, 10 November 2007 (EST)

::Well, if you're not averse to requests... A utility to activate the subterranean flag on indoor areas would be awesome for those of us who'd like to build surface castles in cold/freezing terrain without our dwarves dying of frostbite. -[[User:EarthquakeDamage|EarthquakeDamage]] 22:45, 10 November 2007 (EST)

::I'd like a rock/gem/ore tool. Would be really neat. Especially the ore/gem one. Also, maybe water/magma creation tools if possible?--[[User:Spelguru|Spelguru]] 01:29, 11 November 2007 (EST)

::Something similar to the old skills.exe would be great! --[[User:Vanan|Vanan]] 11:44, 19 November 2007 (EST)

::What I'd like is some way to search for a particular tile on the map. Probably the easiest thing for you to code is to have reveal.exe have an option where it prints the map data to a file in some simple text format (Just a simple list of 'Z,X,Y "tile code"' would be sufficient. mapping what tiles have what value would be nice, but not necessary.) I want to answer the question "Is the raw material for the item the possessed dwarf is asking for somewhere on my map, and if so, where?" --[[User:Warnold|Warnold]] 23:08, 9 December 2007 (EST)

::I would like to request something that teleports items. --[[User:Demosthenes|Demosthenes]] 02:05, 16 December 2007 (EST)

::Is it possible for a utility to remove excess stone? (name and amount in command line) --[[User:Jackard|Jackard]] 07:35, 16 December 2007 (EST)

== Wild Praise ==
Thank you so much for your incredible work! Your applications add so much fun to the game! --[[User:Vanan|Vanan]] 13:56, 17 November 2007 (EST)

Astonishing response time for 33e! --[[User:Geofferic|Geofferic]] 01:04, 9 December 2007 (EST)

== In reply to ==
Your statement to me on my page, "Don't subject your opinion unto others. (Though I think you were just trying to be funny...) --Rick 03:54, 31 October 2007 (EDT)"

Of course I was. But some people have no real sense of humor.

Also, some people believe they can do things they tell others NOT to do. Your statement is a perfect example of this. You tell me not to subject others to MY opinion, but in doing so you are subjecting me to YOUR opinion. Oh yes, you are one of the VIPs in the DF community, because you wrote a couple utilities. So I suppose I should be humble in your presence, and bow to someone so great. I would do that, but when I bow, I do it facing AWAY from that person, and I drop my trousers at the same time. Still want me to bow to your greatness?

I read other contributions here that voice their opinions the same as I did. I wonder if you said the same thing to all of them as well? Tho since I was able to read the pages they wrote, you clearly did not delete their words as you did mine. And while other entries I made were either deleted or edited, as I expected them to be, since I am not a great wiki writer, you were the only one to send me a somewhat nasty note.

Think whatever you like of me, but at least I was contributing, and trying to give a few smiles along the way. Seems to me tho, that DF is fun, and it's wiki should be too. And, from other pages I read, others feel the same way I do. Maybe you should take a look around at some of their pages, and lighten up yourself a bit? Maybe trade with the elves for a tame blue jay, and drop it down your shorts. If that doesnt get a giggle out of you, maybe you should go join the undead at one of their ruins?

: Wow, way to blow up that up, I was just jesting. I think I'll leave your words here, [[User:Darknight|Darknight]]. --[[User:Rick|Rick]] 19:25, 17 November 2007 (EST)

: Oh, and for the record, I did not remove your message, someone else did that. Check the page history. --[[User:Rick|Rick]] 19:29, 17 November 2007 (EST)

== heal.exe bug? ==

Hmm... I've found that heal -hurt doesn't work on fire men, at least in 33b. It sets all their body parts to red, but the fire man just keeps wandering around and scaring my poor witless dwarves. I haven't found a living fire man yet in 33c so I can't check. [[User:Runspotrun|Runspotrun]] 06:59, 28 November 2007 (EST)

: Are firemen immune to pain? Hurt just nukes bodyparts, not kills creatures, most creatures who feel pain will die from that, but I guess ones who don't won't. --[[User:Rick|Rick]] 12:08, 28 November 2007 (EST)

:: Just checked - yes they are. That'd explain it then, ta. [[User:Runspotrun|Runspotrun]] 14:38, 28 November 2007 (EST)

== INI? ==

Does anyone see anything obviously wrong about this? I used various comparisons to come to these values (as well as what the hex fellow posted in the memory hacking section), and editing them as such into the reveal.exe allowed me to get that program to function, but the ini isn't reenabling the executables on its own:

<pre>
[address]
DWARF_FORTRESS=0x0089C414 ; correct
MENU_STATE=0x0124565C ; maybe
FOCUSED_CREATURE=0x00C39548 ; correct
CREATURE_VECTOR=0x01420A48 ; correct
MOUSE_X=0x008FF290 ; pretty sure should be 008FF288
MOUSE_Y=0x008FF294 ; pretty sure should be 008FF28C
MOUSE_Z=0x008FF298 ; pretty sure should be 008FF290
MAP_DATA=0x01462568 ; correct
MAP_X_COUNT=0x01462580 ; correct
MAP_Y_COUNT=0x01462584 ; correct
MAP_Z_COUNT=0x01462588 ; correct
STARTING_DWARF_COUNT=0x0078A54E ; wrong. 0078A554 (value actually is dword at 0078A555)
STARTING_POINT_COUNT=0x00789703 ; correct (value actually is word at 0078970A)

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260 ; dunno
MAP_DATA_OCCUPANCY_OFFSET=0x660 ; dunno
CREATURE_NAME_OFFSET=0x000 ; yes
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308 ; probably
CREATURE_X_OFFSET=0x0094 ; probably
CREATURE_Y_OFFSET=0x0096 ; probably
CREATURE_Z_OFFSET=0x0098 ; probably
</pre>

[[User:Qalnor|Qalnor]] 14:05, 16 December 2007 (EST)

I commented the above. none of the corrections should affect reveal. I don't know what's going wrong. —[[User:0x517A5D|0x517A5D]] 19:53, 16 December 2007 (EST)

:: I made a few mistakes when documenting the existing data, which probably threw you guys off. My user page has been updated for 33f. --[[User:Rick|Rick]] 20:41, 16 December 2007 (EST)

:: Thanks, to both of you. I'll have to go over what I was doing when I get home to try and see where I was going wrong. [[User:Qalnor|Qalnor]] 15:11, 17 December 2007 (EST)

== Possible adjuststart enhancement ==
Hi! Merry culturally-appropriate politically-correct generic holiday!

I have found some interesting addresses that work well with adjuststart.

In .33f, the byte at 0078654B holds a constant that is the upper limit that starting skills can be advanced to. It is normally 5 (proficient). If you change it to 15, skills can be advanced to legendary. If you change it to 20, skills can be advanced to legendary+5.

Also in .33f, there's a pair of bytes at 00786466 and 00786608. If you set both to 0, then the 10 skills per dwarf limit is removed.

I've found equivalant addresses for all the .33 releases. They're in the memory hacking subpages.

—Preceding unsigned comment added by [[User:0x517A5D|0x517A5D]] ([[User talk:0x517A5D|talk]]{{!}}[[Special:Contributions/0x517A5D|contribs]]) {{{2|}}}

:Did I not sign that? Oops. Well, I was tired. Thank you, VengefulDonut. —[[User:0x517A5D|0x517A5D]] 22:02, 19 December 2007 (EST)

::Very cool, I'll probably add these for the next release then. --[[User:Rick|Rick]] 04:18, 20 December 2007 (EST)

== Update of utilities ==

So how much longer do you suppose it might take to transition the utilities to 33f?--[[User:Heliopios|Heliopios]] 13:04, 19 December 2007 (EST)
:With the .ini method there isnt really a need to rebuild the utilities for 32f. [[User:VengefulDonut|VengefulDonut]] 15:25, 19 December 2007 (EST)

:And how exactly do you use memory.ini? I've created a new ini file (yes, it's a .ini, not a .ini.txt) and pasted everything under [code] tags for .33f, and lugged it into the dir. with the required executable (heal.exe in this case) but when I run it it still says it was built for .33e. Should I put it somewhere else? In any case, instructions for use are either inexistent or pretty well hidden here in the wiki.
:Cheers. [[User:N35t0r|N35t0r]] 21:45, 19 December 2007 (EST)
::Did you name it "memory.ini"? This worked for me with reveal.exe [[User:VengefulDonut|VengefulDonut]] 01:52, 20 December 2007 (EST)

== Possible INI file syntax change ==

I would like to suggest a change to the format of MEMORY.INI. Instead of the [generic], [address], and [offset] sections (which in my opinion buy you nothing), I would suggest using sections keyed off the PE header timestamp. (You have previously indicated that you plan to convert to that method anyway.) So a sample .INI file might look like this:

<pre>; .33e
[475B7526]
MENU_STATE=0x01244654
FOCUSED_CREATURE=0x00C38540
CREATURE_VECTOR=0x0141FA40
MOUSE_X=0x008FE288
MOUSE_Y=0x008FE28C
MOUSE_Z=0x008FE290
MAP_DATA=0x01461560
MAP_X_COUNT=0x01461578
MAP_Y_COUNT=0x0146157C
MAP_Z_COUNT=0x01461580
STARTING_DWARF_COUNT=0x007893C5
STARTING_POINT_COUNT=0x0078857A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098

; .33f
[4763710C]
MENU_STATE=0x0124565C
FOCUSED_CREATURE=0x00C39548
CREATURE_VECTOR=0x01420A48
MOUSE_X=0x008FF288
MOUSE_Y=0x008FF28C
MOUSE_Z=0x008FF290
MAP_DATA=0x01462568
MAP_X_COUNT=0x01462580
MAP_Y_COUNT=0x01462584
MAP_Z_COUNT=0x01462588
STARTING_DWARF_COUNT=0x0078A555
STARTING_POINT_COUNT=0x0078970A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098</pre>

The main reason to do this is to allow data for multiple versions to be in the .INI file. —[[User:0x517A5D|0x517A5D]] 18:22, 21 December 2007 (EST)

: Agreed, will do this. --[[User:Rick|Rick]] 15:28, 22 December 2007 (EST)

== 33g memory.ini ==

0x517A5D looked these up and put them on the 33g memory hacking page, but did not actually put them in here. He copied/pasted from 33f. Mistake? I looked up the dwarf fortress tag and used his values for the ones I could see on the other page he posted (33g memory hacking page) and updated them. It works for reveal, but it's missing FOCUSED_CREATURE and CREATURE_VECTOR because I can't find them.
--[[User:Paul|Paul]] 15:05, 22 December 2007 (CST)
:I just cross-referenced those 2 values with the 33f memory location page and updated them. Should work now, though I haven't tested. --[[User:Janus|Janus]] 16:27, 22 December 2007 (EST)
::The currently listed FOCUSED_CREATURE and CREATURE_VECTOR values don't appear to work. --[[User:Zurai|Zurai]] 22:20, 22 December 2007 (EST)
:::Hi Zurai. Do to my blunder, there was a short period where those two values were incorrect. You probably hit that window. Check the values in your copy against the ones shown now. —[[User:0x517A5D|0x517A5D]] 22:59, 22 December 2007 (EST)
::::Heal.exe and warp.exe (only when trying to warp a creature - warp to find the coords of a tile works fine) both give me "An error has occured: please select a unit in 'view units' mode" using FOCUSED_CREATURE=0x00C40540 and CREATURE_VECTOR=0x01427B60, which are the values listed at the time of this writing. I've redownloaded both executables and re-made the ini from scratch, copy-pasting the values from the 33g listing, and it still occurs. Is anyone else having the same issue? Maybe my computer doesn't like heal or warp any more. Reveal works fine, though. --[[User:Zurai|Zurai]] 18:45, 23 December 2007 (EST)
:::::I found the problem. It was MENU_STATE. Yes, anyone else who tried to use these utils would experience the same problem. I have now edited the .33g memory.ini section again, and verified that warp.exe, heal.exe -hurt, and heal.exe all work. I'm really, really sorry for the mess up. —[[User:0x517A5D|0x517A5D]] 22:39, 23 December 2007 (EST)
::::::I'm having this pop up with the new memory.ini info for warp.exe: "An error has occured:failed to read block pointer for to block". --[[User:Corbine|Corbine]] 03:19, 24 December 2007 (EST)
:::::::Well, let's go down the checklist. Due to a blunder on my part, the .33g memory.ini file was wrong for several hours. One of the mistakes causes that error message. Try deleting memory.ini and making a new one with the [[User:Rick#v0.27.169.33g|current data]]. —[[User:0x517A5D|0x517A5D]] 14:29, 24 December 2007 (EST)
::::::::Deleted the memory.ini, made a new one and threw the new info into it, still same error. --[[User:Corbine|Corbine]] 01:28, 25 December 2007 (EST)
:::::::::Corbine, are you still experiencing this? I just realized I've left this hanging for a week. Sorry. Okay, next. Previous versions of warp have worked for you with previous versions of DF? Do other of Rick's utilities work for you? My tentative diagnosis is that part of your INI file is wrong. If the whole thing was wrong, it would merely complain that it was built for version .33e. I don't know which particular key being wrong gives that error, and I don't have a .33g test fort at the moment, so I can't easily check right now. But I could when I have time. Really, I'm puzzled. —[[User:0x517A5D|0x517A5D]] 03:47, 31 December 2007 (EST)
:Yes, mistake. Arrgh. I must have copied from the wrong editor window. Thank you both. —[[User:0x517A5D|0x517A5D]] 17:08, 22 December 2007 (EST)
::No worries, and thanks for posting the new memory locations in the first place. I personally was looking forward to that info so I could use reveal.exe to examine potential fortress locations in newly created 33g worlds, so it is much appreciated. --[[User:Janus|Janus]] 18:07, 22 December 2007 (EST)
::I was all excited when I saw the 33g info up, then went to paste it into my ini and realised the data was the same... I figured you just accidentally pasted the wrong thing in. The only thing I could figure out how to look up was the Dwarf Fortress tag location, so it is appreciated that you looked all the rest up. With the world generation changing, it's nice to have reveal available to search for new sites. [[User:Paul|Paul]] 21:20, 22 December 2007 (EST)

==38a==

How would we update this? --[[User:Squeegy|Squeegy]] 20:22, 5 February 2008 (EST)

we can start by finding the relevant mem locations for 88a 

<blockquote>
[generic] 
DWARF_FORTRESS=0x00C11218 
 
[address] 
 
MENU_STATE= 
FOCUSED_CREATURE= .
CREATURE_VECTOR= 
MOUSE_X=0x0092f288 
MOUSE_Y=0x0092f28c 
MOUSE_Z=0x0092f290 
MAP_DATA= 
MAP_X_COUNT=0x014929F0 
MAP_Y_COUNT=0x014929F4 
MAP_Z_COUNT=0x014929F8 
STARTING_DWARF_COUNT= 
STARTING_POINT_COUNT= 
</blockquote>

those are the easy ones.
if we had map data and confirmed that the offset was correct at least Reveal.exe would work but I'm out of time today. --[[User:Shadetree|Shadetree]] 22:23, 6 February 2008 (EST)

I've found the other addresses. I won't guarantee that the offsets other than MAP_DATA_DESIGNATION_OFFSET, MAP_DATA_OCCUPANCY_OFFSET, and CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET are correct.
[generic]
DWARF_FORTRESS=0x00C11218

[address]
STARTING_POINT_COUNT=0x007AF4FA
STARTING_DWARF_COUNT=0x007B0345
MENU_STATE=0x0127599C
FOCUSED_CREATURE=0x00C69888
CREATURE_VECTOR=0x01450E98
MOUSE_X=0x0092F288
MOUSE_Y=0x0092F28C
MOUSE_Z=0x0092F290
MAP_DATA=0x014929CC
MAP_X_COUNT=0x014929E4
MAP_Y_COUNT=0x014929E8
MAP_Z_COUNT=0x014929EC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
If I understand how Rick's tools work, the offsets I've verified are the only offsets necessary.
-- [[User:Jifodus|Jifodus]] 20:05, 7 February 2008 (EST)

confirmed that this works with Reveal.exe --[[User:Shadetree|Shadetree]] 18:41, 8 February 2008 (EST)

warp.exe and heal.exe do not work with this configuration. --[[User:Markham|Markham]] 11:28, 9 February 2008 (EST)

The reason the creature tools will work is due to some issue with how FOCUSED_CREATURE now behaves. Assuming the address is correct, and I'm 99.9% positive it's the correct address, a new method will have to be determined which unit is focused. Also, did your map have existing creatures? -- [[User:Jifodus|Jifodus]] 17:39, 9 February 2008 (EST)

Confirmed that adjuststart.exe works with this. --[[User:Squeegy|Squeegy]] 23:44, 10 February 2008 (EST)

==176-38a==

Any love on new offsets with version df_27_176_38a? What do you all use to dig up the offsets? A debugger running trace on particular strings?

I use IDA Pro Free, and do a binary match.
<pre>
[generic]
DWARF_FORTRESS=0x008D8B08

[address]
STARTING_POINT_COUNT=0x007B995A
STARTING_DWARF_COUNT=0x007BA7B3
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC00
CREATURE_VECTOR=0x01450E9C
MOUSE_X=0x00941288
MOUSE_Y=0x0094128C
MOUSE_Z=0x00941290
MAP_DATA=0x014A4EAC
MAP_X_COUNT=0x014A4EC4
MAP_Y_COUNT=0x014A4EC8
MAP_Z_COUNT=0x014A4ECC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Heal & Warp won't work due to FOCUSED_CREATURE not working properly. -- [[User:Jifodus|Jifodus]] 04:00, 17 February 2008 (EST)

== 0.27.176.38b ==

<pre>
[generic]
DWARF_FORTRESS=0x008D8A58

[address]
MAP_DATA=0x014A50A4
MAP_X_COUNT=0x014A50BC
MAP_Y_COUNT=0x014A50C0
MAP_Z_COUNT=0x014A50C4
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC04
STARTING_DWARF_COUNT=0x007AEB77
STARTING_POINT_COUNT=0x007BAE4A
MOUSE_X=0x0094128C
MOUSE_Y=0x00941290
MOUSE_Z=0x00941294
CREATURE_VECTOR=0x01463574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 23:08, 24 February 2008 (EST)

Are you sure that's right? Reveal.exe isn't working for me with this.--[[User:Eiba|Eiba]] 00:19, 25 February 2008 (EST)

Seems you got the starting points right for AdjustStart, but not the dwarf count. [[User:MikeWulf|MikeWulf]]

A little late, but my finder program didn't spit out the correct address for vectors. -- [[User:Jifodus|Jifodus]] 02:26, 4 March 2008 (EST)

== 0.27.176.38c ==

<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
STARTING_POINT_COUNT=
STARTING_DWARF_COUNT=
MENU_STATE=
FOCUSED_CREATURE=
CREATURE_VECTOR=
MOUSE_X=
MOUSE_Y=
MOUSE_Z=
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Only reveal works with this memory.ini. Offsets are copied from version 176.38a. --[[User:DFD|DFD]] 11:53, 29 February 2008 (EST)

No guarantee's (I used an automated program to find these), don't expect any of the creature tools to work.
<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4
MENU_STATE=0x01288D14
FOCUSED_CREATURE=0x00C7CC04
STARTING_DWARF_COUNT=0x007BBDB5
STARTING_POINT_COUNT=0x007BAF5A
MOUSE_X=0x0094228C
MOUSE_Y=0x00942290
MOUSE_Z=0x00942294
CREATURE_VECTOR=0x01464574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 02:28, 4 March 2008 (EST)

STARTING-DWARF_COUNT is wrong again apparently. :< [[User:MikeWulf|MikeWulf]] 21:04, 4 March 2008 (EST)

User:Jifodus

2008-03-04T07:36:32Z

Jifodus: /* tile_tool */ tool updates

40d:Utilities

2008-03-04T07:31:25Z

Jifodus: /* Dwarf Foreman */ v0.27.176.38c config

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
This project is meant as a 3rd party utility for the cult-game dwarf fortress. Its purpose is to eventually provide 3-dimensual visualization of static snapshots of the ingame world of a given fortress.

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] is a graphical helper utility for dwarf fortress that aims to fill the gaps in the user interface. It allows some for some nefarious cheating. For example, you can now mark your nobles as butcherable, and change possessed dwarves to fey moods.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

Outdated tools (v0.27.169.32a): [http://www.yourfilehost.com/media.php?cat=other&file=5465reveal.zip reveal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=tileinfo_2.zip tileinfo.exe]

Outdated tools (v0.27.169.33a): [http://kisskapsel.se/adjuststart.exe adjuststart.exe] [http://kisskapsel.se/heal.exe heal.exe] [http://kisskapsel.se/reveal.exe reveal.exe]

Outdated tools (v0.27.169.33b): [http://www.yourfilehost.com/media.php?cat=other&file=4621adjuststart.zip adjuststart.exe] [http://www.yourfilehost.com/media.php?cat=other&file=2802heal.zip heal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=1725reveal.zip reveal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=warp.zip warp.exe]

Outdated tools (v0.27.169.33c): [http://no.shizzle.se/~rgibbed/v0.27.169.33c/adjuststart.exe adjuststart.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/heal.exe heal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/reveal.exe reveal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/warp.exe warp.exe]

Outdated tools (v0.27.169.33d): [http://no.shizzle.se/~rgibbed/v0.27.169.33d/adjuststart.exe adjuststart.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/heal.exe heal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/reveal.exe reveal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/warp.exe warp.exe]

Most Current tools ('''v0.27.169.33e''', none for '''v0.27.176.38a''' yet, unless you use memory.ini for the '''v0.27.169.33e''' tools):

'''Current version out of date? Have skills to find the newer addresses? [[User:Rick#memory.ini|Check Rick's user page for details on memory.ini]].'''

=== adjuststart.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/adjuststart.exe Download adjuststart.exe]   Modifies the starting number of dwarves and/or the starting points. <tt>adjuststart.exe <dwarves> <points></tt>

Instructions: type cmd in run, put in the location for adjuststart.exe, navigate to the DF main menu, change the starting dwarf number and points in this format: C:\location\adjuststart.exe 10 9999 (gives 10 dwarves, 9999 points) then hit enter.

=== heal.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/heal.exe Download heal.exe]   Heals creature limbs (any creature you can highlight with V basically). You can optionally hurt a creature by specifying -hurt on the command-line arguments.

=== reveal.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/reveal.exe Download reveal.exe]   Makes as much of the map visible as it can (eg, it can't reveal unallocated map blocks) Run while Dwarf Fortress is running.

If you want to reveal the entire map, go to the furthest Z level down you can get to, and designate the entire bottom to be mined, then remove the designation, then run reveal.

=== warp.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/warp.exe Download warp.exe]   A creature warper, similar to teleport, but properly sets occupancy flags of the tiles with some limitations (eg: if there are multiple creatures on the source tile, the occupancy flag will still be unset).

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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 recognise 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.

This handy utility would be an ideal complent to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

To make Foreman compatible with '''v0.27.176.38c''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] if it doesn't work.
<pre>
check=01cf4654
critter_start=01464570
dwarfidpos=01285188
profession_start=0470
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

[http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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 antivirus programs.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

==DF Merge by Ikkonoishi ==
A quick and dirty utility to merge the DF data files together. I plan on making it scriptable so that you can use it to combine mods together easily and sort out any conflicts. Right now it is only useful to merge init files together for different versions of DF. Any values that are shared across the two files are combined with the values from the source overwriting the destination. You then click on the text to select it and copy it into the init.txt file of the new version.

Get it at http://www.mediafire.com/?d3yosptjze0

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

== Winmerge ==

This utility allow you to compare even folders or just files and it highlight where lines are different so see what make files different. So that can see what you want merge into one file or not.

Which is at http://winmerge.org/ to download it. [[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)

User talk:Rick

2008-03-04T07:28:05Z

Jifodus: /* 0.27.176.38c */ full config

== Requests ==
Hey there. Thanks for writing reveal.exe. It's made my dwarves' lives so much easier!

Do you take requests?

And is this the right place to ask? [[User:Runspotrun|Runspotrun]] 20:32, 10 November 2007 (EST)

: Yes, and yes. --[[User:Rick|Rick]] 20:49, 10 November 2007 (EST)

::Excellent! Now, I don't know how many people would use it, but I'd love to see a utility that would allow me to choose the temperature/forest/shrub/surroundings/neighbours when starting out. I like to stick to the same sort of areas, but it can be a pain finding them on the map - if they exist at all. Problem is, I think most people take what they're given, region-wise... so I don't think it'd have much of an audience. What do you think? [[User:Runspotrun|Runspotrun]] 20:55, 10 November 2007 (EST)

:: Er, I haven't just described startpoints.exe, have I? [[User:Runspotrun|Runspotrun]] 21:01, 10 November 2007 (EST)

::Well, if you're not averse to requests... A utility to activate the subterranean flag on indoor areas would be awesome for those of us who'd like to build surface castles in cold/freezing terrain without our dwarves dying of frostbite. -[[User:EarthquakeDamage|EarthquakeDamage]] 22:45, 10 November 2007 (EST)

::I'd like a rock/gem/ore tool. Would be really neat. Especially the ore/gem one. Also, maybe water/magma creation tools if possible?--[[User:Spelguru|Spelguru]] 01:29, 11 November 2007 (EST)

::Something similar to the old skills.exe would be great! --[[User:Vanan|Vanan]] 11:44, 19 November 2007 (EST)

::What I'd like is some way to search for a particular tile on the map. Probably the easiest thing for you to code is to have reveal.exe have an option where it prints the map data to a file in some simple text format (Just a simple list of 'Z,X,Y "tile code"' would be sufficient. mapping what tiles have what value would be nice, but not necessary.) I want to answer the question "Is the raw material for the item the possessed dwarf is asking for somewhere on my map, and if so, where?" --[[User:Warnold|Warnold]] 23:08, 9 December 2007 (EST)

::I would like to request something that teleports items. --[[User:Demosthenes|Demosthenes]] 02:05, 16 December 2007 (EST)

::Is it possible for a utility to remove excess stone? (name and amount in command line) --[[User:Jackard|Jackard]] 07:35, 16 December 2007 (EST)

== Wild Praise ==
Thank you so much for your incredible work! Your applications add so much fun to the game! --[[User:Vanan|Vanan]] 13:56, 17 November 2007 (EST)

Astonishing response time for 33e! --[[User:Geofferic|Geofferic]] 01:04, 9 December 2007 (EST)

== In reply to ==
Your statement to me on my page, "Don't subject your opinion unto others. (Though I think you were just trying to be funny...) --Rick 03:54, 31 October 2007 (EDT)"

Of course I was. But some people have no real sense of humor.

Also, some people believe they can do things they tell others NOT to do. Your statement is a perfect example of this. You tell me not to subject others to MY opinion, but in doing so you are subjecting me to YOUR opinion. Oh yes, you are one of the VIPs in the DF community, because you wrote a couple utilities. So I suppose I should be humble in your presence, and bow to someone so great. I would do that, but when I bow, I do it facing AWAY from that person, and I drop my trousers at the same time. Still want me to bow to your greatness?

I read other contributions here that voice their opinions the same as I did. I wonder if you said the same thing to all of them as well? Tho since I was able to read the pages they wrote, you clearly did not delete their words as you did mine. And while other entries I made were either deleted or edited, as I expected them to be, since I am not a great wiki writer, you were the only one to send me a somewhat nasty note.

Think whatever you like of me, but at least I was contributing, and trying to give a few smiles along the way. Seems to me tho, that DF is fun, and it's wiki should be too. And, from other pages I read, others feel the same way I do. Maybe you should take a look around at some of their pages, and lighten up yourself a bit? Maybe trade with the elves for a tame blue jay, and drop it down your shorts. If that doesnt get a giggle out of you, maybe you should go join the undead at one of their ruins?

: Wow, way to blow up that up, I was just jesting. I think I'll leave your words here, [[User:Darknight|Darknight]]. --[[User:Rick|Rick]] 19:25, 17 November 2007 (EST)

: Oh, and for the record, I did not remove your message, someone else did that. Check the page history. --[[User:Rick|Rick]] 19:29, 17 November 2007 (EST)

== heal.exe bug? ==

Hmm... I've found that heal -hurt doesn't work on fire men, at least in 33b. It sets all their body parts to red, but the fire man just keeps wandering around and scaring my poor witless dwarves. I haven't found a living fire man yet in 33c so I can't check. [[User:Runspotrun|Runspotrun]] 06:59, 28 November 2007 (EST)

: Are firemen immune to pain? Hurt just nukes bodyparts, not kills creatures, most creatures who feel pain will die from that, but I guess ones who don't won't. --[[User:Rick|Rick]] 12:08, 28 November 2007 (EST)

:: Just checked - yes they are. That'd explain it then, ta. [[User:Runspotrun|Runspotrun]] 14:38, 28 November 2007 (EST)

== INI? ==

Does anyone see anything obviously wrong about this? I used various comparisons to come to these values (as well as what the hex fellow posted in the memory hacking section), and editing them as such into the reveal.exe allowed me to get that program to function, but the ini isn't reenabling the executables on its own:

<pre>
[address]
DWARF_FORTRESS=0x0089C414 ; correct
MENU_STATE=0x0124565C ; maybe
FOCUSED_CREATURE=0x00C39548 ; correct
CREATURE_VECTOR=0x01420A48 ; correct
MOUSE_X=0x008FF290 ; pretty sure should be 008FF288
MOUSE_Y=0x008FF294 ; pretty sure should be 008FF28C
MOUSE_Z=0x008FF298 ; pretty sure should be 008FF290
MAP_DATA=0x01462568 ; correct
MAP_X_COUNT=0x01462580 ; correct
MAP_Y_COUNT=0x01462584 ; correct
MAP_Z_COUNT=0x01462588 ; correct
STARTING_DWARF_COUNT=0x0078A54E ; wrong. 0078A554 (value actually is dword at 0078A555)
STARTING_POINT_COUNT=0x00789703 ; correct (value actually is word at 0078970A)

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260 ; dunno
MAP_DATA_OCCUPANCY_OFFSET=0x660 ; dunno
CREATURE_NAME_OFFSET=0x000 ; yes
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308 ; probably
CREATURE_X_OFFSET=0x0094 ; probably
CREATURE_Y_OFFSET=0x0096 ; probably
CREATURE_Z_OFFSET=0x0098 ; probably
</pre>

[[User:Qalnor|Qalnor]] 14:05, 16 December 2007 (EST)

I commented the above. none of the corrections should affect reveal. I don't know what's going wrong. —[[User:0x517A5D|0x517A5D]] 19:53, 16 December 2007 (EST)

:: I made a few mistakes when documenting the existing data, which probably threw you guys off. My user page has been updated for 33f. --[[User:Rick|Rick]] 20:41, 16 December 2007 (EST)

:: Thanks, to both of you. I'll have to go over what I was doing when I get home to try and see where I was going wrong. [[User:Qalnor|Qalnor]] 15:11, 17 December 2007 (EST)

== Possible adjuststart enhancement ==
Hi! Merry culturally-appropriate politically-correct generic holiday!

I have found some interesting addresses that work well with adjuststart.

In .33f, the byte at 0078654B holds a constant that is the upper limit that starting skills can be advanced to. It is normally 5 (proficient). If you change it to 15, skills can be advanced to legendary. If you change it to 20, skills can be advanced to legendary+5.

Also in .33f, there's a pair of bytes at 00786466 and 00786608. If you set both to 0, then the 10 skills per dwarf limit is removed.

I've found equivalant addresses for all the .33 releases. They're in the memory hacking subpages.

—Preceding unsigned comment added by [[User:0x517A5D|0x517A5D]] ([[User talk:0x517A5D|talk]]{{!}}[[Special:Contributions/0x517A5D|contribs]]) {{{2|}}}

:Did I not sign that? Oops. Well, I was tired. Thank you, VengefulDonut. —[[User:0x517A5D|0x517A5D]] 22:02, 19 December 2007 (EST)

::Very cool, I'll probably add these for the next release then. --[[User:Rick|Rick]] 04:18, 20 December 2007 (EST)

== Update of utilities ==

So how much longer do you suppose it might take to transition the utilities to 33f?--[[User:Heliopios|Heliopios]] 13:04, 19 December 2007 (EST)
:With the .ini method there isnt really a need to rebuild the utilities for 32f. [[User:VengefulDonut|VengefulDonut]] 15:25, 19 December 2007 (EST)

:And how exactly do you use memory.ini? I've created a new ini file (yes, it's a .ini, not a .ini.txt) and pasted everything under [code] tags for .33f, and lugged it into the dir. with the required executable (heal.exe in this case) but when I run it it still says it was built for .33e. Should I put it somewhere else? In any case, instructions for use are either inexistent or pretty well hidden here in the wiki.
:Cheers. [[User:N35t0r|N35t0r]] 21:45, 19 December 2007 (EST)
::Did you name it "memory.ini"? This worked for me with reveal.exe [[User:VengefulDonut|VengefulDonut]] 01:52, 20 December 2007 (EST)

== Possible INI file syntax change ==

I would like to suggest a change to the format of MEMORY.INI. Instead of the [generic], [address], and [offset] sections (which in my opinion buy you nothing), I would suggest using sections keyed off the PE header timestamp. (You have previously indicated that you plan to convert to that method anyway.) So a sample .INI file might look like this:

<pre>; .33e
[475B7526]
MENU_STATE=0x01244654
FOCUSED_CREATURE=0x00C38540
CREATURE_VECTOR=0x0141FA40
MOUSE_X=0x008FE288
MOUSE_Y=0x008FE28C
MOUSE_Z=0x008FE290
MAP_DATA=0x01461560
MAP_X_COUNT=0x01461578
MAP_Y_COUNT=0x0146157C
MAP_Z_COUNT=0x01461580
STARTING_DWARF_COUNT=0x007893C5
STARTING_POINT_COUNT=0x0078857A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098

; .33f
[4763710C]
MENU_STATE=0x0124565C
FOCUSED_CREATURE=0x00C39548
CREATURE_VECTOR=0x01420A48
MOUSE_X=0x008FF288
MOUSE_Y=0x008FF28C
MOUSE_Z=0x008FF290
MAP_DATA=0x01462568
MAP_X_COUNT=0x01462580
MAP_Y_COUNT=0x01462584
MAP_Z_COUNT=0x01462588
STARTING_DWARF_COUNT=0x0078A555
STARTING_POINT_COUNT=0x0078970A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098</pre>

The main reason to do this is to allow data for multiple versions to be in the .INI file. —[[User:0x517A5D|0x517A5D]] 18:22, 21 December 2007 (EST)

: Agreed, will do this. --[[User:Rick|Rick]] 15:28, 22 December 2007 (EST)

== 33g memory.ini ==

0x517A5D looked these up and put them on the 33g memory hacking page, but did not actually put them in here. He copied/pasted from 33f. Mistake? I looked up the dwarf fortress tag and used his values for the ones I could see on the other page he posted (33g memory hacking page) and updated them. It works for reveal, but it's missing FOCUSED_CREATURE and CREATURE_VECTOR because I can't find them.
--[[User:Paul|Paul]] 15:05, 22 December 2007 (CST)
:I just cross-referenced those 2 values with the 33f memory location page and updated them. Should work now, though I haven't tested. --[[User:Janus|Janus]] 16:27, 22 December 2007 (EST)
::The currently listed FOCUSED_CREATURE and CREATURE_VECTOR values don't appear to work. --[[User:Zurai|Zurai]] 22:20, 22 December 2007 (EST)
:::Hi Zurai. Do to my blunder, there was a short period where those two values were incorrect. You probably hit that window. Check the values in your copy against the ones shown now. —[[User:0x517A5D|0x517A5D]] 22:59, 22 December 2007 (EST)
::::Heal.exe and warp.exe (only when trying to warp a creature - warp to find the coords of a tile works fine) both give me "An error has occured: please select a unit in 'view units' mode" using FOCUSED_CREATURE=0x00C40540 and CREATURE_VECTOR=0x01427B60, which are the values listed at the time of this writing. I've redownloaded both executables and re-made the ini from scratch, copy-pasting the values from the 33g listing, and it still occurs. Is anyone else having the same issue? Maybe my computer doesn't like heal or warp any more. Reveal works fine, though. --[[User:Zurai|Zurai]] 18:45, 23 December 2007 (EST)
:::::I found the problem. It was MENU_STATE. Yes, anyone else who tried to use these utils would experience the same problem. I have now edited the .33g memory.ini section again, and verified that warp.exe, heal.exe -hurt, and heal.exe all work. I'm really, really sorry for the mess up. —[[User:0x517A5D|0x517A5D]] 22:39, 23 December 2007 (EST)
::::::I'm having this pop up with the new memory.ini info for warp.exe: "An error has occured:failed to read block pointer for to block". --[[User:Corbine|Corbine]] 03:19, 24 December 2007 (EST)
:::::::Well, let's go down the checklist. Due to a blunder on my part, the .33g memory.ini file was wrong for several hours. One of the mistakes causes that error message. Try deleting memory.ini and making a new one with the [[User:Rick#v0.27.169.33g|current data]]. —[[User:0x517A5D|0x517A5D]] 14:29, 24 December 2007 (EST)
::::::::Deleted the memory.ini, made a new one and threw the new info into it, still same error. --[[User:Corbine|Corbine]] 01:28, 25 December 2007 (EST)
:::::::::Corbine, are you still experiencing this? I just realized I've left this hanging for a week. Sorry. Okay, next. Previous versions of warp have worked for you with previous versions of DF? Do other of Rick's utilities work for you? My tentative diagnosis is that part of your INI file is wrong. If the whole thing was wrong, it would merely complain that it was built for version .33e. I don't know which particular key being wrong gives that error, and I don't have a .33g test fort at the moment, so I can't easily check right now. But I could when I have time. Really, I'm puzzled. —[[User:0x517A5D|0x517A5D]] 03:47, 31 December 2007 (EST)
:Yes, mistake. Arrgh. I must have copied from the wrong editor window. Thank you both. —[[User:0x517A5D|0x517A5D]] 17:08, 22 December 2007 (EST)
::No worries, and thanks for posting the new memory locations in the first place. I personally was looking forward to that info so I could use reveal.exe to examine potential fortress locations in newly created 33g worlds, so it is much appreciated. --[[User:Janus|Janus]] 18:07, 22 December 2007 (EST)
::I was all excited when I saw the 33g info up, then went to paste it into my ini and realised the data was the same... I figured you just accidentally pasted the wrong thing in. The only thing I could figure out how to look up was the Dwarf Fortress tag location, so it is appreciated that you looked all the rest up. With the world generation changing, it's nice to have reveal available to search for new sites. [[User:Paul|Paul]] 21:20, 22 December 2007 (EST)

==38a==

How would we update this? --[[User:Squeegy|Squeegy]] 20:22, 5 February 2008 (EST)

we can start by finding the relevant mem locations for 88a 

<blockquote>
[generic] 
DWARF_FORTRESS=0x00C11218 
 
[address] 
 
MENU_STATE= 
FOCUSED_CREATURE= .
CREATURE_VECTOR= 
MOUSE_X=0x0092f288 
MOUSE_Y=0x0092f28c 
MOUSE_Z=0x0092f290 
MAP_DATA= 
MAP_X_COUNT=0x014929F0 
MAP_Y_COUNT=0x014929F4 
MAP_Z_COUNT=0x014929F8 
STARTING_DWARF_COUNT= 
STARTING_POINT_COUNT= 
</blockquote>

those are the easy ones.
if we had map data and confirmed that the offset was correct at least Reveal.exe would work but I'm out of time today. --[[User:Shadetree|Shadetree]] 22:23, 6 February 2008 (EST)

I've found the other addresses. I won't guarantee that the offsets other than MAP_DATA_DESIGNATION_OFFSET, MAP_DATA_OCCUPANCY_OFFSET, and CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET are correct.
[generic]
DWARF_FORTRESS=0x00C11218

[address]
STARTING_POINT_COUNT=0x007AF4FA
STARTING_DWARF_COUNT=0x007B0345
MENU_STATE=0x0127599C
FOCUSED_CREATURE=0x00C69888
CREATURE_VECTOR=0x01450E98
MOUSE_X=0x0092F288
MOUSE_Y=0x0092F28C
MOUSE_Z=0x0092F290
MAP_DATA=0x014929CC
MAP_X_COUNT=0x014929E4
MAP_Y_COUNT=0x014929E8
MAP_Z_COUNT=0x014929EC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
If I understand how Rick's tools work, the offsets I've verified are the only offsets necessary.
-- [[User:Jifodus|Jifodus]] 20:05, 7 February 2008 (EST)

confirmed that this works with Reveal.exe --[[User:Shadetree|Shadetree]] 18:41, 8 February 2008 (EST)

warp.exe and heal.exe do not work with this configuration. --[[User:Markham|Markham]] 11:28, 9 February 2008 (EST)

The reason the creature tools will work is due to some issue with how FOCUSED_CREATURE now behaves. Assuming the address is correct, and I'm 99.9% positive it's the correct address, a new method will have to be determined which unit is focused. Also, did your map have existing creatures? -- [[User:Jifodus|Jifodus]] 17:39, 9 February 2008 (EST)

Confirmed that adjuststart.exe works with this. --[[User:Squeegy|Squeegy]] 23:44, 10 February 2008 (EST)

==176-38a==

Any love on new offsets with version df_27_176_38a? What do you all use to dig up the offsets? A debugger running trace on particular strings?

I use IDA Pro Free, and do a binary match.
<pre>
[generic]
DWARF_FORTRESS=0x008D8B08

[address]
STARTING_POINT_COUNT=0x007B995A
STARTING_DWARF_COUNT=0x007BA7B3
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC00
CREATURE_VECTOR=0x01450E9C
MOUSE_X=0x00941288
MOUSE_Y=0x0094128C
MOUSE_Z=0x00941290
MAP_DATA=0x014A4EAC
MAP_X_COUNT=0x014A4EC4
MAP_Y_COUNT=0x014A4EC8
MAP_Z_COUNT=0x014A4ECC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Heal & Warp won't work due to FOCUSED_CREATURE not working properly. -- [[User:Jifodus|Jifodus]] 04:00, 17 February 2008 (EST)

== 0.27.176.38b ==

<pre>
[generic]
DWARF_FORTRESS=0x008D8A58

[address]
MAP_DATA=0x014A50A4
MAP_X_COUNT=0x014A50BC
MAP_Y_COUNT=0x014A50C0
MAP_Z_COUNT=0x014A50C4
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC04
STARTING_DWARF_COUNT=0x007AEB77
STARTING_POINT_COUNT=0x007BAE4A
MOUSE_X=0x0094128C
MOUSE_Y=0x00941290
MOUSE_Z=0x00941294
CREATURE_VECTOR=0x01463574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 23:08, 24 February 2008 (EST)

Are you sure that's right? Reveal.exe isn't working for me with this.--[[User:Eiba|Eiba]] 00:19, 25 February 2008 (EST)

Seems you got the starting points right for AdjustStart, but not the dwarf count. [[User:MikeWulf|MikeWulf]]

A little late, but my finder program didn't spit out the correct address for vectors. -- [[User:Jifodus|Jifodus]] 02:26, 4 March 2008 (EST)

== 0.27.176.38c ==

<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
STARTING_POINT_COUNT=
STARTING_DWARF_COUNT=
MENU_STATE=
FOCUSED_CREATURE=
CREATURE_VECTOR=
MOUSE_X=
MOUSE_Y=
MOUSE_Z=
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Only reveal works with this memory.ini. Offsets are copied from version 176.38a. --[[User:DFD|DFD]] 11:53, 29 February 2008 (EST)

No guarantee's (I used an automated program to find these), don't expect any of the creature tools to work.
<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4
MENU_STATE=0x01288D14
FOCUSED_CREATURE=0x00C7CC04
STARTING_DWARF_COUNT=0x007AEC87
STARTING_POINT_COUNT=0x007BAF5A
MOUSE_X=0x0094228C
MOUSE_Y=0x00942290
MOUSE_Z=0x00942294
CREATURE_VECTOR=0x01464574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 02:28, 4 March 2008 (EST)

User talk:Rick

2008-03-04T07:26:29Z

Jifodus: /* 0.27.176.38b */ config fix

== Requests ==
Hey there. Thanks for writing reveal.exe. It's made my dwarves' lives so much easier!

Do you take requests?

And is this the right place to ask? [[User:Runspotrun|Runspotrun]] 20:32, 10 November 2007 (EST)

: Yes, and yes. --[[User:Rick|Rick]] 20:49, 10 November 2007 (EST)

::Excellent! Now, I don't know how many people would use it, but I'd love to see a utility that would allow me to choose the temperature/forest/shrub/surroundings/neighbours when starting out. I like to stick to the same sort of areas, but it can be a pain finding them on the map - if they exist at all. Problem is, I think most people take what they're given, region-wise... so I don't think it'd have much of an audience. What do you think? [[User:Runspotrun|Runspotrun]] 20:55, 10 November 2007 (EST)

:: Er, I haven't just described startpoints.exe, have I? [[User:Runspotrun|Runspotrun]] 21:01, 10 November 2007 (EST)

::Well, if you're not averse to requests... A utility to activate the subterranean flag on indoor areas would be awesome for those of us who'd like to build surface castles in cold/freezing terrain without our dwarves dying of frostbite. -[[User:EarthquakeDamage|EarthquakeDamage]] 22:45, 10 November 2007 (EST)

::I'd like a rock/gem/ore tool. Would be really neat. Especially the ore/gem one. Also, maybe water/magma creation tools if possible?--[[User:Spelguru|Spelguru]] 01:29, 11 November 2007 (EST)

::Something similar to the old skills.exe would be great! --[[User:Vanan|Vanan]] 11:44, 19 November 2007 (EST)

::What I'd like is some way to search for a particular tile on the map. Probably the easiest thing for you to code is to have reveal.exe have an option where it prints the map data to a file in some simple text format (Just a simple list of 'Z,X,Y "tile code"' would be sufficient. mapping what tiles have what value would be nice, but not necessary.) I want to answer the question "Is the raw material for the item the possessed dwarf is asking for somewhere on my map, and if so, where?" --[[User:Warnold|Warnold]] 23:08, 9 December 2007 (EST)

::I would like to request something that teleports items. --[[User:Demosthenes|Demosthenes]] 02:05, 16 December 2007 (EST)

::Is it possible for a utility to remove excess stone? (name and amount in command line) --[[User:Jackard|Jackard]] 07:35, 16 December 2007 (EST)

== Wild Praise ==
Thank you so much for your incredible work! Your applications add so much fun to the game! --[[User:Vanan|Vanan]] 13:56, 17 November 2007 (EST)

Astonishing response time for 33e! --[[User:Geofferic|Geofferic]] 01:04, 9 December 2007 (EST)

== In reply to ==
Your statement to me on my page, "Don't subject your opinion unto others. (Though I think you were just trying to be funny...) --Rick 03:54, 31 October 2007 (EDT)"

Of course I was. But some people have no real sense of humor.

Also, some people believe they can do things they tell others NOT to do. Your statement is a perfect example of this. You tell me not to subject others to MY opinion, but in doing so you are subjecting me to YOUR opinion. Oh yes, you are one of the VIPs in the DF community, because you wrote a couple utilities. So I suppose I should be humble in your presence, and bow to someone so great. I would do that, but when I bow, I do it facing AWAY from that person, and I drop my trousers at the same time. Still want me to bow to your greatness?

I read other contributions here that voice their opinions the same as I did. I wonder if you said the same thing to all of them as well? Tho since I was able to read the pages they wrote, you clearly did not delete their words as you did mine. And while other entries I made were either deleted or edited, as I expected them to be, since I am not a great wiki writer, you were the only one to send me a somewhat nasty note.

Think whatever you like of me, but at least I was contributing, and trying to give a few smiles along the way. Seems to me tho, that DF is fun, and it's wiki should be too. And, from other pages I read, others feel the same way I do. Maybe you should take a look around at some of their pages, and lighten up yourself a bit? Maybe trade with the elves for a tame blue jay, and drop it down your shorts. If that doesnt get a giggle out of you, maybe you should go join the undead at one of their ruins?

: Wow, way to blow up that up, I was just jesting. I think I'll leave your words here, [[User:Darknight|Darknight]]. --[[User:Rick|Rick]] 19:25, 17 November 2007 (EST)

: Oh, and for the record, I did not remove your message, someone else did that. Check the page history. --[[User:Rick|Rick]] 19:29, 17 November 2007 (EST)

== heal.exe bug? ==

Hmm... I've found that heal -hurt doesn't work on fire men, at least in 33b. It sets all their body parts to red, but the fire man just keeps wandering around and scaring my poor witless dwarves. I haven't found a living fire man yet in 33c so I can't check. [[User:Runspotrun|Runspotrun]] 06:59, 28 November 2007 (EST)

: Are firemen immune to pain? Hurt just nukes bodyparts, not kills creatures, most creatures who feel pain will die from that, but I guess ones who don't won't. --[[User:Rick|Rick]] 12:08, 28 November 2007 (EST)

:: Just checked - yes they are. That'd explain it then, ta. [[User:Runspotrun|Runspotrun]] 14:38, 28 November 2007 (EST)

== INI? ==

Does anyone see anything obviously wrong about this? I used various comparisons to come to these values (as well as what the hex fellow posted in the memory hacking section), and editing them as such into the reveal.exe allowed me to get that program to function, but the ini isn't reenabling the executables on its own:

<pre>
[address]
DWARF_FORTRESS=0x0089C414 ; correct
MENU_STATE=0x0124565C ; maybe
FOCUSED_CREATURE=0x00C39548 ; correct
CREATURE_VECTOR=0x01420A48 ; correct
MOUSE_X=0x008FF290 ; pretty sure should be 008FF288
MOUSE_Y=0x008FF294 ; pretty sure should be 008FF28C
MOUSE_Z=0x008FF298 ; pretty sure should be 008FF290
MAP_DATA=0x01462568 ; correct
MAP_X_COUNT=0x01462580 ; correct
MAP_Y_COUNT=0x01462584 ; correct
MAP_Z_COUNT=0x01462588 ; correct
STARTING_DWARF_COUNT=0x0078A54E ; wrong. 0078A554 (value actually is dword at 0078A555)
STARTING_POINT_COUNT=0x00789703 ; correct (value actually is word at 0078970A)

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260 ; dunno
MAP_DATA_OCCUPANCY_OFFSET=0x660 ; dunno
CREATURE_NAME_OFFSET=0x000 ; yes
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308 ; probably
CREATURE_X_OFFSET=0x0094 ; probably
CREATURE_Y_OFFSET=0x0096 ; probably
CREATURE_Z_OFFSET=0x0098 ; probably
</pre>

[[User:Qalnor|Qalnor]] 14:05, 16 December 2007 (EST)

I commented the above. none of the corrections should affect reveal. I don't know what's going wrong. —[[User:0x517A5D|0x517A5D]] 19:53, 16 December 2007 (EST)

:: I made a few mistakes when documenting the existing data, which probably threw you guys off. My user page has been updated for 33f. --[[User:Rick|Rick]] 20:41, 16 December 2007 (EST)

:: Thanks, to both of you. I'll have to go over what I was doing when I get home to try and see where I was going wrong. [[User:Qalnor|Qalnor]] 15:11, 17 December 2007 (EST)

== Possible adjuststart enhancement ==
Hi! Merry culturally-appropriate politically-correct generic holiday!

I have found some interesting addresses that work well with adjuststart.

In .33f, the byte at 0078654B holds a constant that is the upper limit that starting skills can be advanced to. It is normally 5 (proficient). If you change it to 15, skills can be advanced to legendary. If you change it to 20, skills can be advanced to legendary+5.

Also in .33f, there's a pair of bytes at 00786466 and 00786608. If you set both to 0, then the 10 skills per dwarf limit is removed.

I've found equivalant addresses for all the .33 releases. They're in the memory hacking subpages.

—Preceding unsigned comment added by [[User:0x517A5D|0x517A5D]] ([[User talk:0x517A5D|talk]]{{!}}[[Special:Contributions/0x517A5D|contribs]]) {{{2|}}}

:Did I not sign that? Oops. Well, I was tired. Thank you, VengefulDonut. —[[User:0x517A5D|0x517A5D]] 22:02, 19 December 2007 (EST)

::Very cool, I'll probably add these for the next release then. --[[User:Rick|Rick]] 04:18, 20 December 2007 (EST)

== Update of utilities ==

So how much longer do you suppose it might take to transition the utilities to 33f?--[[User:Heliopios|Heliopios]] 13:04, 19 December 2007 (EST)
:With the .ini method there isnt really a need to rebuild the utilities for 32f. [[User:VengefulDonut|VengefulDonut]] 15:25, 19 December 2007 (EST)

:And how exactly do you use memory.ini? I've created a new ini file (yes, it's a .ini, not a .ini.txt) and pasted everything under [code] tags for .33f, and lugged it into the dir. with the required executable (heal.exe in this case) but when I run it it still says it was built for .33e. Should I put it somewhere else? In any case, instructions for use are either inexistent or pretty well hidden here in the wiki.
:Cheers. [[User:N35t0r|N35t0r]] 21:45, 19 December 2007 (EST)
::Did you name it "memory.ini"? This worked for me with reveal.exe [[User:VengefulDonut|VengefulDonut]] 01:52, 20 December 2007 (EST)

== Possible INI file syntax change ==

I would like to suggest a change to the format of MEMORY.INI. Instead of the [generic], [address], and [offset] sections (which in my opinion buy you nothing), I would suggest using sections keyed off the PE header timestamp. (You have previously indicated that you plan to convert to that method anyway.) So a sample .INI file might look like this:

<pre>; .33e
[475B7526]
MENU_STATE=0x01244654
FOCUSED_CREATURE=0x00C38540
CREATURE_VECTOR=0x0141FA40
MOUSE_X=0x008FE288
MOUSE_Y=0x008FE28C
MOUSE_Z=0x008FE290
MAP_DATA=0x01461560
MAP_X_COUNT=0x01461578
MAP_Y_COUNT=0x0146157C
MAP_Z_COUNT=0x01461580
STARTING_DWARF_COUNT=0x007893C5
STARTING_POINT_COUNT=0x0078857A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098

; .33f
[4763710C]
MENU_STATE=0x0124565C
FOCUSED_CREATURE=0x00C39548
CREATURE_VECTOR=0x01420A48
MOUSE_X=0x008FF288
MOUSE_Y=0x008FF28C
MOUSE_Z=0x008FF290
MAP_DATA=0x01462568
MAP_X_COUNT=0x01462580
MAP_Y_COUNT=0x01462584
MAP_Z_COUNT=0x01462588
STARTING_DWARF_COUNT=0x0078A555
STARTING_POINT_COUNT=0x0078970A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098</pre>

The main reason to do this is to allow data for multiple versions to be in the .INI file. —[[User:0x517A5D|0x517A5D]] 18:22, 21 December 2007 (EST)

: Agreed, will do this. --[[User:Rick|Rick]] 15:28, 22 December 2007 (EST)

== 33g memory.ini ==

0x517A5D looked these up and put them on the 33g memory hacking page, but did not actually put them in here. He copied/pasted from 33f. Mistake? I looked up the dwarf fortress tag and used his values for the ones I could see on the other page he posted (33g memory hacking page) and updated them. It works for reveal, but it's missing FOCUSED_CREATURE and CREATURE_VECTOR because I can't find them.
--[[User:Paul|Paul]] 15:05, 22 December 2007 (CST)
:I just cross-referenced those 2 values with the 33f memory location page and updated them. Should work now, though I haven't tested. --[[User:Janus|Janus]] 16:27, 22 December 2007 (EST)
::The currently listed FOCUSED_CREATURE and CREATURE_VECTOR values don't appear to work. --[[User:Zurai|Zurai]] 22:20, 22 December 2007 (EST)
:::Hi Zurai. Do to my blunder, there was a short period where those two values were incorrect. You probably hit that window. Check the values in your copy against the ones shown now. —[[User:0x517A5D|0x517A5D]] 22:59, 22 December 2007 (EST)
::::Heal.exe and warp.exe (only when trying to warp a creature - warp to find the coords of a tile works fine) both give me "An error has occured: please select a unit in 'view units' mode" using FOCUSED_CREATURE=0x00C40540 and CREATURE_VECTOR=0x01427B60, which are the values listed at the time of this writing. I've redownloaded both executables and re-made the ini from scratch, copy-pasting the values from the 33g listing, and it still occurs. Is anyone else having the same issue? Maybe my computer doesn't like heal or warp any more. Reveal works fine, though. --[[User:Zurai|Zurai]] 18:45, 23 December 2007 (EST)
:::::I found the problem. It was MENU_STATE. Yes, anyone else who tried to use these utils would experience the same problem. I have now edited the .33g memory.ini section again, and verified that warp.exe, heal.exe -hurt, and heal.exe all work. I'm really, really sorry for the mess up. —[[User:0x517A5D|0x517A5D]] 22:39, 23 December 2007 (EST)
::::::I'm having this pop up with the new memory.ini info for warp.exe: "An error has occured:failed to read block pointer for to block". --[[User:Corbine|Corbine]] 03:19, 24 December 2007 (EST)
:::::::Well, let's go down the checklist. Due to a blunder on my part, the .33g memory.ini file was wrong for several hours. One of the mistakes causes that error message. Try deleting memory.ini and making a new one with the [[User:Rick#v0.27.169.33g|current data]]. —[[User:0x517A5D|0x517A5D]] 14:29, 24 December 2007 (EST)
::::::::Deleted the memory.ini, made a new one and threw the new info into it, still same error. --[[User:Corbine|Corbine]] 01:28, 25 December 2007 (EST)
:::::::::Corbine, are you still experiencing this? I just realized I've left this hanging for a week. Sorry. Okay, next. Previous versions of warp have worked for you with previous versions of DF? Do other of Rick's utilities work for you? My tentative diagnosis is that part of your INI file is wrong. If the whole thing was wrong, it would merely complain that it was built for version .33e. I don't know which particular key being wrong gives that error, and I don't have a .33g test fort at the moment, so I can't easily check right now. But I could when I have time. Really, I'm puzzled. —[[User:0x517A5D|0x517A5D]] 03:47, 31 December 2007 (EST)
:Yes, mistake. Arrgh. I must have copied from the wrong editor window. Thank you both. —[[User:0x517A5D|0x517A5D]] 17:08, 22 December 2007 (EST)
::No worries, and thanks for posting the new memory locations in the first place. I personally was looking forward to that info so I could use reveal.exe to examine potential fortress locations in newly created 33g worlds, so it is much appreciated. --[[User:Janus|Janus]] 18:07, 22 December 2007 (EST)
::I was all excited when I saw the 33g info up, then went to paste it into my ini and realised the data was the same... I figured you just accidentally pasted the wrong thing in. The only thing I could figure out how to look up was the Dwarf Fortress tag location, so it is appreciated that you looked all the rest up. With the world generation changing, it's nice to have reveal available to search for new sites. [[User:Paul|Paul]] 21:20, 22 December 2007 (EST)

==38a==

How would we update this? --[[User:Squeegy|Squeegy]] 20:22, 5 February 2008 (EST)

we can start by finding the relevant mem locations for 88a 

<blockquote>
[generic] 
DWARF_FORTRESS=0x00C11218 
 
[address] 
 
MENU_STATE= 
FOCUSED_CREATURE= .
CREATURE_VECTOR= 
MOUSE_X=0x0092f288 
MOUSE_Y=0x0092f28c 
MOUSE_Z=0x0092f290 
MAP_DATA= 
MAP_X_COUNT=0x014929F0 
MAP_Y_COUNT=0x014929F4 
MAP_Z_COUNT=0x014929F8 
STARTING_DWARF_COUNT= 
STARTING_POINT_COUNT= 
</blockquote>

those are the easy ones.
if we had map data and confirmed that the offset was correct at least Reveal.exe would work but I'm out of time today. --[[User:Shadetree|Shadetree]] 22:23, 6 February 2008 (EST)

I've found the other addresses. I won't guarantee that the offsets other than MAP_DATA_DESIGNATION_OFFSET, MAP_DATA_OCCUPANCY_OFFSET, and CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET are correct.
[generic]
DWARF_FORTRESS=0x00C11218

[address]
STARTING_POINT_COUNT=0x007AF4FA
STARTING_DWARF_COUNT=0x007B0345
MENU_STATE=0x0127599C
FOCUSED_CREATURE=0x00C69888
CREATURE_VECTOR=0x01450E98
MOUSE_X=0x0092F288
MOUSE_Y=0x0092F28C
MOUSE_Z=0x0092F290
MAP_DATA=0x014929CC
MAP_X_COUNT=0x014929E4
MAP_Y_COUNT=0x014929E8
MAP_Z_COUNT=0x014929EC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
If I understand how Rick's tools work, the offsets I've verified are the only offsets necessary.
-- [[User:Jifodus|Jifodus]] 20:05, 7 February 2008 (EST)

confirmed that this works with Reveal.exe --[[User:Shadetree|Shadetree]] 18:41, 8 February 2008 (EST)

warp.exe and heal.exe do not work with this configuration. --[[User:Markham|Markham]] 11:28, 9 February 2008 (EST)

The reason the creature tools will work is due to some issue with how FOCUSED_CREATURE now behaves. Assuming the address is correct, and I'm 99.9% positive it's the correct address, a new method will have to be determined which unit is focused. Also, did your map have existing creatures? -- [[User:Jifodus|Jifodus]] 17:39, 9 February 2008 (EST)

Confirmed that adjuststart.exe works with this. --[[User:Squeegy|Squeegy]] 23:44, 10 February 2008 (EST)

==176-38a==

Any love on new offsets with version df_27_176_38a? What do you all use to dig up the offsets? A debugger running trace on particular strings?

I use IDA Pro Free, and do a binary match.
<pre>
[generic]
DWARF_FORTRESS=0x008D8B08

[address]
STARTING_POINT_COUNT=0x007B995A
STARTING_DWARF_COUNT=0x007BA7B3
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC00
CREATURE_VECTOR=0x01450E9C
MOUSE_X=0x00941288
MOUSE_Y=0x0094128C
MOUSE_Z=0x00941290
MAP_DATA=0x014A4EAC
MAP_X_COUNT=0x014A4EC4
MAP_Y_COUNT=0x014A4EC8
MAP_Z_COUNT=0x014A4ECC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Heal & Warp won't work due to FOCUSED_CREATURE not working properly. -- [[User:Jifodus|Jifodus]] 04:00, 17 February 2008 (EST)

== 0.27.176.38b ==

<pre>
[generic]
DWARF_FORTRESS=0x008D8A58

[address]
MAP_DATA=0x014A50A4
MAP_X_COUNT=0x014A50BC
MAP_Y_COUNT=0x014A50C0
MAP_Z_COUNT=0x014A50C4
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC04
STARTING_DWARF_COUNT=0x007AEB77
STARTING_POINT_COUNT=0x007BAE4A
MOUSE_X=0x0094128C
MOUSE_Y=0x00941290
MOUSE_Z=0x00941294
CREATURE_VECTOR=0x01463574

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 23:08, 24 February 2008 (EST)

Are you sure that's right? Reveal.exe isn't working for me with this.--[[User:Eiba|Eiba]] 00:19, 25 February 2008 (EST)

Seems you got the starting points right for AdjustStart, but not the dwarf count. [[User:MikeWulf|MikeWulf]]

A little late, but my finder program didn't spit out the correct address for vectors. -- [[User:Jifodus|Jifodus]] 02:26, 4 March 2008 (EST)

== 0.27.176.38c ==

<pre>
[generic]
DWARF_FORTRESS=0x008D9A58

[address]
STARTING_POINT_COUNT=
STARTING_DWARF_COUNT=
MENU_STATE=
FOCUSED_CREATURE=
CREATURE_VECTOR=
MOUSE_X=
MOUSE_Y=
MOUSE_Z=
MAP_DATA=0x014A60A4
MAP_X_COUNT=0x014A60BC
MAP_Y_COUNT=0x014A60C0
MAP_Z_COUNT=0x014A60C4

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Only reveal works with this memory.ini. Offsets are copied from version 176.38a. --[[User:DFD|DFD]] 11:53, 29 February 2008 (EST)

User talk:Rick

2008-02-25T04:08:12Z

Jifodus: 0.27.176.38b

== Requests ==
Hey there. Thanks for writing reveal.exe. It's made my dwarves' lives so much easier!

Do you take requests?

And is this the right place to ask? [[User:Runspotrun|Runspotrun]] 20:32, 10 November 2007 (EST)

: Yes, and yes. --[[User:Rick|Rick]] 20:49, 10 November 2007 (EST)

::Excellent! Now, I don't know how many people would use it, but I'd love to see a utility that would allow me to choose the temperature/forest/shrub/surroundings/neighbours when starting out. I like to stick to the same sort of areas, but it can be a pain finding them on the map - if they exist at all. Problem is, I think most people take what they're given, region-wise... so I don't think it'd have much of an audience. What do you think? [[User:Runspotrun|Runspotrun]] 20:55, 10 November 2007 (EST)

:: Er, I haven't just described startpoints.exe, have I? [[User:Runspotrun|Runspotrun]] 21:01, 10 November 2007 (EST)

::Well, if you're not averse to requests... A utility to activate the subterranean flag on indoor areas would be awesome for those of us who'd like to build surface castles in cold/freezing terrain without our dwarves dying of frostbite. -[[User:EarthquakeDamage|EarthquakeDamage]] 22:45, 10 November 2007 (EST)

::I'd like a rock/gem/ore tool. Would be really neat. Especially the ore/gem one. Also, maybe water/magma creation tools if possible?--[[User:Spelguru|Spelguru]] 01:29, 11 November 2007 (EST)

::Something similar to the old skills.exe would be great! --[[User:Vanan|Vanan]] 11:44, 19 November 2007 (EST)

::What I'd like is some way to search for a particular tile on the map. Probably the easiest thing for you to code is to have reveal.exe have an option where it prints the map data to a file in some simple text format (Just a simple list of 'Z,X,Y "tile code"' would be sufficient. mapping what tiles have what value would be nice, but not necessary.) I want to answer the question "Is the raw material for the item the possessed dwarf is asking for somewhere on my map, and if so, where?" --[[User:Warnold|Warnold]] 23:08, 9 December 2007 (EST)

::I would like to request something that teleports items. --[[User:Demosthenes|Demosthenes]] 02:05, 16 December 2007 (EST)

::Is it possible for a utility to remove excess stone? (name and amount in command line) --[[User:Jackard|Jackard]] 07:35, 16 December 2007 (EST)

== Wild Praise ==
Thank you so much for your incredible work! Your applications add so much fun to the game! --[[User:Vanan|Vanan]] 13:56, 17 November 2007 (EST)

Astonishing response time for 33e! --[[User:Geofferic|Geofferic]] 01:04, 9 December 2007 (EST)

== In reply to ==
Your statement to me on my page, "Don't subject your opinion unto others. (Though I think you were just trying to be funny...) --Rick 03:54, 31 October 2007 (EDT)"

Of course I was. But some people have no real sense of humor.

Also, some people believe they can do things they tell others NOT to do. Your statement is a perfect example of this. You tell me not to subject others to MY opinion, but in doing so you are subjecting me to YOUR opinion. Oh yes, you are one of the VIPs in the DF community, because you wrote a couple utilities. So I suppose I should be humble in your presence, and bow to someone so great. I would do that, but when I bow, I do it facing AWAY from that person, and I drop my trousers at the same time. Still want me to bow to your greatness?

I read other contributions here that voice their opinions the same as I did. I wonder if you said the same thing to all of them as well? Tho since I was able to read the pages they wrote, you clearly did not delete their words as you did mine. And while other entries I made were either deleted or edited, as I expected them to be, since I am not a great wiki writer, you were the only one to send me a somewhat nasty note.

Think whatever you like of me, but at least I was contributing, and trying to give a few smiles along the way. Seems to me tho, that DF is fun, and it's wiki should be too. And, from other pages I read, others feel the same way I do. Maybe you should take a look around at some of their pages, and lighten up yourself a bit? Maybe trade with the elves for a tame blue jay, and drop it down your shorts. If that doesnt get a giggle out of you, maybe you should go join the undead at one of their ruins?

: Wow, way to blow up that up, I was just jesting. I think I'll leave your words here, [[User:Darknight|Darknight]]. --[[User:Rick|Rick]] 19:25, 17 November 2007 (EST)

: Oh, and for the record, I did not remove your message, someone else did that. Check the page history. --[[User:Rick|Rick]] 19:29, 17 November 2007 (EST)

== heal.exe bug? ==

Hmm... I've found that heal -hurt doesn't work on fire men, at least in 33b. It sets all their body parts to red, but the fire man just keeps wandering around and scaring my poor witless dwarves. I haven't found a living fire man yet in 33c so I can't check. [[User:Runspotrun|Runspotrun]] 06:59, 28 November 2007 (EST)

: Are firemen immune to pain? Hurt just nukes bodyparts, not kills creatures, most creatures who feel pain will die from that, but I guess ones who don't won't. --[[User:Rick|Rick]] 12:08, 28 November 2007 (EST)

:: Just checked - yes they are. That'd explain it then, ta. [[User:Runspotrun|Runspotrun]] 14:38, 28 November 2007 (EST)

== INI? ==

Does anyone see anything obviously wrong about this? I used various comparisons to come to these values (as well as what the hex fellow posted in the memory hacking section), and editing them as such into the reveal.exe allowed me to get that program to function, but the ini isn't reenabling the executables on its own:

<pre>
[address]
DWARF_FORTRESS=0x0089C414 ; correct
MENU_STATE=0x0124565C ; maybe
FOCUSED_CREATURE=0x00C39548 ; correct
CREATURE_VECTOR=0x01420A48 ; correct
MOUSE_X=0x008FF290 ; pretty sure should be 008FF288
MOUSE_Y=0x008FF294 ; pretty sure should be 008FF28C
MOUSE_Z=0x008FF298 ; pretty sure should be 008FF290
MAP_DATA=0x01462568 ; correct
MAP_X_COUNT=0x01462580 ; correct
MAP_Y_COUNT=0x01462584 ; correct
MAP_Z_COUNT=0x01462588 ; correct
STARTING_DWARF_COUNT=0x0078A54E ; wrong. 0078A554 (value actually is dword at 0078A555)
STARTING_POINT_COUNT=0x00789703 ; correct (value actually is word at 0078970A)

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260 ; dunno
MAP_DATA_OCCUPANCY_OFFSET=0x660 ; dunno
CREATURE_NAME_OFFSET=0x000 ; yes
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308 ; probably
CREATURE_X_OFFSET=0x0094 ; probably
CREATURE_Y_OFFSET=0x0096 ; probably
CREATURE_Z_OFFSET=0x0098 ; probably
</pre>

[[User:Qalnor|Qalnor]] 14:05, 16 December 2007 (EST)

I commented the above. none of the corrections should affect reveal. I don't know what's going wrong. —[[User:0x517A5D|0x517A5D]] 19:53, 16 December 2007 (EST)

:: I made a few mistakes when documenting the existing data, which probably threw you guys off. My user page has been updated for 33f. --[[User:Rick|Rick]] 20:41, 16 December 2007 (EST)

:: Thanks, to both of you. I'll have to go over what I was doing when I get home to try and see where I was going wrong. [[User:Qalnor|Qalnor]] 15:11, 17 December 2007 (EST)

== Possible adjuststart enhancement ==
Hi! Merry culturally-appropriate politically-correct generic holiday!

I have found some interesting addresses that work well with adjuststart.

In .33f, the byte at 0078654B holds a constant that is the upper limit that starting skills can be advanced to. It is normally 5 (proficient). If you change it to 15, skills can be advanced to legendary. If you change it to 20, skills can be advanced to legendary+5.

Also in .33f, there's a pair of bytes at 00786466 and 00786608. If you set both to 0, then the 10 skills per dwarf limit is removed.

I've found equivalant addresses for all the .33 releases. They're in the memory hacking subpages.

—Preceding unsigned comment added by [[User:0x517A5D|0x517A5D]] ([[User talk:0x517A5D|talk]]{{!}}[[Special:Contributions/0x517A5D|contribs]]) {{{2|}}}

:Did I not sign that? Oops. Well, I was tired. Thank you, VengefulDonut. —[[User:0x517A5D|0x517A5D]] 22:02, 19 December 2007 (EST)

::Very cool, I'll probably add these for the next release then. --[[User:Rick|Rick]] 04:18, 20 December 2007 (EST)

== Update of utilities ==

So how much longer do you suppose it might take to transition the utilities to 33f?--[[User:Heliopios|Heliopios]] 13:04, 19 December 2007 (EST)
:With the .ini method there isnt really a need to rebuild the utilities for 32f. [[User:VengefulDonut|VengefulDonut]] 15:25, 19 December 2007 (EST)

:And how exactly do you use memory.ini? I've created a new ini file (yes, it's a .ini, not a .ini.txt) and pasted everything under [code] tags for .33f, and lugged it into the dir. with the required executable (heal.exe in this case) but when I run it it still says it was built for .33e. Should I put it somewhere else? In any case, instructions for use are either inexistent or pretty well hidden here in the wiki.
:Cheers. [[User:N35t0r|N35t0r]] 21:45, 19 December 2007 (EST)
::Did you name it "memory.ini"? This worked for me with reveal.exe [[User:VengefulDonut|VengefulDonut]] 01:52, 20 December 2007 (EST)

== Possible INI file syntax change ==

I would like to suggest a change to the format of MEMORY.INI. Instead of the [generic], [address], and [offset] sections (which in my opinion buy you nothing), I would suggest using sections keyed off the PE header timestamp. (You have previously indicated that you plan to convert to that method anyway.) So a sample .INI file might look like this:

<pre>; .33e
[475B7526]
MENU_STATE=0x01244654
FOCUSED_CREATURE=0x00C38540
CREATURE_VECTOR=0x0141FA40
MOUSE_X=0x008FE288
MOUSE_Y=0x008FE28C
MOUSE_Z=0x008FE290
MAP_DATA=0x01461560
MAP_X_COUNT=0x01461578
MAP_Y_COUNT=0x0146157C
MAP_Z_COUNT=0x01461580
STARTING_DWARF_COUNT=0x007893C5
STARTING_POINT_COUNT=0x0078857A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098

; .33f
[4763710C]
MENU_STATE=0x0124565C
FOCUSED_CREATURE=0x00C39548
CREATURE_VECTOR=0x01420A48
MOUSE_X=0x008FF288
MOUSE_Y=0x008FF28C
MOUSE_Z=0x008FF290
MAP_DATA=0x01462568
MAP_X_COUNT=0x01462580
MAP_Y_COUNT=0x01462584
MAP_Z_COUNT=0x01462588
STARTING_DWARF_COUNT=0x0078A555
STARTING_POINT_COUNT=0x0078970A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098</pre>

The main reason to do this is to allow data for multiple versions to be in the .INI file. —[[User:0x517A5D|0x517A5D]] 18:22, 21 December 2007 (EST)

: Agreed, will do this. --[[User:Rick|Rick]] 15:28, 22 December 2007 (EST)

== 33g memory.ini ==

0x517A5D looked these up and put them on the 33g memory hacking page, but did not actually put them in here. He copied/pasted from 33f. Mistake? I looked up the dwarf fortress tag and used his values for the ones I could see on the other page he posted (33g memory hacking page) and updated them. It works for reveal, but it's missing FOCUSED_CREATURE and CREATURE_VECTOR because I can't find them.
--[[User:Paul|Paul]] 15:05, 22 December 2007 (CST)
:I just cross-referenced those 2 values with the 33f memory location page and updated them. Should work now, though I haven't tested. --[[User:Janus|Janus]] 16:27, 22 December 2007 (EST)
::The currently listed FOCUSED_CREATURE and CREATURE_VECTOR values don't appear to work. --[[User:Zurai|Zurai]] 22:20, 22 December 2007 (EST)
:::Hi Zurai. Do to my blunder, there was a short period where those two values were incorrect. You probably hit that window. Check the values in your copy against the ones shown now. —[[User:0x517A5D|0x517A5D]] 22:59, 22 December 2007 (EST)
::::Heal.exe and warp.exe (only when trying to warp a creature - warp to find the coords of a tile works fine) both give me "An error has occured: please select a unit in 'view units' mode" using FOCUSED_CREATURE=0x00C40540 and CREATURE_VECTOR=0x01427B60, which are the values listed at the time of this writing. I've redownloaded both executables and re-made the ini from scratch, copy-pasting the values from the 33g listing, and it still occurs. Is anyone else having the same issue? Maybe my computer doesn't like heal or warp any more. Reveal works fine, though. --[[User:Zurai|Zurai]] 18:45, 23 December 2007 (EST)
:::::I found the problem. It was MENU_STATE. Yes, anyone else who tried to use these utils would experience the same problem. I have now edited the .33g memory.ini section again, and verified that warp.exe, heal.exe -hurt, and heal.exe all work. I'm really, really sorry for the mess up. —[[User:0x517A5D|0x517A5D]] 22:39, 23 December 2007 (EST)
::::::I'm having this pop up with the new memory.ini info for warp.exe: "An error has occured:failed to read block pointer for to block". --[[User:Corbine|Corbine]] 03:19, 24 December 2007 (EST)
:::::::Well, let's go down the checklist. Due to a blunder on my part, the .33g memory.ini file was wrong for several hours. One of the mistakes causes that error message. Try deleting memory.ini and making a new one with the [[User:Rick#v0.27.169.33g|current data]]. —[[User:0x517A5D|0x517A5D]] 14:29, 24 December 2007 (EST)
::::::::Deleted the memory.ini, made a new one and threw the new info into it, still same error. --[[User:Corbine|Corbine]] 01:28, 25 December 2007 (EST)
:::::::::Corbine, are you still experiencing this? I just realized I've left this hanging for a week. Sorry. Okay, next. Previous versions of warp have worked for you with previous versions of DF? Do other of Rick's utilities work for you? My tentative diagnosis is that part of your INI file is wrong. If the whole thing was wrong, it would merely complain that it was built for version .33e. I don't know which particular key being wrong gives that error, and I don't have a .33g test fort at the moment, so I can't easily check right now. But I could when I have time. Really, I'm puzzled. —[[User:0x517A5D|0x517A5D]] 03:47, 31 December 2007 (EST)
:Yes, mistake. Arrgh. I must have copied from the wrong editor window. Thank you both. —[[User:0x517A5D|0x517A5D]] 17:08, 22 December 2007 (EST)
::No worries, and thanks for posting the new memory locations in the first place. I personally was looking forward to that info so I could use reveal.exe to examine potential fortress locations in newly created 33g worlds, so it is much appreciated. --[[User:Janus|Janus]] 18:07, 22 December 2007 (EST)
::I was all excited when I saw the 33g info up, then went to paste it into my ini and realised the data was the same... I figured you just accidentally pasted the wrong thing in. The only thing I could figure out how to look up was the Dwarf Fortress tag location, so it is appreciated that you looked all the rest up. With the world generation changing, it's nice to have reveal available to search for new sites. [[User:Paul|Paul]] 21:20, 22 December 2007 (EST)

==38a==

How would we update this? --[[User:Squeegy|Squeegy]] 20:22, 5 February 2008 (EST)

we can start by finding the relevant mem locations for 88a 

<blockquote>
[generic] 
DWARF_FORTRESS=0x00C11218 
 
[address] 
 
MENU_STATE= 
FOCUSED_CREATURE= .
CREATURE_VECTOR= 
MOUSE_X=0x0092f288 
MOUSE_Y=0x0092f28c 
MOUSE_Z=0x0092f290 
MAP_DATA= 
MAP_X_COUNT=0x014929F0 
MAP_Y_COUNT=0x014929F4 
MAP_Z_COUNT=0x014929F8 
STARTING_DWARF_COUNT= 
STARTING_POINT_COUNT= 
</blockquote>

those are the easy ones.
if we had map data and confirmed that the offset was correct at least Reveal.exe would work but I'm out of time today. --[[User:Shadetree|Shadetree]] 22:23, 6 February 2008 (EST)

I've found the other addresses. I won't guarantee that the offsets other than MAP_DATA_DESIGNATION_OFFSET, MAP_DATA_OCCUPANCY_OFFSET, and CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET are correct.
[generic]
DWARF_FORTRESS=0x00C11218

[address]
STARTING_POINT_COUNT=0x007AF4FA
STARTING_DWARF_COUNT=0x007B0345
MENU_STATE=0x0127599C
FOCUSED_CREATURE=0x00C69888
CREATURE_VECTOR=0x01450E98
MOUSE_X=0x0092F288
MOUSE_Y=0x0092F28C
MOUSE_Z=0x0092F290
MAP_DATA=0x014929CC
MAP_X_COUNT=0x014929E4
MAP_Y_COUNT=0x014929E8
MAP_Z_COUNT=0x014929EC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
If I understand how Rick's tools work, the offsets I've verified are the only offsets necessary.
-- [[User:Jifodus|Jifodus]] 20:05, 7 February 2008 (EST)

confirmed that this works with Reveal.exe --[[User:Shadetree|Shadetree]] 18:41, 8 February 2008 (EST)

warp.exe and heal.exe do not work with this configuration. --[[User:Markham|Markham]] 11:28, 9 February 2008 (EST)

The reason the creature tools will work is due to some issue with how FOCUSED_CREATURE now behaves. Assuming the address is correct, and I'm 99.9% positive it's the correct address, a new method will have to be determined which unit is focused. Also, did your map have existing creatures? -- [[User:Jifodus|Jifodus]] 17:39, 9 February 2008 (EST)

Confirmed that adjuststart.exe works with this. --[[User:Squeegy|Squeegy]] 23:44, 10 February 2008 (EST)

==176-38a==

Any love on new offsets with version df_27_176_38a? What do you all use to dig up the offsets? A debugger running trace on particular strings?

I use IDA Pro Free, and do a binary match.
<pre>
[generic]
DWARF_FORTRESS=0x008D8B08

[address]
STARTING_POINT_COUNT=0x007B995A
STARTING_DWARF_COUNT=0x007BA7B3
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC00
CREATURE_VECTOR=0x01450E9C
MOUSE_X=0x00941288
MOUSE_Y=0x0094128C
MOUSE_Z=0x00941290
MAP_DATA=0x014A4EAC
MAP_X_COUNT=0x014A4EC4
MAP_Y_COUNT=0x014A4EC8
MAP_Z_COUNT=0x014A4ECC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x030C
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
</pre>
Heal & Warp won't work due to FOCUSED_CREATURE not working properly. -- [[User:Jifodus|Jifodus]] 04:00, 17 February 2008 (EST)

== 0.27.176.38b ==

<pre>
[generic]
DWARF_FORTRESS=0x008D8A58

[address]
MAP_DATA=0x014A50A0
MAP_X_COUNT=0x014A50BC
MAP_Y_COUNT=0x014A50C0
MAP_Z_COUNT=0x014A50C4
MENU_STATE=0x01287D14
FOCUSED_CREATURE=0x00C7BC04
STARTING_DWARF_COUNT=0x007AEB77
STARTING_POINT_COUNT=0x007BAE4A
MOUSE_X=0x0094128C
MOUSE_Y=0x00941290
MOUSE_Z=0x00941294
CREATURE_VECTOR=0x01463570

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x0660
CREATURE_NAME_OFFSET=0x0000
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
CREATURE_BODY_PART_HEAL_VECTOR_OFFSET=0x02FC
</pre>
-- [[User:Jifodus|Jifodus]] 23:08, 24 February 2008 (EST)

40d:Utilities

2008-02-25T03:58:10Z

Jifodus: /* Dwarf Foreman */ v0.27.176.38b

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

=== Dwarvis / MapExtract ===
*[http://code.google.com/p/dwarvis/ dwarvis on Google Code]
This project is meant as a 3rd party utility for the cult-game dwarf fortress. Its purpose is to eventually provide 3-dimensual visualization of static snapshots of the ingame world of a given fortress.

=== Dwarf Fortress File Depot ===
*[http://dffd.wimbli.com/ 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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] is a graphical helper utility for dwarf fortress that aims to fill the gaps in the user interface. It allows some for some nefarious cheating. For example, you can now mark your nobles as butcherable, and change possessed dwarves to fey moods.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

Outdated tools (v0.27.169.32a): [http://www.yourfilehost.com/media.php?cat=other&file=5465reveal.zip reveal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=tileinfo_2.zip tileinfo.exe]

Outdated tools (v0.27.169.33a): [http://kisskapsel.se/adjuststart.exe adjuststart.exe] [http://kisskapsel.se/heal.exe heal.exe] [http://kisskapsel.se/reveal.exe reveal.exe]

Outdated tools (v0.27.169.33b): [http://www.yourfilehost.com/media.php?cat=other&file=4621adjuststart.zip adjuststart.exe] [http://www.yourfilehost.com/media.php?cat=other&file=2802heal.zip heal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=1725reveal.zip reveal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=warp.zip warp.exe]

Outdated tools (v0.27.169.33c): [http://no.shizzle.se/~rgibbed/v0.27.169.33c/adjuststart.exe adjuststart.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/heal.exe heal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/reveal.exe reveal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/warp.exe warp.exe]

Outdated tools (v0.27.169.33d): [http://no.shizzle.se/~rgibbed/v0.27.169.33d/adjuststart.exe adjuststart.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/heal.exe heal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/reveal.exe reveal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/warp.exe warp.exe]

Most Current tools ('''v0.27.169.33e''', none for '''v0.27.176.38a''' yet, unless you use memory.ini for the '''v0.27.169.33e''' tools):

'''Current version out of date? Have skills to find the newer addresses? [[User:Rick#memory.ini|Check Rick's user page for details on memory.ini]].'''

=== adjuststart.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/adjuststart.exe Download adjuststart.exe]   Modifies the starting number of dwarves and/or the starting points. <tt>adjuststart.exe <dwarves> <points></tt>

Instructions: type cmd in run, put in the location for adjuststart.exe, navigate to the DF main menu, change the starting dwarf number and points in this format: C:\location\adjuststart.exe 10 9999 (gives 10 dwarves, 9999 points) then hit enter.

=== heal.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/heal.exe Download heal.exe]   Heals creature limbs (any creature you can highlight with V basically). You can optionally hurt a creature by specifying -hurt on the command-line arguments.

=== reveal.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/reveal.exe Download reveal.exe]   Makes as much of the map visible as it can (eg, it can't reveal unallocated map blocks) Run while Dwarf Fortress is running.

If you want to reveal the entire map, go to the furthest Z level down you can get to, and designate the entire bottom to be mined, then remove the designation, then run reveal.

=== warp.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/warp.exe Download warp.exe]   A creature warper, similar to teleport, but properly sets occupancy flags of the tiles with some limitations (eg: if there are multiple creatures on the source tile, the occupancy flag will still be unset).

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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 recognise 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.

This handy utility would be an ideal complent to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

To make Foreman compatible with '''v0.27.176.38b''', update config file as shown below.
<pre>
check=01e3dbcc
critter_start=01463570
dwarfidpos=01284188
profession_start=0470
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

[http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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 antivirus programs.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

==DF Merge by Ikkonoishi ==
A quick and dirty utility to merge the DF data files together. I plan on making it scriptable so that you can use it to combine mods together easily and sort out any conflicts. Right now it is only useful to merge init files together for different versions of DF. Any values that are shared across the two files are combined with the values from the source overwriting the destination. You then click on the text to select it and copy it into the init.txt file of the new version.

Get it at http://www.mediafire.com/?d3yosptjze0

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

== Winmerge ==

This utility allow you to compare even folders or just files and it highlight where lines are different so see what make files different. So that can see what you want merge into one file or not.

Which is at http://winmerge.org/ to download it. [[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)

User:Jifodus

2008-02-23T21:34:09Z

Jifodus: Another little project (not utility)

User:Jifodus

2008-02-23T21:11:56Z

Jifodus: /* tile_tool */ Forgot about the source code

User:Jifodus

2008-02-23T21:09:10Z

Jifodus: /* tile_tool */ Alternate version

User:Jifodus/Map block

2008-02-23T05:27:34Z

Jifodus:

[[Category:Hacking]]

This is a combination of all I've been able to discover. Which isn't much more than what's been already discovered. What I'm not 100% sure about I've added a question mark to it. The letters in ()'s only have significance in my analyzer and editing tool.

You can download my tile analyzer and editing tool from [[User:Jifodus#tile_tool|here]].

Designation
00 |> Liquid Level (0-7), If Magma bit is set, then
01 |> liquid is magma, otherwise water.
02 |>
03
04 |> 001 - M(I)ne Designation
05 |> See [[User:Valdemar/Designation Flags|Valdemar's Designation Flags]] for more details
06 |>
07

08
09 H - (H)idden
10 |>
11 |> Soil/Rock Layer ID?
12 |>
13 |>
14 L - (L)ight
15 S - (S)ubterranean

16 O - (O)utside
17 |>
18 |> Unknown ID?
19 |>
20 |>
21 M - (M)agma
22 D - (D)amp? [[User:Valdemar/Designation Flags|Valdemar's Designation Flags]]
lists this flag as Aquifier
and that it leaks water when set. I cannot
entirely confirm it doesn't leak water
on a map that doesn't have an aquifier, but
on my map, which doesn't have an aquifier,
it didn't leak water. It did, however,
visually indicated that the two wall tiles
next to the tile I set this flag on were
damp (in addition to tile this was set).
I won't confirm this finding just yet, but
I see a strong indication that this indicates
an aquifier.
23 R - (R)ain Drop

24 |> These two bits indicate traffic: 0 - Normal, 1 - Low Traffic, 2 - High Traffic, 3 - Restricted
25 |>
26 Q - Li(Q)id
27
28 Y - Moss(Y)
29 |> Liquid Flow Direction? (Directions may be flipped, this points to the edge that has 6/7 water)
30 |> 0 - NW 2 - NE 4 - SE 6 - SW
31 |> 1 - N 3 - E 5 - S 7 - W

Occupancy
00 U - (U)nwalkable Building Tile
01 B - (B)uilding
02
03 C - (C)reature
04
05 I - (I)tem
06 M - (M)uddy
07

08
09
10
11
12
13
14
15

16
17
18
19
20
21
22
23

24
25
26
27
28
29
30
31 S - (S)now

User:Jifodus

2008-02-23T05:26:03Z

Jifodus: Started a section for my tools. Uploaded a tile editor.

User talk:Rick

2008-02-17T09:00:52Z

Jifodus: /* 176-38a */ Config for 0.27.176.38a

40d:Utilities

2008-02-17T08:49:03Z

Jifodus: /* Dwarf Foreman */ 0.27.176.38a config

Here are third party applications developed for Dwarf 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.

=== CMVPlayer ===

[http://www.geocities.com/jifodus/CMVPlayer.zip Download CMVPlayer.zip]

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.

=== 3Dwarf Visualizer - a tool to view maps in 3D ===
*[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001450 Bay12Forums Thread]
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.

== Dwarf Companion ==
The [[User:Bartavelle/DwarfCompanion|Dwarf Companion]], created by [[User:Bartavelle|Bartavelle]] is a graphical helper utility for dwarf fortress that aims to fill the gaps in the user interface. It allows some for some nefarious cheating. For example, you can now mark your nobles as butcherable, and change possessed dwarves to fey moods.

== [[User:Rick|Rick]]'s utilities ==
Fabulous tools made by the marvelous Rick. All Hail Rick!

Outdated tools (v0.27.169.32a): [http://www.yourfilehost.com/media.php?cat=other&file=5465reveal.zip reveal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=tileinfo_2.zip tileinfo.exe]

Outdated tools (v0.27.169.33a): [http://kisskapsel.se/adjuststart.exe adjuststart.exe] [http://kisskapsel.se/heal.exe heal.exe] [http://kisskapsel.se/reveal.exe reveal.exe]

Outdated tools (v0.27.169.33b): [http://www.yourfilehost.com/media.php?cat=other&file=4621adjuststart.zip adjuststart.exe] [http://www.yourfilehost.com/media.php?cat=other&file=2802heal.zip heal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=1725reveal.zip reveal.exe] [http://www.yourfilehost.com/media.php?cat=other&file=warp.zip warp.exe]

Outdated tools (v0.27.169.33c): [http://no.shizzle.se/~rgibbed/v0.27.169.33c/adjuststart.exe adjuststart.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/heal.exe heal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/reveal.exe reveal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33c/warp.exe warp.exe]

Outdated tools (v0.27.169.33d): [http://no.shizzle.se/~rgibbed/v0.27.169.33d/adjuststart.exe adjuststart.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/heal.exe heal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/reveal.exe reveal.exe] [http://no.shizzle.se/~rgibbed/v0.27.169.33d/warp.exe warp.exe]

Most Current tools ('''v0.27.169.33e''', none for '''v0.27.169.33g''' yet, unless you use memory.ini for the '''v0.27.169.33e''' tools):

'''Current version out of date? Have skills to find the newer addresses? [[User:Rick#memory.ini|Check Rick's user page for details on memory.ini]].'''

=== adjuststart.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/adjuststart.exe Download adjuststart.exe]   Modifies the starting number of dwarves and/or the starting points. <tt>adjuststart.exe <dwarves> <points></tt>

Instructions: type cmd in run, put in the location for adjuststart.exe, navigate to the DF main menu, change the starting dwarf number and points in this format: C:\location\adjuststart.exe 10 9999 (gives 10 dwarves, 9999 points) then hit enter.

=== heal.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/heal.exe Download heal.exe]   Heals creature limbs (any creature you can highlight with V basically). You can optionally hurt a creature by specifying -hurt on the command-line arguments.

=== reveal.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/reveal.exe Download reveal.exe]   Makes as much of the map visible as it can (eg, it can't reveal unallocated map blocks) Run while Dwarf Fortress is running.

If you want to reveal the entire map, go to the furthest Z level down you can get to, and designate the entire bottom to be mined, then remove the designation, then run reveal.

=== warp.exe ===
[http://no.shizzle.se/~rgibbed/v0.27.169.33e/warp.exe Download warp.exe]   A creature warper, similar to teleport, but properly sets occupancy flags of the tiles with some limitations (eg: if there are multiple creatures on the source tile, the occupancy flag will still be unset).

== Dwarf Foreman ==
[http://www.pavlovian.net/foreman/ Home page]. 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 recognise 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.

This handy utility would be an ideal complent to an updated LabourDF.

Source code is available.
----
To make Foreman compatible with '''v0.27.168.33g''', download the new version and update the config file as shown below. - [http://forums.somethingawful.com/showthread.php?threadid=2677834&userid=0&perpage=40&pagenumber=74#post337422833 Originally posted by Mu.]
<pre>check=008c407c
critter_start=01427B50
dwarfidpos=01248AC8
profession_start=45c</pre>

To make Foreman compatible with '''v0.27.173.38a''', update config file as shown below.
<pre>
check=01E30A43
critter_start=01450E98
dwarfidpos=01271E10
profession_start=45c
</pre>

To make Foreman compatible with '''v0.27.176.38a''', update config file as shown below.
<pre>
check=023401d3
critter_start=01463378
dwarfidpos=01284188
profession_start=480
</pre>

== StartProfile ==
Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.
Works for versions 0.27.169.33b, 0.27.169.33c, 0.27.169.33d, and 0.27.169.33e. Check the readme to find out how to switch between the different versions. If you wish to patch the executable yourself, please check [[Talk:Utilities#StartProfile|the utilities talk page]].

[http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001367 Discussion thread]

Obsolete: [http://www.geocities.com/jifodus/StartProfile.zip StartProfile utility]

[http://www.geocities.com/jifodus/dfufend.zip StartProfile utility]

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

----
== [[User:0x517A5D|0x517A5D]]'s utilities ==

=== Enable Magma Buildings ===
Helper utility for Rick's reveal.exe 
[http://www.yourfilehost.com/media.php?cat=other&file=3935enable_magma_buildings.zip enable_magma_buildings.zip]

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.

=== Regional Prospector ===

[http://www.yourfilehost.com/media.php?cat=other&file=regional_prospector.zip regional_prospector.zip]

A simple but very helpful utility that shows hidden map features at embark time.
If you're trying to find the perfect start location by repeatedly embarking and
revealing, give this one a shot!

Map key:
:{{Raw Tile|≈|#F00|#AAA}}   volcano; magma reaches the surface
:{{Raw Tile|~|#F00|#AAA}}   underground magma pipe or magma pool
:{{Raw Tile|≈|#00F|#AAA}}   underground river
:{{Raw Tile|~|#00F|#AAA}}   underground pool
:{{Raw Tile|#|#000|#AAA}}   chasm
:{{Raw Tile|£|#0FF|#AAA}}   adamantine and pits

This utility has been made version-independent.
It is known to work with all releases from 32a to 33g.
It is expected to work with future releases of Dwarf Fortress,
as long as the embark code doesn't change too much.

Discussion and kudos can be left [[User_talk:0x517A5D#Seekret_Projekt|here]].

=== Latitudes ===

[http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip 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 antivirus programs.




----

== Teleport ==
[http://angband.org/~erasmus/df/teleport22.zip teleport22.zip] -- Teleport dwarves and other creatures

Version 2.2 is really now 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.

== Water ==
[http://angband.org/~erasmus/df/water.exe water.exe] -- 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.

== Lava square ==
[http://angband.org/~erasmus/df/lavasquare.exe lavasquare.exe] -- 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 --[[User:Jackard|Jackard]] 09:43, 13 January 2008 (EST)
----

==DF Merge by Ikkonoishi ==
A quick and dirty utility to merge the DF data files together. I plan on making it scriptable so that you can use it to combine mods together easily and sort out any conflicts. Right now it is only useful to merge init files together for different versions of DF. Any values that are shared across the two files are combined with the values from the source overwriting the destination. You then click on the text to select it and copy it into the init.txt file of the new version.

Get it at http://www.mediafire.com/?d3yosptjze0

== [http://en.wikipedia.org/wiki/Macro_%28computer_science%29 Macro Programs] ==
A program that lets you program scripts/macros so that when you press a certain key combination, or in any other fashion activates the program, a series of keystrokes is sent to the active program instead.

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

== Winmerge ==

This utility allow you to compare even folders or just files and it highlight where lines are different so see what make files different. So that can see what you want merge into one file or not.

Which is at http://winmerge.org/ to download it. [[User:Omagaalpha|Omagaalpha]] 08:30, 13 February 2008 (EST)

User:Jifodus/Map block

2008-02-13T23:09:01Z

Jifodus: New page: This is a combination of all I've been able to discover. Which isn't much more than what's been already discovered. What I'm not 100% sure about I've added a question mark to it. The lette...

This is a combination of all I've been able to discover. Which isn't much more than what's been already discovered. What I'm not 100% sure about I've added a question mark to it. The letters in ()'s only have significance in my unreleased tile analyzer and editing tool.

Designation
00 |>
01 |> Liquid Level (0-7), If Magma bit is set, then liquid is magma, otherwise water.
02 |>
03
04 I - M(I)ne Designation
05
06
07

08
09 H - (H)idden
10 |>
11 |> Soil/Rock Layer ID?
12 |>
13 |>
14 L - (L)ight
15 S - (S)ubterranean

16 O - (O)utside
17 |>
18 |> Unknown ID?
19 |>
20 |>
21 M - (M)agma
22 D - (D)amp?
23 R - (R)ain Drop

24 |> These two bits indicate traffic: 0 - Normal, 1 - Low Traffic, 2 - High Traffic, 3 - Restricted
25 |>
26 Q - Li(Q)id
27
28 Y - Moss(Y)
29 |> Liquid Flow Direction? (Directions may be flipped, this points to the edge that has 6/7 water)
30 |> 0 - NW 2 - NE 4 - SE 6 - SW
31 |> 1 - N 3 - E 5 - S 7 - W

Occupancy
00 U - (U)nwalkable Building Tile
01 B - (B)uilding
02
03 C - (C)reature
04
05 I - (I)tem
06 M - (M)uddy
07

08
09
10
11
12
13
14
15

16
17
18
19
20
21
22
23

24
25
26
27
28
29
30
31 S - (S)now

User:Jifodus

2008-02-13T22:56:58Z

Jifodus:

User talk:Rick

2008-02-09T22:39:58Z

Jifodus: /* 38a */

User:Jifodus/Dwarf Fortress Utility Framework

2008-02-09T05:52:01Z

Jifodus: If you're using or looking at DFUF, please read this.

I'm currently writing a framework for Dwarf Fortress utilities. The general idea is to use C++ interfaces in a cross-compiler fashion that is very easy to use. This is designed to assist utility writers, by making possible to compile once, and have it work on future versions of Dwarf Fortress.

'''Attention:''' This is just a quick check to see if anyone is looking at or using the DFUF in any of their projects. I'm thinking of rewriting the interfaces due to some limitations I've been encountering. I also plan on abstracating the environment away from Lua directly. If you are, please PM me on the forums, or leave a note on the talk page. I just want to avoid breaking an existing tool and/or forcing you to learn a new interface.

==License==
I'm not going to hold copyright of either the source code of the framework. It is in the Public Domain.

However, I will hold copyright of StartProfile. And it is licensed under the WTFPL: http://sam.zoy.org/wtfpl/

==Links==
===First Beta Release: January 1, 2008===
Source Code: http://www.geocities.com/jifodus/dfuf2.zip 
Binaries: http://www.geocities.com/jifodus/dfufend2.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug2.zip

'''This first beta release has additional interfaces for working with creatures, it also has more complete data files. It is now possible to cleanly create complex type overrides with ''PointerTo()'', ''VectorOf()'', and ''ArrayOf()''. There is no data for v0.27.169.33g, the data is most complete for v0.27.169.33f.'''
===Alpha Release===
Source Code: http://www.geocities.com/jifodus/dfuf.zip 
Binaries: http://www.geocities.com/jifodus/dfufend.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug.zip

==Todo==
Before the second release, which is necessary before it can be easily used, the following items need to be taken care of.
* Bugs
** There's always going to be a bug somewhere.
* Features
** Main Library
*** '''Error Handling''' - The library itself does not cleanly handle common errors. '''''10% Completed'''''
*** '''Auto-Update''' - Implement automatic update for both framework code and data. '''''0% Completed'''''
*** '''Installer''' - An installer for the library. '''''10% Completed'''''
*** '''Complete Memory Data''' - Complete transforming the memory data available on the wiki to format usable by library. '''''60% Completed'''''
*** '''More Type Objects''' - Provide interface wrappers to some of the commonly used memory types (Creature and Map). '''''60% Completed'''''
*** '''Memory Scanner''' - A simple memory searcher. Used for '''Auto-Identifier'''. '''''0% Completed'''''
*** '''Auto-Identifier''' - Automatically try to find the memory locations and offsets for new versions. '''''0% Completed'''''
*** '''Remote Memory De/Allocate''' - Needed to properly implement String & Vector set functions. '''''0% Completed'''''
*** '''Reload Data''' - The data loading portion does not yet properly reload the data. '''''0% Completed'''''
*** '''Bindings''' - C#/Perl/Java/Python/Lua/Other?

==Features Overview==
The Dwarf Fortress Utility Framework is designed with the following goals in mind:
* Utilities compiled for the very first release of the framework still work 10 years later
** With all the updates and patches applied to the library
** With the latest release of Dwarf Fortress
* The end user of a utility can simply download and run the utility and have it work
* The framework provides a flexible and easy to use way to define types and memory maps, and write utilities to use the types and memory maps

===Current Features===
* Written in C++, using interfaces
* Memory data stored in Lua format
* Sample utility for implementation reference: reimplementation of StartProfile
* API header & library
* Complete source code
* Identify Dwarf Fortress version via PE executable timestamp
* Cross-compiler/mostly C compatible using Windows COM style interfaces
** It is not C compatible due to function overloading issues.
* Auto-loading of Lua data files
* Library self-contained in DLL

===Current Limitations===
* '''Buggy!'''
** Memory leaks exist
* No real documentation whatsoever
* Sparse comments
* Memory data is all there, but the library does not yet use all of it
* The library is designed for C++, the C interface has not been tested (and probably will not work)
** Also, this was only tested using MSVC++ .net 2005, it will probably work on other version of MSVC++.
* Does not cleanly handle errors
* Some interface functions not implemented
** Map/Get through pointer functions not yet implemented
** iDFUF::installDataFile is not yet implemented
* Compiled as debug mode (bloated file sizes)
* The library is not extensively tested
* The library has a dependency on: [http://www.microsoft.com/downloads/details.aspx?FamilyId=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=en Visual Studio 8 Debug CRT]

===Second Release===
The next release planned features will include:
* Auto-retrieve memory data off the internet
* Auto-update framework code itself
* Have an installer that will install the DLL and data file to a shared location, so multiple utilities can use the same library

===Future===
And further down the road (through auto-update):
* Implement specific subsets of the std library; reduce utility size more, no large dependencies for the utilities
** std::string
** std::vector
** std::map
** Console IO
** File IO
* Easy to use GUI framework; for making tools with a nice GUI
* Cross-process memory allocation

==Data Format==

===Requirements===
The framework requires definitions of the following types:
* raw: a raw array of bytes; internally it allows access to an array of type.size * type.fixed_array bytes.
* pointer: a pointer to a location in Dwarf Fortress's memory; can represent a 32-bit pointer
* dword: an integer type that is 4 bytes
* word: an integer type that is 2 bytes
* byte: an integer type that is 1 byte
* float: a 32-bit floating point type
* double: a 64-bit floating point type
* string: a type that represents a std::string
** required members:
*** '''dword''' length: defines how many characters string contains
*** '''dword''' capacity: defines the maximum number of characters the string buffer can contain
*** '''pointer''' buffer_ptr: a pointer to a memory location containing the string data
** optional members:
*** '''raw''' buffer: a fixed-size array of characters containing the string when length < the fixed size of the buffer
* vector: a type representing a std::vector
** required members:
*** '''pointer''' begin: a pointer to the begining of the memory block
*** '''pointer''' end: a pointer to just beyond of the last valid element in the vector
*** '''pointer''' last: a pointer to just beyond the end of the memory block

===Data Files===
The data files must supply the following information:
* Types: each element of the type list represents one type; there is a special type called '''Main''', '''Main''' represents the global memory map
* Signatures: each signature is designed to uniquely identify each version of Dwarf Fortress

====Lua Data Files====
Classes:
* '''Type''': 'type =' The value can either be a set containing a type override or the string of a type name.
** Type: 'type =' A string representing the Type Name of the type to override.
** Subtypes: An array of type overrides and/or Type Names, that are subtypes of this type.
** Size: 'size =' An integer overriding the size of the type.
** Fixed Array Size: 'fixed_size =' An integer overriding the fixed array size of the type.
* Types: 'Types'
** Version: String representing version
*** TypeName: String representing name of the type, special type is '''Main'''.
**** Size: 'size =' an integer representing
**** Members: 'members' a table of of name value pairs; The name being the Member Name; The value is a set containing the Type and Offset.
***** Member Name: String representing the name
****** Type: 'type =' The value can either be a set containing a '''Type''' override or the name of the of a type.
****** Offset: 'offset =' The member offset (from the base address).
****** Pointer: 'pointer =' The pointer in memory for which the member can be found. Used for the '''Main''' type.
* Signatures 'Signatures'
** Version: String representing the version (same string as types).
*** PE Timestamp: 'pe_timestamp' The PE header timestamp value.
*** .text Adler32: 'adler32' The Adler32 CRC of the ".text" section of the executable.
*** Text Segments: 'text_segments' An array of segments of the ".text" section of the executable.
**** Address: [1] = The offset into the ".text" section that the following raw data can be found.
**** Raw Data: [2] = The data the ".text" segment is supposed to contain.

==Library Usage==
(This part is only useful for utility writers.)

===Basic Programming===
The basic program needed to use the library is simply:
#include <dfuf.h>
void main() {
dfuf::iDFUF *uf = dfuf::newDFUF();
// Do something with the framework
uf->destroy(); // in theory cleans up all memory used
}
To connect to an instance of Dwarf Fortress the program must first scan for instances,
then get one of the instances of dwarf fortress like this:
if (uf->scanForInstances() == 0)
// none found
return;
dfuf::iDFInstance *instance = uf->getInstance(0);
After getting a Dwarf Fortress instance, it then becomes possible to access global
pointers and memory locations (i.e. creature vector location) with
iDFInstance::getMemoryObject. iDFInstance::getMemoryObject takes a iType* and an
Address in Dwarf Fortress memory and returns an appropriate iMemoryType*. There are
different ways to provide the iType* and the Address, including from the data file
(via the appropriate name), a iPointerType*, and an iPointer* and iType* lets the
code create from the raw parts. There is a second version of
iDFInstance::getMemoryObject, which follows all the pointers to a non-pointer object
and returns the object called iDFInstance::getMemoryObjectThroughPointers. However,
it has not been implemented in the first release of the library.

From the first memory object created, the code can then either query the value (from
any of the i*Type) or map other members (from any of the i*Object) objects.

===Advanced Programming===
An advanced topic is iMemoryType* creation. It is painful to individually map the
members, therefore creating an iMemoryType* that simplifies access to the type sounds
ideal. However, the library only knows about the types it has been compiled with. Enter
iTypeFactory*, the iTypeFactory* gets registered in iDFUF with iDFUF::addTypeFactory.
Each factory provides 2 functions: construct & destruct. This allows programs to create
their own structures to wrap the creature type.

Example code:
class cCreatureType : public dfuf::iMemoryObject
{
public:
// Implement virtual methods here

public:
dfuf::u32 getHappiness() { return happiness->getValue(); }
void setHappiness(dfuf::u32 value) { happiness->setValue(value); }
// More methods here
cCreatureType(dfuf::iDFInstance *instance, dfuf::iPointer *base, dfuf::iType *type)
{
this->instance = instance;
this->base = base;
this->type = type;
this->happiness = map(L"happiness");
}
public:
dfuf::iDFInstance *instance;
dfuf::iPointer *base;
dfuf::iType *type;
dfuf::iIntegerType *happiness;
};
class cCreatureFactory : public dfuf::iTypeFactory
{
public:
// new creature
{
return new cCreatureType(instance, base, type);
}
// delete creature
{
delete object;
}
};
// Global instance, otherwise we'd have to do memory management on the pointer
cCreatureFactory global_CreatureFactory;
// Usage
void main()
{
dfuf::iDFUF *uf = newDFUF();
dfuf::iDFInstance *instance = uf->getDFInstance(0);
uf->addTypeFactory("creature", &global_CreatureFactory);
iPointer *pointer;
cCreatureType *creature = (cCreatureType *)instance->getMemoryObject
(pointer, instance->getType("creature"));
creature->setHappiness(-10000); // hahaha die dwarf!
uf->destroy();
}

User talk:Rick

2008-02-08T16:52:05Z

Jifodus: /* 38a */ Fixed creature vector address, forgot to subtract by 0x4

User talk:Rick

2008-02-08T01:05:26Z

Jifodus: /* 38a */ full memory.ini for 0.27.173.38a

== Requests ==
Hey there. Thanks for writing reveal.exe. It's made my dwarves' lives so much easier!

Do you take requests?

And is this the right place to ask? [[User:Runspotrun|Runspotrun]] 20:32, 10 November 2007 (EST)

: Yes, and yes. --[[User:Rick|Rick]] 20:49, 10 November 2007 (EST)

::Excellent! Now, I don't know how many people would use it, but I'd love to see a utility that would allow me to choose the temperature/forest/shrub/surroundings/neighbours when starting out. I like to stick to the same sort of areas, but it can be a pain finding them on the map - if they exist at all. Problem is, I think most people take what they're given, region-wise... so I don't think it'd have much of an audience. What do you think? [[User:Runspotrun|Runspotrun]] 20:55, 10 November 2007 (EST)

:: Er, I haven't just described startpoints.exe, have I? [[User:Runspotrun|Runspotrun]] 21:01, 10 November 2007 (EST)

::Well, if you're not averse to requests... A utility to activate the subterranean flag on indoor areas would be awesome for those of us who'd like to build surface castles in cold/freezing terrain without our dwarves dying of frostbite. -[[User:EarthquakeDamage|EarthquakeDamage]] 22:45, 10 November 2007 (EST)

::I'd like a rock/gem/ore tool. Would be really neat. Especially the ore/gem one. Also, maybe water/magma creation tools if possible?--[[User:Spelguru|Spelguru]] 01:29, 11 November 2007 (EST)

::Something similar to the old skills.exe would be great! --[[User:Vanan|Vanan]] 11:44, 19 November 2007 (EST)

::What I'd like is some way to search for a particular tile on the map. Probably the easiest thing for you to code is to have reveal.exe have an option where it prints the map data to a file in some simple text format (Just a simple list of 'Z,X,Y "tile code"' would be sufficient. mapping what tiles have what value would be nice, but not necessary.) I want to answer the question "Is the raw material for the item the possessed dwarf is asking for somewhere on my map, and if so, where?" --[[User:Warnold|Warnold]] 23:08, 9 December 2007 (EST)

::I would like to request something that teleports items. --[[User:Demosthenes|Demosthenes]] 02:05, 16 December 2007 (EST)

::Is it possible for a utility to remove excess stone? (name and amount in command line) --[[User:Jackard|Jackard]] 07:35, 16 December 2007 (EST)

== Wild Praise ==
Thank you so much for your incredible work! Your applications add so much fun to the game! --[[User:Vanan|Vanan]] 13:56, 17 November 2007 (EST)

Astonishing response time for 33e! --[[User:Geofferic|Geofferic]] 01:04, 9 December 2007 (EST)

== In reply to ==
Your statement to me on my page, "Don't subject your opinion unto others. (Though I think you were just trying to be funny...) --Rick 03:54, 31 October 2007 (EDT)"

Of course I was. But some people have no real sense of humor.

Also, some people believe they can do things they tell others NOT to do. Your statement is a perfect example of this. You tell me not to subject others to MY opinion, but in doing so you are subjecting me to YOUR opinion. Oh yes, you are one of the VIPs in the DF community, because you wrote a couple utilities. So I suppose I should be humble in your presence, and bow to someone so great. I would do that, but when I bow, I do it facing AWAY from that person, and I drop my trousers at the same time. Still want me to bow to your greatness?

I read other contributions here that voice their opinions the same as I did. I wonder if you said the same thing to all of them as well? Tho since I was able to read the pages they wrote, you clearly did not delete their words as you did mine. And while other entries I made were either deleted or edited, as I expected them to be, since I am not a great wiki writer, you were the only one to send me a somewhat nasty note.

Think whatever you like of me, but at least I was contributing, and trying to give a few smiles along the way. Seems to me tho, that DF is fun, and it's wiki should be too. And, from other pages I read, others feel the same way I do. Maybe you should take a look around at some of their pages, and lighten up yourself a bit? Maybe trade with the elves for a tame blue jay, and drop it down your shorts. If that doesnt get a giggle out of you, maybe you should go join the undead at one of their ruins?

: Wow, way to blow up that up, I was just jesting. I think I'll leave your words here, [[User:Darknight|Darknight]]. --[[User:Rick|Rick]] 19:25, 17 November 2007 (EST)

: Oh, and for the record, I did not remove your message, someone else did that. Check the page history. --[[User:Rick|Rick]] 19:29, 17 November 2007 (EST)

== heal.exe bug? ==

Hmm... I've found that heal -hurt doesn't work on fire men, at least in 33b. It sets all their body parts to red, but the fire man just keeps wandering around and scaring my poor witless dwarves. I haven't found a living fire man yet in 33c so I can't check. [[User:Runspotrun|Runspotrun]] 06:59, 28 November 2007 (EST)

: Are firemen immune to pain? Hurt just nukes bodyparts, not kills creatures, most creatures who feel pain will die from that, but I guess ones who don't won't. --[[User:Rick|Rick]] 12:08, 28 November 2007 (EST)

:: Just checked - yes they are. That'd explain it then, ta. [[User:Runspotrun|Runspotrun]] 14:38, 28 November 2007 (EST)

== INI? ==

Does anyone see anything obviously wrong about this? I used various comparisons to come to these values (as well as what the hex fellow posted in the memory hacking section), and editing them as such into the reveal.exe allowed me to get that program to function, but the ini isn't reenabling the executables on its own:

<pre>
[address]
DWARF_FORTRESS=0x0089C414 ; correct
MENU_STATE=0x0124565C ; maybe
FOCUSED_CREATURE=0x00C39548 ; correct
CREATURE_VECTOR=0x01420A48 ; correct
MOUSE_X=0x008FF290 ; pretty sure should be 008FF288
MOUSE_Y=0x008FF294 ; pretty sure should be 008FF28C
MOUSE_Z=0x008FF298 ; pretty sure should be 008FF290
MAP_DATA=0x01462568 ; correct
MAP_X_COUNT=0x01462580 ; correct
MAP_Y_COUNT=0x01462584 ; correct
MAP_Z_COUNT=0x01462588 ; correct
STARTING_DWARF_COUNT=0x0078A54E ; wrong. 0078A554 (value actually is dword at 0078A555)
STARTING_POINT_COUNT=0x00789703 ; correct (value actually is word at 0078970A)

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260 ; dunno
MAP_DATA_OCCUPANCY_OFFSET=0x660 ; dunno
CREATURE_NAME_OFFSET=0x000 ; yes
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308 ; probably
CREATURE_X_OFFSET=0x0094 ; probably
CREATURE_Y_OFFSET=0x0096 ; probably
CREATURE_Z_OFFSET=0x0098 ; probably
</pre>

[[User:Qalnor|Qalnor]] 14:05, 16 December 2007 (EST)

I commented the above. none of the corrections should affect reveal. I don't know what's going wrong. —[[User:0x517A5D|0x517A5D]] 19:53, 16 December 2007 (EST)

:: I made a few mistakes when documenting the existing data, which probably threw you guys off. My user page has been updated for 33f. --[[User:Rick|Rick]] 20:41, 16 December 2007 (EST)

:: Thanks, to both of you. I'll have to go over what I was doing when I get home to try and see where I was going wrong. [[User:Qalnor|Qalnor]] 15:11, 17 December 2007 (EST)

== Possible adjuststart enhancement ==
Hi! Merry culturally-appropriate politically-correct generic holiday!

I have found some interesting addresses that work well with adjuststart.

In .33f, the byte at 0078654B holds a constant that is the upper limit that starting skills can be advanced to. It is normally 5 (proficient). If you change it to 15, skills can be advanced to legendary. If you change it to 20, skills can be advanced to legendary+5.

Also in .33f, there's a pair of bytes at 00786466 and 00786608. If you set both to 0, then the 10 skills per dwarf limit is removed.

I've found equivalant addresses for all the .33 releases. They're in the memory hacking subpages.

—Preceding unsigned comment added by [[User:0x517A5D|0x517A5D]] ([[User talk:0x517A5D|talk]]{{!}}[[Special:Contributions/0x517A5D|contribs]]) {{{2|}}}

:Did I not sign that? Oops. Well, I was tired. Thank you, VengefulDonut. —[[User:0x517A5D|0x517A5D]] 22:02, 19 December 2007 (EST)

::Very cool, I'll probably add these for the next release then. --[[User:Rick|Rick]] 04:18, 20 December 2007 (EST)

== Update of utilities ==

So how much longer do you suppose it might take to transition the utilities to 33f?--[[User:Heliopios|Heliopios]] 13:04, 19 December 2007 (EST)
:With the .ini method there isnt really a need to rebuild the utilities for 32f. [[User:VengefulDonut|VengefulDonut]] 15:25, 19 December 2007 (EST)

:And how exactly do you use memory.ini? I've created a new ini file (yes, it's a .ini, not a .ini.txt) and pasted everything under [code] tags for .33f, and lugged it into the dir. with the required executable (heal.exe in this case) but when I run it it still says it was built for .33e. Should I put it somewhere else? In any case, instructions for use are either inexistent or pretty well hidden here in the wiki.
:Cheers. [[User:N35t0r|N35t0r]] 21:45, 19 December 2007 (EST)
::Did you name it "memory.ini"? This worked for me with reveal.exe [[User:VengefulDonut|VengefulDonut]] 01:52, 20 December 2007 (EST)

== Possible INI file syntax change ==

I would like to suggest a change to the format of MEMORY.INI. Instead of the [generic], [address], and [offset] sections (which in my opinion buy you nothing), I would suggest using sections keyed off the PE header timestamp. (You have previously indicated that you plan to convert to that method anyway.) So a sample .INI file might look like this:

<pre>; .33e
[475B7526]
MENU_STATE=0x01244654
FOCUSED_CREATURE=0x00C38540
CREATURE_VECTOR=0x0141FA40
MOUSE_X=0x008FE288
MOUSE_Y=0x008FE28C
MOUSE_Z=0x008FE290
MAP_DATA=0x01461560
MAP_X_COUNT=0x01461578
MAP_Y_COUNT=0x0146157C
MAP_Z_COUNT=0x01461580
STARTING_DWARF_COUNT=0x007893C5
STARTING_POINT_COUNT=0x0078857A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098

; .33f
[4763710C]
MENU_STATE=0x0124565C
FOCUSED_CREATURE=0x00C39548
CREATURE_VECTOR=0x01420A48
MOUSE_X=0x008FF288
MOUSE_Y=0x008FF28C
MOUSE_Z=0x008FF290
MAP_DATA=0x01462568
MAP_X_COUNT=0x01462580
MAP_Y_COUNT=0x01462584
MAP_Z_COUNT=0x01462588
STARTING_DWARF_COUNT=0x0078A555
STARTING_POINT_COUNT=0x0078970A
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098</pre>

The main reason to do this is to allow data for multiple versions to be in the .INI file. —[[User:0x517A5D|0x517A5D]] 18:22, 21 December 2007 (EST)

: Agreed, will do this. --[[User:Rick|Rick]] 15:28, 22 December 2007 (EST)

== 33g memory.ini ==

0x517A5D looked these up and put them on the 33g memory hacking page, but did not actually put them in here. He copied/pasted from 33f. Mistake? I looked up the dwarf fortress tag and used his values for the ones I could see on the other page he posted (33g memory hacking page) and updated them. It works for reveal, but it's missing FOCUSED_CREATURE and CREATURE_VECTOR because I can't find them.
--[[User:Paul|Paul]] 15:05, 22 December 2007 (CST)
:I just cross-referenced those 2 values with the 33f memory location page and updated them. Should work now, though I haven't tested. --[[User:Janus|Janus]] 16:27, 22 December 2007 (EST)
::The currently listed FOCUSED_CREATURE and CREATURE_VECTOR values don't appear to work. --[[User:Zurai|Zurai]] 22:20, 22 December 2007 (EST)
:::Hi Zurai. Do to my blunder, there was a short period where those two values were incorrect. You probably hit that window. Check the values in your copy against the ones shown now. —[[User:0x517A5D|0x517A5D]] 22:59, 22 December 2007 (EST)
::::Heal.exe and warp.exe (only when trying to warp a creature - warp to find the coords of a tile works fine) both give me "An error has occured: please select a unit in 'view units' mode" using FOCUSED_CREATURE=0x00C40540 and CREATURE_VECTOR=0x01427B60, which are the values listed at the time of this writing. I've redownloaded both executables and re-made the ini from scratch, copy-pasting the values from the 33g listing, and it still occurs. Is anyone else having the same issue? Maybe my computer doesn't like heal or warp any more. Reveal works fine, though. --[[User:Zurai|Zurai]] 18:45, 23 December 2007 (EST)
:::::I found the problem. It was MENU_STATE. Yes, anyone else who tried to use these utils would experience the same problem. I have now edited the .33g memory.ini section again, and verified that warp.exe, heal.exe -hurt, and heal.exe all work. I'm really, really sorry for the mess up. —[[User:0x517A5D|0x517A5D]] 22:39, 23 December 2007 (EST)
::::::I'm having this pop up with the new memory.ini info for warp.exe: "An error has occured:failed to read block pointer for to block". --[[User:Corbine|Corbine]] 03:19, 24 December 2007 (EST)
:::::::Well, let's go down the checklist. Due to a blunder on my part, the .33g memory.ini file was wrong for several hours. One of the mistakes causes that error message. Try deleting memory.ini and making a new one with the [[User:Rick#v0.27.169.33g|current data]]. —[[User:0x517A5D|0x517A5D]] 14:29, 24 December 2007 (EST)
::::::::Deleted the memory.ini, made a new one and threw the new info into it, still same error. --[[User:Corbine|Corbine]] 01:28, 25 December 2007 (EST)
:::::::::Corbine, are you still experiencing this? I just realized I've left this hanging for a week. Sorry. Okay, next. Previous versions of warp have worked for you with previous versions of DF? Do other of Rick's utilities work for you? My tentative diagnosis is that part of your INI file is wrong. If the whole thing was wrong, it would merely complain that it was built for version .33e. I don't know which particular key being wrong gives that error, and I don't have a .33g test fort at the moment, so I can't easily check right now. But I could when I have time. Really, I'm puzzled. —[[User:0x517A5D|0x517A5D]] 03:47, 31 December 2007 (EST)
:Yes, mistake. Arrgh. I must have copied from the wrong editor window. Thank you both. —[[User:0x517A5D|0x517A5D]] 17:08, 22 December 2007 (EST)
::No worries, and thanks for posting the new memory locations in the first place. I personally was looking forward to that info so I could use reveal.exe to examine potential fortress locations in newly created 33g worlds, so it is much appreciated. --[[User:Janus|Janus]] 18:07, 22 December 2007 (EST)
::I was all excited when I saw the 33g info up, then went to paste it into my ini and realised the data was the same... I figured you just accidentally pasted the wrong thing in. The only thing I could figure out how to look up was the Dwarf Fortress tag location, so it is appreciated that you looked all the rest up. With the world generation changing, it's nice to have reveal available to search for new sites. [[User:Paul|Paul]] 21:20, 22 December 2007 (EST)

==38a==

How would we update this? --[[User:Squeegy|Squeegy]] 20:22, 5 February 2008 (EST)

we can start by finding the relevant mem locations for 88a 

<blockquote>
[generic] 
DWARF_FORTRESS=0x00C11218 
 
[address] 
 
MENU_STATE= 
FOCUSED_CREATURE= .
CREATURE_VECTOR= 
MOUSE_X=0x0092f288 
MOUSE_Y=0x0092f28c 
MOUSE_Z=0x0092f290 
MAP_DATA= 
MAP_X_COUNT=0x014929F0 
MAP_Y_COUNT=0x014929F4 
MAP_Z_COUNT=0x014929F8 
STARTING_DWARF_COUNT= 
STARTING_POINT_COUNT= 
</blockquote>

those are the easy ones.
if we had map data and confirmed that the offset was correct at least Reveal.exe would work but I'm out of time today. --[[User:Shadetree|Shadetree]] 22:23, 6 February 2008 (EST)

I've found the other addresses. I won't guarantee that the offsets other than MAP_DATA_DESIGNATION_OFFSET, MAP_DATA_OCCUPANCY_OFFSET, and CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET are correct.
[generic]
DWARF_FORTRESS=0x00C11218

[address]
STARTING_POINT_COUNT=0x007AF4FA
STARTING_DWARF_COUNT=0x007B0345
MENU_STATE=0x0127599C
FOCUSED_CREATURE=0x00C69888
CREATURE_VECTOR=0x01450E9C
MOUSE_X=0x0092F288
MOUSE_Y=0x0092F28C
MOUSE_Z=0x0092F290
MAP_DATA=0x014929CC
MAP_X_COUNT=0x014929E4
MAP_Y_COUNT=0x014929E8
MAP_Z_COUNT=0x014929EC

[offset]
MAP_DATA_DESIGNATION_OFFSET=0x0260
MAP_DATA_OCCUPANCY_OFFSET=0x660
CREATURE_NAME_OFFSET=0x000
CREATURE_BODY_PART_HEALTH_VECTOR_OFFSET=0x308
CREATURE_X_OFFSET=0x0094
CREATURE_Y_OFFSET=0x0096
CREATURE_Z_OFFSET=0x0098
If I understand how Rick's tools work, the offsets I've verified are the only offsets necessary.
-- [[User:Jifodus|Jifodus]] 20:05, 7 February 2008 (EST)

40d Talk:Utilities

2008-02-08T00:14:12Z

Jifodus: /* Patching Lavasquare */

== 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 [http://www.autohotkey.com/] 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)

== Yourfilehost ==

Yourfilehost.com has kind of a lousy reputation, and I can confirm it's blocked on certain college networks. Could someone upload these utilities to a more reputable host? -- Mzbundifund 15:55, 04 November 2007 (EDT)
: Such as? --[[User:Rick|Rick]] 18:03, 4 November 2007 (EST)

==heal.exe==

heal.exe does not regrow missing limbs. However, "heal -hurt" on the command line brings missing limbs to red status, and "heal" thereafter restores the being to full health.

I propose a -regrow parameter so we don't have to do this workaround, since if it's possible to bring missing limbs from dark grey to red status it's also possible to grow them back.

Also, when using the -hurt parameter, it still says "059E7210 had 31 body parts '''healed'''", when it should probably say "wounded". --[[User:JT|JT]] 17:58, 10 November 2007 (EST)

: Hmm, if it does heal missing limbs then I just need to change my logic slightly for healing. --[[User:Rick|Rick]] 19:01, 10 November 2007 (EST)

==reveal.exe==

From what I've tested, reveal for 33a does not work for 33b. --[[User:Sparksol|Sparksol]] 13:39, 17 November 2007 (EST)

:Correct. It uses hardcoded offsets, which will change every time new code is added to DF.
:I have a version hacked for .33b, which I will not distribute out of respect for Rick.
:However, if you are skilled with a hex editor, here's what to do: change the first 5 occurances of the pattern 85 45 01 to the pattern 95 45 01. (The 6th occurance of the pattern is a coincidental match and should not be changed.) Then change the pattern 8C 33 89 00 to the pattern 8C 43 89 00. —[[User:0x517A5D|0x517A5D]] 02:31, 19 November 2007 (EST)

:Actually, as it happens, it looks like Rick has produced updated versions of his tools for .33b. They were built on the 16th. However he hasn't linked to them. I don't know why. The URL they're at requests that no links be made to them, so I'm not going to tell you. Sorry, you'll just have to do the hexedit. —[[User:0x517A5D|0x517A5D]] 02:45, 19 November 2007 (EST)

:I just havn't mirrored them yet, that's all. --[[User:Rick|Rick]] 03:10, 19 November 2007 (EST)
::Hey, I'm curious why the file sizes ballooned. Reveal went from 52k to 101k, a doubling in size. Heal grew even more. Maybe you didn't strip debugging info? —[[User:0x517A5D|0x517A5D]] 15:42, 19 November 2007 (EST)
:::Usage of std libraries mostly. I made a library for working with DF so I wouldn't have to keep duplicating code through projects, and when writing it I figured I might as well make it more friendly for me to code in, hence usage of std:: stuff. --[[User:Rick|Rick]] 19:00, 19 November 2007 (EST)

:Whenever I try to open reveal.exe, the window will open up for a millisecond and then immedietely close. Is this a problem with the program or my windows? I am assuming its windows since everyone else seems to be able to use it. Has anyone else had this problem?--[[User:Varsashi|Varsashi]] 17:59, 26 November 2007 (EST)

::It hasn't been updated to work with 33c, and doesn't. Hopefully it will be updated soon. If you're using 33b, it should open and close quickly but reveal all allocated squares. To allocate all squares for revealing, I'll repeat the advice I've seen elsewhere: go to the lowest level and designate the entire level for digging, then remove the dig designation and run the reveal utility. --[[User:Janus|Janus]] 20:08, 26 November 2007 (EST)

So how do people feel about deleting this section, and probably the heal.exe section above too? —[[User:0x517A5D|0x517A5D]] 00:56, 23 December 2007 (EST)

==How to use warp.exe?==
How do you use warp.exe? There's no information on how to use these on the page.--[[User:Demosthenes|Demosthenes]] 02:10, 21 November 2007 (EST)
: <code>warp.exe</code> by itself will list your current cursor position. After you have the position you want to warp a creature to, you do <code>warp.exe <x> <y> <z></code> as arguments, and it will warp the selected creature (selected with 'V'iew) to that destination, if it can. --[[User:Rick|Rick]] 18:10, 21 November 2007 (EST)

==StartProfile==
Perhaps, I don't understand how to use this correctly. I'm using 33e, and the StartProfile linked in the Utils section. I'm supposed to use this util at the Prepare for the Journey screen, correct? I tried testing the export function with the first dwarf, with no skills assigned. startprofile.exe -x 0 test.txt What I got back was: 
<code>
Mining: 1348403210 
Wood Cutter: 1565676876 
Carpenter: 3801123 
Engraving: 34079120 
Record Keepe: 2293770 
Liar: 34341293 
Intimidator: 16843009 
Conversationalist: 16843009 
Comedian: 16843009 
Flatterer: 16843009 
Consoler: 16843009 
Pacifier: 16843009 
</code>
When I try to set a dwarf's skills using StartProfile I end up with huge amounts of either negative or positive points available, with no changes being made to the dwarf's skills. --[[User:Stu72|Stu72]] 09:23, 11 December 2007 (EST)
: The offset for the skills must have changed. I guess I should've actually checked that, and not have assumed that just because the other values were correct, the skills were still correct. I'll check it out and post the appropriate fix. -- [[User:Jifodus|Jifodus]]
: The appropriate fix is redownloading it, when I hex edited the exe I messed it up field. -- [[User:Jifodus|Jifodus]]
:: Thanks, works beautifully. It's a terrific time saver. --[[User:Stu72|Stu72]] 15:30, 14 December 2007 (EST)

How does one use this? The readme isn't very helpful. --[[User:Jackard|Jackard]] 01:08, 27 November 2007 (EST)
: Not knowing exactly what you're having trouble understanding, I'll give examples (the one thing I forgot to add in the readme). <code>startprofile 0 Miner.txt</code> - This will set the skill profile of the first Dwarf, in the list of units, to the skills in Miner.txt <code>startprofile 1 Jeweler.txt</code> - This will set the skills on the second Dwarf, in the list of units, to the skills in Jeweler.txt <code>startprofile -x 3 Customprofile.txt</code> - This will save the set of skills on the fourth Dwarf to Customprofile.txt <code>startprofile -v0.27.169.33b 0 Miner.txt</code> Same as the first example, except it'll work on the previous version of Dwarf Fortress. -- [[User:Jifodus|Jifodus]] 03:28, 27 November 2007 (EST)
::Thanks, I'll try that out. --[[User:Jackard|Jackard]] 21:21, 27 November 2007 (EST)

If you wish to edit the executable, you can modify it so that it works with 0.27.169.33d by making the following changes with a hex editor:
Offset Overwrite With
----------------------------
2A530 | 98 16 25 01 04 00 00 00 DC 00 00 00 F0 08 00 00 70 00 00 00 C0 01 00 00
2A6A6 | 30 2E 32 37 2E 31 36 39 2E 33 33 64
2A77C | 02
-- [[User:Jifodus|Jifodus]] 20:14, 3 December 2007 (EST)
:CBW; PUSH SS; AND EAX, 00000401h; ADD AH, BL; ADD [EAX], AL; ...
:That makes no sense. Must be missing something off the head end.
:3 unknown bytes; ADD [EAX+EAX], EAX; ... No better. Worse, even.
:4 unknown bytes; ADD AL, 00h; ADD [EAX], AL; ... Unh uh. Don't think so.
:8 unknown bytes; ESC-4(00); ... Floating point? Really? No way.
:12 unknown bytes; LOCK OR [EAX], AL ... Insane.
:I don't know what those bytes are, but they're not code.—[[User:0x517A5D|0x517A5D]] 23:23, 3 December 2007 (EST)
::You're right, they're data. First Row is (left to right, 5 dwords): [[User:Jifodus/Memory research#Addresses_3|Start Address]], Offset from address at start address, Dwarf List begin offset, Starting points offset, Skills offset, remaining skill points points. Second row is a character string (15 chars max). Third row is a dword indicating which data index is default.
:: <tt>//Start Addr, O, Lizt, Ponts, Skll, Remain</tt>
:: <tt>{ 0x01251698, 4, 0xDC, 0x8F0, 0x70, 0x1C0 }</tt> - The read/write locations and whatnot
:: <tt>"0.27.169.33d"</tt> - Used for string comparison (-v flag)
:: <tt>2</tt> - The default version to use is the third in the list (what the above just added).
:: Configuration data can be found between 'DATA_SET' and 'TES_ATAD'. The list has enough space for 16 versions (3 are now in use). I'll just say I didn't want to have to recompile it for all the versions -- [[User:Jifodus|Jifodus]] 21:52, 6 December 2007 (EST)
If you wish to edit the executable, you can modify it so that it works with 0.27.169.33e by making the following changes with a hex editor:
Offset Overwrite With
----------------------------
2A550 |"98 26 25 01"04 00 00 00 DC 00 00 00 F0 08 00 00 70 00 00 00 C0 01 00 00
2A6B5 | 30 2E 32 37 2E 31 36 39 2E 33 33"65"
2A77C |"03"

== Patching Lavasquare ==

Due to someone being interested in running lavasquare on version 33g, I determined how to patch the exe to work with later versions. With a hex editor, open lavasquare.exe and find and replace with appropriate values (replace the X's with the values underneath for the version you want). I only tested it for 33f, but I'm assuming that the values for 33g are correct (since I got them off the wiki).

(CursorX)
FIND: EE 57 68 88 E2 8F 00 FF 35
REPLACE: EE 57 68 XX XX XX 0X FF 35
33f 88 F2 8F 0
33g 88 62 90 0
38a 88 F2 92 0

(CursorY)
FIND: EC 57 68 8C E2 8F 00 FF 35
REPLACE: EC 57 68 XX XX XX 0X FF 35
33f 8C F2 8F 0
33g 8C 62 90 0
38a 8C F2 92 0

(CursorZ)
FIND: E6 57 68 90 E2 8F 00 FF 35
REPLACE: E6 57 68 XX XX XX 0X FF 35
33f 90 F2 8F 0
33g 90 62 90 0
38a 80 F2 92 0

(MapBlocks)
FIND: FC 57 68 60 15 46 01 FF 35
REPLACE: FC 57 68 XX XX XX 0X FF 35
33f 68 25 46 1
33g 80 96 46 1
38a CC 29 49 1

(To exit immediately after writing, since I don't want to
verify the other offsets)
FIND: FF 35 5C 80 40 00 E8 88 61 00 00 0F BF 7D
F8 57 0F BF 7D FA 57 8B 7D FC 81 C7 60 06
00 00
REPLACE: FF 35 5C 80 40 00 E8 88 61 00 00 6A FF FF
25 6C B1 40 00 CC CC CC CC CC CC CC CC CC
CC CC
-- [[User:Jifodus|Jifodus]] 02:05, 25 December 2007 (EST)

To modify the above for the same behavior as water:
FIND: 07 00 20 00
REPLACE: 07 00 00 00
-- [[User:Jifodus|Jifodus]] 17:09, 29 December 2007 (EST)

Addresses for 0.27.173.38a:
CursorX 0x0092F288
CursorY 0x0092F28C
CursorZ 0x0092F290
MapBlocks 0x014929CC
Offsets are still the same.
-- [[User:Jifodus|Jifodus]] 19:14, 7 February 2008 (EST)

== Lavasquare Popup? ==

How do I remove the prompt? It is a painful thing for large projects. The macro below helps some, though. --[[User:Jackard|Jackard]] 08:05, 4 January 2008 (EST)

#Persistent
SetTimer, CloseLava, 100
return

CloseLava:
WinClose, lcc runtime
return

del::
IfWinActive Dwarf Fortress
{
send {down}
run C:\Program Files\Dwarf Fortress\Utilities\lavasquare 33g.exe
return
}
else
{
send {del}
return
}

== Lavasquare ==

Why does it seemingly stop working after a while? It runs but summons no magma/lava. --[[User:Spelguru|Spelguru]] 12:28, 18 January 2008 (EST)
:No idea, never run into the problem though I've used it quite thoroughly. --[[User:Jackard|Jackard]] 17:52, 18 January 2008 (EST)
:I've run into this once. Restarting DF fixed the problem. --[[User:SquirrelFarmer|SquirrelFarmer]] 09:50, 29 January 2008 (EST)

User:Jifodus/Dwarf Fortress Utility Framework

2008-01-02T00:26:41Z

Jifodus: /* Current Features */

I'm currently writing a framework for Dwarf Fortress utilities. The general idea is to use C++ interfaces in a cross-compiler fashion that is very easy to use. This is designed to assist utility writers, by making possible to compile once, and have it work on future versions of Dwarf Fortress.

==License==
I'm not going to hold copyright of either the source code of the framework. It is in the Public Domain.

However, I will hold copyright of StartProfile. And it is licensed under the WTFPL: http://sam.zoy.org/wtfpl/

==Links==
===First Beta Release: January 1, 2008===
Source Code: http://www.geocities.com/jifodus/dfuf2.zip 
Binaries: http://www.geocities.com/jifodus/dfufend2.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug2.zip

'''This first beta release has additional interfaces for working with creatures, it also has more complete data files. It is now possible to cleanly create complex type overrides with ''PointerTo()'', ''VectorOf()'', and ''ArrayOf()''. There is no data for v0.27.169.33g, the data is most complete for v0.27.169.33f.'''
===Alpha Release===
Source Code: http://www.geocities.com/jifodus/dfuf.zip 
Binaries: http://www.geocities.com/jifodus/dfufend.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug.zip

==Todo==
Before the second release, which is necessary before it can be easily used, the following items need to be taken care of.
* Bugs
** There's always going to be a bug somewhere.
* Features
** Main Library
*** '''Error Handling''' - The library itself does not cleanly handle common errors. '''''10% Completed'''''
*** '''Auto-Update''' - Implement automatic update for both framework code and data. '''''0% Completed'''''
*** '''Installer''' - An installer for the library. '''''10% Completed'''''
*** '''Complete Memory Data''' - Complete transforming the memory data available on the wiki to format usable by library. '''''60% Completed'''''
*** '''More Type Objects''' - Provide interface wrappers to some of the commonly used memory types (Creature and Map). '''''60% Completed'''''
*** '''Memory Scanner''' - A simple memory searcher. Used for '''Auto-Identifier'''. '''''0% Completed'''''
*** '''Auto-Identifier''' - Automatically try to find the memory locations and offsets for new versions. '''''0% Completed'''''
*** '''Remote Memory De/Allocate''' - Needed to properly implement String & Vector set functions. '''''0% Completed'''''
*** '''Reload Data''' - The data loading portion does not yet properly reload the data. '''''0% Completed'''''
*** '''Bindings''' - C#/Perl/Java/Python/Lua/Other?

==Features Overview==
The Dwarf Fortress Utility Framework is designed with the following goals in mind:
* Utilities compiled for the very first release of the framework still work 10 years later
** With all the updates and patches applied to the library
** With the latest release of Dwarf Fortress
* The end user of a utility can simply download and run the utility and have it work
* The framework provides a flexible and easy to use way to define types and memory maps, and write utilities to use the types and memory maps

===Current Features===
* Written in C++, using interfaces
* Memory data stored in Lua format
* Sample utility for implementation reference: reimplementation of StartProfile
* API header & library
* Complete source code
* Identify Dwarf Fortress version via PE executable timestamp
* Cross-compiler/mostly C compatible using Windows COM style interfaces
** It is not C compatible due to function overloading issues.
* Auto-loading of Lua data files
* Library self-contained in DLL

===Current Limitations===
* '''Buggy!'''
** Memory leaks exist
* No real documentation whatsoever
* Sparse comments
* Memory data is all there, but the library does not yet use all of it
* The library is designed for C++, the C interface has not been tested (and probably will not work)
** Also, this was only tested using MSVC++ .net 2005, it will probably work on other version of MSVC++.
* Does not cleanly handle errors
* Some interface functions not implemented
** Map/Get through pointer functions not yet implemented
** iDFUF::installDataFile is not yet implemented
* Compiled as debug mode (bloated file sizes)
* The library is not extensively tested
* The library has a dependency on: [http://www.microsoft.com/downloads/details.aspx?FamilyId=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=en Visual Studio 8 Debug CRT]

===Second Release===
The next release planned features will include:
* Auto-retrieve memory data off the internet
* Auto-update framework code itself
* Have an installer that will install the DLL and data file to a shared location, so multiple utilities can use the same library

===Future===
And further down the road (through auto-update):
* Implement specific subsets of the std library; reduce utility size more, no large dependencies for the utilities
** std::string
** std::vector
** std::map
** Console IO
** File IO
* Easy to use GUI framework; for making tools with a nice GUI
* Cross-process memory allocation

==Data Format==

===Requirements===
The framework requires definitions of the following types:
* raw: a raw array of bytes; internally it allows access to an array of type.size * type.fixed_array bytes.
* pointer: a pointer to a location in Dwarf Fortress's memory; can represent a 32-bit pointer
* dword: an integer type that is 4 bytes
* word: an integer type that is 2 bytes
* byte: an integer type that is 1 byte
* float: a 32-bit floating point type
* double: a 64-bit floating point type
* string: a type that represents a std::string
** required members:
*** '''dword''' length: defines how many characters string contains
*** '''dword''' capacity: defines the maximum number of characters the string buffer can contain
*** '''pointer''' buffer_ptr: a pointer to a memory location containing the string data
** optional members:
*** '''raw''' buffer: a fixed-size array of characters containing the string when length < the fixed size of the buffer
* vector: a type representing a std::vector
** required members:
*** '''pointer''' begin: a pointer to the begining of the memory block
*** '''pointer''' end: a pointer to just beyond of the last valid element in the vector
*** '''pointer''' last: a pointer to just beyond the end of the memory block

===Data Files===
The data files must supply the following information:
* Types: each element of the type list represents one type; there is a special type called '''Main''', '''Main''' represents the global memory map
* Signatures: each signature is designed to uniquely identify each version of Dwarf Fortress

====Lua Data Files====
Classes:
* '''Type''': 'type =' The value can either be a set containing a type override or the string of a type name.
** Type: 'type =' A string representing the Type Name of the type to override.
** Subtypes: An array of type overrides and/or Type Names, that are subtypes of this type.
** Size: 'size =' An integer overriding the size of the type.
** Fixed Array Size: 'fixed_size =' An integer overriding the fixed array size of the type.
* Types: 'Types'
** Version: String representing version
*** TypeName: String representing name of the type, special type is '''Main'''.
**** Size: 'size =' an integer representing
**** Members: 'members' a table of of name value pairs; The name being the Member Name; The value is a set containing the Type and Offset.
***** Member Name: String representing the name
****** Type: 'type =' The value can either be a set containing a '''Type''' override or the name of the of a type.
****** Offset: 'offset =' The member offset (from the base address).
****** Pointer: 'pointer =' The pointer in memory for which the member can be found. Used for the '''Main''' type.
* Signatures 'Signatures'
** Version: String representing the version (same string as types).
*** PE Timestamp: 'pe_timestamp' The PE header timestamp value.
*** .text Adler32: 'adler32' The Adler32 CRC of the ".text" section of the executable.
*** Text Segments: 'text_segments' An array of segments of the ".text" section of the executable.
**** Address: [1] = The offset into the ".text" section that the following raw data can be found.
**** Raw Data: [2] = The data the ".text" segment is supposed to contain.

==Library Usage==
(This part is only useful for utility writers.)

===Basic Programming===
The basic program needed to use the library is simply:
#include <dfuf.h>
void main() {
dfuf::iDFUF *uf = dfuf::newDFUF();
// Do something with the framework
uf->destroy(); // in theory cleans up all memory used
}
To connect to an instance of Dwarf Fortress the program must first scan for instances,
then get one of the instances of dwarf fortress like this:
if (uf->scanForInstances() == 0)
// none found
return;
dfuf::iDFInstance *instance = uf->getInstance(0);
After getting a Dwarf Fortress instance, it then becomes possible to access global
pointers and memory locations (i.e. creature vector location) with
iDFInstance::getMemoryObject. iDFInstance::getMemoryObject takes a iType* and an
Address in Dwarf Fortress memory and returns an appropriate iMemoryType*. There are
different ways to provide the iType* and the Address, including from the data file
(via the appropriate name), a iPointerType*, and an iPointer* and iType* lets the
code create from the raw parts. There is a second version of
iDFInstance::getMemoryObject, which follows all the pointers to a non-pointer object
and returns the object called iDFInstance::getMemoryObjectThroughPointers. However,
it has not been implemented in the first release of the library.

From the first memory object created, the code can then either query the value (from
any of the i*Type) or map other members (from any of the i*Object) objects.

===Advanced Programming===
An advanced topic is iMemoryType* creation. It is painful to individually map the
members, therefore creating an iMemoryType* that simplifies access to the type sounds
ideal. However, the library only knows about the types it has been compiled with. Enter
iTypeFactory*, the iTypeFactory* gets registered in iDFUF with iDFUF::addTypeFactory.
Each factory provides 2 functions: construct & destruct. This allows programs to create
their own structures to wrap the creature type.

Example code:
class cCreatureType : public dfuf::iMemoryObject
{
public:
// Implement virtual methods here

public:
dfuf::u32 getHappiness() { return happiness->getValue(); }
void setHappiness(dfuf::u32 value) { happiness->setValue(value); }
// More methods here
cCreatureType(dfuf::iDFInstance *instance, dfuf::iPointer *base, dfuf::iType *type)
{
this->instance = instance;
this->base = base;
this->type = type;
this->happiness = map(L"happiness");
}
public:
dfuf::iDFInstance *instance;
dfuf::iPointer *base;
dfuf::iType *type;
dfuf::iIntegerType *happiness;
};
class cCreatureFactory : public dfuf::iTypeFactory
{
public:
// new creature
{
return new cCreatureType(instance, base, type);
}
// delete creature
{
delete object;
}
};
// Global instance, otherwise we'd have to do memory management on the pointer
cCreatureFactory global_CreatureFactory;
// Usage
void main()
{
dfuf::iDFUF *uf = newDFUF();
dfuf::iDFInstance *instance = uf->getDFInstance(0);
uf->addTypeFactory("creature", &global_CreatureFactory);
iPointer *pointer;
cCreatureType *creature = (cCreatureType *)instance->getMemoryObject
(pointer, instance->getType("creature"));
creature->setHappiness(-10000); // hahaha die dwarf!
uf->destroy();
}

User:Jifodus/Dwarf Fortress Utility Framework

2008-01-02T00:21:23Z

Jifodus: /* Current Limitations */

I'm currently writing a framework for Dwarf Fortress utilities. The general idea is to use C++ interfaces in a cross-compiler fashion that is very easy to use. This is designed to assist utility writers, by making possible to compile once, and have it work on future versions of Dwarf Fortress.

==License==
I'm not going to hold copyright of either the source code of the framework. It is in the Public Domain.

However, I will hold copyright of StartProfile. And it is licensed under the WTFPL: http://sam.zoy.org/wtfpl/

==Links==
===First Beta Release: January 1, 2008===
Source Code: http://www.geocities.com/jifodus/dfuf2.zip 
Binaries: http://www.geocities.com/jifodus/dfufend2.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug2.zip

'''This first beta release has additional interfaces for working with creatures, it also has more complete data files. It is now possible to cleanly create complex type overrides with ''PointerTo()'', ''VectorOf()'', and ''ArrayOf()''. There is no data for v0.27.169.33g, the data is most complete for v0.27.169.33f.'''
===Alpha Release===
Source Code: http://www.geocities.com/jifodus/dfuf.zip 
Binaries: http://www.geocities.com/jifodus/dfufend.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug.zip

==Todo==
Before the second release, which is necessary before it can be easily used, the following items need to be taken care of.
* Bugs
** There's always going to be a bug somewhere.
* Features
** Main Library
*** '''Error Handling''' - The library itself does not cleanly handle common errors. '''''10% Completed'''''
*** '''Auto-Update''' - Implement automatic update for both framework code and data. '''''0% Completed'''''
*** '''Installer''' - An installer for the library. '''''10% Completed'''''
*** '''Complete Memory Data''' - Complete transforming the memory data available on the wiki to format usable by library. '''''60% Completed'''''
*** '''More Type Objects''' - Provide interface wrappers to some of the commonly used memory types (Creature and Map). '''''60% Completed'''''
*** '''Memory Scanner''' - A simple memory searcher. Used for '''Auto-Identifier'''. '''''0% Completed'''''
*** '''Auto-Identifier''' - Automatically try to find the memory locations and offsets for new versions. '''''0% Completed'''''
*** '''Remote Memory De/Allocate''' - Needed to properly implement String & Vector set functions. '''''0% Completed'''''
*** '''Reload Data''' - The data loading portion does not yet properly reload the data. '''''0% Completed'''''
*** '''Bindings''' - C#/Perl/Java/Python/Lua/Other?

==Features Overview==
The Dwarf Fortress Utility Framework is designed with the following goals in mind:
* Utilities compiled for the very first release of the framework still work 10 years later
** With all the updates and patches applied to the library
** With the latest release of Dwarf Fortress
* The end user of a utility can simply download and run the utility and have it work
* The framework provides a flexible and easy to use way to define types and memory maps, and write utilities to use the types and memory maps

===Current Features===
* Written in C++, using interfaces
* Memory data stored in Lua format
* Sample utility for implementation reference: reimplementation of StartProfile
* API header & library
* Complete source code
* Identify Dwarf Fortress version via PE executable timestamp
* Cross-compiler/C compatible using Windows COM style interfaces
* Auto-loading of Lua data files
* Library self-contained in DLL

===Current Limitations===
* '''Buggy!'''
** Memory leaks exist
* No real documentation whatsoever
* Sparse comments
* Memory data is all there, but the library does not yet use all of it
* The library is designed for C++, the C interface has not been tested (and probably will not work)
** Also, this was only tested using MSVC++ .net 2005, it will probably work on other version of MSVC++.
* Does not cleanly handle errors
* Some interface functions not implemented
** Map/Get through pointer functions not yet implemented
** iDFUF::installDataFile is not yet implemented
* Compiled as debug mode (bloated file sizes)
* The library is not extensively tested
* The library has a dependency on: [http://www.microsoft.com/downloads/details.aspx?FamilyId=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=en Visual Studio 8 Debug CRT]

===Second Release===
The next release planned features will include:
* Auto-retrieve memory data off the internet
* Auto-update framework code itself
* Have an installer that will install the DLL and data file to a shared location, so multiple utilities can use the same library

===Future===
And further down the road (through auto-update):
* Implement specific subsets of the std library; reduce utility size more, no large dependencies for the utilities
** std::string
** std::vector
** std::map
** Console IO
** File IO
* Easy to use GUI framework; for making tools with a nice GUI
* Cross-process memory allocation

==Data Format==

===Requirements===
The framework requires definitions of the following types:
* raw: a raw array of bytes; internally it allows access to an array of type.size * type.fixed_array bytes.
* pointer: a pointer to a location in Dwarf Fortress's memory; can represent a 32-bit pointer
* dword: an integer type that is 4 bytes
* word: an integer type that is 2 bytes
* byte: an integer type that is 1 byte
* float: a 32-bit floating point type
* double: a 64-bit floating point type
* string: a type that represents a std::string
** required members:
*** '''dword''' length: defines how many characters string contains
*** '''dword''' capacity: defines the maximum number of characters the string buffer can contain
*** '''pointer''' buffer_ptr: a pointer to a memory location containing the string data
** optional members:
*** '''raw''' buffer: a fixed-size array of characters containing the string when length < the fixed size of the buffer
* vector: a type representing a std::vector
** required members:
*** '''pointer''' begin: a pointer to the begining of the memory block
*** '''pointer''' end: a pointer to just beyond of the last valid element in the vector
*** '''pointer''' last: a pointer to just beyond the end of the memory block

===Data Files===
The data files must supply the following information:
* Types: each element of the type list represents one type; there is a special type called '''Main''', '''Main''' represents the global memory map
* Signatures: each signature is designed to uniquely identify each version of Dwarf Fortress

====Lua Data Files====
Classes:
* '''Type''': 'type =' The value can either be a set containing a type override or the string of a type name.
** Type: 'type =' A string representing the Type Name of the type to override.
** Subtypes: An array of type overrides and/or Type Names, that are subtypes of this type.
** Size: 'size =' An integer overriding the size of the type.
** Fixed Array Size: 'fixed_size =' An integer overriding the fixed array size of the type.
* Types: 'Types'
** Version: String representing version
*** TypeName: String representing name of the type, special type is '''Main'''.
**** Size: 'size =' an integer representing
**** Members: 'members' a table of of name value pairs; The name being the Member Name; The value is a set containing the Type and Offset.
***** Member Name: String representing the name
****** Type: 'type =' The value can either be a set containing a '''Type''' override or the name of the of a type.
****** Offset: 'offset =' The member offset (from the base address).
****** Pointer: 'pointer =' The pointer in memory for which the member can be found. Used for the '''Main''' type.
* Signatures 'Signatures'
** Version: String representing the version (same string as types).
*** PE Timestamp: 'pe_timestamp' The PE header timestamp value.
*** .text Adler32: 'adler32' The Adler32 CRC of the ".text" section of the executable.
*** Text Segments: 'text_segments' An array of segments of the ".text" section of the executable.
**** Address: [1] = The offset into the ".text" section that the following raw data can be found.
**** Raw Data: [2] = The data the ".text" segment is supposed to contain.

==Library Usage==
(This part is only useful for utility writers.)

===Basic Programming===
The basic program needed to use the library is simply:
#include <dfuf.h>
void main() {
dfuf::iDFUF *uf = dfuf::newDFUF();
// Do something with the framework
uf->destroy(); // in theory cleans up all memory used
}
To connect to an instance of Dwarf Fortress the program must first scan for instances,
then get one of the instances of dwarf fortress like this:
if (uf->scanForInstances() == 0)
// none found
return;
dfuf::iDFInstance *instance = uf->getInstance(0);
After getting a Dwarf Fortress instance, it then becomes possible to access global
pointers and memory locations (i.e. creature vector location) with
iDFInstance::getMemoryObject. iDFInstance::getMemoryObject takes a iType* and an
Address in Dwarf Fortress memory and returns an appropriate iMemoryType*. There are
different ways to provide the iType* and the Address, including from the data file
(via the appropriate name), a iPointerType*, and an iPointer* and iType* lets the
code create from the raw parts. There is a second version of
iDFInstance::getMemoryObject, which follows all the pointers to a non-pointer object
and returns the object called iDFInstance::getMemoryObjectThroughPointers. However,
it has not been implemented in the first release of the library.

From the first memory object created, the code can then either query the value (from
any of the i*Type) or map other members (from any of the i*Object) objects.

===Advanced Programming===
An advanced topic is iMemoryType* creation. It is painful to individually map the
members, therefore creating an iMemoryType* that simplifies access to the type sounds
ideal. However, the library only knows about the types it has been compiled with. Enter
iTypeFactory*, the iTypeFactory* gets registered in iDFUF with iDFUF::addTypeFactory.
Each factory provides 2 functions: construct & destruct. This allows programs to create
their own structures to wrap the creature type.

Example code:
class cCreatureType : public dfuf::iMemoryObject
{
public:
// Implement virtual methods here

public:
dfuf::u32 getHappiness() { return happiness->getValue(); }
void setHappiness(dfuf::u32 value) { happiness->setValue(value); }
// More methods here
cCreatureType(dfuf::iDFInstance *instance, dfuf::iPointer *base, dfuf::iType *type)
{
this->instance = instance;
this->base = base;
this->type = type;
this->happiness = map(L"happiness");
}
public:
dfuf::iDFInstance *instance;
dfuf::iPointer *base;
dfuf::iType *type;
dfuf::iIntegerType *happiness;
};
class cCreatureFactory : public dfuf::iTypeFactory
{
public:
// new creature
{
return new cCreatureType(instance, base, type);
}
// delete creature
{
delete object;
}
};
// Global instance, otherwise we'd have to do memory management on the pointer
cCreatureFactory global_CreatureFactory;
// Usage
void main()
{
dfuf::iDFUF *uf = newDFUF();
dfuf::iDFInstance *instance = uf->getDFInstance(0);
uf->addTypeFactory("creature", &global_CreatureFactory);
iPointer *pointer;
cCreatureType *creature = (cCreatureType *)instance->getMemoryObject
(pointer, instance->getType("creature"));
creature->setHappiness(-10000); // hahaha die dwarf!
uf->destroy();
}

User:Jifodus/Dwarf Fortress Utility Framework

2008-01-02T00:13:32Z

Jifodus: /* Links */

I'm currently writing a framework for Dwarf Fortress utilities. The general idea is to use C++ interfaces in a cross-compiler fashion that is very easy to use. This is designed to assist utility writers, by making possible to compile once, and have it work on future versions of Dwarf Fortress.

==License==
I'm not going to hold copyright of either the source code of the framework. It is in the Public Domain.

However, I will hold copyright of StartProfile. And it is licensed under the WTFPL: http://sam.zoy.org/wtfpl/

==Links==
===First Beta Release: January 1, 2008===
Source Code: http://www.geocities.com/jifodus/dfuf2.zip 
Binaries: http://www.geocities.com/jifodus/dfufend2.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug2.zip

'''This first beta release has additional interfaces for working with creatures, it also has more complete data files. It is now possible to cleanly create complex type overrides with ''PointerTo()'', ''VectorOf()'', and ''ArrayOf()''. There is no data for v0.27.169.33g, the data is most complete for v0.27.169.33f.'''
===Alpha Release===
Source Code: http://www.geocities.com/jifodus/dfuf.zip 
Binaries: http://www.geocities.com/jifodus/dfufend.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug.zip

==Todo==
Before the second release, which is necessary before it can be easily used, the following items need to be taken care of.
* Bugs
** There's always going to be a bug somewhere.
* Features
** Main Library
*** '''Error Handling''' - The library itself does not cleanly handle common errors. '''''10% Completed'''''
*** '''Auto-Update''' - Implement automatic update for both framework code and data. '''''0% Completed'''''
*** '''Installer''' - An installer for the library. '''''10% Completed'''''
*** '''Complete Memory Data''' - Complete transforming the memory data available on the wiki to format usable by library. '''''60% Completed'''''
*** '''More Type Objects''' - Provide interface wrappers to some of the commonly used memory types (Creature and Map). '''''60% Completed'''''
*** '''Memory Scanner''' - A simple memory searcher. Used for '''Auto-Identifier'''. '''''0% Completed'''''
*** '''Auto-Identifier''' - Automatically try to find the memory locations and offsets for new versions. '''''0% Completed'''''
*** '''Remote Memory De/Allocate''' - Needed to properly implement String & Vector set functions. '''''0% Completed'''''
*** '''Reload Data''' - The data loading portion does not yet properly reload the data. '''''0% Completed'''''
*** '''Bindings''' - C#/Perl/Java/Python/Lua/Other?

==Features Overview==
The Dwarf Fortress Utility Framework is designed with the following goals in mind:
* Utilities compiled for the very first release of the framework still work 10 years later
** With all the updates and patches applied to the library
** With the latest release of Dwarf Fortress
* The end user of a utility can simply download and run the utility and have it work
* The framework provides a flexible and easy to use way to define types and memory maps, and write utilities to use the types and memory maps

===Current Features===
* Written in C++, using interfaces
* Memory data stored in Lua format
* Sample utility for implementation reference: reimplementation of StartProfile
* API header & library
* Complete source code
* Identify Dwarf Fortress version via PE executable timestamp
* Cross-compiler/C compatible using Windows COM style interfaces
* Auto-loading of Lua data files
* Library self-contained in DLL

===Current Limitations===
* '''Buggy!'''
** Memory leaks exist
* No real documentation whatsoever
* Sparse comments
* Memory data is all there, but the library does not yet use all of it
* The library is designed for C++, the C interface has not been tested (and probably will not work)
** Also, this was only tested using MSVC++ .net 2005, it will probably work on other version of MSVC++.
* Does not cleanly handle errors
* Some interface functions not implemented
** Map/Get through pointer functions not yet implemented
** iDFUF::installDataFile is not yet implemented
* Compiled as debug mode (bloated file sizes)
* Windows XP or later required (from the use of GetModuleHandleEx)
* The library is not extensively tested

===Second Release===
The next release planned features will include:
* Auto-retrieve memory data off the internet
* Auto-update framework code itself
* Have an installer that will install the DLL and data file to a shared location, so multiple utilities can use the same library

===Future===
And further down the road (through auto-update):
* Implement specific subsets of the std library; reduce utility size more, no large dependencies for the utilities
** std::string
** std::vector
** std::map
** Console IO
** File IO
* Easy to use GUI framework; for making tools with a nice GUI
* Cross-process memory allocation

==Data Format==

===Requirements===
The framework requires definitions of the following types:
* raw: a raw array of bytes; internally it allows access to an array of type.size * type.fixed_array bytes.
* pointer: a pointer to a location in Dwarf Fortress's memory; can represent a 32-bit pointer
* dword: an integer type that is 4 bytes
* word: an integer type that is 2 bytes
* byte: an integer type that is 1 byte
* float: a 32-bit floating point type
* double: a 64-bit floating point type
* string: a type that represents a std::string
** required members:
*** '''dword''' length: defines how many characters string contains
*** '''dword''' capacity: defines the maximum number of characters the string buffer can contain
*** '''pointer''' buffer_ptr: a pointer to a memory location containing the string data
** optional members:
*** '''raw''' buffer: a fixed-size array of characters containing the string when length < the fixed size of the buffer
* vector: a type representing a std::vector
** required members:
*** '''pointer''' begin: a pointer to the begining of the memory block
*** '''pointer''' end: a pointer to just beyond of the last valid element in the vector
*** '''pointer''' last: a pointer to just beyond the end of the memory block

===Data Files===
The data files must supply the following information:
* Types: each element of the type list represents one type; there is a special type called '''Main''', '''Main''' represents the global memory map
* Signatures: each signature is designed to uniquely identify each version of Dwarf Fortress

====Lua Data Files====
Classes:
* '''Type''': 'type =' The value can either be a set containing a type override or the string of a type name.
** Type: 'type =' A string representing the Type Name of the type to override.
** Subtypes: An array of type overrides and/or Type Names, that are subtypes of this type.
** Size: 'size =' An integer overriding the size of the type.
** Fixed Array Size: 'fixed_size =' An integer overriding the fixed array size of the type.
* Types: 'Types'
** Version: String representing version
*** TypeName: String representing name of the type, special type is '''Main'''.
**** Size: 'size =' an integer representing
**** Members: 'members' a table of of name value pairs; The name being the Member Name; The value is a set containing the Type and Offset.
***** Member Name: String representing the name
****** Type: 'type =' The value can either be a set containing a '''Type''' override or the name of the of a type.
****** Offset: 'offset =' The member offset (from the base address).
****** Pointer: 'pointer =' The pointer in memory for which the member can be found. Used for the '''Main''' type.
* Signatures 'Signatures'
** Version: String representing the version (same string as types).
*** PE Timestamp: 'pe_timestamp' The PE header timestamp value.
*** .text Adler32: 'adler32' The Adler32 CRC of the ".text" section of the executable.
*** Text Segments: 'text_segments' An array of segments of the ".text" section of the executable.
**** Address: [1] = The offset into the ".text" section that the following raw data can be found.
**** Raw Data: [2] = The data the ".text" segment is supposed to contain.

==Library Usage==
(This part is only useful for utility writers.)

===Basic Programming===
The basic program needed to use the library is simply:
#include <dfuf.h>
void main() {
dfuf::iDFUF *uf = dfuf::newDFUF();
// Do something with the framework
uf->destroy(); // in theory cleans up all memory used
}
To connect to an instance of Dwarf Fortress the program must first scan for instances,
then get one of the instances of dwarf fortress like this:
if (uf->scanForInstances() == 0)
// none found
return;
dfuf::iDFInstance *instance = uf->getInstance(0);
After getting a Dwarf Fortress instance, it then becomes possible to access global
pointers and memory locations (i.e. creature vector location) with
iDFInstance::getMemoryObject. iDFInstance::getMemoryObject takes a iType* and an
Address in Dwarf Fortress memory and returns an appropriate iMemoryType*. There are
different ways to provide the iType* and the Address, including from the data file
(via the appropriate name), a iPointerType*, and an iPointer* and iType* lets the
code create from the raw parts. There is a second version of
iDFInstance::getMemoryObject, which follows all the pointers to a non-pointer object
and returns the object called iDFInstance::getMemoryObjectThroughPointers. However,
it has not been implemented in the first release of the library.

From the first memory object created, the code can then either query the value (from
any of the i*Type) or map other members (from any of the i*Object) objects.

===Advanced Programming===
An advanced topic is iMemoryType* creation. It is painful to individually map the
members, therefore creating an iMemoryType* that simplifies access to the type sounds
ideal. However, the library only knows about the types it has been compiled with. Enter
iTypeFactory*, the iTypeFactory* gets registered in iDFUF with iDFUF::addTypeFactory.
Each factory provides 2 functions: construct & destruct. This allows programs to create
their own structures to wrap the creature type.

Example code:
class cCreatureType : public dfuf::iMemoryObject
{
public:
// Implement virtual methods here

public:
dfuf::u32 getHappiness() { return happiness->getValue(); }
void setHappiness(dfuf::u32 value) { happiness->setValue(value); }
// More methods here
cCreatureType(dfuf::iDFInstance *instance, dfuf::iPointer *base, dfuf::iType *type)
{
this->instance = instance;
this->base = base;
this->type = type;
this->happiness = map(L"happiness");
}
public:
dfuf::iDFInstance *instance;
dfuf::iPointer *base;
dfuf::iType *type;
dfuf::iIntegerType *happiness;
};
class cCreatureFactory : public dfuf::iTypeFactory
{
public:
// new creature
{
return new cCreatureType(instance, base, type);
}
// delete creature
{
delete object;
}
};
// Global instance, otherwise we'd have to do memory management on the pointer
cCreatureFactory global_CreatureFactory;
// Usage
void main()
{
dfuf::iDFUF *uf = newDFUF();
dfuf::iDFInstance *instance = uf->getDFInstance(0);
uf->addTypeFactory("creature", &global_CreatureFactory);
iPointer *pointer;
cCreatureType *creature = (cCreatureType *)instance->getMemoryObject
(pointer, instance->getType("creature"));
creature->setHappiness(-10000); // hahaha die dwarf!
uf->destroy();
}

User:Jifodus/Dwarf Fortress Utility Framework

2008-01-02T00:06:35Z

Jifodus: /* Todo */

I'm currently writing a framework for Dwarf Fortress utilities. The general idea is to use C++ interfaces in a cross-compiler fashion that is very easy to use. This is designed to assist utility writers, by making possible to compile once, and have it work on future versions of Dwarf Fortress.

==License==
I'm not going to hold copyright of either the source code of the framework. It is in the Public Domain.

However, I will hold copyright of StartProfile. And it is licensed under the WTFPL: http://sam.zoy.org/wtfpl/

==Links==
First Beta Release January 1, 2008 
Source Code: http://www.geocities.com/jifodus/dfuf2.zip 
Binaries: http://www.geocities.com/jifodus/dfufend2.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug2.zip

Alpha Release: 
Source Code: http://www.geocities.com/jifodus/dfuf.zip 
Binaries: http://www.geocities.com/jifodus/dfufend.zip 
Debugging Symbols for the Binaries: http://www.geocities.com/jifodus/dfufdebug.zip

==Todo==
Before the second release, which is necessary before it can be easily used, the following items need to be taken care of.
* Bugs
** There's always going to be a bug somewhere.
* Features
** Main Library
*** '''Error Handling''' - The library itself does not cleanly handle common errors. '''''10% Completed'''''
*** '''Auto-Update''' - Implement automatic update for both framework code and data. '''''0% Completed'''''
*** '''Installer''' - An installer for the library. '''''10% Completed'''''
*** '''Complete Memory Data''' - Complete transforming the memory data available on the wiki to format usable by library. '''''60% Completed'''''
*** '''More Type Objects''' - Provide interface wrappers to some of the commonly used memory types (Creature and Map). '''''60% Completed'''''
*** '''Memory Scanner''' - A simple memory searcher. Used for '''Auto-Identifier'''. '''''0% Completed'''''
*** '''Auto-Identifier''' - Automatically try to find the memory locations and offsets for new versions. '''''0% Completed'''''
*** '''Remote Memory De/Allocate''' - Needed to properly implement String & Vector set functions. '''''0% Completed'''''
*** '''Reload Data''' - The data loading portion does not yet properly reload the data. '''''0% Completed'''''
*** '''Bindings''' - C#/Perl/Java/Python/Lua/Other?

==Features Overview==
The Dwarf Fortress Utility Framework is designed with the following goals in mind:
* Utilities compiled for the very first release of the framework still work 10 years later
** With all the updates and patches applied to the library
** With the latest release of Dwarf Fortress
* The end user of a utility can simply download and run the utility and have it work
* The framework provides a flexible and easy to use way to define types and memory maps, and write utilities to use the types and memory maps

===Current Features===
* Written in C++, using interfaces
* Memory data stored in Lua format
* Sample utility for implementation reference: reimplementation of StartProfile
* API header & library
* Complete source code
* Identify Dwarf Fortress version via PE executable timestamp
* Cross-compiler/C compatible using Windows COM style interfaces
* Auto-loading of Lua data files
* Library self-contained in DLL

===Current Limitations===
* '''Buggy!'''
** Memory leaks exist
* No real documentation whatsoever
* Sparse comments
* Memory data is all there, but the library does not yet use all of it
* The library is designed for C++, the C interface has not been tested (and probably will not work)
** Also, this was only tested using MSVC++ .net 2005, it will probably work on other version of MSVC++.
* Does not cleanly handle errors
* Some interface functions not implemented
** Map/Get through pointer functions not yet implemented
** iDFUF::installDataFile is not yet implemented
* Compiled as debug mode (bloated file sizes)
* Windows XP or later required (from the use of GetModuleHandleEx)
* The library is not extensively tested

===Second Release===
The next release planned features will include:
* Auto-retrieve memory data off the internet
* Auto-update framework code itself
* Have an installer that will install the DLL and data file to a shared location, so multiple utilities can use the same library

===Future===
And further down the road (through auto-update):
* Implement specific subsets of the std library; reduce utility size more, no large dependencies for the utilities
** std::string
** std::vector
** std::map
** Console IO
** File IO
* Easy to use GUI framework; for making tools with a nice GUI
* Cross-process memory allocation

==Data Format==

===Requirements===
The framework requires definitions of the following types:
* raw: a raw array of bytes; internally it allows access to an array of type.size * type.fixed_array bytes.
* pointer: a pointer to a location in Dwarf Fortress's memory; can represent a 32-bit pointer
* dword: an integer type that is 4 bytes
* word: an integer type that is 2 bytes
* byte: an integer type that is 1 byte
* float: a 32-bit floating point type
* double: a 64-bit floating point type
* string: a type that represents a std::string
** required members:
*** '''dword''' length: defines how many characters string contains
*** '''dword''' capacity: defines the maximum number of characters the string buffer can contain
*** '''pointer''' buffer_ptr: a pointer to a memory location containing the string data
** optional members:
*** '''raw''' buffer: a fixed-size array of characters containing the string when length < the fixed size of the buffer
* vector: a type representing a std::vector
** required members:
*** '''pointer''' begin: a pointer to the begining of the memory block
*** '''pointer''' end: a pointer to just beyond of the last valid element in the vector
*** '''pointer''' last: a pointer to just beyond the end of the memory block

===Data Files===
The data files must supply the following information:
* Types: each element of the type list represents one type; there is a special type called '''Main''', '''Main''' represents the global memory map
* Signatures: each signature is designed to uniquely identify each version of Dwarf Fortress

====Lua Data Files====
Classes:
* '''Type''': 'type =' The value can either be a set containing a type override or the string of a type name.
** Type: 'type =' A string representing the Type Name of the type to override.
** Subtypes: An array of type overrides and/or Type Names, that are subtypes of this type.
** Size: 'size =' An integer overriding the size of the type.
** Fixed Array Size: 'fixed_size =' An integer overriding the fixed array size of the type.
* Types: 'Types'
** Version: String representing version
*** TypeName: String representing name of the type, special type is '''Main'''.
**** Size: 'size =' an integer representing
**** Members: 'members' a table of of name value pairs; The name being the Member Name; The value is a set containing the Type and Offset.
***** Member Name: String representing the name
****** Type: 'type =' The value can either be a set containing a '''Type''' override or the name of the of a type.
****** Offset: 'offset =' The member offset (from the base address).
****** Pointer: 'pointer =' The pointer in memory for which the member can be found. Used for the '''Main''' type.
* Signatures 'Signatures'
** Version: String representing the version (same string as types).
*** PE Timestamp: 'pe_timestamp' The PE header timestamp value.
*** .text Adler32: 'adler32' The Adler32 CRC of the ".text" section of the executable.
*** Text Segments: 'text_segments' An array of segments of the ".text" section of the executable.
**** Address: [1] = The offset into the ".text" section that the following raw data can be found.
**** Raw Data: [2] = The data the ".text" segment is supposed to contain.

==Library Usage==
(This part is only useful for utility writers.)

===Basic Programming===
The basic program needed to use the library is simply:
#include <dfuf.h>
void main() {
dfuf::iDFUF *uf = dfuf::newDFUF();
// Do something with the framework
uf->destroy(); // in theory cleans up all memory used
}
To connect to an instance of Dwarf Fortress the program must first scan for instances,
then get one of the instances of dwarf fortress like this:
if (uf->scanForInstances() == 0)
// none found
return;
dfuf::iDFInstance *instance = uf->getInstance(0);
After getting a Dwarf Fortress instance, it then becomes possible to access global
pointers and memory locations (i.e. creature vector location) with
iDFInstance::getMemoryObject. iDFInstance::getMemoryObject takes a iType* and an
Address in Dwarf Fortress memory and returns an appropriate iMemoryType*. There are
different ways to provide the iType* and the Address, including from the data file
(via the appropriate name), a iPointerType*, and an iPointer* and iType* lets the
code create from the raw parts. There is a second version of
iDFInstance::getMemoryObject, which follows all the pointers to a non-pointer object
and returns the object called iDFInstance::getMemoryObjectThroughPointers. However,
it has not been implemented in the first release of the library.

From the first memory object created, the code can then either query the value (from
any of the i*Type) or map other members (from any of the i*Object) objects.

===Advanced Programming===
An advanced topic is iMemoryType* creation. It is painful to individually map the
members, therefore creating an iMemoryType* that simplifies access to the type sounds
ideal. However, the library only knows about the types it has been compiled with. Enter
iTypeFactory*, the iTypeFactory* gets registered in iDFUF with iDFUF::addTypeFactory.
Each factory provides 2 functions: construct & destruct. This allows programs to create
their own structures to wrap the creature type.

Example code:
class cCreatureType : public dfuf::iMemoryObject
{
public:
// Implement virtual methods here

public:
dfuf::u32 getHappiness() { return happiness->getValue(); }
void setHappiness(dfuf::u32 value) { happiness->setValue(value); }
// More methods here
cCreatureType(dfuf::iDFInstance *instance, dfuf::iPointer *base, dfuf::iType *type)
{
this->instance = instance;
this->base = base;
this->type = type;
this->happiness = map(L"happiness");
}
public:
dfuf::iDFInstance *instance;
dfuf::iPointer *base;
dfuf::iType *type;
dfuf::iIntegerType *happiness;
};
class cCreatureFactory : public dfuf::iTypeFactory
{
public:
// new creature
{
return new cCreatureType(instance, base, type);
}
// delete creature
{
delete object;
}
};
// Global instance, otherwise we'd have to do memory management on the pointer
cCreatureFactory global_CreatureFactory;
// Usage
void main()
{
dfuf::iDFUF *uf = newDFUF();
dfuf::iDFInstance *instance = uf->getDFInstance(0);
uf->addTypeFactory("creature", &global_CreatureFactory);
iPointer *pointer;
cCreatureType *creature = (cCreatureType *)instance->getMemoryObject
(pointer, instance->getType("creature"));
creature->setHappiness(-10000); // hahaha die dwarf!
uf->destroy();
}