Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[strainer]

Cavern Keeper extends manipulator, Dfhack's in-game labor manager with advanced colorful display features. The full personalities of dwarves, pets and visitors can be quickly browsed, easily sorted into groups and subsorted. Their physical stats can be displayed, their best labors and abilities are highlighted and their conditions and problems listed.

On starting a new game, the 'mode' keys set the options for level of skill highlighting, 1 to 3 lines of character summaries, name translation, color theme, werecreature & vamp notice and other cheat options.

Here is an expedition leader automatically selected by embark profile, her description reveals she is "extremely fierce" with other good qualities, and respects combat, hates sacrifice but nobody's perfect. Seems a good choice for a captain ;

The summary lines are carefully formatted to not jump around while browsing through the list. The characters age and focus level are shown, their most useful liked items, dreams, priorities and gods. Also the characters traits are summarized in greater detail than in their long game description, using refined adjectives that indicate the in game effect of each trait.

Here is Nil Wheeledsyrups long description for comparison :


Mind and Body Attributes View:
    A characters mind and body attributes have a big effect on how well it performs at different jobs, and different jobs exercise and improve relevant attributes. (Military training is also good at improving some attributes)

In this view the attributes relevant to each job are highlighted white, but the next screenshot is focused on a cat and its climbing ability. The screenshots following this pompous cat show white highlighted attributes...

A characters mind and body attributes have a strong effect on the jobs/activities it can do best, so cavern keeper calculates "aptitude scores" and colors the activation grid to indicate the best and worst performing jobs. For the character and job in focus, the aptitude score is also printed along with experience and skill rating. See later screenshots, this cat is a bad example. Sorry, Shoo !


Next a screenshot of the post embark cheat-mode mysteriously titled "Whims of Laven". Since dwarves are much easier to assess here than in the embark preparation screens, this feature allows skill points to be redistributed, but keeps track to make sure extra are not added.
In this screenshot units are also sorted by "medic" which ranks most highly generous and non-sadistic personalities. The top dwarf looks like a decent leader/manager type so...


Here it is on attributes tab again and redistributing the whims of Laven to make Glovedikes a better leader.


This is the help screen showing the meaning of the attribute grids header.


There are some more tips in the help screen but it currently needs to zoom out to show everything.

Cavern keeper is not difficult to navigate. Control of sorting is simpler than manipulator, yet the sorting options are much improved. The Tab key changes what is displayed beside the labor grid (professions, squads, current activities, notices or body attributes). A couple of mode keys cycle through color and theme tweaking options, configuration and focus is persistent. All the control keys are displayed in the footer, the only controls which are not obvious are for the cheat options.
 
Cavern keeper is available for the latest DF44 Windows and Linux and MacOS* 64bit newbie packs:
 
    O=[:::::::>    this way for the Caverns    <:::::::]=O


* Thanks to user:venicedreamway forging the latest version for MacOS miners !

[jecowa]

Is this a plugin for DFHack? Can this plugin only be used when starting a new game? "Lagacy mode" means fortress mode I hope?

[strainer]

Yes its a dfhack plugin for dwarf mode - its actually the current dfhack labor manager plugin improved and can be installed on top of it (manipulator). Im giving it a new name because its really improved a lot and i prefer a fantastic name. I also have to get it tested and in demand before dfhack can take it back, which is fair enough.

By "legacy" mode i just meant it starts with character summaries and with labor highlighting turned off - it looks very similar to "manipulator" then.

Its not just for starting a new game, although that cheatmode is designed just to be able to revise embark skills without feeling too cheaty. There is a "deeper" cheatmode that lets attributes be changed as well as skills, freely - but thats proper cheating.

There is also a 'notices' listing which lists dwarfs health issues, curses, and things which becomes useful later in the game. And the summaries include when dwarves become cave adapted, hardened, and other things. And the "fcs+0" in the summary readout shows how focused units are on a scale -9 to +9, should be useful later. I havent had time to play a proper game with the latest summaries yet...

[Novaris]

Looks very interesting

[strainer]

Being able to scroll quickly through so much info is fascinating, potentially overwhelming. The detail level can be turned down, but I prefer to see it all.

I was suprised this evening to notice that while dogs are running in and out of the temple they have been worshiping deities - different deities from their owners, but dwarf deities. ( The other, noticably distressed dogs in this screenshot are burrowed in the hospital btw...)



Here is a big screen showing off the sort features 'group highlighting' Here the arrival groups are shown, and name, focus, skill, personality and score sub-sorts can be applied within the groups. This make it easy to review arrival groups or squads or a custom selection.

[Stiqy]

I am not a programmer, so what is a .so file? Is there a place to just download the plugin already compiled to install?

[strainer]

If you are on linux the .so file is the compiled plugin. Just save it on top of the manipulator.plug.so in that same newbie pack, then in will be accessible in the game.

Or if you want to try it on an earlier df linux version, I can make a compile for it if you let me know which (these plugins need made for the precise version)

fraid I cant make any windows compiles at the moment.

[Stiqy]

If you are on linux the .so file is the compiled plugin. Just save it on top of the manipulator.plug.so in that same newbie pack, then in will be accessible in the game.

Or if you want to try it on an earlier df linux version, I can make a compile for it if you let me know which (these plugins need made for the precise version)

fraid I cant make any windows compiles at the moment.

Ah, my bad... I was missing the detail that this was Linux only and was looking for a windows version. May have to fire up MINT again, this looks very helpful. Nice work.

[strainer]

Thanks - I should have windows compiles in a week or so.

[bwbill]

I registered just to say I love this, and I'm eagerly awaiting the version for Linux 44.05-r01. Thank you!

Edit: looks like it's updated on github! Thanks again!

[strainer]

That's great to hear thanks  
Let me know if you find any issues or things to tweak.

[bwbill]

I couldn't find the cheat mode in the new version, but that's probably for the better.

Would you be willing to provide an overview of recent changes? I've never done a version diff with github but I could grok a diff if it's too much to type a changelog during active development...

[strainer]

I polished the cheat modes a bit in last commit, making them count skills the same way embark does (costs 3 points to boost skill from 2 to 3). To get to the lesser cheat mode press Shift-T a few times. Cheat turns off when keepers viewscreen exits, but it remembers 'banked' skill points for when it is next activated. For unlimited points and the ability to change mind and body attributes, sacrifice a dozen shift-t presses. After this mode is activated it stains part of the theme blood red for the rest of the game... thats all.

Source code wise:

My development commits have been 'overstuffed', they number about 45 with most of them on whitespace, formatting and debugging but they are logged here:

github.com/strainer/dfhack/commits/manipu_remix

The original 'manipulator.cpp' has 7800 commits since 2009. It was about 1000 lines of code and quite neat in October. Ive added about 2500 lines of code, overall not neat but some good efficient number crunching and stuff - lots of features. I should sometime refactor and neaten it up so it can go back on dfhacks historic repo. But now it seems to be working and stable, I like to imagine its fully debugged and (almost) feature complete.

edit:doh! That was the entire history of dfhack.

[strainer]

I made a windows compile finally for DF44.05.r02

It can be found here.

[Boltgun]

Nice, I use the labor manager all the time and I'll definitely try it out.