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 v0.31: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.
You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "v0.31"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.
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 1: | Line 1: | ||
− | + | An XML dump of a world's history can be generated from [[Legends]] mode. | |
− | + | ||
+ | The XML file this produces is currently not well-formed, lacking a root element that encapsulates the other contents of the dump. Some XML manipulation programs may need to have this taken into account to handle the file properly. | ||
The XML dump consists of the following elements: | The XML dump consists of the following elements: | ||
Line 16: | Line 17: | ||
**Mountains | **Mountains | ||
**Glacier | **Glacier | ||
− | |||
− | |||
− | |||
− | |||
==underground_regions== | ==underground_regions== | ||
Line 42: | Line 39: | ||
**cave | **cave | ||
**dwarf fortress | **dwarf fortress | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
*coords - an X, Y coordinate giving the location of the site on the world map. | *coords - an X, Y coordinate giving the location of the site on the world map. | ||
Line 57: | Line 44: | ||
Each site may contain a <structures> tag. | Each site may contain a <structures> tag. | ||
− | |||
− | |||
− | |||
== historical_figures == | == historical_figures == | ||
− | The <historical_figure> elements contain the | + | The <historical_figure> elements contain only the very most basic information: |
− | *id | + | *id |
− | *name | + | *name |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | Other information such as | + | Other information such as birth and death dates are stored in the historical_events element. |
== entity_populations == | == entity_populations == | ||
Line 236: | Line 60: | ||
Each <entity> element contains an id tag, and may also contain a name tag. | Each <entity> element contains an id tag, and may also contain a name tag. | ||
− | |||
− | |||
==historical_events== | ==historical_events== | ||
Line 243: | Line 65: | ||
The <historical_event> element is the most complex. Each contains: | The <historical_event> element is the most complex. Each contains: | ||
− | * id - a reference number | + | *id - a reference number |
− | * year - the year in which the event took place | + | *year - the year in which the event took place |
− | * seconds72 - | + | *seconds72 - |
− | * type - a label indicating what sort of event this is. | + | *type - a label indicating what sort of event this is. |
The other elements of the historical_event will depend on the contents of the type element. Types include: | The other elements of the historical_event will depend on the contents of the type element. Types include: | ||
− | |||
− | |||
− | |||
− | |||
=== add hf hf link === | === add hf hf link === | ||
− | This is an event that links two historical figures (hf) together. | + | This is an event that links two historical figures (hf) together. This event could either be a marriage, the beginning of hfid worshipping hfid_target, or something else. |
− | * hfid | + | *hfid |
− | * hfid_target | + | *hfid_target |
===add hf site link=== | ===add hf site link=== | ||
− | |||
This event shows that some (unexported) HF took up residence in some site (site_id) | This event shows that some (unexported) HF took up residence in some site (site_id) | ||
− | * site_id | + | *site_id |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== attacked site === | === attacked site === | ||
This is an event that marks when a group (attacker_civ_id) attacked another group (site_civ_id) at a site (site_id) owned by a civ (defender_civ_id). The attack was led by a HF (attacker_general_hfid) and the defense was led by another hfid (defender_general_hfid). | This is an event that marks when a group (attacker_civ_id) attacked another group (site_civ_id) at a site (site_id) owned by a civ (defender_civ_id). The attack was led by a HF (attacker_general_hfid) and the defense was led by another hfid (defender_general_hfid). | ||
− | * attacker_civ_id | + | *attacker_civ_id |
− | * defender_civ_id | + | *defender_civ_id |
− | * site_civ_id | + | *site_civ_id |
− | * site_id | + | *site_id |
− | * attacker_general_hfid | + | *attacker_general_hfid |
− | * defender_general_hfid | + | *defender_general_hfid |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== change hf job === | === change hf job === | ||
Line 301: | Line 102: | ||
**settled (site,coords given) | **settled (site,coords given) | ||
**scouting (site,coords given) | **scouting (site,coords given) | ||
− | ** | + | **theif (site,coords given) |
**snatcher (site,coords given) | **snatcher (site,coords given) | ||
**wandering (feature_layer given) | **wandering (feature_layer given) | ||
Line 311: | Line 112: | ||
*feature_layer_id | *feature_layer_id | ||
*coords | *coords | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== created structure === | === created structure === | ||
− | |||
− | |||
Some entity (site_civ_id) of entity/civ (civ_id) built structure (structure_id) at some site (site_id) | Some entity (site_civ_id) of entity/civ (civ_id) built structure (structure_id) at some site (site_id) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
* civ_id | * civ_id | ||
* site_civ_id | * site_civ_id | ||
− | * | + | * site_id |
− | * | + | * structure_id |
− | |||
− | |||
=== creature devoured === | === creature devoured === | ||
Line 355: | Line 125: | ||
* subregion_id | * subregion_id | ||
* feature_layer_id | * feature_layer_id | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===field battle=== | ===field battle=== | ||
This event shows that some entity (attacker_civ_id) attacked some entity (defender_civ_id) at some region (subregion_id) led by a HF (attacker_general_hfid), the defenders are led by another HF (defender_general_hfid). | This event shows that some entity (attacker_civ_id) attacked some entity (defender_civ_id) at some region (subregion_id) led by a HF (attacker_general_hfid), the defenders are led by another HF (defender_general_hfid). | ||
− | * attacker_civ_id | + | *attacker_civ_id |
− | * defender_civ_id | + | *defender_civ_id |
− | * subregion_id | + | *subregion_id |
− | * feature_layer_id | + | *feature_layer_id |
− | * coords | + | *coords |
− | * attacker_general_hfid | + | *attacker_general_hfid |
− | * defender_general_hfid | + | *defender_general_hfid |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===hf died === | ===hf died === | ||
Line 406: | Line 146: | ||
* feature_layer_id | * feature_layer_id | ||
* cause - causes include: | * cause - causes include: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
** shot | ** shot | ||
** struck | ** struck | ||
− | ** | + | ** dragonfire |
− | |||
=== hf new pet === | === hf new pet === | ||
Line 433: | Line 159: | ||
=== hf razed structure === | === hf razed structure === | ||
− | |||
− | |||
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id) | Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id) | ||
* hist_fig_id | * hist_fig_id | ||
* site_id | * site_id | ||
* structure_id | * structure_id | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===hf simple battle event=== | ===hf simple battle event=== | ||
This shows that some HF (group_1_hfid) did something (subtype) to another HF (group_2_hfid) at some site/region (site_id or subregion_id) | This shows that some HF (group_1_hfid) did something (subtype) to another HF (group_2_hfid) at some site/region (site_id or subregion_id) | ||
− | * subtype | + | *subtype |
− | ** attacked | + | **attacked |
− | ** scuffle | + | **scuffle |
− | + | **confront | |
− | ** confront | + | **ambushed |
− | ** ambushed | + | **2 lost after receiving wounds |
− | ** 2 lost after receiving | + | *group_1_hfid |
− | + | *group_2_hfid | |
− | + | *site_id | |
− | * group_1_hfid | + | *subregion_id |
− | * group_2_hfid | + | *feature_layer_id |
− | * site_id | ||
− | * subregion_id | ||
− | * feature_layer_id | ||
=== hf travel === | === hf travel === | ||
Line 477: | Line 182: | ||
:escaped from the underworld (has <escape/> and feature_layer_id given) | :escaped from the underworld (has <escape/> and feature_layer_id given) | ||
:returned to a site (has "<return/>" listed and a site) | :returned to a site (has "<return/>" listed and a site) | ||
− | :left a site | + | :left a site to a region (has subregion_id,coords and site_id) |
* group_hfid | * group_hfid | ||
* site_id | * site_id | ||
Line 485: | Line 190: | ||
=== hf wounded === | === hf wounded === | ||
− | This event shows that some HF (woundee_hfid) was wounded at site/region (site_id or subregion_id) by some HF (wounder_hfid | + | This event shows that some HF (woundee_hfid) was wounded at site/region (site_id or subregion_id) by some HF (wounder_hfid) |
− | * woundee_hfid | + | *woundee_hfid |
− | * wounder_hfid | + | *wounder_hfid |
− | * site_id | + | *site_id |
− | * subregion_id | + | *subregion_id |
− | * feature_layer_id | + | *feature_layer_id |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== remove hf site link=== | === remove hf site link=== | ||
− | + | This even shows that some HF (unexported) moved out of site_id. | |
− | |||
− | This | ||
* site_id | * site_id | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== historical_event_collections == | == historical_event_collections == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== historical_eras == | == historical_eras == | ||
Each <historical_era> element contains a name and a start_year element. | Each <historical_era> element contains a name and a start_year element. | ||
− | |||
− |