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.

Difference between revisions of "Utility Talk:Dwarf Companion"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
 
(182 intermediate revisions by 75 users not shown)
Line 1: Line 1:
Things I've noticed with tinkering around in 33g.
+
I did some cleaning (actually I just removed most of it).
*"invade?" tag toggles prone position for the target.
 
*0x1.7(4th row) places and removes the target from the royal guard.
 
*0x2.7(4th row) places and removes the target from the fortress guard.
 
*0x4000 second row seems to dictate if the creature has a job or place to go to. Turning it off seems to do nothing, it just turns right back on again, unless the creature is moved in the process of applying.
 
*0x84, 0x800 and 0x4.5(7th row) make the dwarf friendly oriented instead of a fortress-dweller, much like a merchant.
 
*0x8 Is only present on dwarves legendary through making an artifact. It could be what keeps them from having another mood.
 
*0x2000 and 0x2.7(last row) seem to be related to lung-related injuries. Both make a "winded" effect appear on the dwarf. 0x2.7 seems to wear off after a short time.
 
*0x100(2nd row) does something peculiar. It removes the dwarf from the unit list, and then the dwarf just completely vanishes. Several tags are reset and the dwarf, for all purposes, seems to no longer exist. So far nothing I can find will bring the dwarf back, and several tags used on the dwarf will cause DF to lock up.
 
*0x400 makes the target invisible to the unit list only, does not seem to have any adverse effects.
 
*0x8.5(7th row) makes the unit a "visitor" on the unit list. Behaves friendly, not sure what it does otherwise.
 
  
Some interesting notes too. Setting a dwarf to hostile, waiting until a nearby soldier is charging to attack, then making them friendly again causes something really interesting. The soldier will kill the now-friendly dwarf, and then that soldier will become a target to all nearby soldiers, despite still being controllable and interactable.
+
== Compatibility with Mods ==
Also, that "staring off into the distance" mood is interesting. I want to see it in action but I can't find a way to actually trigger the mood to act. [[User:Lightning4|Lightning4]] 09:23, 27 December 2007 (EST)
+
 
 +
Was working with the Dig Deeper mod, and found that it doesn't work with modded in creatures at all. That's a let-down. [[User:Jwguy|Jwguy]] 07:55, 5 July 2009 (UTC)
 +
 
 +
Not actual anymore. Works with all creatures, whether modded or not.  --[[User:Blur|Blur]] 18:30, 8 February 2010 (UTC)
 +
 
 +
== Not working ==
 +
 
 +
I'm on 40d, and have followed the instructions on the page, (GTK Win32 runtime, Python 2.5, All three modules, and the Program), started the program up before and after Dwarf Fortress, just to see if I did it wrong the first time, and it doesn't work. The Program just has some category tabs and a few buttons, but never shows any data. [[User:Jwguy|Jwguy]] 18:31, 29 May 2009 (UTC)
 +
 
 +
*Additionally, in case it might help, all I am getting is a single box with Refresh, All Creatures, Only Dwarves, etc. There doesn't seem to be a load function or anything. I'd really appreciate some help with this. [[User:Jwguy|Jwguy]] 18:41, 29 May 2009 (UTC)
 +
 
 +
*Here's a screenshot of what I am dealing with, also: http://i64.photobucket.com/albums/h178/Jwguy/Notworking2.jpg . It was also suggested to me that I may need something called Pango, which doesn't seem to be mentioned on the wiki, anywhere. [[User:Jwguy|Jwguy]] 21:06, 29 May 2009 (UTC)
 +
 
 +
** I believe I was able to correct the problem. Apparently, the program is centered around the C:/ drive only. I normally play Dwarf Fortress from my portable hard-drive, and tried initializing the program on both devices. After a bit of trial and error, I moved both to my desktop, and it seems to work, now. Hopefully, if anyone else has this problem, they can fix it like this; I still can't get my dwarves to stop dying from heat after running through a flow of lava, though. I threw them in water, doused the clothes and healed, but I digress. [[User:Jwguy|Jwguy]] 00:31, 30 May 2009 (UTC)
 +
 
 +
== Bugs ==
 +
There are a few known bugs :
 +
* exhaustion is sometimes maxed out when you edit a creature
 +
* bleeding seems not to be stoppable in most case : just turn the creature undead
 +
* if there is a problem related to python and/or gtk, just make sure you followed the installation instructions. If it doesn't work anyway, it is unlikely I can help you (would be a python or gtk problem, not a DC problem)
  
:Thanks for this update! I'll include them in the next revision. AFAIK 0x8 triggers the "creator of" text, and works on any dwarf. It's quite possible to trigger a mood, i'll try soon triggering an artifical mood. [[User:Bartavelle|Bartavelle]] 11:54, 27 December 2007 (EST)
 
  
 
== Feature requests! ==
 
== Feature requests! ==
  
