Print

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

[Kromtec]

Recreates Legends Mode from exported data. Browser like navigation, including tabs, allows to easily view other people/places/entities by just clicking names in the event logs or search lists, CTRL+Click opens a new tab.

Download here!

Source!

README

Getting the data from Dwarf Fortress:
If you are already playing a fort or adventure on the save you want to use, you need to:
* Make a copy of your save!!!
* Abandon or retire your fortress/adventure on the copy
* Enter DF legends mode on the copy

Recommended: (requires DFHack which is usually included in Lazy Newb Pack)
1. Enter DF legends mode on the save you want to export
2. Switch to the DFHack window
3. Enter the command `exportlegends info` and press enter
  * this command generates all files you need and an additional file with the ending legends_plus.xml
  * the legends_plus.xml file contains a lot of information that is missing if you export via the old way

Or use the old way:
1. Enter Legends Mode.
2. Export the XML `(x)`
3. Export Map/Gen Information `(p)`
4. (Optional) Export Additional Detailed Maps `(d)`

* (Optional) Archive/Compress files

NOTE: If you see a lot of UNKNOWN stuff it is because of this:

XML dump is incomplete! Anywhere that there are details left out I noted with "UNKNOWN" however if you see any "INVALID" then its a bug that needs to be fixed.

If you export the data with DFHacks' `exportlegends info` a lot of additional data is available and you will get less "UNKNOWN" information.

Screenshots:

Familytree:

Spoiler (click to show/hide)

Curse Lineage:

Spoiler (click to show/hide)

Regions:

Spoiler (click to show/hide)

Sites with Structures:

Spoiler (click to show/hide)

World Constructions (Roads, Tunnels):

Spoiler (click to show/hide)

Structures (Taverns, Libraries, ...):

Spoiler (click to show/hide)

Written Content:

Spoiler (click to show/hide)

Leadership Information:

Spoiler (click to show/hide)

Changelog:

Spoiler (click to show/hide)

# Bugfixes + Performance

- fix for crash if a vault was conquered (parent of the vault entity was null)
- various performance tweaks


