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
(adding some event types I just had listed, if someone could get the data parts for each that would be helpful, all are incomplete AFAIK though.)
m (formatting)
 
(53 intermediate revisions by 15 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 birth and death dates are stored in the historical_events element.
+
Other information such as marriages are stored in the historical_events element.
  
 
== entity_populations ==
 
== entity_populations ==
Line 60: Line 236:
  
 
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.
 +
 +
Entities are civilizations, groups (which can found sites/religions/attack/defend), or religions.
  
 
==historical_events==
 
==historical_events==
Line 65: Line 243:
 
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 - 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
 +
 
 +
=== artifact created ===
 +
(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
  
−
=== 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 '''
+
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
−
'''Parts needed'''
+
* site_id
 +
* subregion_id (always -1?)
 +
* feature_layer_id (always -1?)
 +
* coords
  
  
Line 111: 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 121: 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 ===
 
'''Explanation needed '''
 
'''Explanation needed '''
−
'''Parts needed'''
+
''No Parts''
  
−
=== created structure ===
+
=== created site ===
−
Some entity (site_civ_id) of entity/civ (civ_id) built structure (structure_id) at some site (site_id)
+
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
 
* site_id
 
* site_id
−
* structure_id
+
 
 +
=== 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)
 +
* 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 ===
 
=== 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.
 +
* civ_id
 +
* site_civ_id
 +
* wcid
 +
* master_wcid
 +
* site_id1
 +
* site_id2
  
 
=== creature devoured ===
 
=== creature devoured ===
Line 145: Line 358:
 
=== 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).
 +
* site_id
 +
* site_civ_id
 +
* attacker_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 152: Line 377:
 
===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 164: Line 389:
  
 
subregion_id/feature_layer_id always -1?
 
subregion_id/feature_layer_id always -1?
 +
 +
* target_hfid
 +
* snatcher_hfid
 +
* site_id
 +
* subregion_id
 +
* feature_layer_id
  
 
===hf died ===
 
===hf died ===
Line 175: 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 188: 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 194: 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
+