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.

Difference between revisions of "v0.31:XML dump"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m (formatting)
 
(42 intermediate revisions by 12 users not shown)
Line 1: Line 1:
−
An XML dump of a world's history can be generated from [[Legends]] mode.
+
{{av}}
−
 
+
{{quality|Exceptional|02:38, 30 April 2011 (UTC)}}An XML dump of a world's history can be generated from [[Legends]] mode by pressing [x], and will be placed in the ''Dwarf Fortress'' root folder.
−
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 17: Line 16:
 
**Mountains
 
**Mountains
 
**Glacier
 
**Glacier
 +
**Wetland
 +
**Grassland
 +
**Lake
 +
**Tundra
  
 
==underground_regions==
 
==underground_regions==
Line 39: Line 42:
 
**cave
 
**cave
 
**dwarf fortress
 
**dwarf fortress
 +
**mountain halls
 +
**hamlet
 +
**dark fortress
 +
**forest retreat
 +
**town
 +
**fortress
 +
**camp
 +
**lair
 +
**labyrinth
 +
**shrine
 
*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 44: Line 57:
  
 
Each site may contain a <structures> tag.
 
Each site may contain a <structures> tag.
 +
== world_constructions ==
 +
 +
== artifacts ==
  
 
== historical_figures ==
 
== historical_figures ==
  
−
The <historical_figure> elements contain only the very most basic information:
+
The <historical_figure> elements contain the following information:
−
*id
+
*id - reference number used to identify the historical figure elsewhere
−
*name
+
*name - the name of the historical figure
 +
*race - the race of the figure, the following have been seen (not present if the figure is a force)
 +
**alligator
 +
**bat_giant
 +
**bear_black
 +
**bear_grizzly
 +
**bird_eagle_giant
 +
**bird_swallow_cave
 +
**bird_vulture
 +
**blind_cave_bear
 +
**blind_cave_ogre
 +
**cave_dragon
 +
**camel_1_hump
 +
**camel_2_hump
 +
**cheetah
 +
**cheetah_giant
 +
**colossus_bronze
 +
**cougar
 +
**crocodile_saltwater
 +
**cyclops
 +
**demon_x where x is a number
 +
**dog
 +
**dragon
 +
**draltha
 +
**dwarf
 +
**elf
 +
**ettin
 +
**forgotten_beast_x where x is a number
 +
**giant
 +
**goblin
 +
**gorlak
 +
**human
 +
**hungry_head
 +
**hydra
 +
**imp_fire
 +
**jabberer
 +
**jaguar
 +
**jaguar_giant
 +
**kobold
 +
**leopard
 +
**leopard_giant
 +
**lion
 +
**lion_giant
 +
**llama
 +
**minotaur
 +
**molemarian
 +
**night_creature_x where x is a number
 +
**rat
 +
**sasquatch
 +
**scorpion_desert_giant
 +
**spider_cave_giant
 +
**tiger
 +
**tiger_giant
 +
**titan_x where x is a number
 +
**troglodyte
 +
**troll
 +
**voracious_cave_crawler
 +
**wolf
 +
**yeti
 +
 
 +
*caste - the gender of the figure, can be one of the following (not present if the figure is a force)
 +
**default
 +
**female
 +
**male
 +
*appeared - unknown, seems to be related to apperance in the world, sometimes appeared and birth_year are different, mostly (~80%) the same.
 +
*birth_year - the year of the figure's birth, can be negative value (to indicate figure existing before the beginning of the world?)
 +
*birth_seconds72 - unknown
 +
*death_year - the year of the figure's death, -1 means the figure is still alive
 +
*death_seconds72 - unknown
 +
*associated_type - seems to be the job of the figure, the following have been seen
 +
**administrator
 +
**animal_caretaker
 +
**animal_dissector
 +
**animal_trainer
 +
**architect
 +
**armorer
 +
**axeman
 +
**baby
 +
**blacksmith
 +
**bone_carver
 +
**bone_setter
 +
**bowman
 +
**bowyer
 +
**brewer
 +
**butcher
 +
**carpenter
 +
**cheese_maker
 +
**child
 +
**clerk
 +
**clothier
 +
**cook
 +
**craftsman
 +
**crossbowman
 +
**diagnoser
 +
**drunk
 +
**dyer
 +
**engraver
 +
**farmer
 +
**fish_cleaner
 +
**fish_dissector
 +
**fisherman
 +
**fishery_worker
 +
**furnace_operator
 +
**gem_cutter
 +
**gem_setter
 +
**glassmaker
 +
**hammerman
 +
**herbalist
 +
**hunter
 +
**jeweler
 +
**lasher
 +
**leatherworker
 +
**lye_maker
 +
**maceman
 +
**mason
 +
**master_bowman
 +
**master_crossbowman
 +
