v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Utility:Dwarf Companion

From Dwarf Fortress Wiki
Revision as of 13:50, 21 December 2007 by Bartavelle (talk | contribs) (→‎What?)
Jump to navigation Jump to search

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.

It supports versions 33d and 33f.

Dfcompanion1.png

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