You suggested we put feature requests in the wiki discussion page, so here they are!
+
What would be the chances of dwarf item manipulation?  I'd love to bhttp://dwarffortresswiki.net/index.php/Utility_Talk:DwarfCompanione able to get rid of the rotting clothes that these stinking dwarves insist on wearing. [[User:Aristoi|Aristoi]] 15:01, 20 May 2009 (UTC)
* From sphir: "Any plans on map-related modules? e.g.
+
:Or maybe destroy that burning fire imp fat... [[User:Forsaken1111|Forsaken1111]] 06:08, 27 May 2009 (UTC)
**one button designate cut tree after recording the regions.
+
 
:: I do not get this one? What is exactly suggested? Designate ALL trees at once? [[User:Bartavelle|Bartavelle]] 06:34, 28 December 2007 (EST)
+
Most Dwarves acquire dabbling level in all the social skills very quickly, which leaves these skills at the top of their skill list for all time.  Even if they later become a Legendary Mason, you still have to scroll down to see it.  Can you add something that reorders their skills by highest level, so the things they're best at show up first?  --[[User:Oddrune|Oddrune]] 05:19, 1 June 2009 (UTC)
**additional "bookmarks", jump to creature (esp dead creatures, which cannot be done in game)
+
 
:: I'll add that soon, as it doesn't seem too hard [[User:Bartavelle|Bartavelle]] 06:34, 28 December 2007 (EST)
+
 
**add foreman.exe-like macro job management by profession?"
+
Ignite units would be a nice feature too.  --[[User:Blur|Blur]] 17:23, 8 February 2010 (UTC)
:: This is planned too [[User:Bartavelle|Bartavelle]] 06:34, 28 December 2007 (EST)
+
 
* and mine: "alert me when my hunters run out of bolts so I can draft them to reset their job state and get them to pick up a fresh batch of ammo. It's such a hassle to have to constantly watch hunters just so they don't do something dumb like put their head inside a cougar's mouth. Or even a way to look at the items in a dwarf's inventory would be lovely."
+
== Dwarf Companion - Cheating Fun in Adventure Mode! ==
: This one could be a bit tricky, as inventory is not reversed yet, and i haven't been looking at it, so i have no clue on how hard it is [[User:Bartavelle|Bartavelle]] 06:34, 28 December 2007 (EST)
+
 
I guess others should just add their requests below. Awesome application, thanks Bartavelle! [[User:Chrominance|Chrominance]] 20:06, 27 December 2007 (EST)
+
I was tinkering about with the Dwarf Companion program earlier today, when a thought came to my mind. "What if you could do stuff with this program in Adventure mode?"  
:How about the ability to change what the dwarf likes and hates? Just so my Mayor won't mandate the construction of adamantine items. --[[User:Corbine|Corbine]] 08:01, 28 December 2007 (EST)
+
 
::Likes and recent "events" are next on my list of stuff to reverse. I would especially like to display a summary of all "bad mood stuff" that recently happened to dwarves. [[User:Bartavelle|Bartavelle]] 11:14, 28 December 2007 (EST)
+
Well, it turns out that you can. By turning on the program and hitting the "All Creatures" box, you can access any loaded creature as well as your own adventurer. By doing this, you can make him as strong and legendary as you want, and effectively kill anything within the sector. You can also change your character into any creature in the game, including demons, goblins, etc. (NOTE: 'Shapeshifting' like this renders the tile where you changed un-passable, and you tend to teleport when you do so. Also, when I changed into a dragon, the game crashed.) Moods are also able to toggle, though I've only tested them upon my own adventurer. Going beserk in a human town triggered the mayor to start attacking me, but when I turned it off, he became friendly once again.
 +
 
 +
Here's a movie of some of my exploits with a fresh adventurer dwarf: http://mkv25.net/dfma/movie-348-dwarfcompanioninadventuremode17338a
 +
 
 +
I hope this strikes as interesting / useful for the future!
 +
 
 +
:Please sign your additions to the discussion page. [[User:Forsaken1111|Forsaken1111]] 06:09, 27 May 2009 (UTC)
 +
 
 +
== Easy Python/PyGTK installer ==
 +
 
 +
I was having some trouble getting all the Python dependencies to work properly together, but after some research I found a nice all-in-one PyGTK installer that works perfectly with companion 0.10. http://aruiz.typepad.com/siliconisland/2006/12/allinone_win32_.html Hope this helps!
 +
 
 +
== DwarfCompanion Linux HOWTO ==
 +
 
 +
There are two major problems when trying to run DwarfCompanion-0.13 in Linux:
 +
 
 +
* at least when started with "wine dwarfort.exe", dwarf-companion
 +
** cannot find the path to the executable when searching for the offsets
 +
** and has problems finding the process with "endswith()"
 +
 
 +
