Editing World History file

{{migrated article}}
{{av}}
{{Quality|Unrated}}

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 your fortress name, followed by the world name.

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

<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 [[Deity|deities]] or [[force]]s that 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/etc.):

<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 leader's name: <code>Logem Anvilentrance</code>
:*The leader's 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 leader's 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]]

{{Category|Files}}
[[ru:World History file]]