Utility:Dwarf Companion

What?

This project is about having a helper utility for dwarf fortress, hopefully filling gaps in the user interface. It will also allow some cool cheating, so that it would be possible to play with the engine. For example, you can now mark your nobles as butcherable! Ain't that cool?

For now, a *PROTOTYPE* utility is available, for testings. It uses python and requires many dependencies. It will end up as a standard .exe tool once features are ironed out.

How

You need to install several things first:

• Python 2.4 (this is a link to 2.4.4, should work with higher versions, like 2.6.*, but i did not test them)
• pywin32, select the package corresponding to your python version (should be pywin32-210.win32-py2.4.exe)
• from this page, install PyCairo, PyGObject and PyGTK (check the corresponding python version!)
• from this page, the latest "Gtk+/Win32 Runtime Environment Installer"

Now you can just grab the utility at this place, unzip it and double click on "dfcompanion_prototype.py".

Problems?

Please run the tool from the command line if you experience problems, and copy/paste errors in the discussion page.

The unit list often gets desynchronised (multiple dwarves appearing). To solve this, just press "refresh".

Usage

The general idea is to have the main window open next to your DF windows. Order dwarves using the column "alerts" so that most important stuff is on top. You can play with creatures by double clicking them. Right now, you can interact by:

• clicking "heal", heals creature
• clicking "hurt", hurts creature
• clicking "apply", saves the following changes:
  • position X,Y,Z
  • strength, agility, toughness
  • all flags (the checkbox stuff), most being unknown, please let us know about their use if you get it!
  • pain, exhaustion, hunger, thirst, drowsiness