Dwarf Fortress Wiki - User contributions [en]

Topic/table/philosophy

2021-11-07T18:30:31Z

Mason11987: is conduct not ethics

{| class = "wikitable sortable" style="width: 60%"
! scope="col" style="width: 25%;" | Topic
! scope="col" style="width: 50%;" | Description
! scope="col" style="width: 25%;" | Wikipedia link
! scope="col" style="width: 25%;" | Subdivision
! scope="col" style="width: 25%;" | Skills used in research
|-
|Nature of beauty
|Discourse on the nature of beauty
|[[wikipedia:Beauty (ancient thought)|Beauty (ancient thought)]]
|Aesthetics
|[[Critical thinker]]
|-
|Value of art
|Discourse on the value of art
|[[wikipedia:Aesthetics|Aesthetics]]
|Aesthetics
|[[Critical thinker]]
|-
|Belief
|Discourse on the nature of belief
|[[wikipedia:Epistemology#Belief|Epistemology § Belief]]
|Epistemology
|[[Critical thinker]]
|-
|Justification
|Discourse on the nature of justification
|[[wikipedia:Epistemology#Justification|Epistemology § Justification]]
|Epistemology
|[[Critical thinker]]
|-
|Perception
|Discourse on the nature of perception
|[[wikipedia:Philosophy of perception|Philosophy of perception]]
|Epistemology
|[[Critical thinker]]
|-
|Truth
|Discourse on the nature of truth
|[[wikipedia:Epistemology#Truth|Epistemology § Truth]]
|Epistemology
|[[Critical thinker]]
|-
|Individual value
|Discourse on the meaning of individual happiness
|[[wikipedia:Value (ethics)#Personal values|Value (ethics) § Personal values]]
|Ethics
|[[Critical thinker]]
|-
|State consequentialism
|Discourse on ethics as applied to the benefit of the state
|[[wikipedia:State consequentialism|State consequentialism]]
|Ethics
|[[Critical thinker]]
|-
|Interpersonal conduct
|Discourse on ethics as applied to interpersonal conduct
|[[wikipedia:Value (ethics)#Cultural values|Value (ethics) § Cultural values]]
|Ethics (applied)
|[[Critical thinker]]
|-
|Medical
|Discourse on medical ethics
|[[wikipedia:Medical ethics|Medical ethics]]
|Ethics (applied)
|[[Critical thinker]]
|-
|Military
|Discourse on ethics as applied to war
|[[wikipedia:Ethics#Military ethics|Ethics § Military ethics]]
|Ethics (applied)
|[[Critical thinker]]
|-
|Analogical inference
|Analogical inference
|[[wikipedia:Argument from analogy|Argument from analogy]]
|Logic
|[[Logician]]
|-
|Deductive reasoning
|Deductive reasoning
|[[wikipedia:Deductive reasoning|Deductive reasoning]]
|Logic
|[[Logician]]
|-
|Dialectic reasoning
|Dialectic reasoning. Books on this topic will instead talk about using the dialogue, as this opens up the dialogue literary form.
|[[wikipedia:Dialectic|Dialectic]]
|Logic
|[[Logician]]
|-
|Direct inference
|Direct inference
|[[wikipedia:Statistical syllogism|Statistical syllogism]]
|Logic
|[[Logician]]
|-
|Formal reasoning
|Formal reasoning
|[[wikipedia:Reason|Reason]]
|Logic
|[[Logician]]
|-
|Hypothetical syllogisms
|Hypothetical syllogisms
|[[wikipedia:Hypothetical syllogism|Hypothetical syllogism]]
|Logic
|[[Logician]]
|-
|Inductive reasoning
|Inductive reasoning
|[[wikipedia:Inductive reasoning|Inductive reasoning]]
|Logic
|[[Logician]]
|-
|Propositional logic
|
|[[wikipedia:Propositional calculus|Propositional calculus]]
|Logic
|
|-
|Syllogistic logic
|Syllogistic logic
|[[wikipedia:Syllogism|Syllogism]]
|Logic
|[[Logician]]
|-
|Causation
|The nature of causation
|[[wikipedia:Causality|Causality]]
|Metaphysics
|[[Critical thinker]]
|-
|Events
|Discourse on the nature of events
|[[wikipedia:Event (philosophy)|Event (philosophy)]]
|Metaphysics
|[[Critical thinker]]
|-
|Existence
|The nature of existence.
|[[wikipedia:Existence|Existence]]
|Metaphysics
|[[Critical thinker]]
|-
|Mind body
|Discourse on the nature of mind and body
|[[wikipedia:Mind–body problem|Mind–body problem]]
|Metaphysics
|[[Critical thinker]]
|-
|Objects and properties
|The relationship between objects and their properties
|[[wikipedia:Essence|Essence]]
|Metaphysics
|[[Critical thinker]]
|-
|Processes
|The nature of processes
|[[wikipedia:Process philosophy|Process philosophy]]
|Metaphysics
|[[Critical thinker]]
|-
|Time
|Discourse on the nature of time
|[[wikipedia:Time|Time]]
|Metaphysics
|[[Critical thinker]]
|-
|Wholes and parts
|The relationship between wholes and parts
|[[wikipedia:Mereology|Mereology]]
|Metaphysics
|[[Critical thinker]]
|-
|Education
|Education, its forms and recommendations
|[[wikipedia:Education|Education]]
|Specialized
|[[Critical thinker]]
|-
|Law
|Discourse on law
|[[wikipedia:Law|Law]]
|Specialized
|[[Critical thinker]]
|-
|Dictionary
|Dictionaries
|[[wikipedia:Dictionary|Dictionary]]
|Specialized (language)
|[[Critical thinker]]
|-
|Etymology
|The notion of etymology
|[[wikipedia:Etymology|Etymology]]
|Specialized (language)
|[[Critical thinker]]
|-
|Grammar
|Grammar
|[[wikipedia:Grammar|Grammar]]
|Specialized (language)
|[[Critical thinker]]
|-
|Diplomacy
|Discourse on diplomacy
|[[wikipedia:Diplomacy|Diplomacy]]
|Specialized (politics)
|[[Critical thinker]]
|-
|Economic policy
|Discourse on economic policy
|[[wikipedia:Economic policy|Economic policy]]
|Specialized (politics)
|[[Critical thinker]]
|-
|Government forms
|Discourse on government
|[[wikipedia:Government|Government]]
|Specialized (politics)
|[[Critical thinker]]
|-
|Social welfare
|Discourse on social welfare
|[[wikipedia:Welfare|Welfare]]
|Specialized (politics)
|[[Critical thinker]]
|-
|Value agendas
|The philosopher will choose a [[belief]] that they have and write about the "worthlessness/nuances/value of (belief)". Reading these books will result in a dwarf's (or adventurer's) values changing. {{cite forum|154197.0}} {{cite devlog|2015|07|25}}
|[[wikipedia:Propaganda|Propaganda]]
|''n/a''
|
|}

v0.34:World Sites file

2014-06-24T13:35:47Z

Mason11987: /* Sites */ Added additional site info

User talk:Briess

2014-03-06T04:57:30Z

Mason11987: /* Hey! */ new section

{{archive|*[[User_talk:Briess/archive1|archive 1]]
*[[User_talk:Briess/archive2|archive 2]]
*[[User_talk:Briess/archive3|archive 3]]
*[[User_talk:Briess/archive4|archive 4]]
*[[User_talk:Briess/archive5|archive 5]]
}}

== German wiki links ==

79.206.195.135 (<s>Gerugon?</s>) [[DF2012 talk:Quickstart guide#German wiki|set up a German wiki]] and was wondering if you could add an interwiki link for it. --{{User:Lethosor/sig}} 18:42, 18 May 2013 (UTC)

:Sorry for misleading that is't gerugons IP that mine (Kupferdrache in german wiki, i have no account here yet, may be I should add one), but the german wiki is started by gerugon. Great that your replied so quick. I have another request could we get a full list of used namespaces so we don't have to break the layout, which will help us to keep articles up to date, also ist easier to link between the different language versions if the sorting is comparable, also ther is a DF translation project in progress to help this great game to get more attention (at the moment only as mod, but may be we cann get enough support to make it choosable in init.txt wich language should be used. I hope I didn#t forgot anything important. [[Special:Contributions/79.206.195.135|79.206.195.135]] 08:08, 19 May 2013 (UTC)
:: This should now be active. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 18:48, 10 December 2013 (UTC)

== File upload rights ==

Hi Briess. I'm currently trying to upload a couple of my images so I can add [http://www.bay12forums.com/smf/index.php?topic=126934.0 my new graphics set] to the [[DF2012:Graphics set repository|Graphics set repository]]. I'm an experienced Wikipedian (the ''real'' Wikipedia, that is, heh), so I was wondering if I should just wait for a few days for file upload permissions (like in Wikipedia) or is it exclusively granted by admins such as yourself?

Also I think the Jolly Bastion graphics set should be added there as well. --[[User:Obsidian Soul|Obsidian Soul]] ([[User talk:Obsidian Soul|talk]]) 03:00, 7 June 2013 (UTC)

:I believe it's 4 days and 3 edits, although I might be wrong about the days. Briess should be able to confirm you, but it's probably easier just to make a couple more edits. In the meantime I can upload them for you, but I'd need to know which ones and where to put them. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:10, 7 June 2013 (UTC)

::Hm, I forgot about the edit count to article space also contributing to the autoconfirmed rights. It's been so long since I had to do this in a wiki, heh. I'll just take a look around and see what I can fix in other articles, then upload them. I'll also take care of the Jolly Bastion set. If you know of any other graphics sets not in the wiki, it would be nice to add them as well for exposure. This is the primary resource when searching for graphics set and I found my first one here. Anyway, thanks. :) --[[User:Obsidian Soul|Obsidian Soul]] ([[User talk:Obsidian Soul|talk]]) 22:07, 7 June 2013 (UTC)

:::[[DF2012:Graphics set repository|Ok done]]. I've added the Jolly Bastion set as well and removed the empty sections.--[[User:Obsidian Soul|Obsidian Soul]] ([[User talk:Obsidian Soul|talk]]) 23:03, 7 June 2013 (UTC)
::::Awesome. Sorry I've been away - just to confirm, it is 3 edits to get autoconfirmed (I removed the 4 day requirement a couple of months ago). --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 05:21, 17 June 2013 (UTC)

== Offline HTML Dump ==

Hi Briess. I was wondering if it was possible for an HTML dump of the wiki to be created. That way the wiki can be viewed by DwarfForters like myself with limited/no internet access. I google'd around for mediawiki ways to do this and come up with [http://www.lee.org/blog/2008/08/17/how-to-create-an-html-dump-of-mediawiki/ this method] using the [http://www.mediawiki.org/wiki/Extension%3aDumpHTML DumpHTML] extension. It would be greatly appreciated if this could happen. – [[template:unsigned|unsigned]] comment by [[User:Bsilvereagle|Bsilvereagle]]

:From what I remember, size is a major issue with this wiki (due to the multiple namespaces). There used to be a dump of the DF2012 namespace listed in the announcements box ([http://dwarffortresswiki.org/index.php?title=Dwarf_Fortress_Wiki:Announcements&oldid=170946]). The link was removed, but apparently it's still accessible. I just downloaded it – it's about 10 MB, and appears to contain the latest revisions of all DF2012 articles (from yesterday, July 7) that I checked (it ''doesn't'' include articles from older namespaces, however). It's an XML dump, though, so I don't know how to make it work with various wiki-viewing tools. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 01:36, 8 July 2013 (UTC)
:Also: daD generated a basic HTML dump (which may be slightly outdated): [http://www.bay12forums.com/smf/index.php?topic=125494.0]. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 01:40, 8 July 2013 (UTC)
::Ah, I didn't know those existed. It's looking like daD's dump is what I'm after, it's downloading now. I guess I should have used Google instead of the wiki search bar for searching for offline.... Thanks Lethosor.

== Bot ==

I'm thinking of trying out a bot (not immediately, as it's still experimental), and was wondering if there are any policies regarding their creation here (would I be allowed to create a new account, do you need to test it first, etc.). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 18:55, 25 July 2013 (UTC)
: Only policies are bots are for people I trust. I trust you. If you create a new account, I'll set it up with the appropriate flags (just poke me here as you know how wonderful the recent changes list is for new accounts >.>) --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 18:57, 25 July 2013 (UTC)
:: Thanks :) It does show up on the recent changes differently (at least the way I created it), but just to confirm it's [[User:LethosorBot]]. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 19:32, 25 July 2013 (UTC)
::: Done! I also made you (and the bot) an administrator. No reason not to at this point. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 19:58, 25 July 2013 (UTC)
:::: Thanks! :) It'll be nice to be able to do some admin-related things when I need to. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:25, 25 July 2013 (UTC)

== Extension update ==

You might want to update [[wikipedia:mw:Extension:RegexFunctions|Extension:RegexFunctions]] to 1.4.3 — the current version has some type of security vulnerability, which looks like it might allow running arbitrary code. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:00, 25 July 2013 (UTC)
:: Thanks for the heads up. I've updated the extension. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 08:49, 26 July 2013 (UTC)

== A Chinese Version WIKI? ==

Hi Briess, I just a new player of DF. This WIKI site is awesome! It is pretty cool to do some translation when I am free. Is it a possible to make a Chinese version site of this? --[[User:Qianbb2004|Qianbb2004]] ([[User_talk:Qianbb2004|talk]]) 15:10, 02 August 2013 (UTC)

== Polish Dwarf Fortress wiki ==

Hello there!

I would like to add a link to Polish Dwarf Fortress wiki, so that it will be possible to connect every article from this page with <nowiki>[[pl:Article name]]</nowiki> template.

Here is a website: http://pl.dwarffortress.wikia.com/
and here is a main page: http://pl.dwarffortress.wikia.com/wiki/Dwarf_Fortress_Wiki

Thank you in advance, --[[User:Marzecki|Marzecki]] ([[User talk:Marzecki|talk]]) 14:23, 30 August 2013 (UTC)

:: Is there a chance and possibility to link Polish Dwarf Fortress Wikia on this wiki? Please, someone. Many of the players are visiting English Wiki, and some of them doesn't even know about existence of Polish Wiki! Part of them are teens, which english language level is poor - native language wiki is for them! Please someone :D --[[User:Marzecki|Marzecki]] ([[User talk:Marzecki|talk]]) 12:53, 2 December 2013 (UTC)
::: I'll take a look at doing that this weekend. Sorry for the delay! --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 01:17, 7 December 2013 (UTC)
:::: Finally! Waiting for url update :) --[[User:Marzecki|Marzecki]] ([[User talk:Marzecki|talk]]) 23:00, 9 December 2013 (UTC)
::: This should now be active. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 18:48, 10 December 2013 (UTC)
:::: Yes, alias "pl:SiteName" is active! '''But''', there is no "pl." at the beginning, so it redirects to non-existent wiki, showing up "This wiki was closed". Example: [[pl:Dwarf_Fortress_Wiki]] (http://dwarffortress.wikia.com/wiki/Dwarf_Fortress_Wiki) should be (http://pl.dwarffortress.wikia.com/wiki/Dwarf_Fortress_Wiki) --[[User:Marzecki|Marzecki]] ([[User talk:Marzecki|talk]]) 23:23, 11 December 2013 (UTC)
:::: Oops, sorry. I've fixed this. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 17:42, 14 December 2013 (UTC)
:::: Finally. I hope that now some Polish players will visit Polish wiki and consider writing a few articles. Thank you. --[[User:Marzecki|Marzecki]] ([[User talk:Marzecki|talk]]) 00:58, 15 December 2013 (UTC)

== Spambot activity ==
Hi, I was wondering whether you could add a filter option to the "recent changes" pages so it could hide user registrations: whenever I want to review the most recent changes it seems that the only things going on are a hundred or so spambot registrations. While I know you're doing the best you can about that, it'd be cool to be able to hide these useless events from view. Thanks! [[Special:Contributions/78.250.226.221|78.250.226.221]] 14:05, 7 September 2013 (UTC)

== Alternative captchas ==

It seems, from [[wikipedia:mw:Extension:ConfirmEdit|the ConfirmEdit page]], that ReCaptcha might not be as secure as other types of captchas. [http://wiki.uqm.stack.nl/ This wiki] seems to have solved this problem by using FancyCaptcha. While it might not be as secure (according to the page on mediawiki.org), its code is part of the extension, which means it can be easily modified to prevent automated scripts from succeeding, even if they guess the captcha correctly (check the source of the [http://wiki.uqm.stack.nl/script/index.php?title=Special:UserLogin&returnto=Main+Page&type=signup account creation page]). It seems to be reasonably effective - the change was made near the end of July, and only 3 accounts have been [http://wiki.uqm.stack.nl/script/index.php?title=Special%3ALog&type=newusers&user=&page=&year=&month=-1 created] since then. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 14:45, 7 September 2013 (UTC)
:I'll take a look when I'm over this nasty flu. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 08:28, 9 September 2013 (UTC)
::I am no longer dying sick, but I do have a business trip and a bunch of work to catch up on. If I haven't gotten to this in a week or so, feel free to yell at me to look at this. Thanks :) --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 02:50, 18 September 2013 (UTC)

== Italian main ==

Hi, I'm an user of the italian community, I'm here for ask to you if will be possible to create a main page with italian language, and after (subpages) the others page in italian.

In this moment the wiki use this link http://dwarffortresswiki.org/index.php/Main_Page
but for the italian page we can use http://dwarffortresswiki.org/index.php/Main_Page/italia or http://dwarffortresswiki.org/index.php/Main_Page/italy or http://dwarffortresswiki.org/index.php/Main_Page_Italy

I'm here only for ask and for information, if it is possible.

I'll wait answer.

Thanks a lot for your time.

NB
sorry for my english

:(Comment:) [http://mediawiki.org mediawiki.org] does something similar to this - I'm not sure how well it would work for some pages on this wiki, especially for pages that check the /raw subpage (they'd have to be rewritten to use the base raw page), but it's worth looking into.
:(Regarding the Italian wiki:) There's a [http://pl.dwarffortress.wikia.com/ Polish wiki] set up on Wikia - maybe this could be used as an alternative, and we could link to that (like the Russian/French links on the [[Main Page]]). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 00:43, 20 September 2013 (UTC)

:(comment): i see this www.wikidot.com, is a good site? ([[User talk:Jostino]]) 19:47, 20 September 2013 (GMT+200)

::Wikidot is a pretty good site, as well as Wikia (which may be better, since it uses the same software as this site). Unfortunately, this site uses a lot of extensions and modifications, which would be difficult, or even impossible, to set up on a large hosting site. I'll look more into the possibilities of hosting pages in different languages ''here'', which would be much easier to set up. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:04, 20 September 2013 (UTC)

== Additional languages ==

It may be considerably easier to set up non-English wikis on this site than on other wikis (as I mentioned above, the extensions and patches we use here would be hard to set up, even on a MediaWiki hosting site). Using this site would allow complex things (mainly templates and functions) to be used without being copied over to other wikis. Also, foreign-language wikis would tend to be a lot smaller than the main English wiki (due to fewer contributors), so size shouldn't be a problem. A few things I've found that could assist with this:
* Some templates exist that could probably be ported to this wiki: [[Wikipedia:mw:Template:Languages]] uses a lot of #ifexist checks (which could be deleted for languages we won't use at all). [[Wikipedia:meta:Template:Languages]] is similar, but adds <code>uselang=</code> to change the interface language for foreign-language pages (which could also be specified in the preferences, so I'm not sure how useful this is).
* [[Wikipedia:mw:Extension:Translate|Extension:Translate]] seems promising (it's used on some WMF wikis) - I haven't looked into it much, but I'll test it out when I get a chance.
--[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:31, 20 September 2013 (UTC)

Update: [[Wikipedia:mw:Extension:Translate|Extension:Translate]] is working very well - all that's required is adding <translate> tags around the page content. It lets any (logged-in) user edit translations by default, but pages need to be ''marked'' before they can be translated, which needs to be done by an admin by default (I'd recommend allowing at least autoconfirmed users to do this with something like <code>$wgGroupPermissions['autoconfirmed']['pagetranslation'] = true;</code>). [[Wikipedia:mw:MLEB|MLEB]] is the bundle I'm using - it includes a few useful multilingual extensions, including Translate, Babel, and a language selector (which allows you to change the interface language without messing around with your preferences.) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 17:26, 21 September 2013 (UTC)
:Interesting. I like the idea, but I can't do anything about it until I get back from my business trip. It's probably about time to update the mediawiki software too - I'll look into both at that time. Thanks for doing the research on this! --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 17:56, 21 September 2013 (UTC)
Templates have been harder to work out than content pages - the best method I've found so far is using {{#delay:int:}} to change the displayed text based on the interface language (which I suppose is more useful to end users anyway). Unfortunately, this would require editing MediaWiki: messages, which normal users can't do... :( 
Anyway, MediaWiki 1.22 should be released soon, so it may be worth waiting to upgrade (the only useful thing I've found in 1.21 is Ajax patrolling, which I've already [[User:Lethosor/ajaxpatrol.js|implemented]]). Also, if you end up doing software upgrades, [[Wikipedia:mw:Extension:WikiEditor|Extension:WikiEditor]] and [[Wikipedia:mw:Extension:CodeEditor|Extension:CodeEditor]] (and maybe even [[Wikipedia:mw:Extension:Scribunto|Extension:Scribunto]]) could be useful (WikiEditor is extensible, so it would be easy to set up DFWiki-specific editing customizations - maybe adding a [[CP437]] palette, for example). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 01:49, 22 September 2013 (UTC)

Well, I finally managed to get templates to work with translations (see {{tl|msg}}). Would you be able to deploy the multilingual extensions? (I can make a PR for it, but it'll require running update.php). Once they're installed, I can do the rest of the setup on the wiki. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:05, 4 November 2013 (UTC)

(They seem to be [http://lists.wikimedia.org/pipermail/mediawiki-i18n/2013-October/000762.html compatible] with both 1.20 and 1.21.) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:17, 4 November 2013 (UTC)

Unfortunately, I am slammed this week, so I won't really be able to start on them until next week. I am more than willing to set it up starting on next monday though. Only thing with update.php - we will need to make sure it's compatible with postgresql, or modify the extension SQL to be compatible with postgresql. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 17:21, 11 November 2013 (UTC)
:From what I can tell, the extensions use MediaWiki's database system, which is compatible with several database systems (including PostgreSQL), but I'll see if I can set up a test wiki with PostgreSQL to make sure. (I'm pretty busy this week myself, so I doubt I can get much done on this either :). I was hoping to get this set up in time for the next DF release, which gives us another couple of weeks at least.)--[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:44, 11 November 2013 (UTC)
::I may be taking some time off early next week. If I do so, I'll start working on this. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 17:21, 12 November 2013 (UTC)

Turns out that the Translate extension SQL is ''not'' compatible with PostgreSQL. I've managed to get the tables created successfully after messing around with a bunch of SQL conversion tools (see [https://gist.github.com/lethosor/7457533 this gist]), but there are still errors in the extension files that prevent the extension from actually working. I'll see if I can fix those, although it might make it hard to update in the future. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 22:44, 13 November 2013 (UTC)

I've made a little progress (the database error on Special:Translate no longer occurs), but translation doesn't work at all for some reason (probably because update.php won't run with the SQL modifications I've made, so the installation isn't complete yet). I'm reluctant to ask, but is MySQL a possible alternative? I've found that it tends to be better-supported than other database systems on MediaWiki (SQLite is supposedly well-supported too, but I doubt it would handle a large wiki very well). There are a variety of conversion tools that look promising, such as [http://dev.mysql.com/doc/workbench/en/wb-migration-database-postgresql.html MySQL workbench], but I haven't tested them to see if/how they work. If not, I'll continue my attempts at patching (which will hopefully work eventually). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 17:37, 24 November 2013 (UTC)

Never mind about that. :) I think I finally got the Translate extension to work with PostgreSQL (fortunately, it was the only one of the six that required any changes). I made a [https://gerrit.wikimedia.org/r/#/c/98045/ patch] for it, and I'll let you know how that turns out. (One thing to note is that the current Translate extension requires the current UniversalLanguageSelector extension as well – that is, not the <code>2013.10</code> branch – so either waiting for a new release or using the "master" branch would be necessary for now) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 01:59, 28 November 2013 (UTC)
:Go figure. I'm going to have limited availability over the thanksgiving holiday, but I'll take a look at things on the server starting when I get back. Also, do you have my skype information? it's the same as my github username. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 05:57, 28 November 2013 (UTC)
::I must have skipped over your response in the recent changes because I thought it was my own edit. -_- Anyway, Skype probably isn't the best way to contact me, but I'm usually available on the Bay12 forums and Gmail (and probably other places that I can't think of right now). Not that those are equivalent to Skype, but they're probably better than constantly editing talk pages.
::Also, my patch still has a few bugs, one of which causes deletion jobs to fail and display an ugly error message for every user that happens to run one of those jobs when it's in the queue, so don't include that just yet. (Hopefully I can get that fixed quickly.) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 01:01, 1 December 2013 (UTC)

== Database error when editing an IP talk page ==

<blockquote>
<div id="mw-content-text">A database query syntax error has occurred.
This may indicate a bug in the software.
The last attempted database query was:
<blockquote><code>(SQL query hidden)</code></blockquote>
from within function "<code>User::updateNewtalk</code>".
Database returned error "<samp>23502: ERROR: null value in column "user_id" violates not-null constraint
</samp>".</div>
</blockquote>
I'm not having this issue with 1.21, with a nearly-identical installation (except for the namespace-link patch, and I'm not sure how that could cause it). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:37, 24 September 2013 (UTC)

: Can you make a branch for me with your code as is on the dfwiki github? --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 21:00, 24 September 2013 (UTC)
::I meant that the error is occurring on ''this'' wiki - I haven't seen this issue on my own wiki, which uses pretty much the same extensions and settings (except it's using MW 1.21, which would make it hard to merge on GitHub). Fortunately, the problem isn't as severe as I thought - messages still get posted (see [[User talk:127.0.0.1]]), but it's still confusing to editors. I'm wondering if there are other patches you know of (besides the link patch) that have been installed on this wiki since the 1.20 upgrade, or if the database settings were recently changed. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:55, 24 September 2013 (UTC)
:::Not that I'm aware of. The code on github is what the wiki is using, minus the extensions, I believe (I may turn them into submodules at some point) --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 05:52, 4 October 2013 (UTC)
I'm guessing this is a PostgreSQL problem (it looks familiar ;) ). A MediaWiki upgrade might fix the problem, but I don't think it's major enough for that to be worthwhile. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 02:01, 28 November 2013 (UTC)

I just checked on the PostgreSQL wiki I set up to test the Translate extension and experienced the exact same problem (on 1.21). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 02:03, 28 November 2013 (UTC)

== Pull requests ==

Do you need to do anything special to merge in changes I made on the dfwiki repo, or are changes I make to master automatically merged? --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:41, 3 October 2013 (UTC)

: I merged them in, but deploys are manual. For some reason, I didn't get a notification of the pull request, I just fixed that so I do get them again. I'll deploy the change shortly. Also, I'm back from the business trip, yay! --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 05:51, 4 October 2013 (UTC)

== Email Contact ==

Hey there! I'm trying to get ahold of the administration team to talk about a partnership proposal, but I cannot find the proper channel to pursue. If you get the chance, can you drop an email at kristophermsandoval@gmail.com and let me know the proper channel to go through? Thank you so much! I look forward to hearing from you! [[Special:Contributions/24.10.3.183|24.10.3.183]] 19:24, 7 October 2013 (UTC)

== Spam prevention ==

I found a couple interesting strategies that could prevent automated account registration entirely, while still allowing users to create accounts normally:
* Disabling [[wikipedia:mw:API:Account creation|the account creation API]] would block account registrations using api.php instead of [[Special:CreateAccount]]:
:<pre>$wgAPIModules['createaccount'] = 'ApiDisabled';</pre>
* If it turns out that the spammers use [[Special:CreateAccount]] instead (which is less likely), someone at MediaWiki has [https://www.mediawiki.org/wiki/Talk:Anti-spam_features#random_or_editable_Special:UserLogin_link suggested] renaming [[Special:UserLogin]] (or CreateAccount), which would allow it to be accessible with the navigation links but not by a direct URL. I'm not sure how this would be done, but it's probably possible since changing the wiki language changes special pages' URLs.
* Cookiepedia has their [http://www.cookipedia.co.uk/recipes_wiki/File:Vhost.conf.txt config file] publicly available, which contains IP's of many spammers. I'm not sure how up-to-date it is, but it appears to be working for them.
* Lastly, blocking requests with an empty User-Agent header has worked in the past. I doubt many current spambots would be blocked by this trick, however.
It may even be possible to remove captchas entirely if one of these methods works, which would be a lot less irritating for new users. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:46, 11 December 2013 (UTC)
: Unfortunately, we already disable API account creation, and I block a bunch of IPs very aggressively at the nginx layer (updated via cron job daily). I haven't done anything with user-agent yet, but that may be worth looking into. --21:51, 11 December 2013 (UTC)
:: Looks like I forgot to check the settings again. -_- I've managed to find a simple method that prevents [[Special:CreateAccount]] from working when accessed directly, which I put on Github in the <code>test-login</code> branch. I'm not sure how effective it is – the alternate captcha method above may be a better solution. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 22:12, 11 December 2013 (UTC)
:: I've also found that it's possible to change the <code>wpRetype</code> field in the password form, which would prevent (generic) automated submissions. I'm not sure how automated they are, though, since they can get through the captcha (occasionally – maybe they just guess?). --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 22:31, 11 December 2013 (UTC)
::QuestyCaptcha could probably work too, since it can be easily customized for an individual wiki (although eventually spammers might figure them out). Maybe with DFRawFunctions we could set it up to generate random questions on DF-related things, although that would probably be complicated. (Sorry about the multiple edits/notifications, by the way :)) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 22:38, 11 December 2013 (UTC)
I found [[wikipedia:mw:Extension:ConfirmAccount|Extension:ConfirmAccount]], which seemed like it required too much information to be usable on this wiki (biography, real name, an optional resume, etc.), but it turns out that's easy to disable:
<pre>
$wgConfirmAccountRequestFormItems['RealName']['enabled'] = false;
$wgConfirmAccountRequestFormItems['Biography']['enabled'] = false;
$wgConfirmAccountRequestFormItems['CV']['enabled'] = false;
$wgConfirmAccountRequestFormItems['Notes']['enabled'] = false;
$wgConfirmAccountRequestFormItems['Links']['enabled'] = false;
$wgConfirmAccountRequestFormItems['TermsOfService']['enabled'] = false;
// To allow admins to confirm accounts:
$wgGroupPermissions['sysop']['confirmaccount'] = true;
</pre>
This would require users to enter a username and email address to create an account, which would then be confirmed by an admin and by email. 
Anyway, this would almost certainly stop the spam registrations, although I'm not sure if it's worth it (for admins and users). Any thoughts on this? --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:31, 13 December 2013 (UTC)
: It's certainly an option, but I would prefer something that doesn't require a bunch of administrator action. That would be hell. I'm wondering if renaming the signup page will be enough to combat the issue. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 05:12, 13 December 2013 (UTC)
: Although, I'm not against requiring an email confirmation, but I would probably have to do some work on the email service to make it behave a little better with more providers. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 05:13, 13 December 2013 (UTC)

== Announcements ==

[[Mediawiki:Siteannounce]] (the announcement box) has gone missing (but [[DF:Announcements]] is still intact). This causes an error with [[User:Briess/hideAnnouncements.js]], although it doesn't appear to be causing any major problems. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 15:59, 21 December 2013 (UTC)

Thanks for catching my edit on {{tl|rounded info box}}. Apparently a <div> tag on the same line as Mediawiki's {| table syntax ''breaks the table''. But not the whole table. Just the ''start'' of the table. The end of the table gets parsed perfectly, which caused things that should have been inside a table to float around the page. And adding a newline before the table in the red box doesn't change anything. (Okay, that's probably because of Mediawiki's whitespace stripping, but that doesn't explain why ''every other box on the page worked'' with my change.) I would have tested it more thoroughly, except I thought that wrapping something in a <div> tag wouldn't do anything. This is why I hate Mediawiki table syntax (although HTML table syntax isn't much better. I tried {{tl|columns}} as a [[User:Lethosor/Main Page|replacement]], but apparently it doesn't work in Firefox :( ) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:24, 23 December 2013 (UTC)
: No worries. I unfortunately have been very busy, or I would have tried to fix it instead of just reverting it. I'll create an issue soon on github about announcements and I'll discuss what Emily and I talked about with announcements. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 04:34, 23 December 2013 (UTC)

[https://www.mediawiki.org/wiki/Extension:DismissableSiteNotice This extension] looks interesting, although it only works well for a single, temporary announcement. It might be possible to modify it, though. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 01:38, 12 January 2014 (UTC)

I think the problem was that the relevant system message is actually [[Mediawiki:Sitenotice]]. (I thought it was a Mediawiki bug that was causing the history to vanish this whole time). —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:49, 24 January 2014 (UTC)

Anyway, how's [[Dwarf_Fortress_Wiki:Announcements/box|this]] for now? I'm thinking of adding it to the recent changes page (see below), although it might be a little big - I can try adjusting the old JS to work with it, or make it possible to hide them in the preferences. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:17, 17 February 2014 (UTC)

== Dutch wiki translation ==

Hi.
As you probably not know, I am a very fluent Dutch speaker, and I think I could make a dutch translation of the wiki(partially, and definitely not alone). How about it?
 {{User:Latias1290/Sig/src|13:33|January 15, 2014}}
: We are looking at solutions for hosting translations locally on the wiki at this time. I'm not sure how long before we're ready, but when we are I'll let you know. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 20:22, 15 January 2014 (UTC)

== [[:File:FunComic.png]] missing ==

Pointed out [[Talk:Main_Page#Fun_Comic|here]]. It may be related to [[:File:Roach.png]]'s disappearance a while back, although that image (and the others) are working now. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:28, 23 January 2014 (UTC)
:Rebuilding all images now. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 21:54, 23 January 2014 (UTC)

== Recent changes text ==

The Community Portal is a helpful resource for filtering through recent changes.
Any idea where this text is coming from? Passing "uselang=qqx" (which usually displays the message names) does nothing: [http://i.imgur.com/ZBH6hcJ.png]. Searching the wiki repo also turns up nothing.

—[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 22:23, 8 February 2014 (UTC)

:I honestly have no idea. --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 04:36, 12 February 2014 (UTC)

::It turns out it is, in fact, [[MediaWiki:Recentchangestext]] (see the title of this section). I found it on [[Special:Allmessages]], but it's strange that it doesn't show up with uselang=qqx. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 19:47, 17 February 2014 (UTC)
::: welp --[[User:Briess|Briess]] ([[User talk:Briess|talk]]) 19:56, 17 February 2014 (UTC)

== Hey! ==

Kind of crazy that I just today decided to take a look here and sign in and saw a "new message" from you from April 2013 :P. Glad to see you guys are going strong still! I might take a look around and see if I can help some for the '''hopefully''' soon to come release :). [[User:Mason11987|Mason]] ([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]]) 04:57, 6 March 2014 (UTC)

v0.34:XML dump

2012-02-23T03:26:45Z

Mason11987: this is a much bigger change, but I think a holder page is useful with a brief note until we can get it all up correctly here. Please don't copy paste from the old version without serious editing

{{av}}
{{Quality|Tattered|02:39, 23 February 2012 (UTC)}}

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

The XML dump has had significant changes since the [[v0.31:XML dump|v0.31 version]], although that page should be useful until this page can be rewritten.

== See Also ==

* [[Legends|Legends Mode]]
* [[World History file]]
* [[World Sites file]]

v0.34:World Sites file

2012-02-23T03:21:17Z

Mason11987: This definitely could use some additions, but it's a decent start.

v0.34:World History file

2012-02-23T03:10:11Z

Mason11987:

{{av}}
{{Quality|Fine|03:08, 23 February 2012 (UTC)}}

In [[Legends]] Mode, pressing the {{k|p}} (Export Map/Gen information) will create three files in the root directory of DF, one of those files is the '''World History file''' named (save name)-world_history.txt.

== File Breakdown ==

Below the history file will be explained in detail, using portions from an example file to show all of the possibilities.

=== World Name ===
At the top of the file is the World name, and nickname.

<pre>
Mareecamo EwŠ
The Soul-Universe of Enchanting
</pre>

=== Unintelligent Civs ===

Following the world name is a series of names of different unintelligent civs which exist in the world, no further information can be gathered from these files about these civs.

<pre>
Mareecamo EwŠ
The Soul-Universe of Enchanting

Cave fish men
Serpent men
Reptile men
Bat men
Antmen
Cave swallow men
Olm men
... (Multiple more lines)
</pre>

=== Civilizations ===
The majority of the useful information in the history file exists within the civilizations, which follow immediately after the unintelligent civs. A short example civ is shown below, but the components will be viewed in detail afterwards.

<pre>
Bat men
Amphibian men
Cave swallow men
The Hammer of Seers, Dwarves
Worship List
Engig the Bright Pearls, deity: metals, jewels, wealth
Onget the Fiery Oil, deity: mountains, volcanos
Laltur, deity: fortresses
Ral Minedirons, deity: minerals
Mirstal, deity: music, festivals, song
Kogan Coastalpaddled, deity: rivers
king List
[*] Logem Anvilentrance (b.??? d. 36, Reign Began: 1), *** Original Line, Married (d. 8)
4 Children (out-lived 1 of them) -- Ages at death: 32 31 29 (d. 14)
Worshipped Onget the Fiery Oil (61%)
[*] Bomrek Championboulder (b.7 d. 51, Reign Began: 37), Inherited from mother, Never Married
No Children
Worshipped Onget the Fiery Oil (94%)
[*] Cog Cloisteredrazors (b.???, Reign Began: 52), *** New Line, Married
14 Children -- Ages: 62 61 60 59 54 51 36 31 24 18 16 15 12 4
Worships Mirstal (32%)
</pre>

==== Civ Name and Race ====
The Civ name is at the top of the section for each civ, along with the race of the civ.

<pre>
The Hammer of Seers, Dwarves
</pre>

==== Worship List ====
If the civ has any Deities or Forces they have ever worshipped then this section will exist, beginning with the text:

<pre> Worship List</pre>

Each individual line refers to a different force or deity. First the deity name, then whether they are a "deity" or "force", and finally a list of the [[sphere]]s they belong to, or control.

<pre> Istrath the Gravel of Oiling, deity: earth, wealth</pre>

==== Leader List ====
If the civ has had any leaders, they will be listed according to what type of leader they are (king/queen/law-giver/ect.):

<pre> king List</pre>

Each individual leader begins with the text <code>[*]</code>, and has two or three lines. Those are:
<pre>
[*] Logem Anvilentrance (b.??? d. 36, Reign Began: 1), *** Original Line, Married (d. 8)
4 Children (out-lived 1 of them) -- Ages at death: 32 31 29 (d. 14)
Worshipped Onget the Fiery Oil (61%)
</pre>
*'''Leader Name and Life''': <code> Logem Anvilentrance (b.??? d. 36, Reign Began: 1), *** Original Line, Married (d. 8) </code>
*'''Leader Children''': <code> 4 Children (out-lived 1 of them) -- Ages at death: 32 31 29 (d. 14) </code>
*'''Leader Worship''': <code> Worshipped Onget the Fiery Oil (61%) </code>

'''Leader Name and Life''' is made up of several pieces of information.
:*The leaders name: <code>Logem Anvilentrance</code>
:*The leaders birth year: <code> (b.???</code>
:**This is represented as ??? if the leader was born before history (before year 1).
:**If there is a year, there is no space between the "b." and the year. ex: <code> (b.66</code>
:*The leaders death year: <code> d. 36</code>
:**If the leader hasn't died, this won't be listed.
:**There '''is''' a space between the "d." and the year.
:*The year the leader's reign began: <code>, Reign Began: 1),</code>
:*How the Leader acquired power, either by being the original leader (<code> *** Original Line,</code>), starting a new line (<code> *** New Line,</code>), or by inheriting the position (<code> Inherited from </code>)
:*If the position was inherited, it will list who they received it from. The possibilities:
:**Father - <code> Inherited from father,</code>
:**Mother - <code> Inherited from mother,</code>
:**Paternal Grandfather - <code> Inherited from paternal grandfather,</code>
:**Paternal Grandmother - <code> Inherited from paternal grandmother,</code>
:**Maternal Grandfather - <code> Inherited from maternal grandfather,</code>
:**Maternal Grandmother - <code> Inherited from maternal grandmother,</code>
:**Unknown - <code> Inherited from,</code>
:*The marriage of this leader. Either: <code> Never Married</code> or <code> Married</code>
:*If the leader has married, and the spouse died, it'll list the year they died <code> Married (d. 8)</code>

'''Leader Children''' is made up of several pieces of information about a leader's children (if any)
:*Number of children: <code>No Children</code>, <code>1 Child</code> or <code>x Children</code>, where "x" is the number of children >1
:*Number of outlived children, which is some number less than or equal to the number of children: <code> (out-lived 9 of them) </code>. If the leader outlived none, then this part won't be given.
:*Ages (at death) of children. Listed with <code>-- Ages at death: </code> if the leader has died, otherwise with <code>-- Ages</code>
:**It will list as "Ages" even if there was only one child.
:*The ages at death will be listed as numbers separated by spaces: (<code>37 31 27 9</code>), or if the child was outlived, with the year they died: (<code>(d. 32) (d. 29) (d. 8)</code>)
:**There aren't always the right number of items in this list, at times some children ages might not be listed.{{verify}}

*'''Leader Worship''' gives information about the leader's deity/force of worship, if they did not worship, this line won't exist.
:*Worship object name: <code>Worshipped Onget the Fiery Oil</code>
:*Degree of worship: <code>(61%)</code>
:**Between 1% and 100% inclusive.

== See Also ==

* [[Legends|Legends Mode]]
* [[World Sites file]]
* [[XML dump]]

v0.34:World History file

2012-02-23T03:08:25Z

Mason11987: Looks like it's almost completely the same, there is one "verify" that will require testing against a large history dump to check

v0.34:World History file

2012-02-23T02:40:10Z

Mason11987:

{{av}}
{{Quality|Tattered|02:39, 23 February 2012 (UTC)}}

== See Also ==

* [[World Sites file]]
* [[XML dump]]

v0.34:World Sites file

2012-02-23T02:40:06Z

Mason11987:

{{av}}
{{quality|Tattered|02:38, 23 February 2012 (UTC)}}

== See Also ==

* [[World History file]]
* [[XML dump]]

v0.34:XML dump

2012-02-23T02:39:44Z

Mason11987: Created page with "{{av}} {{Quality|Tattered|~~~~~}} == See Also == * World History file * World Sites file"

{{av}}
{{Quality|Tattered|02:39, 23 February 2012 (UTC)}}

== See Also ==

* [[World History file]]
* [[World Sites file]]

v0.34:World History file

2012-02-23T02:39:38Z

Mason11987: Created page with "{{av}} {{Quality|Tattered|~~~~~}} == See Also == * World Sites file * XML Dump"

{{av}}
{{Quality|Tattered|02:39, 23 February 2012 (UTC)}}

== See Also ==

* [[World Sites file]]
* [[XML Dump]]

v0.34:World Sites file

2012-02-23T02:38:59Z

Mason11987:

{{av}}
{{quality|Tattered|02:38, 23 February 2012 (UTC)}}

== See Also ==

* [[World History file]]
* [[XML Dump]]

v0.34:World Sites file

2012-02-23T02:38:09Z

Mason11987: Working on these pages

v0.31:XML dump

2012-02-23T02:35:57Z

Mason11987:

{{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 Dwarf Fortress' root folder.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.
== world_constructions ==

== artifacts ==

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (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

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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 ===
'''.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===
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 ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_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
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''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 ===
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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== 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 ===
*attacker_civ_id
*new_site_civ_id
*defender_civ_id
*site_civ_id
*site_id

== historical_event_collections ==
'''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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

{{Category|Guides}}

v0.31:World History file

2010-12-28T11:12:43Z

Mason11987:

{{av}}
{{Quality|Fine|11:12, 28 December 2010 (UTC)}}

In {{L|Legends}} Mode, pressing the {{k|p}} (Export Map/Gen information) will create three files in the root directory of DF, one of those files is the '''World History file''' named (save name)-world_history.txt.

== File Breakdown ==

Below the history file will be explained in detail, using portions from an example file to show all of the possibilities.

=== World Name ===
At the top of the file is the World name, and nickname.

<pre>
Ikuinenplaneetta
The Eternal Planet
</pre>

=== Unintelligent Civs ===

Following the world name is a series of names of different unintelligent civs which exist in the world, no further information can be gathered from these files about these civs.

<pre>
Ikuinenplaneetta
The Eternal Planet

Olm men
Cave swallow men
Bat men
Olm men
Cave swallow men
... (Multiple more lines)
</pre>

=== Civilizations ===
The majority of the useful information in the history file exists within the civilizations, which follow immediately after the unintelligent civs. A short example civ is shown below, but the components will be viewed in detail afterwards.

<pre>
Olm men
Cave swallow men
Antmen
The Standards of Brushing, Dwarves
Worship List
Istrath the Gravel of Oiling, deity: earth, wealth
Kerlig, deity: fortresses
king List
[*] Stinthad Paddledrock (b.???, Reign Began: 1), *** Original Line, Never Married
No Children
[*] Obok Firecrypt (b.??? d. 84, Reign Began: 5), *** New Line, Married (d. 77)
14 Children (out-lived 9 of them) -- Ages at death: (d. 32) (d. 29) (d. 8) (d. 16) (d. 16) 67 (d. 30) (d. 30) (d. 48) (d. 48) 37 31 27 9
Worshipped Tabmik the Larval Filths (48%)
</pre>

==== Civ Name and Race ====
The Civ name is at the top of the section for each civ, along with the race of the civ.

<pre>
The Standards of Brushing, Dwarves
</pre>

==== Worship List ====
If the civ has any Deities or Forces they have ever worshipped then this section will exist, beginning with the text:

<pre> Worship List</pre>

Each individual line refers to a different force or deity. First the deity name, then whether they are a "deity" or "force", and finally a list of the {{L|sphere}}s they belong to, or control.

<pre> Istrath the Gravel of Oiling, deity: earth, wealth</pre>

==== Leader List ====
If the civ has had any leaders, they will be listed according to what type of leader they are (king/queen/law-giver/ect.):

<pre> king List</pre>

Each individual leader begins with the text <pre>[*]</pre>, and has two or three lines. Those are:

[*] Obok Firecrypt (b.??? d. 84, Reign Began: 5), *** New Line, Married (d. 77)
14 Children (out-lived 9 of them) -- Ages at death: (d. 32) (d. 29) (d. 8) (d. 16) (d. 16) 67 (d. 30) (d. 30) (d. 48) (d. 48) 37 31 27 9
Worshipped Tabmik the Larval Filths (48%)

*'''Leader Name and Life''': <code> Obok Firecrypt (b.??? d. 84, Reign Began: 5), *** New Line, Married (d. 77) </code>
*'''Leader Children''': <code> 14 Children (out-lived 9 of them) -- Ages at death: (d. 32) (d. 29) (d. 8) (d. 16) (d. 16) 67 (d. 30) (d. 30) (d. 48) (d. 48) 37 31 27 9 </code>
*'''Leader Worship''': <code> Worshipped Tabmik the Larval Filths (48%) </code>

'''Leader Name and Life''' is made up of several pieces of information.
:*The leaders name: <code>Obok Firecrypt</code>
:*The leaders birth year: <code> (b.???</code>
:**This is represented as ??? if the leader was born before history (before year 1).
:**If there is a year, there is no space between the "b." and the year. ex: <code> (b.66</code>
:*The leaders death year: <code> d. 84</code>
:**If the leader hasn't died, this won't be listed.
:**There '''is''' a space between the "d." and the year.
:*The year the leader's reign began: <code>, Reign Began: 5),</code>
:*How the Leader acquired power, either by being the original leader (<code> *** Original Line,</code>), starting a new line (<code> *** New Line,</code>), or by inheriting the position (<code> Inherited from </code>)
:*If the position was inherited, it will list who they received it from. The possibilities:
:**Father - <code> Inherited from father,</code>
:**Mother - <code> Inherited from mother,</code>
:**Paternal Grandfather - <code> Inherited from paternal grandfather,</code>
:**Paternal Grandmother - <code> Inherited from paternal grandmother,</code>
:**Maternal Grandfather - <code> Inherited from maternal grandfather,</code>
:**Maternal Grandmother - <code> Inherited from maternal grandmother,</code>
:**Unknown - <code> Inherited from,</code>
:*The marriage of this leader. Either: <code> Never Married</code> or <code> Married</code>
:*If the leader has married, and the spouse died, it'll list the year they died <code> Married (d. 77)</code>

'''Leader Children''' is made up of several pieces of information about a leader's children (if any)
:*Number of children: <code>No Children</code>, <code>1 Child</code> or <code>x Children</code>, where "x" is the number of children >1
:*Number of outlived children, which is some number less than or equal to the number of children: <code> (out-lived 9 of them) </code>. If the leader outlived none, then this part won't be given.
:*Ages (at death) of children. Listed with <code>-- Ages at death: </code> if the leader has died, otherwise with <code>-- Ages</code>
:**It will list as "Ages" even if there was only one child.
:*The ages at death will be listed as numbers separated by spaces: (<code>37 31 27 9</code>), or if the child was outlived, with the year they died: (<code>(d. 32) (d. 29) (d. 8)</code>)
:**There aren't always the right number of items in this list, at times some children ages might not be listed.

*'''Leader Worship''' gives information about the leader's deity/force of worship, if they did not worship, this line won't exist.
:*Worship object name: <code>Worshipped Tabmik the Larval Filths</code>
:*Degree of worship: <code>(48%)</code>
:**Between 1% and 100% inclusive.

40d:World History file

2010-12-28T11:12:07Z

Mason11987: Rated article "Fine" using the rating script

{{quality|Fine|11:12, 28 December 2010 (UTC)}}{{av}}

In {{L|Legends}} Mode, pressing the {{k|p}} (Export Map/Gen information) will create three files in the root directory of DF, one of those files is the '''World History file''' named (save name)-world_history.txt.

== File Breakdown ==

Below the history file will be explained in detail, using portions from an example file to show all of the possibilities.

=== World Name ===
At the top of the file is the World name, and nickname.

<pre>
Ikuinenplaneetta
The Eternal Planet
</pre>

=== Civilizations ===
The majority of the useful information in the history file exists within the civilizations, which follow immediately after the name. A short example civ is shown below, but the components will be viewed in detail afterwards.

<pre>
Osmlo Ud”
The Dimensions of Soul

The Fountain of Entrancing, Dwarves
Worship List
RŒsen the Silvery Merchants, deity: metals, minerals, jewels, wealth, trade
Bufut, deity: fortresses, war, valor
¢k Crestoil the Walled Point, deity: mountains
RŒthol Noblereigned, deity: rulership
Som, deity: speech
B†l the Whiteness of Blueness, deity: the dawn
Lemis the Leopard of Roots, deity: animals, plants
Inod, deity: boundaries
T¡lgil, deity: family, children
Iden, deity: the rain
Shadmal Sneaksecrets, deity: darkness
Tesum, deity: thunder
Ruler List
[*] Šrith Ringjewel (b.??? d. 22, Reign Began: 1), *** Original Line, Married (d. 99)
4 Children -- Ages at death: 21 20 17 15
Worshipped B†l the Whiteness of Blueness (61%)
[*] Tekkud Honestpaint (b.5, Reign Began: 23), Inherited from father, Married (d. 91)
10 Children -- Ages: 94 92 90 87 73 65 40 34 31 26
Worships B†l the Whiteness of Blueness (72%)
</pre>

==== Civ Name and Race ====
The Civ name is at the top of the section for each civ, along with the race of the civ.

<pre>
The Fountain of Entrancing, Dwarves
</pre>

==== Worship List ====
If the civ has any Deities or Forces they have ever worshipped then this section will exist, beginning with the text:

<pre> Worship List</pre>

Each individual line refers to a different force or deity. First the deity name, then whether they are a "deity" or "force", and finally a list of the {{L|sphere}}s they belong to, or control. Unlike .31.x versions, these spheres can sometimes be made up of two words, like "the rain"

<pre> RŒsen the Silvery Merchants, deity: metals, minerals, jewels, wealth, trade</pre>

==== Ruler List ====
If the civ has had any rulers.

<pre> Ruler List</pre>

Each individual ruler begins with the text <pre>[*]</pre>, and has two or three lines. Those are:

<pre>
[*] Šrith Ringjewel (b.??? d. 22, Reign Began: 1), *** Original Line, Married (d. 99)
4 Children -- Ages at death: 21 20 17 15
Worshipped B†l the Whiteness of Blueness (61%)
</pre>

*'''Ruler Name and Life''': <code> [*] Šrith Ringjewel (b.??? d. 22, Reign Began: 1), *** Original Line, Married (d. 99) </code>
*'''Ruler Children''': <code> 4 Children -- Ages at death: 21 20 17 15 </code>
*'''Ruler Worship''': <code> Worshipped B†l the Whiteness of Blueness (61%) </code>

'''Ruler Name and Life''' is made up of several pieces of information.
:*The rulers name: <code>Šrith Ringjewel</code>
:*The rulers birth year: <code> (b.???</code>
:**This is represented as ??? if the ruler was born before history (before year 1).
:**If there is a year, there is no space between the "b." and the year. ex: <code> (b.66</code>
:*The rulers death year: <code> d. 84</code>
:**If the ruler hasn't died, this won't be listed.
:**There '''is''' a space between the "d." and the year.
:*The year the ruler's reign began: <code>, Reign Began: 5),</code>
:*How the Ruler acquired power, either by being the original ruler (<code> *** Original Line,</code>), starting a new line (<code> *** New Line,</code>), or by inheriting the position (<code> Inherited from </code>)
:*If the position was inherited, it will list who they received it from. The possibilities:
:**Father - <code> Inherited from father,</code>
:**Mother - <code> Inherited from mother,</code>
:**Paternal Grandfather - <code> Inherited from paternal grandfather,</code>
:**Paternal Grandmother - <code> Inherited from paternal grandmother,</code>
:**Maternal Grandfather - <code> Inherited from maternal grandfather,</code>
:**Maternal Grandmother - <code> Inherited from maternal grandmother,</code>
:**Unknown - <code> Inherited from,</code> (this may only exist in .31.18. Not yet confirmed in 40d)
:*The marriage of this ruler. Either: <code> Never Married</code> or <code> Married</code>
:*If the ruler has married, and the spouse died, it'll list the year they died <code> Married (d. 77)</code>

'''Ruler Children''' is made up of several pieces of information about a ruler's children (if any)
:*Number of children: <code>No Children</code>, <code>1 Child</code> or <code>x Children</code>, where "x" is the number of children >1
:*Number of outlived children, which is some number less than or equal to the number of children: <code> (out-lived 9 of them) </code>. If the ruler outlived none, then this part won't be given.
:*Ages (at death) of children. Listed with <code>-- Ages at death: </code> if the ruler has died, otherwise with <code>-- Ages</code>
:**It will list as "Ages" even if there was only one child.
:*The ages at death will be listed as numbers separated by spaces: (<code>37 31 27 9</code>), or if the child was outlived, with the year they died: (<code>(d. 32) (d. 29) (d. 8)</code>)
:**There aren't always the right number of items in this list, at times some children ages might not be listed.

*'''Ruler Worship''' gives information about the ruler's deity/force of worship, if they did not worship, this line won't exist.
:*Worship object name: <code>Worshipped B†l the Whiteness of Blueness</code>
:*Degree of worship: <code>(61%)</code>
:**Between 1% and 100% inclusive.

40d:World History file

2010-12-28T11:11:11Z

Mason11987: from .31.x version, there are some changes though

{{av}}
{{Quality|Tattered|00:51, 21 December 2010 (UTC)}}

In {{L|Legends}} Mode, pressing the {{k|p}} (Export Map/Gen information) will create three files in the root directory of DF, one of those files is the '''World History file''' named (save name)-world_history.txt.

== File Breakdown ==

Below the history file will be explained in detail, using portions from an example file to show all of the possibilities.

=== World Name ===
At the top of the file is the World name, and nickname.

<pre>
Ikuinenplaneetta
The Eternal Planet
</pre>

=== Civilizations ===
The majority of the useful information in the history file exists within the civilizations, which follow immediately after the name. A short example civ is shown below, but the components will be viewed in detail afterwards.

<pre>
Osmlo Ud”
The Dimensions of Soul

The Fountain of Entrancing, Dwarves
Worship List
RŒsen the Silvery Merchants, deity: metals, minerals, jewels, wealth, trade
Bufut, deity: fortresses, war, valor
¢k Crestoil the Walled Point, deity: mountains
RŒthol Noblereigned, deity: rulership
Som, deity: speech
B†l the Whiteness of Blueness, deity: the dawn
Lemis the Leopard of Roots, deity: animals, plants
Inod, deity: boundaries
T¡lgil, deity: family, children
Iden, deity: the rain
Shadmal Sneaksecrets, deity: darkness
Tesum, deity: thunder
Ruler List
[*] Šrith Ringjewel (b.??? d. 22, Reign Began: 1), *** Original Line, Married (d. 99)
4 Children -- Ages at death: 21 20 17 15
Worshipped B†l the Whiteness of Blueness (61%)
[*] Tekkud Honestpaint (b.5, Reign Began: 23), Inherited from father, Married (d. 91)
10 Children -- Ages: 94 92 90 87 73 65 40 34 31 26
Worships B†l the Whiteness of Blueness (72%)
</pre>

==== Civ Name and Race ====
The Civ name is at the top of the section for each civ, along with the race of the civ.

<pre>
The Fountain of Entrancing, Dwarves
</pre>

==== Worship List ====
If the civ has any Deities or Forces they have ever worshipped then this section will exist, beginning with the text:

<pre> Worship List</pre>

Each individual line refers to a different force or deity. First the deity name, then whether they are a "deity" or "force", and finally a list of the {{L|sphere}}s they belong to, or control. Unlike .31.x versions, these spheres can sometimes be made up of two words, like "the rain"

<pre> RŒsen the Silvery Merchants, deity: metals, minerals, jewels, wealth, trade</pre>

==== Ruler List ====
If the civ has had any rulers.

<pre> Ruler List</pre>

Each individual ruler begins with the text <pre>[*]</pre>, and has two or three lines. Those are:

<pre>
[*] Šrith Ringjewel (b.??? d. 22, Reign Began: 1), *** Original Line, Married (d. 99)
4 Children -- Ages at death: 21 20 17 15
Worshipped B†l the Whiteness of Blueness (61%)
</pre>

*'''Ruler Name and Life''': <code> [*] Šrith Ringjewel (b.??? d. 22, Reign Began: 1), *** Original Line, Married (d. 99) </code>
*'''Ruler Children''': <code> 4 Children -- Ages at death: 21 20 17 15 </code>
*'''Ruler Worship''': <code> Worshipped B†l the Whiteness of Blueness (61%) </code>

'''Ruler Name and Life''' is made up of several pieces of information.
:*The rulers name: <code>Šrith Ringjewel</code>
:*The rulers birth year: <code> (b.???</code>
:**This is represented as ??? if the ruler was born before history (before year 1).
:**If there is a year, there is no space between the "b." and the year. ex: <code> (b.66</code>
:*The rulers death year: <code> d. 84</code>
:**If the ruler hasn't died, this won't be listed.
:**There '''is''' a space between the "d." and the year.
:*The year the ruler's reign began: <code>, Reign Began: 5),</code>
:*How the Ruler acquired power, either by being the original ruler (<code> *** Original Line,</code>), starting a new line (<code> *** New Line,</code>), or by inheriting the position (<code> Inherited from </code>)
:*If the position was inherited, it will list who they received it from. The possibilities:
:**Father - <code> Inherited from father,</code>
:**Mother - <code> Inherited from mother,</code>
:**Paternal Grandfather - <code> Inherited from paternal grandfather,</code>
:**Paternal Grandmother - <code> Inherited from paternal grandmother,</code>
:**Maternal Grandfather - <code> Inherited from maternal grandfather,</code>
:**Maternal Grandmother - <code> Inherited from maternal grandmother,</code>
:**Unknown - <code> Inherited from,</code> (this may only exist in .31.18. Not yet confirmed in 40d)
:*The marriage of this ruler. Either: <code> Never Married</code> or <code> Married</code>
:*If the ruler has married, and the spouse died, it'll list the year they died <code> Married (d. 77)</code>

'''Ruler Children''' is made up of several pieces of information about a ruler's children (if any)
:*Number of children: <code>No Children</code>, <code>1 Child</code> or <code>x Children</code>, where "x" is the number of children >1
:*Number of outlived children, which is some number less than or equal to the number of children: <code> (out-lived 9 of them) </code>. If the ruler outlived none, then this part won't be given.
:*Ages (at death) of children. Listed with <code>-- Ages at death: </code> if the ruler has died, otherwise with <code>-- Ages</code>
:**It will list as "Ages" even if there was only one child.
:*The ages at death will be listed as numbers separated by spaces: (<code>37 31 27 9</code>), or if the child was outlived, with the year they died: (<code>(d. 32) (d. 29) (d. 8)</code>)
:**There aren't always the right number of items in this list, at times some children ages might not be listed.

*'''Ruler Worship''' gives information about the ruler's deity/force of worship, if they did not worship, this line won't exist.
:*Worship object name: <code>Worshipped B†l the Whiteness of Blueness</code>
:*Degree of worship: <code>(61%)</code>
:**Between 1% and 100% inclusive.

v0.31:World History file

2010-12-21T17:27:26Z

Mason11987:

{{av}}
{{Quality|Tattered|00:51, 21 December 2010 (UTC)}}

In {{L|Legends}} Mode, pressing the {{k|p}} (Export Map/Gen information) will create three files in the root directory of DF, one of those files is the '''World History file''' named (save name)-world_history.txt.

== File Breakdown ==

Below the history file will be explained in detail, using portions from an example file to show all of the possibilities.

=== World Name ===
At the top of the file is the World name, and nickname.

<pre>
Ikuinenplaneetta
The Eternal Planet
</pre>

=== Unintelligent Civs ===

Following the world name is a series of names of different unintelligent civs which exist in the world, no further information can be gathered from these files about these civs.

<pre>
Ikuinenplaneetta
The Eternal Planet

Olm men
Cave swallow men
Bat men
Olm men
Cave swallow men
... (Multiple more lines)
</pre>

=== Civilizations ===
The majority of the useful information in the history file exists within the civilizations, which follow immediately after the unintelligent civs. A short example civ is shown below, but the components will be viewed in detail afterwards.

<pre>
Olm men
Cave swallow men
Antmen
The Standards of Brushing, Dwarves
Worship List
Istrath the Gravel of Oiling, deity: earth, wealth
Kerlig, deity: fortresses
king List
[*] Stinthad Paddledrock (b.???, Reign Began: 1), *** Original Line, Never Married
No Children
[*] Obok Firecrypt (b.??? d. 84, Reign Began: 5), *** New Line, Married (d. 77)
14 Children (out-lived 9 of them) -- Ages at death: (d. 32) (d. 29) (d. 8) (d. 16) (d. 16) 67 (d. 30) (d. 30) (d. 48) (d. 48) 37 31 27 9
Worshipped Tabmik the Larval Filths (48%)
</pre>

==== Civ Name and Race ====
The Civ name is at the top of the section for each civ, along with the race of the civ.

<pre>
The Standards of Brushing, Dwarves
</pre>

==== Worship List ====
If the civ has any Deities or Forces they have ever worshipped then this section will exist, beginning with the text:

<pre> Worship List</pre>

Each individual line refers to a different force or deity. First the deity name, then whether they are a "deity" or "force", and finally a list of the {{L|sphere}}s they belong to, or control.

<pre> Istrath the Gravel of Oiling, deity: earth, wealth</pre>

==== Leader List ====
If the civ has had any leaders, they will be listed according to what type of leader they are (king/queen/law-giver/ect.):

<pre> king List</pre>

Each individual leader begins with the text <pre>[*]</pre>, and has two or three lines. Those are:

[*] Obok Firecrypt (b.??? d. 84, Reign Began: 5), *** New Line, Married (d. 77)
14 Children (out-lived 9 of them) -- Ages at death: (d. 32) (d. 29) (d. 8) (d. 16) (d. 16) 67 (d. 30) (d. 30) (d. 48) (d. 48) 37 31 27 9
Worshipped Tabmik the Larval Filths (48%)

*'''Leader Name and Life''': <code> Obok Firecrypt (b.??? d. 84, Reign Began: 5), *** New Line, Married (d. 77) </code>
*'''Leader Children''': <code> 14 Children (out-lived 9 of them) -- Ages at death: (d. 32) (d. 29) (d. 8) (d. 16) (d. 16) 67 (d. 30) (d. 30) (d. 48) (d. 48) 37 31 27 9 </code>
*'''Leader Worship''': <code> Worshipped Tabmik the Larval Filths (48%) </code>

'''Leader Name and Life''' is made up of several pieces of information.
:*The leaders name: <code>Obok Firecrypt</code>
:*The leaders birth year: <code> (b.???</code>
:**This is represented as ??? if the leader was born before history (before year 1).
:**If there is a year, there is no space between the "b." and the year. ex: <code> (b.66</code>
:*The leaders death year: <code> d. 84</code>
:**If the leader hasn't died, this won't be listed.
:**There '''is''' a space between the "d." and the year.
:*The year the leader's reign began: <code>, Reign Began: 5),</code>
:*How the Leader acquired power, either by being the original leader (<code> *** Original Line,</code>), starting a new line (<code> *** New Line,</code>), or by inheriting the position (<code> Inherited from </code>)
:*If the position was inherited, it will list who they received it from. The possibilities:
:**Father - <code> Inherited from father,</code>
:**Mother - <code> Inherited from mother,</code>
:**Paternal Grandfather - <code> Inherited from paternal grandfather,</code>
:**Paternal Grandmother - <code> Inherited from paternal grandmother,</code>
:**Maternal Grandfather - <code> Inherited from maternal grandfather,</code>
:**Maternal Grandmother - <code> Inherited from maternal grandmother,</code>
:**Unknown - <code> Inherited from,</code>
:*The marriage of this leader. Either: <code> Never Married</code> or <code> Married</code>
:*If the leader has married, and the spouse died, it'll list the year they died <code> Married (d. 77)</code>

'''Leader Children''' is made up of several pieces of information about a leader's children (if any)
:*Number of children: <code>No Children</code>, <code>1 Child</code> or <code>x Children</code>, where "x" is the number of children >1
:*Number of outlived children, which is some number less than or equal to the number of children: <code> (out-lived 9 of them) </code>. If the leader outlived none, then this part won't be given.
:*Ages (at death) of children. Listed with <code>-- Ages at death: </code> if the leader has died, otherwise with <code>-- Ages</code>
:**It will list as "Ages" even if there was only one child.
:*The ages at death will be listed as numbers separated by spaces: (<code>37 31 27 9</code>), or if the child was outlived, with the year they died: (<code>(d. 32) (d. 29) (d. 8)</code>)
:**There aren't always the right number of items in this list, at times some children ages might not be listed.

*'''Leader Worship''' gives information about the leader's deity/force of worship, if they did not worship, this line won't exist.
:*Worship object name: <code>Worshipped Tabmik the Larval Filths</code>
:*Degree of worship: <code>(48%)</code>
:**Between 1% and 100% inclusive.

v0.31:World History file

2010-12-21T00:51:28Z

Mason11987: Created page with '{{av}} {{Quality|Tattered|~~~~~}} In {{L|Legends}} Mode, pressing the {{k|p}} (Export Map/Gen information) will create three files in the root directory of DF, one of those file…'

v0.31:Legends

2010-12-21T00:37:09Z

Mason11987:

{{av}}
{{Quality|Fine|14:16, 9 June 2010 (UTC)}}
'''Legends''' mode is one of the three main methods of interacting with an already generated {{L|World generation|world}}. You cannot start Legends mode (or {{L|Dwarf fortress mode|Fortress}} or {{L|Adventurer mode|Adventurer}} mode) until you create a new world.

Legends mode allows you to inspect the history of a world. Many players choose to design a world where the option '''Reveal all history''' is set to YES. However, if you set the option to NO, then the the vast majority of the world's history will be hidden from Legends mode, and only uncovered by brave adventurers. In fact, there are many ways for an adventurer to uncover the past. Talk to people in civilized sites and they will tell you of their families, surroundings and local histories. Past events can also be found by viewing {{L|coins}} or items with images, or by visiting an abandoned {{L|fortress}}es and viewing the {{L|engraving|engraved}} tiles within.

You don't have to have an adventure or fortress game active in order to use legend mode. Some players simply enjoy Legends mode for the option of looking at the interactive historical map, or to read about the last time their favorite kingdom went to war, or for the ability to export lists of all the sites and governments active in the world.

== Number of Events Undiscovered ==
A self-explanatory number indicating how many "legends" are still lost in the mists of time. If you chose to reveal all history during world generation, the number displayed should be 0. Otherwise, better get out there and adventure some more.

== Historical Figures ==
The number to the right indicates how many historical figures exist in this world's history. Historical figures include entries on {{L|megabeast}}s, {{L|forgotten beast}}s, {{L|demon}}s, gods, {{L|Dwarf|dwarves}}, {{L|human}}s, {{L|goblin}}s, {{L|kobold}}s, and named {{L|creature}}s.

== Sites ==
The number to the right indicates how many sites have existed throughout this world's history. Sites include things like towns, towers, fortresses, forest retreats, and {{L|cave}}s.

== Regions ==
A list of the various regions of the world, along with the various historical events that occurred within those regions.

== Civilizations and Entities ==
The number to the right indicates how many civilizations, local governments, and religions have existed throughout this world's history. The histories of these various groups can be viewed as well, detailing events like when a site was founded, when a person was kidnapped, or when a road was completed.

== Structures ==
Structures are buildings found throughout the world. Fortress, towers, shops, taverns and more can all be found in this list.

== Historical Map ==
The historical map is a relatively new and very cool feature of Legends mode. From here you can view the territorial disputes between different civilizations and entities, including those who were destroyed before your starting year. If you are new to Dwarf Fortress, reading the map may be a little difficult, but play around with these buttons and you might get a better grasp of what you are seeing. Press {{k|Enter}} while looking at the map to change between the political and geographical view of the world. The geographic map is colored (blue seas, gray mountains, green forests etc.) while the political map's background is tan (think parchment) with colored fields corresponding to the territories of different civilizations. Civilizations can lay claim to the same area, causing the colored territory markers to overlap. You can also see how territories changes over time by moving 10 or 100 years forward and back through time. Pressing {{k|c}} while looking at the political map will show local government territories instead of civilizations, but that's generally a pretty messy scene.

== The Age of... ==
During world generation, the Ages are named for the greatest powers extant in the world. In v0.31, megabeasts are nearly immortal during world gen, so history rarely ever advances beyond the "Age of Myth", although with a small enough world, or a modded game you can get names like "The Age of the Titan and Hydra". In previous versions, Ages would commonly advance during world generation (e.g. Age of Legends, Age of Heroes, Age of Humans), this is now extremly rare. When you choose to look at the history of an Age, you will be given a list of all historical events in chronological order. Here you can read the battle reports from various wars, or the duels that took place between long dead champions, or the <s>burninations</s> rampages of megabeasts amongst the peasants. For a list of ages and their conditions, see [[40d:Calendar#Ages|this page]].

== XML dump ==

Once you've generated a world, you can dump much of the historical data into an XML file for external analysis. The XML dump currently doesn't include every detail of world history but it contains many of the important ones. Be warned that a large world with a thousand years of history can produce an XML dump up to a full gigabyte in size, which may prove unwieldy. Press {{k|x}} while in Legends mode to produce an XML dump (it will be placed in the root Dwarf Fortress directory and named the same as your game's save folder) See [[XML dump]] for information on the XML file's format.

== Export Map/Gen Information.==
Another option is to export the map/gen information by pressing {{k|p}} in Legends mode. This produces three .txt files that are placed in the root directory of Dwarf Fortress, named after the save file you're viewing:
# (save name)-world_gen_param.txt - contains the world generation settings.
# {{L|World History file|(save name)-world_history.txt}} - Includes some information about the deities, and rulers of the Human, Dwarven, Elven, and Goblin civilizations.
# {{L|World Sites file|(save name)-world_sites_and_pops.txt}} - Lists the sites' population, owner, parent civilization and warlord. This one will also list all the animal populations above and below ground including demons.

== Export Detailed Map ==
Pressing {{k|d}} in Legends mode reveals a list of the different kinds map you can export. The Images are exported to the root directory when you highlight the one you want and pressing {{k|Enter}}.

*{{L|Standard biome+site map}}
*{{L|Elevations incl. lake and ocean floors}}
*{{L|Elevations respecting water level}}
*{{L|Temperature}}
*{{L|Rainfall}}
*{{L|Drainage}}
*{{L|Savagery}}
*{{L|Volcanism}}
*{{L|Current vegetation}}
*{{L|evil}}
*{{L|salinity}}

<gallery>
Image:Standard biome and site map.png|Biome & site map
Image:World_graphic-el-region5-203-10075.PNG|Elevation incl. lake and ocean floors
Image:World_graphic-elw-region5-203-10075.PNG|Elevation respecting water level
Image:World graphic-tmp-region5-203-10075.PNG|Temperature
Image:World_graphic-rain-region5-203-10075.PNG|Rainfall
Image:World_graphic-drn-region5-203-10075.PNG|Drainage
Image:World_graphic-sav-region5-203-10075.PNG|Savagery
Image:World_graphic-vol-region5-203-10075.PNG|Volcanism
Image:World_graphic-veg-region5-203-10075.PNG|Current vegetation
Image:World_graphic-evil-region5-203-10075.PNG|Evil
Image:World_graphic-sal-region5-203-10075.PNG|Salinity
Image:modified map.png|Modified
</gallery>

The last image is produced using the following steps.

1. You need to export Elevations Including Lake and Ocean Floors (this is your height-map), Elevation Respecting Water Level (this is for figuring out ocean boundaries) and Current Vegetation.

2. Open your elevations map in photoshop or paintshop or whatever you use. That's your base layer. Colorize it brownish.

3. Open your water levels elevation map and select the blue, invert and delete everything that isn't water. Place this "water" on a new layer above your brown elevation map. Play with the transparency until you have an effect of shallow coasts and deep oceans, 70-80% looks good. Adjust the color if you think the blue is too dark.

4. Open your vegetation map and paste as a new layer above the water. Colorize it greenish, set the blend mode to "color" - this blends the color/saturation but doesn't mess with the lightness so you can see the elevation under your "foliage". Blend mode "Hue" has a similar effect, use whichever you prefer. Adjust transparency of this layer (~60%) or you won't have any brown show through.

5. Import the rainfall like above and add as a new layer above the rest. Blend mode Lighten so only the light areas show. You'll see there's only a few gaps you can see through because this is literally all the rain in the world- you only want the heavy parts as "clouds". If you adjust the brightness you'll create more gaps but your clouds will become darker. Use the curves tool instead- see pic for a nice setting. Then use a weal blur or average effect to take the hard edges off the new clouds.

v0.31:Legends

2010-12-21T00:34:34Z

Mason11987: /* Export Map/Gen Information. */ Going to create these files soon

{{av}}
{{Quality|Fine|14:16, 9 June 2010 (UTC)}}
'''Legends''' mode is one of the three main methods of interacting with an already generated {{L|World generation|world}}. You cannot start Legends mode (or {{L|Dwarf fortress mode|Fortress}} or {{L|Adventurer mode|Adventurer}} mode) until you create a new world.

Legends mode allows you to inspect the history of a world. Many players choose to design a world where the option '''Reveal all history''' is set to YES. However, if you set the option to NO, then the the vast majority of the world's history will be hidden from Legends mode, and only uncovered by brave adventurers. In fact, there are many ways for an adventurer to uncover the past. Talk to people in civilized sites and they will tell you of their families, surroundings and local histories. Past events can also be found by viewing {{L|coins}} or items with images, or by visiting an abandoned {{L|fortress}}es and viewing the {{L|engraving|engraved}} tiles within.

You don't have to have an adventure or fortress game active in order to use legend mode. Some players simply enjoy Legends mode for the option of looking at the interactive historical map, or to read about the last time their favorite kingdom went to war, or for the ability to export lists of all the sites and governments active in the world.

== Number of Events Undiscovered ==
A self-explanatory number indicating how many "legends" are still lost in the mists of time. If you chose to reveal all history during world generation, the number displayed should be 0. Otherwise, better get out there and adventure some more.

== Historical Figures ==
The number to the right indicates how many historical figures exist in this world's history. Historical figures include entries on {{L|megabeast}}s, {{L|forgotten beast}}s, {{L|demon}}s, gods, {{L|Dwarf|dwarves}}, {{L|human}}s, {{L|goblin}}s, {{L|kobold}}s, and named {{L|creature}}s.

== Sites ==
The number to the right indicates how many sites have existed throughout this world's history. Sites include things like towns, towers, fortresses, forest retreats, and {{L|cave}}s.

== Regions ==
A list of the various regions of the world, along with the various historical events that occurred within those regions.

== Civilizations and Entities ==
The number to the right indicates how many civilizations, local governments, and religions have existed throughout this world's history. The histories of these various groups can be viewed as well, detailing events like when a site was founded, when a person was kidnapped, or when a road was completed.

== Structures ==
Structures are buildings found throughout the world. Fortress, towers, shops, taverns and more can all be found in this list.

== Historical Map ==
The historical map is a relatively new and very cool feature of Legends mode. From here you can view the territorial disputes between different civilizations and entities, including those who were destroyed before your starting year. If you are new to Dwarf Fortress, reading the map may be a little difficult, but play around with these buttons and you might get a better grasp of what you are seeing. Press {{k|Enter}} while looking at the map to change between the political and geographical view of the world. The geographic map is colored (blue seas, gray mountains, green forests etc.) while the political map's background is tan (think parchment) with colored fields corresponding to the territories of different civilizations. Civilizations can lay claim to the same area, causing the colored territory markers to overlap. You can also see how territories changes over time by moving 10 or 100 years forward and back through time. Pressing {{k|c}} while looking at the political map will show local government territories instead of civilizations, but that's generally a pretty messy scene.

== The Age of... ==
During world generation, the Ages are named for the greatest powers extant in the world. In v0.31, megabeasts are nearly immortal during world gen, so history rarely ever advances beyond the "Age of Myth", although with a small enough world, or a modded game you can get names like "The Age of the Titan and Hydra". In previous versions, Ages would commonly advance during world generation (e.g. Age of Legends, Age of Heroes, Age of Humans), this is now extremly rare. When you choose to look at the history of an Age, you will be given a list of all historical events in chronological order. Here you can read the battle reports from various wars, or the duels that took place between long dead champions, or the <s>burninations</s> rampages of megabeasts amongst the peasants. For a list of ages and their conditions, see [[40d:Calendar#Ages|this page]].

== XML dump ==

Once you've generated a world, you can dump much of the historical data into an XML file for external analysis. The XML dump currently doesn't include every detail of world history but it contains many of the important ones. Be warned that a large world with a thousand years of history can produce an XML dump up to a full gigabyte in size, which may prove unwieldy. Press {{k|x}} while in Legends mode to produce an XML dump (it will be placed in the root Dwarf Fortress directory and named the same as your game's save folder) See [[XML dump]] for information on the XML file's format.

== Export Map/Gen Information.==
Another option is to export the map/gen information by pressing {{k|p}} in Legends mode. This produces three .txt files that are placed in the root directory of Dwarf Fortress, named after the save file you're viewing:
# (save name)-world_gen_param.txt - contains the world generation settings.
# [[World History file|(save name)-world_history.txt]] - Includes some information about the deities, and rulers of the Human, Dwarven, Elven, and Goblin civilizations.
# [[World Sites file|(save name)-world_sites_and_pops.txt]] - Lists the sites' population, owner, parent civilization and warlord. This one will also list all the animal populations above and below ground including demons.

== Export Detailed Map ==
Pressing {{k|d}} in Legends mode reveals a list of the different kinds map you can export. The Images are exported to the root directory when you highlight the one you want and pressing {{k|Enter}}.

*{{L|Standard biome+site map}}
*{{L|Elevations incl. lake and ocean floors}}
*{{L|Elevations respecting water level}}
*{{L|Temperature}}
*{{L|Rainfall}}
*{{L|Drainage}}
*{{L|Savagery}}
*{{L|Volcanism}}
*{{L|Current vegetation}}
*{{L|evil}}
*{{L|salinity}}

<gallery>
Image:Standard biome and site map.png|Biome & site map
Image:World_graphic-el-region5-203-10075.PNG|Elevation incl. lake and ocean floors
Image:World_graphic-elw-region5-203-10075.PNG|Elevation respecting water level
Image:World graphic-tmp-region5-203-10075.PNG|Temperature
Image:World_graphic-rain-region5-203-10075.PNG|Rainfall
Image:World_graphic-drn-region5-203-10075.PNG|Drainage
Image:World_graphic-sav-region5-203-10075.PNG|Savagery
Image:World_graphic-vol-region5-203-10075.PNG|Volcanism
Image:World_graphic-veg-region5-203-10075.PNG|Current vegetation
Image:World_graphic-evil-region5-203-10075.PNG|Evil
Image:World_graphic-sal-region5-203-10075.PNG|Salinity
Image:modified map.png|Modified
</gallery>

The last image is produced using the following steps.

1. You need to export Elevations Including Lake and Ocean Floors (this is your height-map), Elevation Respecting Water Level (this is for figuring out ocean boundaries) and Current Vegetation.

2. Open your elevations map in photoshop or paintshop or whatever you use. That's your base layer. Colorize it brownish.

3. Open your water levels elevation map and select the blue, invert and delete everything that isn't water. Place this "water" on a new layer above your brown elevation map. Play with the transparency until you have an effect of shallow coasts and deep oceans, 70-80% looks good. Adjust the color if you think the blue is too dark.

4. Open your vegetation map and paste as a new layer above the water. Colorize it greenish, set the blend mode to "color" - this blends the color/saturation but doesn't mess with the lightness so you can see the elevation under your "foliage". Blend mode "Hue" has a similar effect, use whichever you prefer. Adjust transparency of this layer (~60%) or you won't have any brown show through.

5. Import the rainfall like above and add as a new layer above the rest. Blend mode Lighten so only the light areas show. You'll see there's only a few gaps you can see through because this is literally all the rain in the world- you only want the heavy parts as "clouds". If you adjust the brightness you'll create more gaps but your clouds will become darker. Use the curves tool instead- see pic for a nice setting. Then use a weal blur or average effect to take the hard edges off the new clouds.

v0.31:XML dump

2010-12-15T01:08:56Z

Mason11987: /* historical_events */ adding details

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.
== world_constructions ==

== artifacts ==

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== artifact created ===
'''Details needed'''
* artifact_id
* unit_id
* hist_figure_id
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== masterpiece arch constructed ===
'''Details Needed'''
* hfid
* entity_id
* site_id
* skill_at_time

=== masterpiece engraving ===
'''Details Needed'''
* hfid
* entity_id
* site_id
* skill_at_time

=== masterpiece food ===
'''Details Needed'''
* hfid
* entity_id
* site_id
* skill_at_time

=== masterpiece item ===
'''Details Needed'''
* hfid
* entity_id
* site_id
* skill_at_time

=== masterpiece item improvement ===
'''Details Needed'''
* hfid
* entity_id
* site_id
* skill_at_time

=== masterpiece lost ===
'''Details Needed'''
*Nothing Exported

=== merchant ===
'''Details Needed'''
*Nothing exported

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== site taken over ===
*attacker_civ_id
*new_site_civ_id
*defender_civ_id
*site_civ_id
*site_id

== historical_event_collections ==
'''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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-15T00:48:08Z

Mason11987: /* historical_events */ Missing event types

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.
== world_constructions ==

== artifacts ==

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== artifact created ===
'''Details needed'''

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== masterpiece item ===
'''Details Needed'''

=== masterpiece engraving ===
'''Details Needed'''

=== masterpiece food ===
'''Details Needed'''

=== masterpiece item improvement ===
'''Details Needed'''

=== masterpiece lost ===
'''Details Needed'''

=== masterpiece arch constructed ===
'''Details Needed'''

=== merchant ===
'''Details Needed'''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== site taken over ===
*attacker_civ_id
*new_site_civ_id
*defender_civ_id
*site_civ_id
*site_id

== historical_event_collections ==
'''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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-14T21:10:28Z

Mason11987: missing two top-level sections

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.
== world_constructions ==

== artifacts ==

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== site taken over ===
*attacker_civ_id
*new_site_civ_id
*defender_civ_id
*site_civ_id
*site_id

== historical_event_collections ==
'''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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:06:36Z

Mason11987: /* historical_event_collections */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== site taken over ===
*attacker_civ_id
*new_site_civ_id
*defender_civ_id
*site_civ_id
*site_id

== historical_event_collections ==
'''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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:05:05Z

Mason11987: /* site taken over */ This is still in .31.18

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== site taken over ===
*attacker_civ_id
*new_site_civ_id
*defender_civ_id
*site_civ_id
*site_id

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:03:48Z

Mason11987: /* remove hf site link */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
'''Prior to 31.18'''

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

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:03:19Z

Mason11987: /* razed structure */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
'''No longer used in 31.18'''

'''Explanation needed '''

'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:02:26Z

Mason11987: /* hf razed structure */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
'''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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:01:47Z

Mason11987: /* entity created */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== 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 could be either a group which leaves and possibly founds another site, or this could be a religion being founded.

===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).
* attacker_civ_id
* defender_civ_id
* subregion_id
* feature_layer_id
* coords
* attacker_general_hfid
* defender_general_hfid

===hf abducted ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T06:00:09Z

Mason11987: /* created structure */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
'''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 ===
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 ===
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 ===
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

=== entity created ===
No longer used in 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===
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 ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T05:59:50Z

Mason11987: /* created site */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
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 ===
No longer used in 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 ===
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 ===
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 ===
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

=== entity created ===
No longer used in 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===
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 ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T05:58:13Z

Mason11987: /* add hf site link */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
'''Prior to .31.18'''
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
No longer used in 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 ===
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 ===
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 ===
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

=== entity created ===
No longer used in 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===
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 ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T05:57:16Z

Mason11987: /* historical_events */

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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 ===
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 ===
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===
No longer used in 31.18?
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
No longer used in 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 ===
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 ===
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 ===
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

=== entity created ===
No longer used in 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===
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 ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T05:55:45Z

Mason11987: /* historical_figures */ adding </zombie>

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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 ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 ===
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 ===
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===
No longer used in 31.18?
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
No longer used in 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 ===
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 ===
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 ===
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

=== entity created ===
No longer used in 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===
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 ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-12-11T05:54:40Z

Mason11987: /* historical_figures */ I did a test with a fairly large world because I doubted the "mostly" here, but it confirmed it. I believe this is when the individual does something notable, birth - often.

An XML dump of a world's history can be generated from [[Legends]] mode.

The XML dump consists of the following elements:

==regions==

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==
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==

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 ===

Each site may contain a <structures> tag.

== historical_figures ==

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.
*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 ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 ===
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 ===
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===
No longer used in 31.18?
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
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 ===
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 ===
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 ===
(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 ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
No longer used in 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 ===
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 ===
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 ===
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

=== entity created ===
No longer used in 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===
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 ===
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 ===
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 ===
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 ===
No long used in 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 ===
2 or more (only 2 listed) historical figures reunited.
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* 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 ===
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 ===
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 ===
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 ===
'''Explanation needed '''
''No Parts''

=== 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 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 ===
This event ends a war. The info about which entity initiated the negotiations is missing.
* site_id (always -1?)

=== peace rejected ===
'''Explanation needed '''
* site_id (always -1?)

=== razed structure ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
No longer used in 31.18?
This event shows that some HF (unexported) moved out of site_id.
* site_id

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

=== 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

=== site taken over ===
No longer used in 31.18?
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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, format unknown. seconds since 01.01?
* end_year - the year in which the event collection ended
* start_seconds72 - the date of the year, format unknown. seconds since 01.01?
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

Talk:Expedition Leader

2010-09-17T12:57:44Z

Mason11987:

Shouldn't this link to DF2010: Expedition Leader? [[User:Taerh|Taerh]] 23:17, 16 September 2010 (UTC)
:Agreed, done. [[User:Mason11987|Mason]] ([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]]) 12:57, 17 September 2010 (UTC)

v0.31:XML dump

2010-09-16T23:47:54Z

Mason11987: adding theft

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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 ===
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 ===
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 ===
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''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

=== theft ===
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 ===
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 ==

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

v0.31:XML dump

2010-09-16T20:05:48Z

Mason11987:

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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 ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* attacking_enid
* defending_enid

=== beast attack ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* defending_enid

=== duel ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* attacking_hfid
* defending_hfid

=== journey ===
'''Description needed'''

''No additional parts''

=== war ===
'''Description needed'''
* aggressor_ent_id
* defender_ent_id

=== battle ===
'''Description needed'''
* name
* war_eventcol
* subregion_id
* feature_layer_id
* site_id
* 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
* defending_enid

== historical_eras ==

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

v0.31:XML dump

2010-09-16T19:59:40Z

Mason11987: /* historical_event_collections */ lots of details

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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 ===
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

=== 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 ===
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'''

=== site conquered ===
As part of war_eventcol, attacking_enid conquered site_id from defending_enid.
* war_eventcol
* site_id
* attacking_enid
* defending_enid

== historical_eras ==

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

v0.31:XML dump

2010-09-16T19:09:48Z

Mason11987: /* journey */

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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 ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* attacking_enid
* defending_enid

=== beast attack ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* defending_enid

=== duel ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* attacking_hfid
* defending_hfid

=== journey ===
'''Description needed'''

''No additional parts''

=== war ===
'''Description needed'''
* aggressor_ent_id
* defender_ent_id

=== battle ===
'''Description needed'''
* name
* war_eventcol
* subregion_id
* feature_layer_id
* site_id
* 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
* defending_enid

== historical_eras ==

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

v0.31:XML dump

2010-09-16T19:09:34Z

Mason11987: /* historical_event_collections */ the ones I've found thus far

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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 ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* attacking_enid
* defending_enid

=== beast attack ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* defending_enid

=== duel ===
'''Description needed'''
* subregion_id
* feature_layer_id
* site_id
* coords
* attacking_hfid
* defending_hfid

=== journey ===
'''Description needed'''
''No additional parts''

=== war ===
'''Description needed'''
* aggressor_ent_id
* defender_ent_id

=== battle ===
'''Description needed'''
* name
* war_eventcol
* subregion_id
* feature_layer_id
* site_id
* 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
* defending_enid

== historical_eras ==

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

v0.31:XML dump

2010-09-16T18:53:10Z

Mason11987: /* historical_event_collections */

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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

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 ===
'''Description needed'''

'''Parts needed'''

=== beast attack ===
'''Description needed'''

'''Parts needed'''

=== duel ===
'''Description needed'''

'''Parts needed'''

=== journey ===
'''Description needed'''

'''Parts needed'''

=== war ===
'''Description needed'''

'''Parts needed'''

=== battle ===
'''Description needed'''

'''Parts needed'''

=== site conquered ===
'''Description needed'''

'''Parts needed'''

== historical_eras ==

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

v0.31:XML dump

2010-09-16T18:52:29Z

Mason11987: /* historical_event_collections */

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

== historical_event_collections ==
'''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 -
* end_year - the year in which the event collection ended
* start_seconds72 -
* 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

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 ===
'''Description needed'''
'''Parts needed'''

=== beast attack ===
'''Description needed'''
'''Parts needed'''

=== duel ===
'''Description needed'''
'''Parts needed'''

=== journey ===
'''Description needed'''
'''Parts needed'''

=== war ===
'''Description needed'''
'''Parts needed'''

=== battle ===
'''Description needed'''
'''Parts needed'''

=== site conquered ===
'''Description needed'''
'''Parts needed'''

== historical_eras ==

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

v0.31:XML dump

2010-09-16T18:31:26Z

Mason11987:

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:

==regions==

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

==underground_regions==
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==

Each <site> element contains the following:
*id - reference number
*name
*type
**city
**tree city
**cave
**dwarf fortress
*coords - an X, Y coordinate giving the location of the site on the world map.

=== structures ===

Each site may contain a <structures> tag.

== historical_figures ==

The <historical_figure> elements contain only the very most basic information:
*id
*name

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

== entity_populations ==

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

== entities ==

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==

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

* id - a reference number
* year - the year in which the event took place
* seconds72 -
* 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 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.
* hfid
* hfid_target

===add hf site link===
This event shows that some (unexported) HF took up residence in some site (site_id)
* site_id

=== add hf entity link ===
'''Explanation needed '''
* civ_id

=== 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).
* attacker_civ_id
* defender_civ_id
* site_civ_id
* site_id
* attacker_general_hfid
* defender_general_hfid

=== body abused ===
'''Explanation needed '''
* site_id
* subregion_id (always -1?)
* feature_layer_id (always -1?)
* coords

=== change hf job ===
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 ===
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)
**theif (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

=== create entity position ===
'''Explanation needed '''
''No Parts''

=== created site ===
Appears to be the creation of a town (?)
* civ_id
* site_civ_id
* site_id

=== created structure ===
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 ===
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 ===
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 ===
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

=== entity created ===
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===
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 ===
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 ===
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:
** shot
** struck
** dragonfire

=== hf new pet ===
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 ===
Some HF (hist_fig_id) razed a structure (structure_id) at some site (site_id)
* hist_fig_id
* site_id
* structure_id

=== hf reunion ===
'''Explanation needed'''
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

===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)
* subtype
** attacked
** scuffle
** confront
** ambushed
** 2 lost after receiving wounds
* group_1_hfid
* group_2_hfid
* site_id
* subregion_id
* feature_layer_id

=== hf travel ===
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 ===
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
* wounder_hfid
* site_id
* subregion_id
* feature_layer_id

=== impersonate hf ===
This event that some HF (trickster_hfid) began impersonating another HF (cover_hfid) withing an entity (target_enid)

* trickster_hfid
* cover_hfid
* target_enid

=== item stolen ===
'''Explanation needed '''
''No Parts''

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

=== peace accepted ===
'''Explanation needed '''
'''Parts needed'''

=== peace rejected ===
'''Explanation needed '''
'''Parts needed'''

=== razed structure ===
'''Explanation needed '''
'''Parts needed'''

=== reclaim site ===
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===
This event shows that some HF (unexported) moved out of site_id.
* site_id

=== remove hf entity link ===
'''Explanation needed '''
* civ_id

=== 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

=== site taken over ===
'''Explanation needed '''
'''Parts needed'''

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

== historical_eras ==

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

v0.31:Known bugs and issues

2010-08-15T02:25:47Z

Mason11987: /* Items */

{{AV}}
'''PLEASE SUBMIT BUGS TO THE OFFICIAL BUG TRACKER - THEY WON'T GET FIXED IF THEY ARE ONLY LISTED HERE.''' 
'''[http://bay12games.com/dwarves/mantisbt/ Dwarf Fortress Bug Tracker]'''

'''Please link to the mantis tracker issue as well as the forum post if possible.'''

'''This page recently underwent a major cleanup edit. See the talk page for more info.'''

:As the version is new, and we're still discovering bugs, a lot of unverifiable information is going to get added to this thread. It is recommended that new entries be added with "'''(confirmation needed)'''", and that others can discuss and document each bug on the discussion page. Following confirmation of a bug with a specific description of what's occurring, the parenthetical can be removed.

:Please also read the 'Not Actually Bugs' section before adding bug reports!

==Not Actually Bugs==
*When choosing material for a squad item, there are hundreds of "forgotten beast leather" to choose from.
:This is because there are hundreds of different forgotten beasts.

*Making adamantine items sometimes results in "Urist McArmorer, Armorer cancels Forge adamantine cloak: Needs 10000 adamantine cloth." Likewise making pearlash can yield "...cancels Make pearlash. Needs 150 pearlash."
:This happens if you don't have enough cloth/wafers/strands, if you have enough it works nicely. This is probably due to the fact that cloth can be consumed "in pieces" now for medical purposes.

*Animals are listed twice on the embark screen.
:They're listed twice because they separately list males and females.

*Weird red C in top left corner
:"''' C '''" means new combat report
:"''' H '''" means new hunting message
:"''' S '''" means new sparring message
:[http://www.bay12games.com/forum/index.php?topic=52514.0 Forum Link]

*No option for magma in the finder
:[[Magma]] is guaranteed everywhere now.

*Unable to add items or skill points on the embarking screen.
:Check your keybindings! By default the keys to add and remove items and skills are + and - on the numpad.

*{{L|Wrestling}} will take much longer than combat using any kind of weapon (unlike in 40d.)

*When iron men and Bronze Colossuses die, the statues that make up their corpses adopt images of creatures (I.e: Statue of a dwarf 1) and events. The molten metal falling from them will make statues out of any corpses below where they died.

*All fish are mentioned twice.
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123220#msg1123220 Forum Link]
:Not a bug. Each creature has a male and a female caste, and each caste shows up on embark.
== Embarking ==

*You can embark with some rather unrealistic prepared foods (such as fly brains, which in real life go at about 900 thousand brains to the pound). These unrealistic foods have also been seen in trading. This may be related to further issues involving vermin's organs. (Each 'Unit' of Food is representative of enough food to feed a dwarf for just over a month.)

*You may get a "Cavern Collapse" announcement as soon as you arrive. (Perhaps many times, if you have a volcano in your ocean...)
:[http://bay12games.com/dwarves/mantisbt/view.php?id=51 Bug Tracker]

== Sites ==

*Magma pipes in volcanoes extend to the top of the map, past the mountain itself.
:[http://www.bay12games.com/forum/index.php?topic=52412.0 Forum Link]

*Magma tubes remain the same shape and size the whole way down and may be square.
:[http://www.bay12games.com/forum/index.php?topic=52412.0 Forum Link]

*There are currently very few or even no fish. This includes brooks, rivers, oceans, ponds, lakes (underground and otherwise). You may get a few turtles sometimes.
:[http://www.bay12games.com/forum/index.php?topic=52217.0 Forum Link]
:[http://www.bay12games.com/dwarves/mantisbt/view.php?id=2015 Bug Tracker]

== Buildings and Zones ==

*Can't farm on dry soil underground.
:[http://www.bay12games.com/forum/index.php?topic=51951.msg1123336#msg1123336 Forum Link]
:Also, dwarves will clean away mud right from under farm plots, rendering them useless until re-irrigated and rebuilt.

*Construction and/or deconstruction can occasionally force some dwarves to idle.
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123250#msg1123250 Forum Link]

*When linking buildings to levers/pressure plates, the view may center on a different building than the one that is currently selected. (However, the view switches to the correct building after it is selected)
:[http://bay12games.com/dwarves/mantisbt/view.php?id=1915 Bug Tracker] --'''Open'''

*Setting workshop profiles according to minimum and maximum skill levels does not work, typically resulting in no one being able to use the workshop. Setting a profile for individual dwarves still works.
:[http://www.bay12forums.com/smf/index.php?topic=61051.0 Forum Link]

== Combat ==

*Some combat maneuvers have no effect.
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123104#msg1123104 Forum Link]

*Attempting to grab a bodypart with a weapon leads to "you grab *** by *** with your *weapon* but nothing is grabbed

*Attempting to "pinch" various body parts shows "you adjust you grip on***" and nothing else.

*Alligators can wear armor
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123104#msg1123104 Forum Link]

*Non-alive creatures (like bronze colossuses, zombies and blizzard men) cannot be destroyed (possibly because they can't bleed to death nor have their brain destroyed). Arena testing has revealed that [[dragonfire]] and [[magma]] can melt bronze colossuses, and falling from very high up may kill some undead creatures.
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123220#msg1123220 Forum Link]
: Fixed in .10

*Shield-bashing has no effect with a wooden shield
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123499#msg1123499 Forum Link]

*Ballistae have been nerfed considerably: They now easily glance off normal clothing and are very unlikely to kill anything with armour.
:Fixed in .10

*Animals with teeth do nearly no damage. Don't count on your wardogs to help defend your fortress.
:[http://www.bay12forums.com/smf/index.php?topic=55798.0 Workaround]
:[http://bay12games.com/dwarves/mantisbt/view.php?id=744 Bug Tracker] -'''Fixed''' {{version|0.31.06}}

== Labors ==

*Hunting Issues
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123228#msg1123228 Forum Link]

*Miners now cancel mining designations when they can't reach them
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123272#msg1123272 Forum Link]
:'''Fixed''' {{version|0.31.03}}

*Metal goblets are sometimes iron, regardless of input
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123533#msg1123533 Forum Link]

*Manager screen doesn't show you materials for traction benches
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123533#msg1123533 Forum Link]

*Workers are too dedicated, dehydrate themselves. This was intended as a helpful feature, as dwarves will try to finish what they are doing before running off to eat. However, many players view it as a bug, because it can cause dwarves that are far from food to begin with to starve to death. Working while hungry or thirsty also causes unhappy thoughts, slower work, and worse quality work.
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123599#msg1123599 Forum Link]
:[http://bay12games.com/dwarves/mantisbt/view.php?id=8 Bug Tracker] --'''Fixed''' {{version|0.31.07}}

*Cooking with alcohol is buggy
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123702#msg1123702 Forum Link]

*When crafting shell crafts, craftsdwarves never actually produce a shell craft, but instead sit forever with the same shell, with their skills increasing.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=206 Bug Tracker]

*Dwarves take orders to prepare meals with liquid ingredients like dwarven syrup, wine, and rum, but almost never do it and instead dump the liquid inside the kitchen where it sits cluttering it up and can't be moved... Because it's liquid.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=138 Bug Tracker]
:Workaround: Using dwarven syrup works just fine for me, but my cook always grabs at least one solid ingredient. Ie, 3 stacks of syrup + one stack of cheese -> finished and edible meal.
:Workaround: The liquid seems to be underneath the kitchen. If you remove the kitchen, some dwarf will come along and clean the spill. Then you can remake the kitchen. I'd recommend simply disabling all cooking of booze.

*Making Rock Short Sword results in a wooden short sword. Especially annoying when making an adamantine sword! (multiple reports)
:[http://bay12games.com/dwarves/mantisbt/view.php?id=256 Bug Tracker]
:Bug is display only. Stats are based on the rock used.

*Metal items may require fewer bars/wafers than announcements lead you to believe. Since price of items is affected by what went into creating it, this can lead to your adamantine armor being worth far less than it would otherwise.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=130 Bug Tracker]

*Wood cutter. Tried to upgrade his axe to a steel one, never cut another tree in his life after being forced to dump his copper battle axe. It's like wood cutting had a seperate profile and he was the only one excluded; Sure enough, turned one of my jewelers into wood cutter and it worked fine for him.

*Woodcutters can chop down trees with (wooden) training axes.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=712 Bug Tracker]

*Immigrants can arrive with only peasant labors enabled, even if they are legendary jewelers. They may sometimes have weird labors enabled. (Stonecrafting master lye makers.)
:[http://bay12games.com/dwarves/mantisbt/view.php?id=110 Bug Tracker]

*In the {{k|o}}rders menu, there are options (in {{k|W}}orkshops) for auto {{k|b}}utcher, auto {{k|k}}itchen and auto {{k|f}}ishery. All three of these respond to {{k|b}} only, {{k|k}} and {{k|f}} do nothing.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=68 Bug Tracker]

*Parties never end, sometimes eating up half the labor force.
:Workaround: Undesignate whatever the party is gathered around and it will end.

*Soap-making task is missing from the workshop. Issuing work order through the manager does work. Also with cutting clear and crystal glass.
:The soap making task has two reagents, one of which is a barrel that [CONTAINS_LYE]. The bucket the lye is produced in doesn't count, since it's a bucket, not a barrel. Make sure you have 1) a dwarf with the appropriate hauling task enabled, 2) an empty, usable barrel, and 3) a food stockpile with lye allowed that accepts barreled inventory. Once the lye is in the barrel in the stockpile, check the soap shop again. Don't know why the glass is wonky, though. -[[Special:Contributions/76.102.26.49|76.102.26.49]] 06:27, 13 May 2010 (UTC)

*Making waterskin in leather works results in a weird item called "flask" (simply that, no mention of leather or whatever) that is never used and stays forever in the workshop. Those don't seem to cause clutter in the workshop either. (A metal variant (Ex. Iron) is now capable of being created at a metal smith, probably causing this bug. Soldiers will carry an Metal Flask).
:[http://bay12games.com/dwarves/mantisbt/view.php?id=93 Bug Tracker]
: "Flask" can be traded, but isn't automatically moved to stockpiles (It's neither a leather good nor a finished good). They do seem to clutter leatherworkers shops, which must then be destroyed and rebuilt (0.31.06). ~Neftaly Hernandez
: You can also use the View Items in Buildings command {{k|t}} to mark the Flasks for {{k|d}}umping to remove the clutter (0.31.06). ~mk
::More on metal flasks- a friend of mine noticed that when he assigned the job "make iron flask", in would go iron bars and charcoal, and out would come 3 ''gold'' flasks. I did the same thing, except I used coke instead of charcoal, and got 3 gypsum plaster flasks.
:::Making adamantine flasks results in iron flasks.

*Dwarves will occasionally go exceptionally out of their way to get a material while a giant stockpile is sitting beside them (I saw my carpenter travel half the map to get a log while there was a stockpile of 20 logs beside him)
:This will happen if the stockpiled items are already reserved for another task (sometimes happens en masse if you're designating constructions from the material). If this still functions as it did in 40d, dwarves will count the number of tiles to an item 'as the crow flies' rather than checking the actual pathfinding distance, meaning that they regard items above or below their workshop as being very nearby even if the travel distance to reach them is substantial. [[User:Oddtwang of Dork|Oddtwang of Dork]] 16:20, 8 April 2010 (UTC)
:True, but I wasn't using wood for anything, only had 2 carpenters active and the wood was on the same Z plane as my workshops. The usual explanation doesn't fly for the one event I saw.
::Perhaps they had the wood hauling labor enabled and were going to haul it?

*Canceling a job at the metalsmith can jam the shop if the item was being actively produced at that time (Cancelled job to stop untrained armorer from working on an adamantium plate armor, shop jammed and no other orders ever went through. Ordered deconstruction and then halted deconstruction to clear this up.)

== Moods ==

*Fey moods can request body parts (!!!)
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123573#msg1123573 Forum Link]

*Fey moods can request "rock bars." Has been seen to ignore all metal bars, ores, other rock, and rock. (Confirmed)
:I've had the same situation, but my dwarf made due with bars of [[Coke]].

*Fey mood; Dwarf took only dog bones into the craftsdwarf's shop. Produced an iron figurine with an image of waves in dog bone on it.
:Seconded Most if not all figurines made in Fey moods become iron, despite the material used.

*Glass Makers will not use a Magma Glass Furnace to manufacture their artifact. A traditional Glass Furnace is needed. (0.31.04; Unconfirmed)

== Creature Data ==

*Descriptions sometimes take strange objects: "She likes to consume she"
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123533#msg1123533 Forum Link]
:[http://bay12games.com/dwarves/mantisbt/view.php?id=582 Bug Tracker]

*Giants and giantesses are mapped to the wrong gender.
:Fixed
*Unicorns give birth to elk fawns.
:Fixed
*Mountain goat fawns are called "Stray Horse foal", although having all the features of a mountain goat.
:This is due to what is assumed to be a copy/paste error in the raws - The raws list "Mountain goat kid" as well as "Horse foal" as possible child names, so it randomly picks one.
:Fixed
*In BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS both eyelids are around the right eye and clean the left eye
:Fixed
== Stockpiles ==
*Problems with categorization. (Stone is considered metal)
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123178#msg1123178 Forum Link]
:[http://www.bay12games.com/dwarves/mantisbt/view.php?id=157 Bug Tracker]

*Custom stockpile options don't seem to always work
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123474#msg1123474 Forum Link]

<s>*Dead vermin never rot</s>
:[http://www.bay12games.com/forum/index.php?topic=51953.msg1123731#msg1123731 Forum Link]
:[http://bay12games.com/dwarves/mantisbt/view.php?id=161 Bug Tracker] --'''Fixed''' {{version|0.31.04}}

*<s>"Take from stockpile" is broken</s>
:[http://www.bay12games.com/forum/index.php?topic=52126.0 Forum Link]
: Fixed in .10
*There is no category for wood blocks. As such, wood blocks can not be removed from carpentry workshops.
:[http://www.bay12games.com/dwarves/mantisbt/view.php?id=439 Bug Tracker]

== Military ==
'''{{L|Military|Main Military Page}}'''
'''[http://bay12games.com/dwarves/mantisbt/view.php?id=535 Main Military Equipment Bug Tracker Page]'''
*Dwarves who are assigned to squads seem to be permanently affixed to the soldier life - changing schedules, training options, switching out dwarves, disbanding the squad: nothing works. All they do is eat, drink, sleep, Individual Combat Drill and take Kill orders. (Multiple reports, bug incidence is somewhat inconsistent, deconstructing assigned barracks sometimes helps.)
:[http://bay12games.com/dwarves/mantisbt/view.php?id=605 Bug Tracker] --'''Acknowledged''' (There may be several duplicate bug reports.)

*The [[arsenal dwarf]] may assign weapons/armor that do not belong to you.
:[http://www.bay12games.com/dwarves/mantisbt/view.php?id=1290 Bug Tracker-Goblins] --'''Fixed''' {{version|0.31.06}}
:[http://bay12games.com/dwarves/mantisbt/view.php?id=1526 Bug Tracker-Caravans] --'''Fixed''' {{version|0.31.06}}
:Arsenal dwarf position deleted in .10
*Squads can get into a "permanent civilian life" and will never go into "recruit mode" unless ordered to "station" or "Kill a target", upon canceling this order they will go back to civilian mode. (Although they will perform individual combat drills, but in civilian garbs unless you replaced their equipment) [[User:Kenji 03|Kenji 03]] 11:54, 5 April 2010 (UTC).
:You mean they're supposed to not be civilians while training? Oh... yeah maybe that is a bug, never seen anything else personally - foarl 10:19, 09 April, 2010
::This bug is different - not civilian clothing, but civilian jobs. They'll work in workshops, haul goods, sit idle with "No Job", etc, and never attempt "Individual Combat Training". They do appear to equip assigned gear, though. -- 5:50, 10 June, 2010
:::Yes I can verify this bug. I have version .10 and it is still present-- None of the 4 dwarfs in 1 of my 2 squads will take on 'active' military roles such as macedwarf, marksdwarf, etc... unless they are performing a move or attack order. When a kill order was cancelled (because it was completed) they even dumped their weapons and armor right where they were! At the same time the other squad works fine other than they are all endlessly waiting for a training excercise to begin. I was able to work around this by disbanding the squad, firing the militia captain & recreating them. 17:00EST 19 July, 2010

*Bolts assigned to a squad that is then disbanded do not free up for use by other squads automatically.

*The default settings are such that your military dwarfs will train, train, train, and possibly starve in the process. [[Thirsty]] and [[Hungry]] tags are guaranteed to appear for any soldier (as they are when a dwarf does anything else in this release) because Dwarves will now try to complete a task before they eat/drink.
:{{L|Military/Guide}}

*Dwarves will continue to train in barracks even after being removed from a squad. (Because they are completing the task they started before they will move on to something else, changing your alert helps here as well).

*Dwarves will sometimes use many weapons and armor at once. When they have two weapons in the same hand, they seem to be unable to attack with either weapon.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=648 Bug Tracker]

*Dwarves who die are still listed in the military screen in their squad without any notification of their death. This could lead to a user assigning the best equipment to a squad leader without knowledge of his demise.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=182 Bug Tracker]

*When [[Reclaim]]ing a lost fortress, soldiers will not use any armour or weapons assigned to them, insisting on training and fighting unarmoured and barehanded. This behaviour seems related to the [[arsenal dwarf]] position - when the fortress population becomes high enough and a dwarf is assigned to the position, soldiers will finally use the equipment they have been assigned. It seems that, on reclaiming, the game acts as if you need to have an arsenal dwarf right from the start, despite there not being any way to assign one.

*Copying an empty order causes an immediate crash.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=35 Bug Tracker] --'''Fixed''' {{version|0.31.03}}

*Going to the schedule grid of the inactive group causes an immediate crash.
:[http://www.bay12games.com/dwarves/mantisbt/view.php?id=156 Bug Tracker] --'''Fixed''' {{version|0.31.03}}

== Medicine ==
*<s>Surgeons may endlessly perform surgery on dwarves with no effect.</s>
:[http://bay12games.com/dwarves/mantisbt/view.php?id=318 Bug Tracker]
: Fixed
*<s>Surgeon provided constant "suturing," each time using up thread. May be related to above problem.</s>
:Fixed
*Any blood smear or pool can spread indefinitely. The most common problem is a pool of blood in a high-traffic area. This causes every dwarf that touches it to get blood on them. Each dwarf will then eventually wash it off, creating another pool of blood by the well, which is likely another high-traffic area. Eventually you end up with the dining room and food stockpiles all coated with several dozen different creatures' blood.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=296 Bug Tracker]

*<s>Dwarves raid caravans for cloth (maybe thread as well) for the hospital zone.</s>
:[http://bay12games.com/dwarves/mantisbt/view.php?id=66 Bug tracker]

== Items ==

*Eating a masterwork meal will cause the cook to suffer art defacement. --'''Fixed''' {{version|0.31.07}

*Quarry bush leaves might not appear in the kitchen menu, and dwarves might not cook them, rendering them useless except for trading.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=47 Bug Tracker] --'''Fixed''' {{version|0.31.02}}

*Obsidian does not appear in the accounting stone menu.
: Workaround: Remove edge tags from raws.
*Reclaim mode, some items recovered become immobile, even when claimed instead of forbidden. Buidling on the area they occupy is impossible, as dwarves won't move the item.
:Workaround: Make water wash the item into a river, or somewhere it will be destroyed.
:Workaround: Channel under the item, dropping it to a lower z-level. This makes the item usable again.

*Dwarves will frequently abandon meals they've claimed for eating, resulting in rotting food scattered about the fortress that can't be stored, hauled, or dumped by any dwarf, including the one who claimed it.

==Nobles==

*<s>When the mayor dies, all nobles are removed until a new mayor is elected.</s>
:Workaround: To speed up this process, set the population required for mayors to '1' in the raws (raw>objects>entity_default.txt).
:[http://bay12games.com/dwarves/mantisbt/view.php?id=141 Bug Tracker] --'''Fixed''' {{version|0.31.05}}

*Former mayors continue to demand accomodations and make mandates. You can check their mandates by going to that specific dwarf's thoughts. This can cause [[fun]] as dwarves are arrested for not fufilling demands.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=814 Bug Tracker] --'''Fixed''' {{version|0.31.05}}

== Graphics ==
*Arena does not work for graphics mode.
:[http://www.bay12forums.com/smf/index.php?topic=53505.0 Forum Link]
:[http://bay12games.com/dwarves/mantisbt/view.php?id=42 Bug Tracker] --'''Fixed''' {{version|0.31.02}}

*After generating a world and embarking, you may notice missing tiles.
:Workaround: Restart Dwarf Fortress.

*In the 'z'-status menu, there is no image for nobles/administrators. Instead, there is an empty space where the purple dwarf should be.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=375 Bug Tracker] --'''Open'''

== Saves ==
*Renaming a save (ex. "Region2-spr-1050" to "Region2") may invalidate the save, even if you give the save its original name back. ((Confirmation needed))

==Trading and Depot==

*Elf traders may stay a long time.
:This is because creatures that the elves come with do not have pack animal values set on them, yet elves are able to use any creature as a pack animal. Check what is carrying their goods when they arrive. Often it will be warthogs, which do not have trade capacity values. Which apparently makes them carry enormous, ridiculous loads and take forever to load/unpack.
:Workaround: A fix is to go into the creature_large_topical.txt file and add in [TRADE_CAPACITY:XXXX] under the warthog's [PACK_ANIMAL] entry (where XXXX is the weight you want them to carry). Or just remove the [PACK_ANIMAL] tag altogether. Be forewarned, you may or may not have to make a new world for the fix to take effect.
:Workaround: with the game paused and the depot in view, designate treecutting {{k|d}} - {{k|t}}, and just hold down the mouse button until the depot display no longer flashes between items very quickly.
::Why this works: it has been known that certain parts of the game engine keep running while the game is paused. These include cat-dwarf adoptions and the trade liaison conversation. It appears to also apply to traders loading up their goods, and probably to unloading goods as well.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=325 Bug Tracker] --'''Fixed''' {{version|0.31.06}}

*No one brings wagons, even if there is a clear path to your depot.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=197 Bug Tracker]

*Dwarves may try to eat unowned food at the Depot, but realize their mistake halfway and stop... then try again... you can see where this is going.
:[http://bay12games.com/dwarves/mantisbt/view.php?id=237 Bug Tracker]

== Program Lockup ==
*The DF process sometimes locks up (freezes) when alt-tabbing to another window and back.
:Workaround: That happened to me fairly often in the 40d# series. Try hitting the Alt key (I think it was Alt anyway) before you give up. [[Special:Contributions/75.210.204.237|75.210.204.237]] 04:42, 2 June 2010 (UTC)
::Alt did not work, neither did control, shift, enter or any combination of those--[[Special:Contributions/208.81.12.34|208.81.12.34]] 18:22, 9 June 2010 (UTC)
:::My lockup issue seems to be related to Lotus Notes. I only get the lockup when running Notes, and I don't get locked up when not running Notes.--[[Special:Contributions/208.81.12.34|208.81.12.34]] 17:12, 14 July 2010 (UTC)

v0.31:Maximizing framerate

2010-08-13T04:46:19Z

Mason11987: cleanup and av article

{{quality|Fine|08:00, 22 May 2010 (UTC)}}
{{av}}
[[File:Frames_Per_Second_Meter.png|300px|thumb|bottom|A picture of Dwarf Fortress with Frames Per Second displayed.]]

{{L|Frames per second|Framerate}} is used in Dwarf Fortress to measure the speed at which the game is running. To check your FPS (frames per second) in Dwarf Fortress, simply change [FPS:NO] to [FPS:YES] in {{l|init.txt}}, and your FPS will be displayed near the top right corner of the screen.

==Ways to increase your framerate==

* Decreasing the G_FPS in the init text file can drastically improve your fortress' overall FPS. Be careful however, decreasing it too much can subject you to incomprehensible graphic instabilities. G_FPS refers to the "maximum graphical frame refresh rate during play." In other words, the maximum number of times it repaints the graphics of your game per second. Remember, with a low G_FPS, it can be dangerous during battle or when arrows are flying over your Dwarves' heads, because the screen doesn't update as often. The default is 50 G_FPS, but it's been reported that 20 G_FPS is fine. Others report being able to play at even 5 G_FPS. There is no set number, just remember to test out a variety of numbers to see which one is right for you and your computer.

*Disabling [[Temperature]] and [[Weather]] in the init file increases speed due to fewer calculations being required.

*Limiting the number of dwarves and other moving units (cage or butcher animals!) greatly helps keep speed up.

*World size and fortress site size increase RAM usage and decrease speed. Check if you are happier with an embark rectangle of 3x3 or 3x2 and a medium or small world.
::(DF .31.12) World size probably doesn't matter at all (except for save file size), but the embark size and how many cavern layers the world has (defaults to 3).

*Lowering the pathfinder cost for normal tiles to 1 can reduce lag created by open space but does this at the cost of being able to use high traffic options. Alternatively, you can cover the entire map with high traffic tiles and simply make everything you don't want your dwarves traveling through low or restricted.

* Some people try to reduce the number of items in the fort by "atom-smashing" them under a bridge or donating them away to traders. Alternatively, less digging in the first place results in fewer stones and corridors in the world to consider.

* Due to bug (0000296), contaminants such as blood, snow, etc, count as items. Since contaminants can spread and you cannot easily get rid of them, try to avoid things that spread contaminants: wells, killing things in high traffic spots, and soap. If you have HFS that exudes slime, you might as well save your game and wait for an update.

v0.31:Interface

2010-08-11T20:59:09Z

Mason11987:

{{av}}

The Dwarf Fortress interface is made up of several different parts besides the main game area.

[[Image:DFInterface.png|right|500px]]

* A: [[Combat report|Combat, Hunting, and Sparring reports]].
* B: The game [[Menu]]
* C: The number of [[Idle dwarfs]]
* D: The [[z-level]] you are currently viewing.

v0.31:Interface

2010-08-11T20:58:09Z

Mason11987: This

{{av}}

The Dwarf Fortress interface is made up of several different parts besides the main game area.

[[Image:DFInterface.png|right|500px]]

* A: [[Combat Report|Comabt, Hunting, and Sparring reports]].
* B: The game [[Menu]]
* C: The number of [[Idle dwarfs]]
* D: The [[z-leve]] you are currently viewing.

File:DFInterface.png

2010-08-11T20:55:23Z

Mason11987: