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 death dates and marriages are stored in the historical_events element. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | Other information such as 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 245: | Line 69: | ||
* 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 ''' | |
− | * | + | * civ_id |
− | |||
− | |||
− | |||
− | |||
=== attacked site === | === attacked site === | ||
Line 282: | Line 97: | ||
=== body abused === | === body abused === | ||
− | + | '''Explanation needed ''' | |
* site_id | * site_id | ||
* subregion_id (always -1?) | * subregion_id (always -1?) | ||
Line 301: | Line 116: | ||
**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 126: | ||
*feature_layer_id | *feature_layer_id | ||
*coords | *coords | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== create entity position === | === create entity position === | ||
Line 326: | Line 132: | ||
=== created site === | === created site === | ||
− | + | Appears to be the creation of a town (?) | |
* civ_id | * civ_id | ||
* site_civ_id | * site_civ_id | ||
Line 332: | Line 138: | ||
=== 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 - identifies an entity that makes up the second part of the Civ name (i.e. the 'X' in "Y of X") | * civ_id - identifies an entity that makes up the second part of the Civ name (i.e. the 'X' in "Y of X") | ||
Line 362: | Line 166: | ||
* attacker_civ_id | * attacker_civ_id | ||
* defender_civ_id | * defender_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 406: | Line 202: | ||
* 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 215: | ||
=== 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 221: | ||
=== hf reunion === | === hf reunion === | ||
− | + | '''Explanation needed''' | |
* group_1_hfid | * group_1_hfid | ||
* group_2_hfid | * group_2_hfid | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
* site_id | * site_id | ||
* subregion_id | * subregion_id | ||
Line 461: | Line 233: | ||
** attacked | ** attacked | ||
** scuffle | ** scuffle | ||
− | |||
** confront | ** confront | ||
** ambushed | ** ambushed | ||
** 2 lost after receiving wounds | ** 2 lost after receiving wounds | ||
− | |||
− | |||
* group_1_hfid | * group_1_hfid | ||
* group_2_hfid | * group_2_hfid | ||
Line 485: | Line 254: | ||
=== 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 | ||
Line 493: | Line 262: | ||
=== 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) |
* trickster_hfid | * trickster_hfid | ||
Line 502: | Line 271: | ||
'''Explanation needed ''' | '''Explanation needed ''' | ||
''No Parts'' | ''No Parts'' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== 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''' | |
=== razed structure === | === razed structure === | ||
− | |||
− | |||
'''Explanation needed ''' | '''Explanation needed ''' | ||
− | |||
'''Parts needed''' | '''Parts needed''' | ||
Line 579: | Line 295: | ||
=== 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 ''' | |
* civ_id | * civ_id | ||
=== 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 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== site taken over === | === site taken over === | ||
− | + | '''Explanation needed ''' | |
− | + | '''Parts needed''' | |
− | |||
− | |||
− | |||
== historical_event_collections == | == historical_event_collections == | ||
Line 617: | Line 316: | ||
* id - a reference number | * id - a reference number | ||
* start_year - the year in which the event collection started | * start_year - the year in which the event collection started | ||
− | * start_seconds72 - | + | * start_seconds72 - |
* end_year - the year in which the event collection ended | * end_year - the year in which the event collection ended | ||
− | * start_seconds72 - | + | * start_seconds72 - |
* event - one or more events which are part of this collection | * event - one or more events which are part of this collection | ||
* type - the type of event collection this is (the different types are listed below) | * type - the type of event collection this is (the different types are listed below) | ||
Line 637: | Line 336: | ||
* attacking_enid | * attacking_enid | ||
* defending_enid | * defending_enid | ||
+ | |||
+ | === beast attack === | ||
+ | A beast attacked a member of defending_enid at site_id, located at coords. | ||
+ | |||
+ | * subregion_id | ||
+ | * feature_layer_id | ||
+ | * site_id | ||
+ | * coords | ||
+ | * defending_enid | ||
+ | |||
+ | === duel === | ||
+ | This describes a duel between attacking_hfid and defending_hfid at site_id, located at coords. | ||
+ | * subregion_id | ||
+ | * feature_layer_id | ||
+ | * site_id | ||
+ | * coords | ||
+ | * attacking_hfid | ||
+ | * defending_hfid | ||
+ | |||
+ | === journey === | ||
+ | This describes a journey of a HF, normally when they leave a site to go tame an animal in a nearby region, then return. | ||
+ | |||
+ | ''No additional parts'' | ||
+ | |||
+ | === war === | ||
+ | A war, as named, where aggressor_ent_id battled defender_ent_id. It contains the battles, sieges, and pillaging events listed in eventcol. | ||
+ | * eventcol (multiple) | ||
+ | * name | ||
+ | * aggressor_ent_id | ||
+ | * defender_ent_id | ||
=== battle === | === battle === | ||
Line 673: | Line 402: | ||
''' Does not have an "ordinal" part''' | ''' Does not have an "ordinal" part''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== site conquered === | === site conquered === | ||
Line 703: | Line 409: | ||
* attacking_enid | * attacking_enid | ||
* defending_enid | * defending_enid | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== 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. | ||
− | |||
− |