**Note:**
_Use 'exportlegends info' or 'exportlegends all' of [DFHack](https://github.com/DFHack/dfhack/releases) to get lots and lots more info and less UNKNOWN data. The new legends_plus.xml features require [DFHack](https://github.com/DFHack/dfhack/releases) which is usually included in the Lazy Newb Pack for exporting the additional XML file!_

Older Changelogs:
See on Releases page on GitHub

[PeridexisErrant]

PTW

[notfood]

Do you think it'd  be possible to run it under Mono?

[Witty]

Awesome! I really appreciate you taking over for Parker here, this is one of my favorite third party utilities. Be a shame if it just went under with this new version.

[Kromtec]

Do you think it'd  be possible to run it under Mono?

Sorry, I won't have the time to rewrite larger core components of the program especially with tools I am not familiar with.
But I will definitly do my best to keep it alive and healthy.

[jaked122]

Mono is an implementation of .Net for Linux, Mac OSX, and Windows. It is not the Microsoft version, though Microsoft has contributed significantly to the development of Mono.


 You may wish to familiarize yourself with the ecosystem of .Net, but hey, good job updating.


Let's run through a checklist, does it use the Windows Forms for gui? Check.


Does it use an external library that is specific to Windows? Yes. It uses 7Zip.dll, which is written in C, rather than a portable C# implementation. That may be an issue, I'm not sure if it is possible to change the linking so that it would use a Linux version of the library. It looks like it would probably require some modification in order to allow it to work on both, I'm not set up for that right now though.

[Shonai_Dweller]

Odd entry in Legends Viewer for a world I just generated. I'm using a modded in race of minotaurs, but I don't think that'd cause this:

"In 258, early summer, (Hematite, 15) the hydra Cavere Largespecial the Growth of Blisters fought with Ingiz. While defeated, the latter escaped unscathed. In The 2nd rampage of Cavere Largespecial the Growth of Blisters in Gemwondered as part of a competition."

Awesome that the 1 year old Ingiz Gildrush survived a hydra attack. Odd that it was part of a competition...!

DF Legends mode records the attack, but not as a competition.

Interestingly, Ingiz went on to become a farmer, then suddenly at the age of 19 began worshiping rocs.  4 of them at first. A couple of years later she became queen and added another roc to her God list. She worships a hydra on the side too (not the one that tried to eat her as a child).

[Kromtec]

Odd entry in Legends Viewer for a world I just generated. I'm using a modded in race of minotaurs, but I don't think that'd cause this:

"In 258, early summer, (Hematite, 15) the hydra Cavere Largespecial the Growth of Blisters fought with Ingiz. While defeated, the latter escaped unscathed. In The 2nd rampage of Cavere Largespecial the Growth of Blisters in Gemwondered as part of a competition."

Awesome that the 1 year old Ingiz Gildrush survived a hydra attack. Odd that it was part of a competition...!

DF Legends mode records the attack, but not as a competition.

Interestingly, Ingiz went on to become a farmer, then suddenly at the age of 19 began worshiping rocs.  4 of them at first. A couple of years later she became queen and added another roc to her God list. She worships a hydra on the side too (not the one that tried to eat her as a child).

That is really strange. I just looked through some bigger worlds and it seems common now, that beast attacks have a "parent_eventcol"-property set with IDs that link them to event collections of competitions, ceremonies, ...

Tomorrow when I am at home, I will take a look at older 0.40.xx worlds if beast attacks have meaningful "parent_eventcol"-properties there.

Edit:
I checked and couldn't find one beast attack that was linked to a parent collection in 0.40.xx worlds.
Now in 0.42.xx a lot of beast attacks happen to be during special occasions. What's very weird is that the linked occasion always has the exact same start- and enddates as the attack. I could understand if there is a ceremony that gets interrupted by an attacking beast, but in that case the ceremony should start before the attack, not in the same second.

If DF Legends Mode doesn't show it, I'll call it a bug and won't show it in the next version either.

Thanks Shonai_Dweller for reporting.

[Shonai_Dweller]

Didn't Toady say some festivals are set up in memory of beast attacks/beast defeats. That would require linking one to the other presumably. And while they should probably start a year later, it might be easier for world-gen to start them at the same time for some reason.

[Heretic]

Changelog 1.14.02:

Spoiler (click to show/hide)

# World Stats + Populations + Artifacts

### World Stats
* Added a chart for civilized world populations
* Split civ-list into current and fallen civilizations
* Added population and site count information for each civilization

### Population Lists
* Populationlists on entity and site pages are now split into
  * Civilized Populations
  * Animal People Populations
  * Outcasts
  * Prisoners
  * Slaves
  * Other Populations

### Artifacts
* Artifacts have now their own tab (in collections)
* They are searchable and can be filtered by eventtypes

### Navigation
* Restructured navigation tabs
* Wars, battles, conquerings, rampages are grouped into warfare
* Collections includes eras and artifacts
* Regions includes overworld and underground regions

### Bugfixes:
* Kobold groups and sites were never properly linked to their parent civilization
* Various smaller bugfixes

### Tweaks
* Removed link between beast attacks and parent event collections, until more
  information is available how they are connected
* Lots of style changes to the generated HTML pages

**Note:**
To display the new population chart correctly you will need IE9+ rather than IE7+ as previously.

Changelog 1.14.01:

Spoiler (click to show/hide)

# Bugfixes + HTML-Pages overhaul

### New Event
* Added support for "Artifact Destroyed" event

### Bugfixes:
* Clicking buttons before a world is loaded doesn't lead to crashes
* A lot of fixes for NullReferenceExceptions connected to various events
* Made parser for sites_and_pops.txt file robuster
  * Missing "Civilized World Populations" section doesn't lead to crash

### HTML-Pages:
* Valid stand-alone HTML pages are generated
* Style information removed from page content
* Styles are now defined in internal separate stylesheet file

### Tweaks
* resolved some site conflicts
* resolved some cases of duplicated historical figures
* Display of existing events
* Unify layout and structure of all generated pages
* Added "Civilized World Population" section to World Summary
* Added README.md to root of project

Changelog 1.14.00:

Spoiler (click to show/hide)

# Added support for DF 0.42.XX features

### New Historical Events:
* Procession
* Ceremony
* Performance
* Competition
* Poetic Form Created
* MusicalForm Created
* Dance Form Created
* Written Content Composed
* Knowledge Discovered
* HF Relationship Denied
* Region Population Incorporated Into Entity

### New Event Collections:
* Occasion
* Procession
* Ceremony
* Performance
* Competition

### New Site Link Type:
* Occupation

### New HF Link Type:
* former apprentice
* former master

### Tweaks
* Display of existing events

Where I can see ceremonies and other new events? I can't find them in program. Using with 42.03 DF.

[Staalo]

Good work! I have been running my own modded version of Parker147's original code to keep Legends Viewer relevant for .40/.42 but I'm going to switch over to this. Thank you.

[Kromtec]

As some of you may have already seen. I released Version 1.14.02 today!

Download here!

When ever I fired up Legend-Viewer in previous versions the first thing I did was to go through the individual civilization pages.
I wanted to get an idea of the distribution of powers in my newly generated world.

How many fortresses do this dwarven civilization have?
How strong is their population compared to the goblin civilization next door?
Is the civ I want to play even composed of dwarves or mainly of goblins and humans?
Will I get visits from the kobold civs or are they already extinct?
...

My main goal with this release was essentially to get a good overview of all this things without having to navigate through a lot of pages.

Instead of only a list of civilization names you now get more detailed information on top of the world stats page.



Next to the map is a chart of the civilized world population distribution.
The list of civilizations is split into current and fallen civilizations.



One entry of a civilization shows the portion of people from the original civ-race + the portion of people from other civilized races that migrated into this civ.
You also get the number of sites that are currently owned by this civ.


If you navigate to an entity (civ, group, ...) or site instead of one list for all population information you now get grouped lists for civilized, animal people, outcasts, prisoners, slaves and others.

Changelog 1.14.02:

Spoiler (click to show/hide)

# World Stats + Populations + Artifacts

### World Stats
* Added a chart for civilized world populations
* Split civ-list into current and fallen civilizations
* Added population and site count information for each civilization

### Population Lists
* Populationlists on entity and site pages are now split into
  * Civilized Populations
  * Animal People Populations
  * Outcasts
  * Prisoners
  * Slaves
  * Other Populations

### Artifacts
* Artifacts have now their own tab (in collections)
* They are searchable and can be filtered by eventtypes

### Navigation
* Restructured navigation tabs
* Wars, battles, conquerings, rampages are grouped into warfare
* Collections includes eras and artifacts
* Regions includes overworld and underground regions

### Bugfixes:
* Kobold groups and sites were never properly linked to their parent civilization
* Various smaller bugfixes

### Tweaks
* Removed link between beast attacks and parent event collections, until more
  information is available how they are connected
* Lots of style changes to the generated HTML pages

**Note:**
To display the new population chart correctly you will need IE9+ rather than IE7+ as previously.

[Shonai_Dweller]

Looks very nice!

I've found previously Legends Viewer has been slightly misleading when it comes to nearly dead civs. Bring up the civ stats and it says 'no sites since 400 years ago' but boot up World Viewer and you find 86 members of the civ living in a nearby refugee camp. DF Adventurer allows you to start at the camp and fortress mode usually allows you to play as them.

Does this new 'fallen civs' actually indicate no playable population, or just no sites? Civs in a bad way make for fun stories.

Also are civilized animal people listed in populations?

[Shonai_Dweller]

OK tried this out now. It's nice. But you've made it incompatible with mods.
Legends Viewer is good because it throws up information about whatever you mod into it. It's great and flexible that way.

I've got a fairly normal world which I've modded an extra race of minotaurs into.

But in new Legends Viewer:
Minotaurs don't show up on the opening graph.
Each Minotaur civ is listed as having no original race members left (lie)
The civilized population of one of my Minotaurs civs apparently consists of Dwarves, Elves, Humans and goblins (despite the population of 8764 minotaurs, who I'm pretty sure are civilized in their own misguided way)

I like the 'was slowly repopulated' information. That's good to know.
Also the what's the top graph total number calculated from? It doesn't match Site Populations. Is it including outcasts?

[Kromtec]

OK tried this out now. It's nice. But you've made it incompatible with mods.
Legends Viewer is good because it throws up information about whatever you mod into it. It's great and flexible that way.

I've got a fairly normal world which I've modded an extra race of minotaurs into.

But in new Legends Viewer:
Minotaurs don't show up on the opening graph.
Each Minotaur civ is listed as having no original race members left (lie)
The civilized population of one of my Minotaurs civs apparently consists of Dwarves, Elves, Humans and goblins (despite the population of 8764 minotaurs, who I'm pretty sure are civilized in their own misguided way)

I like the 'was slowly repopulated' information. That's good to know.
Also the what's the top graph total number calculated from? It doesn't match Site Populations. Is it including outcasts?

Can you upload a legend export? I'll try to make the new features as generic as possible with the next version.
The total numbers in the chart come from the regionx-xxxx-xx-xx-world_sites_and_pops.txt file.