Print

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

[Kromtec]

LegendsViewer-Next: Explore Dwarf Fortress Legends in a Modern Interface!

LegendsViewer-Next recreates Dwarf Fortress Legends Mode from exported data, now reimagined for the Steam release. With a modernized browser-like interface, tables, charts, maps, you can explore people, places, and entities through dynamic tabs and lists. Seamlessly navigate complex histories by clicking names in events, maps, or search results, with new features for an enriched experience.




Download here!

Source on GitHub

README

Getting Dwarf Fortress Data for LegendsViewer-Next:

To set up your world for LegendsViewer-Next:

* Make a copy of the save you want to use
* Abandon or retire your fortress/adventure in the copied save
* Enter Dwarf Fortress Legends Mode on the copied save

Recommended Export Steps (DFHack Recommended):

1. Enter Legends Mode on your save
2. Click on Export
3. This will export the legends.xml and if you have DFHack installed it will also include legends_plus.xml for more detailed info.
   * it is highly recommended to have DFHack installed
   * without DFHack there is no data to generate a map of the world
   * lots of other data is missing
   * the Steam version of DF still misses some data, that was available in old versions like site populations for example
4. You can find the exported data in the main Dwarf Fortress folder

New Features

Using the latest .NET for backend and Vue3 for frontend, Legends Viewer is now finally multi platform (win, linux, osx)
Updated UI with Vue3: Smooth and responsive browser-style navigation with tabs and a sleek interface.
Interactive Map with Layer Controls: Powered by Leaflet.js, toggle site ownership and zoom into details.
Enhanced Family Tree Visualization: Built with Cytoscape.js, view relationships in a detailed, interactive display.
Chronicles of World Events: Explore significant events like wars, journeys, ceremonies, and more with a dedicated event log.

Screenshots of LegendsViewer-Next:

Overview of known Worlds:

Spoiler (click to show/hide)

World Summary:

Spoiler (click to show/hide)

World Map:

Spoiler (click to show/hide)

Historical Figure Infos:

Spoiler (click to show/hide)

Big Size Family Trees:

Spoiler (click to show/hide)

Events:

Spoiler (click to show/hide)

Chronicles:

Spoiler (click to show/hide)

Changelog Highlights

New Features
* Fully rebuilt backend and frontend for the latest Dwarf Fortress version on Steam or itch.io
* Multi platform (win, linux, osx)
* Overview of previously loaded worlds, with thumbnails, timestamps and other infos
* Charts of world population or biome distribution
* Interactive map with locations and ownership of sites
* Maps of the location of underground regions
* Optimized performance for handling large XML files
* Can still read Pre-Steam exports and use old exported maps if newer infos are missing
* Paginated world objects, events and chronicles
* Improved data visualization of chronicles

[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.