**master_hammerman
 +
**master_lasher
 +
**master_maceman
 +
**master_pikeman
 +
**master_spearman
 +
**master_swordsman
 +
**master_thief
 +
**mechanic
 +
**metalcrafter
 +
**metalsmith
 +
**milker
 +
**miller
 +
**miner
 +
**none
 +
**pikeman
 +
**planter
 +
**potash_maker
 +
**pump_operator
 +
**ranger
 +
**recruit
 +
**siege_engineer
 +
**siege_operator
 +
**soap_maker
 +
**spearman
 +
**standard
 +
**stonecrafter
 +
**surgeon
 +
**suturer
 +
**swordsman
 +
**tanner
 +
**thief
 +
**thresher
 +
**trader
 +
**trained war
 +
**weaponsmith
 +
**weaver
 +
**wood_burner
 +
**woodcrafter
 +
**woodcutter
 +
**wrestler
 +
*deity - indicator (does not contain any value) to show if the figure is a deity or not. 
 +
*skeleton - indicator (does not contain any value) to show if the figure is a skeleton or not. 
 +
*zombie - indicator (does not contain any value) to show if the figure is a zombie or not. 
 +
*force - indicator (does not contain any value) to show if the figure is a force.  If this node is present, this figure will lack the race and caste nodes.
  
−
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 61: Line 237:
 
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.
+
Entities are civilizations, groups (which can found sites/religions/attack/defend), or religions.
  
 
==historical_events==
 
==historical_events==
Line 69: Line 245:
 
* 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 - the point in the year when it took place.  There are 403200 seconds in a year, so a value of 394800 would be a week before the end of the year
 
* 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 entity link ===
 +
Some historical figure (unlisted) linked to an entity. Observed link types from legends: became  position in the entity(general/queen/etc) / enemy / member / imprisoned
 +
* civ_id
  
 
=== add hf hf link ===
 
=== add hf hf link ===
−
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.
+
This is an event that links two historical figures (hf) together.  Observed link types from legends: marriage / worship / imprisonment
 
* hfid
 
* hfid
 
* hfid_target
 
* hfid_target
  
 
===add hf site link===
 
===add hf site link===
 +
'''Prior to .31.18'''
 
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 ===
+
=== artifact created ===
−
'''Explanation needed '''
+
(artifact_id) was created in (site_id) by (hist_figure_id)
−
* civ_id
+
* artifact_id
 +
* unit_id (not sure what this is)
 +
* hist_figure_id
 +
* site_id
 +
 
  
 
=== attacked site ===
 
=== attacked site ===
Line 97: Line 282:
  
 
=== body abused ===
 
=== body abused ===
−
'''Explanation needed '''
+
After a historical figure (can be multiple / unlisted) is killed, the body is abused. Observed abuses from legends: horribly mutilated / hung from tree / impaled on pikes
 
* site_id
 
* site_id
 
* subregion_id (always -1?)
 
* subregion_id (always -1?)
Line 116: Line 301:
 
**settled (site,coords given)
 
**settled (site,coords given)
 
**scouting (site,coords given)
 
**scouting (site,coords given)
−
**theif (site,coords given)
+
**thief (site,coords given)
 
**snatcher (site,coords given)
 
**snatcher (site,coords given)
 
**wandering (feature_layer given)
 
**wandering (feature_layer given)
Line 126: Line 311:
 
*feature_layer_id
 
*feature_layer_id
 
*coords
 
*coords
 +
 +
=== changed creature type ===
 +
(changer) turns some (changee) into (new race/caste). Seen to happen in legends after changer (always a demon?) imprisons then turns changee into same demon as changer.
 +
*changee_hfid
 +
*changer_hfid
 +
*old_race
 +
*old_caste
 +
*new_race
 +
*new_caste
  
 
=== create entity position ===
 
=== create entity position ===
Line 132: Line 326:
  
 
=== created site ===
 
=== created site ===
−
Appears to be the creation of a town (?)
+
The founding of a site by site_civ_id, which is a group that is a member of civ_id.
 
* civ_id
 
* civ_id
 
* site_civ_id
 
* site_civ_id
Line 138: Line 332:
  
 
=== created structure ===
 
=== created structure ===
 +
'''Prior to 31.18'''
 +
 
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 166: Line 362:
 
* attacker_civ_id
 
* attacker_civ_id
 
* defender_civ_id
 
* defender_civ_id
 +
 +
=== diplomat lost ===
 +
(unknown entity) lost a diplomat at (unknown site). They suspected the involvement of (unknown entity);
 +
* No details exported.
  
 
=== entity created ===
 
=== entity created ===
 +
'''.31.18'''
 +
Appears as an event in the xml file relating to the player founding a site in dwarf fortress mode. Showing your embark group entity_id being created at your fortress site - site_id
 +
 +
'''Prior to .31.18'''
 
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 202: Line 406:
 
* feature_layer_id
 
* feature_layer_id
 
* cause - causes include:
 
* cause - causes include:
 +
** air (suffocated)
 +
** blood (bled to death)
 +
** crushed bridge (atom smasher?)
 +
** dragonfire
 +
** drown
 +
** exec burned alive
 +
** exec crucified
 +
** exec fet to beasts
 +
** exec hacked to pieces
 +
** fire
 +
** murdered
 +
** obstacle (being thrown into a wall?)
 +
** old age
 
** shot
 
** shot
 
** struck
 
** struck
−
** dragonfire
+
** thirst
 +
** trap
  
 
=== hf new pet ===
 
=== hf new pet ===
Line 215: Line 433:
  
 
=== hf razed structure ===
 
=== hf razed structure ===
 +
'''Prior to 31.18'''
 +
 
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 221: Line 441:
  
 
=== hf reunion ===
 
=== hf reunion ===
−
'''Explanation needed'''
+
2 or more (only 2 listed) historical figures reunited.
 
* group_1_hfid
 
* group_1_hfid
 
* group_2_hfid
 
* group_2_hfid
 +
* site_id
 +
* subregion_id
 +
* feature_layer_id
 +
 +
=== hf revived ===
 +
(hfid) comes back from the dead as a (ghost) in (site_id)
 +
* hfid
 +
* ghost
 
* site_id
 
* site_id
 
* subregion_id
 
* subregion_id
Line 233: Line 461:
 
** attacked
 
** attacked
 
** scuffle
 
** scuffle
 +
** happen upon
 
** confront
 
** confront
 
** ambushed
 
** ambushed
 
** 2 lost after receiving wounds
 
** 2 lost after receiving wounds
 +
** 2 lost after giving wounds
 +
** 2 lost after mutual wounds
 
* group_1_hfid
 
* group_1_hfid
 
* group_2_hfid
 
* group_2_hfid
Line 254: Line 485:
  
 
=== 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). Unlisted body part and attack type (smashed/slashed/etc)
 
* woundee_hfid
 
* woundee_hfid
 
* wounder_hfid
 
* wounder_hfid
Line 262: Line 493:
  
 
=== impersonate hf ===
 
=== impersonate hf ===
−
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)
+
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid / always a deity?) within an entity (target_enid)
  
 
* trickster_hfid
 
* trickster_hfid
Line 271: Line 502:
 
'''Explanation needed '''
 
'''Explanation needed '''
 
''No Parts''
 
''No Parts''
 +
 +
=== masterpiece arch constructed ===
 +
(hfid) constructed a masterpiece (unknown) architecture for (entity_id) at (site_id)
 +
* hfid
 +
* entity_id
 +
* site_id
 +
* skill_at_time
 +
 +
=== masterpiece arch design ===
 +
(hfid) designed a masterpiece (unknown) architecture for (entity_id) at (site_id)
 +
* hfid
 +
* entity_id
 +
* site_id
 +
* skill_at_time
 +
 +
=== masterpiece engraving ===
 +
(hfid) created a masterful engraving for (entity_id) in (site_id)
 +
* hfid
 +
* entity_id
 +
* site_id
 +
* skill_at_time
 +
 +
=== masterpiece food ===
 +
(hfid) prepared a masterful (UNKNOWN) for (entity_id) in (site_id)
 +
* hfid
 +
* entity_id
 +
* site_id
 +
* skill_at_time
 +
 +
=== masterpiece item ===
 +
(hfid) created a masterful (UNKNOWN) for (entity_id) in (site_id)
 +
* hfid
 +
* entity_id
 +
* site_id
 +
* skill_at_time
 +
 +
=== masterpiece item improvement ===
 +
(hfid) added masterful (UNKNOWN) to a (UNKNOWN) for (entity_id) in (site_id)
 +
* hfid
 +
* entity_id
 +
* site_id
 +
* skill_at_time
 +
 +
=== masterpiece lost ===
 +
'''Details Needed'''
 +
*Nothing Exported
 +
 +
=== merchant ===
 +
'''Details Needed'''
 +
*Nothing exported
  
 
=== 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 one and took over the site (site_id), instituting a new government (new_site_civ_id) ran by a new leader (new_leader_hfid).
+
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 won 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 '''
+
This event ends a war. The info about which entity initiated the negotiations is missing.
−
'''Parts needed'''
+
* site_id (always -1?)
  
 
=== peace rejected ===
 
=== peace rejected ===
 
'''Explanation needed '''
 
'''Explanation needed '''
−
'''Parts needed'''
+
* site_id (always -1?)
  
 
=== razed structure ===
 
=== razed structure ===
 +
'''No longer used in 31.18'''
 +
 
'''Explanation needed '''
 
'''Explanation needed '''
 +
 
'''Parts needed'''
 
'''Parts needed'''
  
Line 295: Line 579:
  
 
=== remove hf site link===
 
=== remove hf site link===
 +
'''Prior to 31.18'''
 +
 
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 '''
+
Some historical figure (unlisted) removes link with entity. Observed link removals in legends: ceased to position / escaped from prison
 
* 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 abandoned ===
 +
(site_civ_id) of (civ_id) abandoned the settlement at (site_id)
 +
*civ_id
 +
*site_civ_id
 +
*site_id
 +
 +
=== site died ===
 +
(site_civ_id) and (civ_id) settlement of (site_id) withered.
 +
*civ_id
 +
*site_civ_id
 +
*site_id
  
 
=== site taken over ===
 
=== site taken over ===
−
'''Explanation needed '''
+
*attacker_civ_id
−
'''Parts needed'''
+
*new_site_civ_id
 +
*defender_civ_id
 +
*site_civ_id
 +
*site_id
  
 
== historical_event_collections ==
 
== historical_event_collections ==
Line 316: Line 617:
 
* 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 - the date of the year, in seconds.  There are 403200 seconds in a year, 1200 seconds in a day, 28 days in a month, and 12 months in a year.
 
* end_year - the year in which the event collection ended
 
* end_year - the year in which the event collection ended
−
* start_seconds72 -
+
* start_seconds72 - the date of the year, in seconds.  There are 403200 seconds in a year, 1200 seconds in a day, 28 days in a month, and 12 months in a year.
 
* 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 328: Line 629:
  
 
=== abduction ===
 
=== abduction ===
−
'''Description needed'''
+
An abduction by a member of (attacking_enid) of a member of (defending_enid).  They were abducted from (site_id) located at (coords).
 +
 
 
* subregion_id
 
* subregion_id
 
* feature_layer_id
 
* feature_layer_id
Line 335: Line 637:
 
* attacking_enid
 
* attacking_enid
 
* defending_enid
 
* defending_enid
 +
 +
=== battle ===
 +
This describes a battle between multiple sides.  The battle is part of the war event collection war_eventcol.  The events that make up this collection are individual simple battle events or assaults.  They involve an attacking_hfid and/or a defending_hfid. It occurred at site_id which is located at coords. 
 +
 +
There can be multiple attacking and defending squads made up of non-notable units, their civ they belong to is *_squad_entity_pop.  They contain *_squad_number units of race *_squad_race, of which *_squad_deaths died. 
 +
 +
Also some or all of the important people (attacking_hfid and defending_hfid) may have died.
 +
 +
The outcome is either "defender won" or "attacker won".
 +
 +
* eventcol (multiple?)
 +
* event (multiple)
 +
* name
 +
* war_eventcol
 +
* subregion_id
 +
* feature_layer_id
 +
* site_id
 +
* coords
 +
* attacking_hfid (multiple)
 +
* defending_hfid (multiple)
 +
* noncom_hfid (multiple) (?)
 +
* '''Multiple different "attacking squads" each with these parts
 +
** attacking_squad_race
 +
** attacking_squad_entity_pop
 +
** attacking_squad_number
 +
** attacking_squad_deaths
 +
** attacking_squad_site (?)
 +
* '''Multiple different "defending squads" each with these parts
 +
** defending_squad_race
 +
** defending_squad_entity_pop
 +
** defending_squad_number
 +
** defending_squad_deaths
 +
** defending_squad_site
 +
* outcome
 +
 +
''' Does not have an "ordinal" part'''
  
 
=== beast attack ===
 
=== beast attack ===
−
'''Description needed'''
+
A beast attacked a member of defending_enid at site_id, located at coords.
 +
 
 
* subregion_id
 
* subregion_id
 
* feature_layer_id
 
* feature_layer_id
Line 345: Line 684:
  
 
=== duel ===
 
=== duel ===
−
'''Description needed'''
+
This describes a duel between attacking_hfid and defending_hfid at site_id, located at coords.
 
* subregion_id
 
* subregion_id
 
* feature_layer_id
 
* feature_layer_id
Line 354: Line 693:
  
 
=== journey ===
 
=== journey ===
−
'''Description needed'''
+
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''
 
''No additional parts''
  
−
=== war ===
+
=== site conquered ===
−
'''Description needed'''
+
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
−
* aggressor_ent_id
+
* war_eventcol
−
* defender_ent_id
+
* site_id
 +
* attacking_enid
 +
* defending_enid
  
−
=== battle ===
+
=== theft ===
−
'''Description needed'''
+
A member of attacking_enid stole something from a member of defending_enid at site_id located at coords.  Can include multiple different thefts by different theives from the same location
−
* name
 
−
* war_eventcol
 
 
* subregion_id
 
* subregion_id
 
* feature_layer_id
 
* feature_layer_id
 
* site_id
 
* site_id
 
* coords
 
* coords
−
* attacking_hfid (multiple)
 
−
* '''Multiple different "squads" each with these parts
 
−
** attacking_squad_race
 
−
** attacking_squad_entity_pop
 
−
** attacking_squad_number
 
−
** attacking_squad_deaths
 
−
** attacking_squad_site
 
−
* outcome
 
−
 
−
''' Does not have an "ordinal" part
 
−
 
−
 
−
 
−
=== site conquered ===
 
−
'''Description needed'''
 
−
* war_eventcol
 
−
* site_id
 
 
* attacking_enid
 
* attacking_enid
 
* defending_enid
 
* defending_enid
 +
 +
=== 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
  
 
== 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.
 +
 +
{{Category|Guides}}

Latest revision as of 17:48, 12 March 2023

v50.14 · v0.47 · v0.34 · v0.31.25 · v0.28 · v0.23
This article is about an older version of DF.
xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

An XML dump of a world's history can be generated from Legends mode by pressing [x], and will be placed in the Dwarf Fortress root folder.

The XML dump consists of the following elements:

regions[edit]

Each dump contains one <regions> element, which contains a large number of <region> elements. Each <region> element has the following attributes stored as elements within it:

  • id - a reference number used to identify the region elsewhere
  • name - the name of the region (eg, "the colorless desert" or "the perplexing forests"). The names are all lower-case.
  • type - the type of region. Types include:
    • Ocean
    • Hills
    • Desert
    • Forest
    • Mountains
    • Glacier
    • Wetland
    • Grassland
    • Lake
    • Tundra

underground_regions[edit]

Similar to the <regions> element. The <underground_region> elements contain the following:

  • id - reference number used to identify the region
  • type - can be:
    • cavern
    • magma
    • underworld
  • depth

Note that underground regions don't have names.

sites[edit]

Each <site> element contains the following:

  • id - reference number
  • name
  • type
    • city
    • tree city
    • cave
    • dwarf fortress
    • mountain halls
    • hamlet
    • dark fortress
    • forest retreat
    • town
    • fortress
    • camp
    • lair
    • labyrinth
    • shrine
  • coords - an X, Y coordinate giving the location of the site on the world map.

structures[edit]

Each site may contain a <structures> tag.

world_constructions[edit]

artifacts[edit]

historical_figures[edit]

The <historical_figure> elements contain the following information:

  • id - reference number used to identify the historical figure elsewhere
  • name - the name of the historical figure
  • race - the race of the figure, the following have been seen (not present if the figure is a force)
    • alligator
    • bat_giant
    • bear_black
    • bear_grizzly
    • bird_eagle_giant
    • bird_swallow_cave
    • bird_vulture
    • blind_cave_bear
    • blind_cave_ogre
    • cave_dragon
    • camel_1_hump
    • camel_2_hump
    • cheetah
    • cheetah_giant
    • colossus_bronze
    • cougar
    • crocodile_saltwater
    • cyclops
    • demon_x where x is a number
    • dog
    • dragon
    • draltha
    • dwarf
    • elf
    • ettin
    • forgotten_beast_x where x is a number
    • giant
    • goblin
    • gorlak
    • human
    • hungry_head
    • hydra
    • imp_fire
    • jabberer
    • jaguar
    • jaguar_giant
    • kobold
    • leopard
    • leopard_giant
    • lion
    • lion_giant
    • llama
    • minotaur
    • molemarian
    • night_creature_x where x is a number
    • rat
    • sasquatch
    • scorpion_desert_giant
    • spider_cave_giant
    • tiger
    • tiger_giant
    • titan_x where x is a number
    • troglodyte
    • troll
    • voracious_cave_crawler
    • wolf
    • yeti
  • caste - the gender of the figure, can be one of the following (not present if the figure is a force)
    • default
    • female
    • male
  • appeared - unknown, seems to be related to apperance in the world, sometimes appeared and birth_year are different, mostly (~80%) the same.
  • birth_year - the year of the figure's birth, can be negative value (to indicate figure existing before the beginning of the world?)
  • birth_seconds72 - unknown
  • death_year - the year of the figure's death, -1 means the figure is still alive
  • death_seconds72 - unknown
  • associated_type - seems to be the job of the figure, the following have been seen
    • administrator
    • animal_caretaker
    • animal_dissector
    • animal_trainer
    • architect
    • armorer
    • axeman
    • baby
    • blacksmith
    • bone_carver
    • bone_setter
    • bowman
    • bowyer
    • brewer
    • butcher
    • carpenter
    • cheese_maker
    • child
    • clerk
    • clothier
    • cook
    • craftsman
    • crossbowman
    • diagnoser
    • drunk
    • dyer
    • engraver
    • farmer
    • fish_cleaner
    • fish_dissector
    • fisherman
    • fishery_worker
    • furnace_operator
    • gem_cutter
    • gem_setter
    • glassmaker
    • hammerman
    • herbalist
    • hunter
    • jeweler
    • lasher
    • leatherworker
    • lye_maker
    • maceman
    • mason
    • master_bowman
    • master_crossbowman
    • master_hammerman
    • master_lasher
    • master_maceman
    • master_pikeman
    • master_spearman
    • master_swordsman
    • master_thief
    • mechanic
    • metalcrafter
    • metalsmith
    • milker
    • miller
    • miner
    • none
    • pikeman
    • planter
    • potash_maker
    • pump_operator
    • ranger
    • recruit
    • siege_engineer
    • siege_operator
    • soap_maker
    • spearman
    • standard
    • stonecrafter
    • surgeon
    • suturer
    • swordsman
    • tanner
    • thief
    • thresher
    • trader
    • trained war
    • weaponsmith
    • weaver
    • wood_burner
    • woodcrafter
    • woodcutter
    • wrestler
  • deity - indicator (does not contain any value) to show if the figure is a deity or not.
  • skeleton - indicator (does not contain any value) to show if the figure is a skeleton or not.
  • zombie - indicator (does not contain any value) to show if the figure is a zombie or not.
  • force - indicator (does not contain any value) to show if the figure is a force. If this node is present, this figure will lack the race and caste nodes.

Other information such as marriages are stored in the historical_events element.

entity_populations[edit]

Each <entity_population> element contains only a single tag, giving an id number.

entities[edit]

Each <entity> element contains an id tag, and may also contain a name tag.

Entities are civilizations, groups (which can found sites/religions/attack/defend), or religions.

historical_events[edit]

The <historical_event> element is the most complex. Each contains:

  • id - a reference number
  • year - the year in which the event took place
  • seconds72 - the point in the year when it took place. There are 403200 seconds in a year, so a value of 394800 would be a week before the end of the year
  • 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:

add hf entity link[edit]

Some historical figure (unlisted) linked to an entity. Observed link types from legends: became position in the entity(general/queen/etc) / enemy / member / imprisoned

  • civ_id

add hf hf link[edit]

This is an event that links two historical figures (hf) together. Observed link types from legends: marriage / worship / imprisonment

  • hfid
  • hfid_target

add hf site link[edit]

Prior to .31.18 This event shows that some (unexported) HF took up residence in some site (site_id)

  • site_id

artifact created[edit]

(artifact_id) was created in (site_id) by (hist_figure_id)

  • artifact_id
  • unit_id (not sure what this is)
  • hist_figure_id
  • site_id


attacked site[edit]

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
  • defender_civ_id
  • site_civ_id
  • site_id
  • attacker_general_hfid
  • defender_general_hfid

body abused[edit]

After a historical figure (can be multiple / unlisted) is killed, the body is abused. Observed abuses from legends: horribly mutilated / hung from tree / impaled on pikes

  • site_id
  • subregion_id (always -1?)
  • feature_layer_id (always -1?)
  • coords


change hf job[edit]

This event shows that some HF (hfid) took up a different job (unexported) at some site (site_id)

  • hfid
  • site_id
  • subregion_id (always -1?)
  • feature_layer_id (always -1?)

change hf state[edit]

This event shows that some HF (hfid) changed state (to state) at site_id, in subregion_id, or in feature_layer_id, located at coords.

  • state - tells what state the historical figure is changing to.
    • settled (site,coords given)
    • scouting (site,coords given)
    • thief (site,coords given)
    • snatcher (site,coords given)
    • wandering (feature_layer given)
    • refugee (subregion_id,coords given)
    • hunting (subregion_id,coords given)
  • hfid - ID number of the historical figure whose state is changing
  • site_id
  • subregion_id
  • feature_layer_id
  • coords

changed creature type[edit]

(changer) turns some (changee) into (new race/caste). Seen to happen in legends after changer (always a demon?) imprisons then turns changee into same demon as changer.

  • changee_hfid
  • changer_hfid
  • old_race
  • old_caste
  • new_race
  • new_caste

create entity position[edit]

Explanation needed No Parts

created site[edit]

The founding of a site by site_civ_id, which is a group that is a member of civ_id.

  • civ_id
  • site_civ_id
  • site_id

created structure[edit]

Prior to 31.18

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")
  • site_civ_id - identifies an entity that makes up the first part of the Civ name (i.e. the 'Y' in "Y of X")
  • site_id - the site where the structure was created - town, fortress, whatever
  • structure_id - An ID identifying the structure. Uncertain if there is a way to find out what type of structure this is.

created world construction[edit]

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.

  • civ_id
  • site_civ_id
  • wcid
  • master_wcid
  • site_id1
  • site_id2

creature devoured[edit]

This event shows that some HF (unexported) devoured another HF (unexported) at some site/region (site_id or subregion_id)

  • site_id
  • subregion_id
  • feature_layer_id

destroyed site[edit]

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).

  • site_id
  • site_civ_id
  • attacker_civ_id
  • defender_civ_id

diplomat lost[edit]

(unknown entity) lost a diplomat at (unknown site). They suspected the involvement of (unknown entity);

  • No details exported.

entity created[edit]

.31.18 Appears as an event in the xml file relating to the player founding a site in dwarf fortress mode. Showing your embark group entity_id being created at your fortress site - site_id

Prior to .31.18 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.

field battle[edit]

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
  • defender_civ_id
  • subregion_id
  • feature_layer_id
  • coords
  • attacker_general_hfid
  • defender_general_hfid

hf abducted[edit]

This event shows that some HF (target_hfid) was abducted by a snatcher (snatcher_hfid) from some site (site_id)

subregion_id/feature_layer_id always -1?

  • target_hfid
  • snatcher_hfid
  • site_id
  • subregion_id
  • feature_layer_id

hf died[edit]

This event shows that some HF (hfid) was killed by some HF (slayer_hfid) at site/region (site_id or subregion_id)

  • hfid - the historical figure who died
  • slayer_hfid - the historical figure who slew him
  • slayer_item_id - -1 if no notable item was used
  • slayer_shooter_item_id - -1 if no notable item was used
  • site_id - -1 if not killed at a site
  • subregion_id
  • feature_layer_id
  • cause - causes include:
    • air (suffocated)
    • blood (bled to death)
    • crushed bridge (atom smasher?)
    • dragonfire
    • drown
    • exec burned alive
    • exec crucified
    • exec fet to beasts
    • exec hacked to pieces
    • fire
    • murdered
    • obstacle (being thrown into a wall?)
    • old age
    • shot
    • struck
    • thirst
    • trap

hf new pet[edit]

This event shows that some HF (group_hfid) tamed some animal in sub_region_id at coords.

  • group_hfid
  • site_id (always -1?)
  • subregion_id
  • feature_layer_id (always -1?)
  • coords

hf razed structure[edit]

Prior to 31.18

Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)

  • hist_fig_id
  • site_id
  • structure_id

hf reunion[edit]

2 or more (only 2 listed) historical figures reunited.

  • group_1_hfid
  • group_2_hfid
  • site_id
  • subregion_id
  • feature_layer_id

hf revived[edit]

(hfid) comes back from the dead as a (ghost) in (site_id)

  • hfid
  • ghost
  • site_id
  • subregion_id
  • feature_layer_id

hf simple battle event[edit]

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
    • attacked
    • scuffle
    • happen upon
    • confront
    • ambushed
    • 2 lost after receiving wounds
    • 2 lost after giving wounds
    • 2 lost after mutual wounds
  • group_1_hfid
  • group_2_hfid
  • site_id
  • subregion_id
  • feature_layer_id

hf travel[edit]

This event shows that some HF (group_hfid):

escaped from the underworld (has <escape/> and feature_layer_id given)
returned to a site (has "<return/>" listed and a site)
left a site to go to a region (has subregion_id,coords and site_id)
  • group_hfid
  • site_id
  • subregion_id
  • feature_layer_id
  • coords

hf wounded[edit]

This event shows that some HF (woundee_hfid) was wounded at site/region (site_id or subregion_id) by some HF (wounder_hfid). Unlisted body part and attack type (smashed/slashed/etc)

  • woundee_hfid
  • wounder_hfid
  • site_id
  • subregion_id
  • feature_layer_id

impersonate hf[edit]

This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid / always a deity?) within an entity (target_enid)

  • trickster_hfid
  • cover_hfid
  • target_enid

item stolen[edit]

Explanation needed No Parts

masterpiece arch constructed[edit]

(hfid) constructed a masterpiece (unknown) architecture for (entity_id) at (site_id)

  • hfid
  • entity_id
  • site_id
  • skill_at_time

masterpiece arch design[edit]

(hfid) designed a masterpiece (unknown) architecture for (entity_id) at (site_id)

  • hfid
  • entity_id
  • site_id
  • skill_at_time

masterpiece engraving[edit]

(hfid) created a masterful engraving for (entity_id) in (site_id)

  • hfid
  • entity_id
  • site_id
  • skill_at_time

masterpiece food[edit]

(hfid) prepared a masterful (UNKNOWN) for (entity_id) in (site_id)

  • hfid
  • entity_id
  • site_id
  • skill_at_time

masterpiece item[edit]

(hfid) created a masterful (UNKNOWN) for (entity_id) in (site_id)

  • hfid
  • entity_id
  • site_id
  • skill_at_time

masterpiece item improvement[edit]

(hfid) added masterful (UNKNOWN) to a (UNKNOWN) for (entity_id) in (site_id)

  • hfid
  • entity_id
  • site_id
  • skill_at_time

masterpiece lost[edit]

Details Needed

  • Nothing Exported

merchant[edit]

Details Needed

  • Nothing exported

new site leader[edit]

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 won 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[edit]

This event ends a war. The info about which entity initiated the negotiations is missing.

  • site_id (always -1?)

peace rejected[edit]

Explanation needed

  • site_id (always -1?)

razed structure[edit]

No longer used in 31.18

Explanation needed

Parts needed

reclaim site[edit]

This event shows an entity (site_civ_id), a member of another entity (civ_id) reclaimed a site (site_id).

  • civ_id
  • site_civ_id
  • site_id

remove hf site link[edit]

Prior to 31.18

This event shows that some HF (unexported) moved out of site_id.

  • site_id

remove hf entity link[edit]

Some historical figure (unlisted) removes link with entity. Observed link removals in legends: ceased to position / escaped from prison

  • civ_id

replaced structure[edit]

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 abandoned[edit]

(site_civ_id) of (civ_id) abandoned the settlement at (site_id)

  • civ_id
  • site_civ_id
  • site_id

site died[edit]

(site_civ_id) and (civ_id) settlement of (site_id) withered.

  • civ_id
  • site_civ_id
  • site_id

site taken over[edit]

  • attacker_civ_id
  • new_site_civ_id
  • defender_civ_id
  • site_civ_id
  • site_id

historical_event_collections[edit]

As of .31.13 these have been added and contain a massive amount of information. Please help to add details below

Each historical event collection contains the following items, as well as additional items depending on it's type:

  • id - a reference number
  • start_year - the year in which the event collection started
  • start_seconds72 - the date of the year, in seconds. There are 403200 seconds in a year, 1200 seconds in a day, 28 days in a month, and 12 months in a year.
  • end_year - the year in which the event collection ended
  • start_seconds72 - the date of the year, in seconds. There are 403200 seconds in a year, 1200 seconds in a day, 28 days in a month, and 12 months in a year.
  • 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)
  • parent_eventcol - Is this event collection part of another event collection? If so the id of that parent is listed here, otherwise it will be -1
  • ordinal - How many times has this happened ("The Third Siege of Ironhand" would have <ordinal>3</ordinal>)

The different types of event collections along with a description and their components are listed below. It's likely there are more event collections then those listed below:


abduction[edit]

An abduction by a member of (attacking_enid) of a member of (defending_enid). They were abducted from (site_id) located at (coords).

  • subregion_id
  • feature_layer_id
  • site_id
  • coords
  • attacking_enid
  • defending_enid

battle[edit]

This describes a battle between multiple sides. The battle is part of the war event collection war_eventcol. The events that make up this collection are individual simple battle events or assaults. They involve an attacking_hfid and/or a defending_hfid. It occurred at site_id which is located at coords.

There can be multiple attacking and defending squads made up of non-notable units, their civ they belong to is *_squad_entity_pop. They contain *_squad_number units of race *_squad_race, of which *_squad_deaths died.

Also some or all of the important people (attacking_hfid and defending_hfid) may have died.

The outcome is either "defender won" or "attacker won".

  • eventcol (multiple?)
  • event (multiple)
  • name
  • war_eventcol
  • subregion_id
  • feature_layer_id
  • site_id
  • coords
  • attacking_hfid (multiple)
  • defending_hfid (multiple)
  • noncom_hfid (multiple) (?)
  • Multiple different "attacking squads" each with these parts
    • attacking_squad_race
    • attacking_squad_entity_pop
    • attacking_squad_number
    • attacking_squad_deaths
    • attacking_squad_site (?)
  • Multiple different "defending squads" each with these parts
    • defending_squad_race
    • defending_squad_entity_pop
    • defending_squad_number
    • defending_squad_deaths
    • defending_squad_site
  • outcome

Does not have an "ordinal" part

beast attack[edit]

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[edit]

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[edit]

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

site conquered[edit]

As part of war_eventcol, attacking_enid conquered site_id from defending_enid.

  • war_eventcol
  • site_id
  • attacking_enid
  • defending_enid

theft[edit]

A member of attacking_enid stole something from a member of defending_enid at site_id located at coords. Can include multiple different thefts by different theives from the same location

  • subregion_id
  • feature_layer_id
  • site_id
  • coords
  • attacking_enid
  • defending_enid

war[edit]

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

historical_eras[edit]

Each <historical_era> element contains a name and a start_year element.

Retrieved from "https://dwarffortresswiki.org/index.php?title=v0.31:XML_dump&oldid=292317"