the following patch tries to work around these problems somewhat (you either have to run DwarfCompanion one directory-level down from your dwarfort.exe or change the path in the patch):
 +
 
 +
--- companion/dwarfdbg.py 2008-09-07 22:04:12.000000000 +0000
 +
+++ ~/dwarf_fortress/companion/dwarfdbg.py 2008-09-07 22:07:11.000000000 +0000
 +
@@ -100,9 +100,9 @@
 +
  self.dbg = pydbg()
 +
  self.metals = None
 +
  for (pid, proc) in self.dbg.enumerate_processes():
 +
- if proc.lower().endswith("dwarfort.exe"):
 +
+ if "dwarfort.exe" in proc.lower():
 +
  break
 +
- if not proc.lower().endswith("dwarfort.exe"):
 +
+ if not "dwarfort.exe" in proc.lower():
 +
  print "Dwarf Fortress is not running, or could not be found"
 +
  sys.exit(-1)
 +
  self.image = proc
 +
@@ -864,7 +865,7 @@
 +
 
 +
  def getOs(self):
 +
  if self.ofs == None:
 +
- self.ofs = offsetsearch.offsetsearch(self.image)
 +
+ self.ofs = offsetsearch.offsetsearch("../dwarfort.exe")
 +
  return self.ofs
 +
 
 +
  def instaMood(self):
 +
 
 +
 
 +
* reading/writing from the dwarf-fortress process when attaching/detaching with ptrace() without waiting for the process to react to the ptrace() also leads to problems, basically it is timing-dependent if you can read or change anything
 +
 
 +
