v50 Steam/Premium information for editors
- v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
- Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.
Editing XML dump
Jump to navigation
Jump to search
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
If you are creating a redirect to the current version's page, do not use any namespace. For example: use #REDIRECT [[Cat]], not #REDIRECT [[Main:Cat]] or #REDIRECT [[cv:Cat]]. See DF:Versions for more information.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 5: | Line 5: | ||
{{old|v=50.01}} | {{old|v=50.01}} | ||
− | An '''XML dump''' of a world's history can be generated from [[Legends]] mode by pressing {{k|x}}, and will be placed in the ''Dwarf Fortress'' root folder. The dump consists of many internals ''Dwarf Fortress'' tracks about the world in [[wikipedia:XML|XML format]]. Be warned that the generated XML file can be quite large, even a gigabyte or more, especially for long-lived worlds with many [[historical figure]]s. The dump is currently incomplete and is missing a lot of data about the world. The third-party utility [[Utility:DFHack|DFHack]] can output a more thorough legends_plus.xml dump that | + | An '''XML dump''' of a world's history can be generated from [[Legends]] mode by pressing {{k|x}}, and will be placed in the ''Dwarf Fortress'' root folder. The dump consists of many internals ''Dwarf Fortress'' tracks about the world in [[wikipedia:XML|XML format]]. Be warned that the generated XML file can be quite large, even a gigabyte or more, especially for long-lived worlds with many [[historical figure]]s. The dump is currently incomplete and is missing a lot of data about the world. The third-party utility [[Utility:DFHack|DFHack]] can output a more thorough legends_plus.xml dump that includes at least some of the missing information. |
== Format == | == Format == | ||
Line 28: | Line 28: | ||
Versions of DFHack made for Dwarf Fortress 0.47.01 and later should not suffer from this problem. | Versions of DFHack made for Dwarf Fortress 0.47.01 and later should not suffer from this problem. | ||
− | == Contents of the | + | == Contents of the XML file == |
− | + | The XML file has, at the top-level, the `df_world` node. This contains 14 child nodes, each of which acts as a list of identical child nodes. The nodes are as follows: | |
− | |||
{| class="wikitable" | {| class="wikitable" | ||
|+ df_world format | |+ df_world format | ||
|- | |- | ||
− | ! Parent node !! Individual node name !! | + | ! Parent node !! Individual node name !! content |
|- | |- | ||
| regions || region || A named region of the world map. | | regions || region || A named region of the world map. | ||
Line 41: | Line 40: | ||
| underground_regions || underground_region || An unnamed underground region of the world map. | | underground_regions || underground_region || An unnamed underground region of the world map. | ||
|- | |- | ||
− | | sites || site || A site on the map with structures | + | | sites || site || A site on the map with a location, site type, and structures contained. |
|- | |- | ||
− | | artifacts || artifact || Artifacts with their associated written content, location | + | | artifacts || artifact || Artifacts with their associated written content (if books, scrolls, etc.) or location (if lost) or holder (if wielded). |
|- | |- | ||
− | | world_constructions || world_construction || | + | | world_constructions || world_construction || |
|- | |- | ||
− | | historical_figures || historical_figure || | + | | historical_figures || historical_figure || |
|- | |- | ||
− | | entity_populations || entity_population || | + | | entity_populations || entity_population || |
|- | |- | ||
− | | entities || entity || | + | | entities || entity || |
|- | |- | ||
− | | historical_events || historical_event || | + | | historical_events || historical_event || |
|- | |- | ||
− | | historical_event_collections || historical_event_collection || | + | | historical_event_collections || historical_event_collection || |
|- | |- | ||
− | | historical_eras || historical_era || | + | | historical_eras || historical_era || |
− | |||
|- | |- | ||
− | | poetic_forms || poetic_form || | + | | poetic_forms || poetic_form || |
|- | |- | ||
− | | musical_forms || musical_form || | + | | musical_forms || musical_form || |
|- | |- | ||
− | | dance_forms || dance_form || | + | | dance_forms || dance_form || |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||