Not Maintained - (2019-09) This project was a learning excercise. Now we all play on the servers it's redundant.
A Python program to analyse your Dungeon Crawl Stone Soup morgue folder, collate metrics, spot patterns and give hints.
- Version: 0.1 'mucking about with python'
- Release date: tba
- Maintainer: MarshP (marshp.vcs@gmail)
This tool is in pre-pre-nascent-alpha I'm doing this to help me learn Python, though other contributions may make it somewhat useful.
This readme contains only a quickstart, but that should be enough for most users.
More detailed user docs are on the project documentation pages
Contributor docs and discussions are in the project wiki.
- Ensure Python 3 (download) is installed
- Copy the
.pyfiles in thedcss_morgue_analyser/directory to your DCSScrawl/morgue/directory
- On Windows look in
%AppData%for the crawl directory - If you intend to analyse a subset of your morgue, such as characters of one species/profession, copy those files to a new directory and use that in place of the morgue
- In the morgue directory open a shell or command prompt:
$ Python ./morgue-analyser.py - Look for an output file called
dcssma-analysis.txt. This will look prettier if opened in a mardown-enabled reader.
If you spot something, raise an issue or -- as you can almost certainly code better than I can -- fork and fix. :0)
DCSSMA will start life as a simple script which takes the morgue folder location as a command line arg. It will parse the morgue .txt files and use some pretty blunt regex work to produce some metrics and report them.
Later I hope to add more efficient data handling, more refined analysis, and maybe a gui or interactive file selection shell. Maybe some link to webtiles...
The plan is for min, max and useful derived figures -- median, mean, SD and so forth -- for a variety of metrics. But we're guided by useful questions.
- How far does the player usually progress, in terms of dungeon exploration, time/turns played, XP/XL and skills?
- What usually kills the characters, and how, and where?
- Are there avoidable issues? Including:
- unidentified items while i.d scrolls are available,
- unused heal wounds pots at HP death,
- under-used god abilities with high piety,
- unspent gold
- enchant armour/weaps scrolls gained early and unused
- ...and other gameplay smells to be added
- What is the progress on primary skills for the background and species, or the skills with best species aptitude?
And how does all that differ when the player plays different species, backgrounds and classes of background like warrior, zealot or mage?
No copyright claimed on top of whatever arises naturally from publishing the repo contents in any given jurisdiction .
License is WTFPL.