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.

Editing Utility:Dwarf Companion

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.


The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{uv|40d}}
+
[[Category:Utilities]]
 
[[Image:dfcompanion1.png|thumb|This is a preliminary screenshot of the prototype.]]
 
[[Image:dfcompanion1.png|thumb|This is a preliminary screenshot of the prototype.]]
 
= What? =
 
= What? =
Line 7: Line 7:
 
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.
 
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 version 40d16, supposedly. The latest screenshot is at [http://bartabox.banquise.net/df/screen1.png this place].
+
It supports versions 33d and later. The latest screenshot is at [http://bartabox.banquise.net/df/screen1.png this place].
  
 
= Important warning =
 
= Important warning =
Line 14: Line 14:
 
* do not teleport creatures that are hauling
 
* do not teleport creatures that are hauling
  
= Self-packaged executables =
+
= How =
There is an executable version by [[User:Valdemar|Valdemar]] available that does not require Python or any of the other of the dependencies to be installed. Unzip it and run "dfcompanion_prototype.exe" to bring up the core companion window. The scripts available in the pure python version also have exe equivalents:
+
You need to install several things first.
* revealVeins.exe - run with no arguments to reveal all vein tiles
 
* reveal.exe - run with no arguments to reveal the whole map (very slow, a C utility like Tweak is recommended for this task)
 
* designator.exe - see [[User:Bartavelle/DesignatorTiles]]
 
* changeProfession.exe - run through command prompt like "changeProfession [id] [profession]" where id is the ID of the dwarf you want to change (find this through core companion; pull up the profile of a dwarf and look in the window title) and profession is the profession to change to (Mason, Peasant, Speardwarf, etc.)
 
 
 
[http://www.pindi.us/files/df/dfcompanion-0.16-exe.zip Download (Version 0.16)].
 
[http://www.pindi.us/files/df/dfcompanion-0.17c-exe.zip Download (Version 0.17c)].
 
 
 
= How to install and run it =
 
You need to install several things first. Do it right, or it will not work.
 
  
* [http://www.python.org/download/ Python] (should work with any version)
+
* [http://www.python.org/download/ Python] (works with any version, 2.5 is prefered)
* from [http://sourceforge.net/projects/gladewin32/files/ this page], the latest "Gtk+/Win32 Runtime Environment Installer" (the files that is named like that : gtk-2.12.9-win32-2.exe, scroll down a bit).
+
* from [http://sourceforge.net/project/showfiles.php?group_id=98754 this page], the latest "Gtk+/Win32 Runtime Environment Installer"
  
 +
* For python 2.5 users, just grab the utility at [http://bartabox.banquise.net/df/companion-0.8-python25.zip this place], and unzip it (warning, this is an old version).
 
* For users of the -any versions, or python 2.4 users, you must:
 
* For users of the -any versions, or python 2.4 users, you must:
 
** Install the three modules from [http://www.pygtk.org/downloads.html this page] (PyCairo, PyGObject, PyGTK)
 
** Install the three modules from [http://www.pygtk.org/downloads.html this page] (PyCairo, PyGObject, PyGTK)
** Grab the software, v0.17d, at [http://bartabox.banquise.net/df/companion-0.17d-any.zip this place].
+
** Grab the software at [http://bartabox.banquise.net/df/companion-0.13-any.zip this place].
  
* Reboot your computer. Although the software doesn't demand it, if you don't do so Python won't know where to find modules, leading to errors.
 
 
* Double click on "dfcompanion_prototype.py"!
 
* Double click on "dfcompanion_prototype.py"!
 +
 +
An installer that contains all needed modules can be found here:
 +
http://aruiz.typepad.com/siliconisland/2006/12/allinone_win32_.html
  
 
= Problems? =
 
= Problems? =
Line 42: Line 35:
 
----
 
----
 
cd c:\where\companion\is\located\
 
cd c:\where\companion\is\located\
 
 
dfcompanion_prototype.py
 
dfcompanion_prototype.py
 
----
 
----
Line 56: Line 48:
 
* The error messages says something like "g_assert_warning not found in libglib-2.0.0.dll"
 
* The error messages says something like "g_assert_warning not found in libglib-2.0.0.dll"
 
There is a DLL conflict. You should reinstall the GTK runtime environment. If this fails, you have to find the old DLL that is staying somewhere on your system and remove it. Probably in c:\windows\system32\
 
There is a DLL conflict. You should reinstall the GTK runtime environment. If this fails, you have to find the old DLL that is staying somewhere on your system and remove it. Probably in c:\windows\system32\
 
* No-one responds when I ask questions on the talk page.
 
Have everyone look at the discussion page on the off chance that they might know something.
 
  
 
= Usage - what can you do? =
 
= Usage - what can you do? =
 
First run Dwarf Fortress, and load your game. It won't work otherwise.
 
First run Dwarf Fortress, and load your game. It won't work otherwise.
  
The general idea is to have the main window open next to your DF windows. It should help you play the game by providing useful hints while playing. Order dwarves using the column "alerts" so that most important stuff is on top : hungry, unhappy, moody, hurt dwarves. You can play with creatures and view detailed views of their attributes by double clicking them. Right now, you can interact by:
+
The general idea is to have the main window open next to your DF windows. It should help you play the game by providing useful hints while playing. Order dwarves using the column "alerts" so that most important stuff is on top : hungry, unhappy, moody, hurt dwarves. You can play with creatures and view detailled views of their attributes by double clicking them. Right now, you can interact by:
 
* clicking "heal", heals creature
 
* clicking "heal", heals creature
 
* clicking "hurt", hurts creature
 
* clicking "hurt", hurts creature
Line 75: Line 64:
  
 
Interesting effects are [http://mkv25.net/dfma/movie-236-lazydwarvesmustdie butcherable dwarves] and [http://img184.imageshack.us/img184/7919/straydognz6.jpg Corbine's crazy dogs]. Oh, and skeletal legendary miners that turn against your fortress.
 
Interesting effects are [http://mkv25.net/dfma/movie-236-lazydwarvesmustdie butcherable dwarves] and [http://img184.imageshack.us/img184/7919/straydognz6.jpg Corbine's crazy dogs]. Oh, and skeletal legendary miners that turn against your fortress.
 
= Random questions =
 
* How to prevent a dwarf from bleeding to death ? Turn him zombie. It will make him hostile, but cure his bleeding. Turn him back when happy.
 
* Reveal like tools and discovering the underground features : you have to uncover a tile belonging to an underground feature for it to be officially found. Just unreveal some tiles and dig through them.
 
  
 
= dwarfdbg scripts =
 
= dwarfdbg scripts =
Line 129: Line 114:
 
** zoom feature is disabled, because of UI changes
 
** zoom feature is disabled, because of UI changes
 
** added bugged slow reveal script :)
 
** added bugged slow reveal script :)
* companion.0.14-any.zip - 14/09/2008
 
** zoom is back
 
** custom alerts are easier to add
 
** corrected the map offsets, added a "revealVein.py" script
 
* companion.0.15-any.zip
 
** linux support is back
 
** and now, it is fast
 
* companion.0.16-any.zip - 05/10/2009
 
** solves bug with additional languages
 
* companion.0.17-any.zip - 27/11/2009
 
** d16 support
 
** ASLR support
 
  
 
= thanks =
 
= thanks =
Line 148: Line 121:
 
* sinoth, for early testings, bug discovery
 
* sinoth, for early testings, bug discovery
  
[[Category:Hacking|DwarfCompanion]]
+
[[Category:Hacking]]
[[Category:Utilities]]
 

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)