Skip to content

strainer/cavekeeperdf

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kloker (fka Cavern Keeper)

This is a much extended dfhack labor manager plugin.

screenshot1

screenshot2

It includes these improvements:

  • Units characters are summarized in great detail as they are focused in listing.
  • Sorting of unit list is powerful and simple to control.
  • Units physical and mental scores, and units conditions (pregnant, noShoes, needs doctor, wounded etc) can be easily browsed.
  • DFhack autolabor is integrated, enabling easy assignment of outstanding tasks to selected units.
  • Colorful highlighting indicates which jobs and roles each units are especially good or bad at (beyond their plain skill level which is also displayed).
  • A fair cheat feature is included so dwarfs skills can be revised immediately after embark, since they are much easier to examine in kloker than in the embark preparation screens.
  • Kloker can also open and display the intresting details of pets, visitors and others, monsters etc. and can also nickname pets and visitors.
  • Kloker's UI has multiple refinements over the basic labor manager to make it easier to use often, such as persistent focus and selection, and jumping straight to units from the game map.

Availability

The latest version is only currently available for linux DFHack version 0.47.05-r2, it is included in the pack found here:

Bay12 lnp-forge LinuxDwarfPack

Hopefuly more compiles will be sorted out before long, or Kloker can make it into DFHack or a Windows pack.

Archived previous (development) versions.

Compiles for starter packs are located in the following directories:

Linux DFHack 47.03 beta 1

Win64 DFHack 47.04 rel 1

Linux Newbie Pack ver. 44.12 r03 (pack here)

Linux Newbie Pack ver. 44.12 r1

Linux Newbie Pack ver. 44.10

Windows64 Peridix's starter Pack ver. 0.44.12-r04

Windows64 Peridix's starter Pack ver. 0.44.12-r05 (pack is here)

For MacOS DFHack ver 44.12-r2

The development plugin file is called "manipulator.plug.so" for linux, "manipulator.plug.dll" for windows and "manipulator.plug.dylib" for MacOS. The file goes into the directory '../(df_directory)/hack/plugins' or '..\dwarf fortress\hack\plugins' on windows. Overwritting the legacy manipulator plugin.

Running

To open Kloker in fortress mode press 'u' (for unitlist) and then 'k' for kloker. It can also be opened on the listing screens for pets and visitors and the dead. It can also open on the map.

It behaves similar to the legacy dfhack labor manager. Adjust Klokers extended abilities by pressing the keys displayed in the menu next to 'Mode'. A tooltip appears to help understand setting changes.

Here is a intro and discussion on the plugin at bay12forum. Feedback there is appreciated.

Extra configs:

Alternative keeper color pallete:

The file dfkeeper_pallete.txt is optional and disabled but can be used to customise the theme colors. It can be saved into the directory ..\[dfhome]\kloker\ and can be edited with a text editor for tweaking.

Game's color pallete tweaked for nice text as well as graphics:

colors.txt is the default LNP pallet tweaked to balance text readablity and graphics look. It can be saved on top of ..\[dfhome]\data\init\colors.txt

Keypress Timings:

DF's default keypress timings seem really sluggish to me. Here are my tweaked keyboard speed settings, they go near the bottom of ~lnp\df_linux\data\init\init.txt

[KEY_HOLD_MS:250]
[KEY_REPEAT_MS:133]
[KEY_REPEAT_ACCEL_LIMIT:20]
[KEY_REPEAT_ACCEL_START:2]

Also the game Zoom setting works nicely with much smaller increments than default setting of 10 ( allows finding better pixel ratios too )

[ZOOM_SPEED:3]

Development:

To make a compile it is necessary to place kloker.cpp it into /plugins/ in a full dfhack repo and follow DFhack's excellent compiling instructions.

The latest sourecode file is in /plugins directory. It has a complete but messy commit history since I worked in and merged a few branches.

Hopefuly this can go back to dfhack sometime. It seems quite well tested and stable.