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 marriages are stored in the historical_events element. | + | Other information such as death dates and marriages are stored in the historical_events element. |
== entity_populations == | == entity_populations == | ||
Line 237: | Line 61: | ||
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. | ||
− | + | Entityies are civilizations, groups (which can found sites/religions/attack/defend), or religions. | |
==historical_events== | ==historical_events== | ||
Line 243: | Line 67: | ||
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 | ||
+ | === add hf entity link === | ||
+ | '''Explanation needed ''' | ||
+ | '''Parts needed''' | ||
=== 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 |
=== body abused === | === body abused === | ||
− | + | '''Explanation needed ''' | |
− | + | '''Parts needed''' | |
− | |||
− | |||
− | |||
Line 301: | Line 113: | ||
**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 123: | ||
*feature_layer_id | *feature_layer_id | ||
*coords | *coords | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== create entity position === | === create entity position === | ||
'''Explanation needed ''' | '''Explanation needed ''' | ||
− | '' | + | '''Parts needed''' |
+ | |||
+ | === created structure === | ||
+ | Some entity (site_civ_id) of entity/civ (civ_id) built structure (structure_id) at some site (site_id) | ||
+ | * civ_id | ||
+ | * site_civ_id | ||
+ | * site_id | ||
+ | * structure_id | ||
=== created site === | === created site === | ||
− | + | Appears to be the creation of a town (?) | |
* civ_id | * civ_id | ||
* site_civ_id | * site_civ_id | ||
* site_id | * site_id | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== created world construction === | === created world construction === | ||
Some entity (site_civ_id) of some civ/entity (civ_id) completed component wcid of master_wcid, which is a road between site_id1 and site_id2. | Some entity (site_civ_id) of some civ/entity (civ_id) completed component wcid of master_wcid, which is a road between site_id1 and site_id2. | ||
The final completion of the road has master_wcid being -1. | The final completion of the road has master_wcid being -1. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== creature devoured === | === creature devoured === | ||
Line 358: | Line 153: | ||
=== destroyed site === | === destroyed site === | ||
This event shows that some entity (attacker_civ_id) destroyed some site (site_id) defended by some entity (defender_civ_id) which is a member of some entity (site_civ_id). | This event shows that some entity (attacker_civ_id) destroyed some site (site_id) defended by some entity (defender_civ_id) which is a member of some entity (site_civ_id). | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== entity created === | === entity created === | ||
− | |||
− | |||
− | |||
− | |||
This event makrs the creation of an entity (entity_id) at some site (site_id). | This event makrs the creation of an entity (entity_id) at some site (site_id). | ||
This could be either a group which leaves and possibly founds another site, or this could be a religion being founded. | This could be either a group which leaves and possibly founds another site, or this could be a religion being founded. | ||
Line 377: | Line 160: | ||
===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 abducted === | ===hf abducted === | ||
Line 389: | Line 172: | ||
subregion_id/feature_layer_id always -1? | subregion_id/feature_layer_id always -1? | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===hf died === | ===hf died === | ||
Line 406: | Line 183: | ||
* 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 196: | ||
=== 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 | ||
Line 441: | Line 202: | ||
=== hf reunion === | === hf reunion === | ||
− | + | '''Explanation needed''' | |
− | * group_1_hfid | + | *group_1_hfid |
− | * group_2_hfid | + | *group_2_hfid |
− | + | *site_id | |
− | + | *subregion_id | |
− | + | *feature_layer_id | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | * site_id | ||
− | * subregion_id | ||
− | * feature_layer_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 485: | Line 235: | ||
=== 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 |
=== impersonate hf === | === impersonate hf === | ||
− | This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid | + | This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid) |
− | |||
− | |||
− | |||
− | |||
=== item stolen === | === item stolen === | ||
'''Explanation needed ''' | '''Explanation needed ''' | ||
− | '' | + | '''Parts needed''' |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== new site leader === | === new site leader === | ||
− | This event shows that an attacking entity (attacker_civ_id) attacked another entity (defender_civ_id) which was part of an entity (site_civ_id). The attackers | + | This event shows that an attacking entity (attacker_civ_id) attacked another entity (defender_civ_id) which was part of an entity (site_civ_id). The attackers one and took over the site (site_id), instituting a new government (new_site_civ_id) ran by a new leader (new_leader_hfid). |
=== peace accepted === | === peace accepted === | ||
− | + | '''Explanation needed ''' | |
− | + | '''Parts needed''' | |
=== peace rejected === | === peace rejected === | ||
'''Explanation needed ''' | '''Explanation needed ''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
'''Parts needed''' | '''Parts needed''' | ||
=== reclaim site === | === reclaim site === | ||
This event shows an entity (site_civ_id), a member of another entity (civ_id) reclaimed a site (site_id). | This event shows an entity (site_civ_id), a member of another entity (civ_id) reclaimed a site (site_id). | ||
− | |||
− | |||
− | |||
− | |||
=== remove hf site link=== | === remove hf site link=== | ||
− | |||
− | |||
This event shows that some HF (unexported) moved out of site_id. | This event shows that some HF (unexported) moved out of site_id. | ||
* site_id | * site_id | ||
=== remove hf entity link === | === remove hf entity link === | ||
− | + | '''Explanation needed ''' | |
− | + | '''Parts needed''' | |
=== replaced structure === | === replaced structure === | ||
This event shows that an entity (site_civ_id) a member of another entity (civ_id) replaced a structure type (old_ab_id) with another structure type (new_ab_id) at a site (site_id). This normally (only?) happens when a civ replaces buildings (homes) with larger buildings | This event shows that an entity (site_civ_id) a member of another entity (civ_id) replaced a structure type (old_ab_id) with another structure type (new_ab_id) at a site (site_id). This normally (only?) happens when a civ replaces buildings (homes) with larger buildings | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== 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. | ||
− | |||
− |