Bay 12 Games Forum

Please login or register.

Login with username, password and session length
Advanced search  

Show Posts

This section allows you to view all posts made by this member. Note that you can only see posts made in areas you currently have access to.

Topics - Parker147

Pages: [1]
1
DF Suggestions / Legends XML Dump Suggestions
« on: December 21, 2010, 07:40:15 pm »
With version 34 we got some new XML data, but I don't like the way that we were given some of it. I want to give a suggestion on how to go about changing it so that it would be easier to use. Also, including a list of all the missing data from the XML as a reference for myself and for others.

Issue: Unnecessary Historical Figure / Entity / Site Link Properties
Description:
      -We already have events that relate to these properties, mostly. The data is missing though as shown below.
      -If loading XML in order and building links as you go, link properties reference historical figures/entities that haven't been loaded yet.
      -If the data for those events were to be filled in, we would still be missing a way to build the Parent/Child relationship since there is no birth event.
      -HF to HF and Site links are only the most current, doesn’t contain previous links. Entity links do though contain previous links.
Suggestion: Remove the entity link / historical figure / site link properties from historical figures and let the add/remove link events cover this data. Add simple Mother/Father properties to make up for the lack of a birth event. This will allow for creating a complete history of links.

Issue: Missing XML Data
Description: I've listed below all data that is needed to complete the XML so that legends mode can be 100% remade from the XML. Some of the major data that I thought wasn't intentionally left out I put into this bug report.
Spoiler: Missing Data (click to show/hide)

2
Utilities and 3rd Party Applications / Legends Viewer 1.13 (v40 Compatible)
« on: December 09, 2010, 09:30:46 pm »
Get it here: http://dffd.wimbli.com/file.php?id=3556

Source: https://github.com/Parker147/Legends-Viewer

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.

Screenshots

Getting the data from Dwarf Fortress:
  • Enter Legends Mode. If you are already playing a fort or adventure on the save you want to use, you need to:
                1. Make a copy of your save!
                2. Abandon your fort/adventure on the copy
                3. Enter legends on the copy
  • Export the XML (x).
  • Export Map/Gen Information (p).
  • Export Detailed Map (d) > Standard biome+site map.
       or
       Use the ASCII/Tile map exported from step 3.
  • (Optional) Archive/Compress files
  • (Optional) Export Additional Detailed Maps

Opening the data with Legends Viewer:
    Select the XML or Archive first by pressing the "..." button next to the XML / Archive text box.
    Legends Viewer will attempt to automatically find the remaining files.
    If the viewer was unable to locate a file it will indicate which files by turning the text box red. You will then have to manually select those files by pressing the "..." button for each file.
    The files needed are (which will be dumped in the root Dwarf Fortress directory)
        "save"-legends.xml
        "save"-world_history.txt
        "save"-world_sites_and_pops.txt
        Map Image file

Using Legends Viewer: View the ReadMe for details on how to use the various tools.
      
Things to note:
  • XML dump is incomplete! Anywhere that there are details left out I noted with "UNKNOWN" however if you see "INVALID" any then its a bug that needs to be fixed.
  • Duplicate Historical Figures / Entities in summary log indicate that relations for duplicates may not be setup properly you will have to check History/Site files to view these relations.
  • Bigger worlds will perform slower. Some pages with a lot of activity can take a few seconds to load. Be careful in the Era tab with events and era length, all events are filtered out by default. Selecting too many events and a lengthy era can result in GBs of memory being used and can take some time to generate the page.
  • Requires .NET 4 (http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff4-4491-b0e5-b386f32c0992&displaylang=en)

Archive Support
   -Tested with (zip/7zip/rar)
   -Must have these files in the archive
      -XML file
      -history file ending with "-world_history.txt"
      -sites and populations file ending with "-world_sites_and_pops.txt"
      -Map Image files (bmp/png/jpg/jpeg)
   -Any other files in the archive will be ignored without error.   
   
Troubleshooting
  • If images aren't showing up in pages or navigating pages doesn't work try updating Internet Explorer to the newest version.
  • If you encouter errors while loading files, first try restarting Dwarf Fortress and re-export all the files. If it still happens after that you can send me your files or world gen parameters and I will look into it.

Pages: [1]