this is easily fixed with waitpid (though I'm not quite sure if this really fixes the problem or if some signals could screw everything up again, therefore the "print status" statement):
 +
 
 +
--- companion/dflinux.py 2008-01-09 10:50:00.000000000 +0000
 +
+++ ~/dwarf_fortress/companion/dflinux.py 2008-09-07 21:29:50.000000000 +0000
 +
@@ -33,6 +33,9 @@
 +
  pid = int(spid)
 +
  self.pid = pid
 +
  self.libc.ptrace(16, self.pid, 0, 0) #ptrace attach
 +
+ status = 0
 +
+ self.libc.waitpid(self.pid, status, 0)
 +
+ print status
 +
 
 +
  def read(self, addr, size):
 +
  out = ''
 +
@@ -60,4 +63,7 @@
 +
  def detach(self):
 +
  if self.pid>0:
 +
  self.libc.ptrace(17, self.pid, 0, 0) #ptrace detach
 +
+ status = 0
 +
+ self.libc.waitpid(self.pid, status, 0)
 +
+ print status
 +
  self.pid = 0
 +
 
 +
* There are still some minor problems, e.g. when trying to set anything in the creature-editor, but at least healing and resting from the creature-list works now as expected. I will try to take a look at the creature-editor ...
 +
 
 +
--[[User:Penguin dwarf08|Penguin dwarf08]] 14:14, 11 September 2008 (EDT)
 +
 
 +
:Thanks for this ! [[User:Bartavelle|Bartavelle]] 09:20, 17 March 2009 (UTC)
 +
 
 +
 
 +
== Happydorf.py ==
 +
 
 +
I ran into a bug with a fortress that my dorfs were suiciding so I hacked this up to force their happiness to max, and it got me over the hump.  It might help someone someday.  Save as happydorf.py and dump it in your DC/scripts folder.
 +
 
 +
<tt>
 +
from dwarfdbg import *
 +
from eventname import jobName
 +
import sys
 +
dbg = dwarfdbg() #init dbg
 +
cl = dbg.getCreatures(0) #get the whole creature list (slow)
 +
for id in cl:
 +
    if cl[id][1] != 'dwarf': #keep Dwarf (both alive and dead)
 +
          continue
 +
    c = cl[id][13] # creature structure
 +
    if c.fe4&2:
 +
          continue
 +
    c.happiness = 65534 #Set happy to max -1, (max is 65535 as of 40D)
 +
    dbg.saveCreature(c) #save
 +
</tt>
 +
--[[User:Kittyz|Kittyz]] 14:56, 27 January 2009 (EST) Kittyz
 +
 
 +
== Compatibility ==
 +
 
 +
Does this work in 0.28.181.40d11? It says DF isn't running or can't be found when I try. --[[User:Simmura McCrea|Simmura McCrea]] 18:16, 12 May 2009 (UTC)
 +
 
 +
: Nope. --[[User:Bartavelle|Bartavelle]] 08:48, 13 May 2009 (UTC)
 +
 
 +
::Damn. Cheers anyway. --[[User:Simmura McCrea|Simmura McCrea]] 15:25, 13 May 2009 (UTC)
 +
 
 +
:::Workaround: Transport save file to a 40d folder, mess around, transport it back. 40d/40d11 are mutually compatible. -[[User:Heartofgoldfish|Heartofgoldfish]] 00:18, 18 May 2009 (UTC)
 +
 
 +
::::Are there any plans to update the memory locations? I tried simply renaming the file to dwarfort.exe as it is in 40d but it would not work as the memory locations are out of date. [[User:Forsaken1111|Forsaken1111]] 06:08, 27 May 2009 (UTC)
 +
 
 +
: The problem lies in the name of the file, change Dwarf Fortress.exe to dwarfort.exe and the utility will find it, gave me a memory error, but it may work for you once you have the right name.  [[User:Janizary|Janizary]] 19:39, 18 May 2009 (UTC)
 +
 
 +
::[[Dwarf Fortress Wiki:Community Portal#B|"B"]] is for Bold.  You should put this out on the wiki proper, where it will be found by those who need it - start a Linux article, perhaps. Jo no habla linuxol, but once you do it will only grow.--[[User:Albedo|Albedo]] 15:08, 20 May 2009 (UTC)
 +
 
 +
== Unknown flags ==
 +
0x1      =???        <br />
 +
dead?    =Kills creature when used with 'dead' <br />
 +
0x4      =??? <br />
 +
artifact =designates whether creature has created an artifact <br />
 +
0x10    =hostile        <br />
 +
0x20    =???    <br />
 +
merch1?  <br />
 +
caravan guard? <br />
 +
0x100          <br />
 +
0x200          <br />
 +
!unitlist      <br />
 +
liaison?      <br />
 +
zombie        <br />
 +
skel          <br />
 +
working        <br />
 +
prone          <br />
 +
0x1.4          <br />
 +
inv1          <br />
 +
hidden        <br />
 +
inv2          <br />
 +
0x1.5          <br />
 +
0x2.5          <br />
 +
0x4.5          <br />
 +
0x8.5          <br />
 +
0x1.6          <br />
 +
0x2.6          <br />
 +
tame          <br />
 +
0x8.6          <br />
 +
r.guard        <br />
 +
f.guard        <br />
 +
0x4.7 <br />
 +
0x8.7 <br />
 +
0x1b <br />
 +
0x2b <br />
 +
0x4b <br />
 +
0x8b <br />
 +
0x10b <br />
 +
0x20b <br />
 +
0x40b <br />
 +
dead <br />
 +
vanish? <br />
 +
0x200b <br />
 +
0x400b <br />
 +
0x800b <br />
 +
0x1000b <br />
 +
winded? <br />
 +
0x4000b <br />
 +
ground <br />
 +
flying <br />
 +
slaughter <br />
 +
underwrld <br />
 +
can't eat <br />
 +
0x1.5b <br />
 +
0x2.5b <br />
 +
0x4.5b <br />
 +
visitor? <br />
 +
0x1.6b <br />
 +
0x2.6b <br />
 +
0x4.6b <br />
 +
0x8.6b <br />
 +
0x1.7b <br />
 +
winded? <br />
 +
0x4.7b <br />
 +
tame2 <br />
 +
 
 +
* Technically, '''all''' of these flags are known - see [[Creature flags in DF memory]]. --[[User:Quietust|Quietust]] 17:14, 18 May 2010 (UTC)
 +
 
 +
== FTP SERVER DOWN! ==
 +
THE FTP SERVER FOR THE PyObject AND WHATEVER THE OTHER TWO ARE IS DOWN! THE DAMN FTP SERVER IS DOWN! GOD DAMN IT THE FTP SERVER IS DOWN! I NEED FTP SERVER! FTP SERVER DOWN! FTP SERVER NOT WORKING! FTP SERVER DEAD! FTP SERVER SUFFERING MANGLED HEART!
 +
 
 +
I found a site that mirrors these files (possibly not the most up-to-date ones though)
 +
http://www.filewatcher.com/b/ftp/ftp.dit.upm.es/linux/mirrors/ftp.gnome.org/binaries/win32.0.0.html
 +
 
 +
== Additional in-game languages (v0.17) ==
 +
 
 +
If you have additional languages modded into the game, out-of-the-box DwarfCompanion 0.17 will bomb with an error:
 +
<blockquote>
 +
  File "[PATH]\dwarfdbg.py", line 477, in getCreature
 +
    name = self.getName(c, details)
 +
  File "[PATH]\dwarfdbg.py", line 323, in getName
 +
    lastname = self.printName(table, lang)
 +
  File "[PATH]\dwarfdbg.py", line 219, in printName
 +
    lastname += self.rwords[lang][v]
 +
IndexError: list index out of range
 +
</blockquote>
 +
 
 +
To make it work, count the number of languages you have (but not language_SYM.txt).
 +
 
 +
Find the line in dwarfdbg.py which reads:
 +
 
 +
:for race in range(4):
 +
 
 +
Replace the 4 with the number of languages you have, run again, and it should work fine.
 +
 
 +
As of 0.17c this is no longer necessary.
 +
 
 +
== Loading error ==
 +
 
 +
I'm not sure if you actually check this, but here goes anyway.
 +
 
 +
I have all the other things installed (GTK, PYCairo, etc.), and when I click it, it simply opens a black window for a moment and closes. So I tried to run it through the command prompt, and it comes up with the following error:
 +
 
 +
:C:\Games\Dwarf Fortress>dfcompanion_prototype.py
 +
:Timestamp = 0x48c330df
 +
:Traceback (most recent call last):
 +
:File "C:\Games\Dwarf Fortress\dfcompanion_prototype.py", line 409, in <module>
 +
 
 +
:DFcmp = DFcompanion()
 +
:File "C:\Games\Dwarf Fortress\dfcompanion_prototype.py", line 353, in __init__
 +
 
 +
:self.dd = dwarfdbg(verbose=True)
 +
:File "C:\Games\Dwarf Fortress\dwarfdbg.py", line 131, in __init__
 +
:self.configoffsets()
 +
:File "C:\Games\Dwarf Fortress\dwarfdbg.py", line 89, in configoffsets
 +
:raise "can't guess offsets if not PE"
 +
:TypeError: exceptions must be classes or instances, not str
 +
 
 +
A similar thing happens when I try to use the executable version:
 +
 
 +
:C:\Documents and Settings\****\My Documents\Downloads\dist>dfcompanion_prototype.exe
 +
:Timestamp = 0x48c330df
 +
:C:\Documents and Settings\****\My Documents\Downloads\dist\library.zip\dwarfdbg.py:98: DeprecationWarning: raising a string exception is deprecated
 +
:Traceback (most recent call last):
 +
:File "dfcompanion_prototype.py", line 409, in <module>
 +
:File "dfcompanion_prototype.py", line 353, in __init__
 +
:File "dwarfdbg.pyc", line 131, in __init__
 +
:File "dwarfdbg.pyc", line 89, in configoffsets
 +
:can't guess offsets if not PE
 +
 
 +
What does this mean? How do I fix it? Did I do something stupid and obvious to mess it up? [[Special:Contributions/69.109.124.77|69.109.124.77]] 09:37, 12 January 2010 (UTC)
 +
 
 +
Try running version 0.16:  version 0.17 is for DF 40d16 only which may not be the version you are running. [[Special:Contributions/12.71.14.197|12.71.14.197]] 13:42, 25 February 2010 (UTC)
 +
 
 +
== tried running through the cmd.exe but I keep getting "the directory name is invalid" ==
 +
 
 +
It was flashing the black window so I tried to run it through run/cmd.exe, however it says that the directory name is invalid. I have tried several solutions, such as surrounding it with quotes (helps a little bit but not much), but I still can't get it to run. Which is a pity because I was looking forward to this.  Suggestions?
 +
 
 +
 
 +
Edit: I made the window flash enough times to get a glimpse of what was written, and it looks like I have a similar problem to the above poster.    Pleeeeease respond, someone?  :(
 +
 
 +
As above:  try running version 0.16:  version 0.17 is for DF 40d16 only which may not be the version of DF that you are running. [[Special:Contributions/12.71.14.197|12.71.14.197]] 13:43, 25 February 2010 (UTC)
 +
 
 +
This information really needs to written somwhere close to the download links, I made the same error
 +
 
 +
 
 +
♥Many♥ thanks, lets try it now!  ☺
 +
 
 +
 
 +
I'm having the same problems as the above, though with both executable versions of companion. I'm on DF 31.25. (does it even support this?)
 +
 
 +
Running the exe flashes with cannot find DF, Command prompt is no exception, any suggestions?
  
== Bugs ==
+
== Buggy window ==
 +
 
 +
C:\blahblahblah\dfcompanion_prototype.exe:360:PangoWarning: failed to find shape engine. expect ugly output. engine-type='PangoRenderWin32', script=latin
 +
 
 +
This error message repeats twice, and I get an extremely tall, spaced window that cannot be resized. Anyone know what the deal with this is?
 +
 
 +
== Is there a "this is about an older version of DF" template that can be added? ==
  
Occasionally when you heal/hurt or modify something of a dwarf or creature, the exhaustion amount will be maxed out, causing the target to pass out for QUITE awhile. --[[User:Corbine|Corbine]] 08:15, 28 December 2007 (EST)
+
This doesn't seem to have been updated since 40d.  It might be helpful to have a header to reflect that. [[Special:Contributions/130.160.154.207|130.160.154.207]] 00:51, 7 April 2014 (UTC)

Latest revision as of 00:51, 7 April 2014

I did some cleaning (actually I just removed most of it).

Compatibility with Mods[edit]

Was working with the Dig Deeper mod, and found that it doesn't work with modded in creatures at all. That's a let-down. Jwguy 07:55, 5 July 2009 (UTC)

Not actual anymore. Works with all creatures, whether modded or not. --Blur 18:30, 8 February 2010 (UTC)

Not working[edit]

I'm on 40d, and have followed the instructions on the page, (GTK Win32 runtime, Python 2.5, All three modules, and the Program), started the program up before and after Dwarf Fortress, just to see if I did it wrong the first time, and it doesn't work. The Program just has some category tabs and a few buttons, but never shows any data. Jwguy 18:31, 29 May 2009 (UTC)

  • Additionally, in case it might help, all I am getting is a single box with Refresh, All Creatures, Only Dwarves, etc. There doesn't seem to be a load function or anything. I'd really appreciate some help with this. Jwguy 18:41, 29 May 2009 (UTC)
    • I believe I was able to correct the problem. Apparently, the program is centered around the C:/ drive only. I normally play Dwarf Fortress from my portable hard-drive, and tried initializing the program on both devices. After a bit of trial and error, I moved both to my desktop, and it seems to work, now. Hopefully, if anyone else has this problem, they can fix it like this; I still can't get my dwarves to stop dying from heat after running through a flow of lava, though. I threw them in water, doused the clothes and healed, but I digress. Jwguy 00:31, 30 May 2009 (UTC)

Bugs[edit]

There are a few known bugs :

  • exhaustion is sometimes maxed out when you edit a creature
  • bleeding seems not to be stoppable in most case : just turn the creature undead
  • if there is a problem related to python and/or gtk, just make sure you followed the installation instructions. If it doesn't work anyway, it is unlikely I can help you (would be a python or gtk problem, not a DC problem)


Feature requests![edit]

What would be the chances of dwarf item manipulation? I'd love to bhttp://dwarffortresswiki.net/index.php/Utility_Talk:DwarfCompanione able to get rid of the rotting clothes that these stinking dwarves insist on wearing. Aristoi 15:01, 20 May 2009 (UTC)

Or maybe destroy that burning fire imp fat... Forsaken1111 06:08, 27 May 2009 (UTC)

Most Dwarves acquire dabbling level in all the social skills very quickly, which leaves these skills at the top of their skill list for all time. Even if they later become a Legendary Mason, you still have to scroll down to see it. Can you add something that reorders their skills by highest level, so the things they're best at show up first? --Oddrune 05:19, 1 June 2009 (UTC)


Ignite units would be a nice feature too. --Blur 17:23, 8 February 2010 (UTC)

Dwarf Companion - Cheating Fun in Adventure Mode![edit]

I was tinkering about with the Dwarf Companion program earlier today, when a thought came to my mind. "What if you could do stuff with this program in Adventure mode?"

Well, it turns out that you can. By turning on the program and hitting the "All Creatures" box, you can access any loaded creature as well as your own adventurer. By doing this, you can make him as strong and legendary as you want, and effectively kill anything within the sector. You can also change your character into any creature in the game, including demons, goblins, etc. (NOTE: 'Shapeshifting' like this renders the tile where you changed un-passable, and you tend to teleport when you do so. Also, when I changed into a dragon, the game crashed.) Moods are also able to toggle, though I've only tested them upon my own adventurer. Going beserk in a human town triggered the mayor to start attacking me, but when I turned it off, he became friendly once again.

Here's a movie of some of my exploits with a fresh adventurer dwarf: http://mkv25.net/dfma/movie-348-dwarfcompanioninadventuremode17338a

I hope this strikes as interesting / useful for the future!

Please sign your additions to the discussion page. Forsaken1111 06:09, 27 May 2009 (UTC)

Easy Python/PyGTK installer[edit]

I was having some trouble getting all the Python dependencies to work properly together, but after some research I found a nice all-in-one PyGTK installer that works perfectly with companion 0.10. http://aruiz.typepad.com/siliconisland/2006/12/allinone_win32_.html Hope this helps!

DwarfCompanion Linux HOWTO[edit]

There are two major problems when trying to run DwarfCompanion-0.13 in Linux:

  • at least when started with "wine dwarfort.exe", dwarf-companion
    • cannot find the path to the executable when searching for the offsets
    • and has problems finding the process with "endswith()"

the following patch tries to work around these problems somewhat (you either have to run DwarfCompanion one directory-level down from your dwarfort.exe or change the path in the patch):

--- companion/dwarfdbg.py	2008-09-07 22:04:12.000000000 +0000
+++ ~/dwarf_fortress/companion/dwarfdbg.py	2008-09-07 22:07:11.000000000 +0000
@@ -100,9 +100,9 @@
 		self.dbg = pydbg()
 		self.metals = None
 		for (pid, proc) in self.dbg.enumerate_processes():
-			if proc.lower().endswith("dwarfort.exe"):
+			if "dwarfort.exe" in proc.lower():
 				break
-		if not proc.lower().endswith("dwarfort.exe"):
+		if not "dwarfort.exe" in proc.lower():
 			print "Dwarf Fortress is not running, or could not be found"
 			sys.exit(-1)
 		self.image = proc
@@ -864,7 +865,7 @@
 
 	def getOs(self):
 		if self.ofs == None:
-			self.ofs = offsetsearch.offsetsearch(self.image)
+			self.ofs = offsetsearch.offsetsearch("../dwarfort.exe")
 		return self.ofs
 
 	def instaMood(self):


  • reading/writing from the dwarf-fortress process when attaching/detaching with ptrace() without waiting for the process to react to the ptrace() also leads to problems, basically it is timing-dependent if you can read or change anything

this is easily fixed with waitpid (though I'm not quite sure if this really fixes the problem or if some signals could screw everything up again, therefore the "print status" statement):

--- companion/dflinux.py	2008-01-09 10:50:00.000000000 +0000
+++ ~/dwarf_fortress/companion/dflinux.py	2008-09-07 21:29:50.000000000 +0000
@@ -33,6 +33,9 @@
 		pid = int(spid)
 		self.pid = pid
 		self.libc.ptrace(16, self.pid, 0, 0) #ptrace attach
+		status = 0
+		self.libc.waitpid(self.pid, status, 0)
+		print status
 	
 	def read(self, addr, size):
 		out = 
@@ -60,4 +63,7 @@
 	def detach(self):
 		if self.pid>0:
 			self.libc.ptrace(17, self.pid, 0, 0) #ptrace detach
+			status = 0
+			self.libc.waitpid(self.pid, status, 0)
+			print status
 			self.pid = 0
  • There are still some minor problems, e.g. when trying to set anything in the creature-editor, but at least healing and resting from the creature-list works now as expected. I will try to take a look at the creature-editor ...

--Penguin dwarf08 14:14, 11 September 2008 (EDT)

Thanks for this ! Bartavelle 09:20, 17 March 2009 (UTC)


Happydorf.py[edit]

I ran into a bug with a fortress that my dorfs were suiciding so I hacked this up to force their happiness to max, and it got me over the hump. It might help someone someday. Save as happydorf.py and dump it in your DC/scripts folder.

from dwarfdbg import * from eventname import jobName import sys dbg = dwarfdbg() #init dbg cl = dbg.getCreatures(0) #get the whole creature list (slow) for id in cl:

    if cl[id][1] != 'dwarf': #keep Dwarf (both alive and dead)
         continue
    c = cl[id][13] # creature structure
    if c.fe4&2:
         continue
    c.happiness = 65534 #Set happy to max -1, (max is 65535 as of 40D)
    dbg.saveCreature(c) #save

--Kittyz 14:56, 27 January 2009 (EST) Kittyz

Compatibility[edit]

Does this work in 0.28.181.40d11? It says DF isn't running or can't be found when I try. --Simmura McCrea 18:16, 12 May 2009 (UTC)

Nope. --Bartavelle 08:48, 13 May 2009 (UTC)
Damn. Cheers anyway. --Simmura McCrea 15:25, 13 May 2009 (UTC)
Workaround: Transport save file to a 40d folder, mess around, transport it back. 40d/40d11 are mutually compatible. -Heartofgoldfish 00:18, 18 May 2009 (UTC)
Are there any plans to update the memory locations? I tried simply renaming the file to dwarfort.exe as it is in 40d but it would not work as the memory locations are out of date. Forsaken1111 06:08, 27 May 2009 (UTC)
The problem lies in the name of the file, change Dwarf Fortress.exe to dwarfort.exe and the utility will find it, gave me a memory error, but it may work for you once you have the right name. Janizary 19:39, 18 May 2009 (UTC)
"B" is for Bold. You should put this out on the wiki proper, where it will be found by those who need it - start a Linux article, perhaps. Jo no habla linuxol, but once you do it will only grow.--Albedo 15:08, 20 May 2009 (UTC)

Unknown flags[edit]

0x1 =???
dead? =Kills creature when used with 'dead'
0x4 =???
artifact =designates whether creature has created an artifact
0x10 =hostile
0x20 =???
merch1?
caravan guard?
0x100
0x200
!unitlist
liaison?
zombie
skel
working
prone
0x1.4
inv1
hidden
inv2
0x1.5
0x2.5
0x4.5
0x8.5
0x1.6
0x2.6
tame
0x8.6
r.guard
f.guard
0x4.7
0x8.7
0x1b
0x2b
0x4b
0x8b
0x10b
0x20b
0x40b
dead
vanish?
0x200b
0x400b
0x800b
0x1000b
winded?
0x4000b
ground
flying
slaughter
underwrld
can't eat
0x1.5b
0x2.5b
0x4.5b
visitor?
0x1.6b
0x2.6b
0x4.6b
0x8.6b
0x1.7b
winded?
0x4.7b
tame2

FTP SERVER DOWN![edit]

THE FTP SERVER FOR THE PyObject AND WHATEVER THE OTHER TWO ARE IS DOWN! THE DAMN FTP SERVER IS DOWN! GOD DAMN IT THE FTP SERVER IS DOWN! I NEED FTP SERVER! FTP SERVER DOWN! FTP SERVER NOT WORKING! FTP SERVER DEAD! FTP SERVER SUFFERING MANGLED HEART!

I found a site that mirrors these files (possibly not the most up-to-date ones though) http://www.filewatcher.com/b/ftp/ftp.dit.upm.es/linux/mirrors/ftp.gnome.org/binaries/win32.0.0.html

Additional in-game languages (v0.17)[edit]

If you have additional languages modded into the game, out-of-the-box DwarfCompanion 0.17 will bomb with an error:

File "[PATH]\dwarfdbg.py", line 477, in getCreature name = self.getName(c, details) File "[PATH]\dwarfdbg.py", line 323, in getName lastname = self.printName(table, lang) File "[PATH]\dwarfdbg.py", line 219, in printName lastname += self.rwords[lang][v] IndexError: list index out of range

To make it work, count the number of languages you have (but not language_SYM.txt).

Find the line in dwarfdbg.py which reads:

for race in range(4):

Replace the 4 with the number of languages you have, run again, and it should work fine.

As of 0.17c this is no longer necessary.

Loading error[edit]

I'm not sure if you actually check this, but here goes anyway.

I have all the other things installed (GTK, PYCairo, etc.), and when I click it, it simply opens a black window for a moment and closes. So I tried to run it through the command prompt, and it comes up with the following error:

C:\Games\Dwarf Fortress>dfcompanion_prototype.py
Timestamp = 0x48c330df
Traceback (most recent call last):
File "C:\Games\Dwarf Fortress\dfcompanion_prototype.py", line 409, in <module>
DFcmp = DFcompanion()
File "C:\Games\Dwarf Fortress\dfcompanion_prototype.py", line 353, in __init__
self.dd = dwarfdbg(verbose=True)
File "C:\Games\Dwarf Fortress\dwarfdbg.py", line 131, in __init__
self.configoffsets()
File "C:\Games\Dwarf Fortress\dwarfdbg.py", line 89, in configoffsets
raise "can't guess offsets if not PE"
TypeError: exceptions must be classes or instances, not str

A similar thing happens when I try to use the executable version:

C:\Documents and Settings\****\My Documents\Downloads\dist>dfcompanion_prototype.exe
Timestamp = 0x48c330df
C:\Documents and Settings\****\My Documents\Downloads\dist\library.zip\dwarfdbg.py:98: DeprecationWarning: raising a string exception is deprecated
Traceback (most recent call last):
File "dfcompanion_prototype.py", line 409, in <module>
File "dfcompanion_prototype.py", line 353, in __init__
File "dwarfdbg.pyc", line 131, in __init__
File "dwarfdbg.pyc", line 89, in configoffsets
can't guess offsets if not PE

What does this mean? How do I fix it? Did I do something stupid and obvious to mess it up? 69.109.124.77 09:37, 12 January 2010 (UTC)

Try running version 0.16: version 0.17 is for DF 40d16 only which may not be the version you are running. 12.71.14.197 13:42, 25 February 2010 (UTC)

tried running through the cmd.exe but I keep getting "the directory name is invalid"[edit]

It was flashing the black window so I tried to run it through run/cmd.exe, however it says that the directory name is invalid. I have tried several solutions, such as surrounding it with quotes (helps a little bit but not much), but I still can't get it to run. Which is a pity because I was looking forward to this. Suggestions?


Edit: I made the window flash enough times to get a glimpse of what was written, and it looks like I have a similar problem to the above poster. Pleeeeease respond, someone? :(

As above: try running version 0.16: version 0.17 is for DF 40d16 only which may not be the version of DF that you are running. 12.71.14.197 13:43, 25 February 2010 (UTC)

This information really needs to written somwhere close to the download links, I made the same error


♥Many♥ thanks, lets try it now! ☺


I'm having the same problems as the above, though with both executable versions of companion. I'm on DF 31.25. (does it even support this?)

Running the exe flashes with cannot find DF, Command prompt is no exception, any suggestions?

Buggy window[edit]

C:\blahblahblah\dfcompanion_prototype.exe:360:PangoWarning: failed to find shape engine. expect ugly output. engine-type='PangoRenderWin32', script=latin

This error message repeats twice, and I get an extremely tall, spaced window that cannot be resized. Anyone know what the deal with this is?

Is there a "this is about an older version of DF" template that can be added?[edit]

This doesn't seem to have been updated since 40d. It might be helpful to have a header to reflect that. 130.160.154.207 00:51, 7 April 2014 (UTC)