v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Editing DF2014:Legends

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.

You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "DF2014"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Quality|Exceptional|06:48, 6 October 2013 (UTC)}}
+
#REDIRECT [[Legends]]
{{av}}
 
[[File:Vanitas still life.jpg|thumb|250px|right|Only two things are certain in ''Dwarf Fortress'': [[Fun]], and the legends you leave behind.]]
 
'''Legends''' mode is one of the three main methods of interacting with an already-generated [[World generation|world]]. In Legends mode, players can view maps, histories of each civilization and any figure who has lived or died in the generated world. Any noticeable achievement made by the player in [[Dwarf fortress mode|Fortress]] or [[Adventurer mode|Adventurer]] mode is recorded and is viewable in Legends mode. You may explore Legends mode after you generate a new world.
 
 
 
Many players choose to generate a world where the option '[[Advanced_world_generation#Reveal_All_Historical_Events|Reveal All Historical Events]]' is set to YES (the default) - however, if you set the option to NO, then the vast majority of the world history will be hidden in Legends mode until uncovered by brave adventurers. Even when set to YES, some things may not be revealed; all ''events'' will be revealed, but some [[historical figure]]s, [[site]]s, [[region]]s, and [[civilization]]s and other entities may ''not'' be, possibly because they are not known to any civilization.
 
 
 
Ways for an adventurer to uncover events and other things include:
 
* talking to people in civilized sites and asking them various questions
 
* viewing items with images, like [[coin]]s, [[armor]], [[engraving]]s, [[statue]]s, etc
 
* finding artifacts and [[book]]s and other written works
 
* possibly reading written works{{verify}} or by listening to stories and songs{{verify}}
 
 
 
You don't ''have'' to have had an adventurer or fortress game active in order to use Legends mode - some players simply enjoy it 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. In fact, Legends Mode cannot be entered if there is an active adventurer or fortress in the world. However, a copy of such a world can be made, loaded in the game and the current mode retired or abandoned, then opened in Legends mode.
 
 
 
== Accessing Legends Mode ==
 
By accessing Legends mode, you are deciding to reveal all the knowledge of the world that would otherwise be discoverable only in pieces, through Fortress or Adventurer Mode. When you choose "Start Playing" in a world that doesn't have a current Adventure or Dwarf mode game, you will be presented with Legends Mode.
 
 
 
:Note: If you are already playing a fort or adventure on the save you want to use, you can make a copy of the existing world from the [[Saved_game_folder|save folder]], and then retire the fortress from that copy. <!-- or use dfhack method below-->
 
 
 
=== Available Information===
 
[[File:Legends menu.png|thumb|In-game Legends viewer (''not to be confused with [[Utilities#Legends_Viewer| the utility of the same name]]'')]]
 
 
 
* '''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 figure]]s exist in the world's history. Historical figures include entries on [[megabeast]]s, [[forgotten beast]]s, [[demon]]s, [[deity|gods]], [[Dwarf|dwarves]], [[human]]s, [[goblin]]s, [[kobold]]s, and other named [[creature]]s.
 
 
 
* '''Sites''' - The number to the right indicates how many [[site]]s have existed throughout the world's history. [[Site]]s include things like [[town]]s, [[Tower (necromancy)|tower]]s, [[fortress]]es, [[forest retreat]]s, and [[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 [[civilization]]s, local governments, and religions have existed throughout the 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. Fortresses, towers, shops, taverns, temples and more can all be found in this list.  Temples are the central location of [[religion]]s, and can be 'profaned' by historical figures, though it is not explained what this involves.
 
 
 
* '''Historical Map''' - The historical map is a very cool feature of Legends mode - from here, you can view the territorial disputes between different civilizations and entities, including those that 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. Multiple civilizations can lay claim to the same area, causing the colored territory markers to overlap. You can also see how territories change 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.
 
 
 
* '''[[Ages|The Age of...]]''' - During world generation, the calendrical ages are named for the greatest powers extant in the world, which commonly advance during world generation (e.g. Age of Legends, Age of Heroes, Age of Humans) due to the death of megabeasts, and sometimes even regress due to the creation of [[night creature]]s and the birth of new [[megabeast]]s. When you choose to look at the history of an [[Ages|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 [[megabeast]]s amongst the [[peasant]]s.  See [[Ages|here]] for a list of ages and their conditions.
 
 
 
==Exporting World information==
 
 
 
Legends mode has built-in tools to export lists of events, maps at various scales, and data such as locations of sites.  This is particularly useful as input data for the utilities described below; there are even tools to make this export process easier (see next section). 
 
 
 
=== 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, say, 1000 years (or even 10,000) 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 [[Main:XML dump|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 and one bitmap image that are placed in the root directory of ''Dwarf Fortress''.  The exported data files are named by the save file name, and the current world date:
 
# (save name)-world_gen_param.txt - contains the world generation settings.
 
# [[World History file|(save name)-(year)-(month)-(day)-world_history.txt]] - Includes some information about the deities, and rulers of the Human, Dwarven, Elven, and Goblin civilizations.
 
# [[World Sites file|(save name)-(year)-(month)-(day)-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.
 
# (save name)-(year)-(month)-(day)-world_map.bmp  - This is the full world map as it is shown on the embark screen, and, unlike the detailed maps below, will depend on the tileset and colour scheme you have installed.
 
 
 
=== Export Detailed Maps ===
 
Pressing {{k|d}} in Legends mode reveals a list of the different kinds of map you can export. The images are exported to the game's root directory when you highlight the one you want and press {{k|Enter}}.
 
 
 
{|
 
|- style="vertical-align: top;"
 
| style="width:350px;"|
 
;List
 
*Standard biome+site map (detailed map)
 
*[[Advanced_world_generation#Elevation|Elevations]] incl. lake and ocean floors
 
*[[Advanced_world_generation#Elevation|Elevations]] respecting water level
 
*[[Advanced_world_generation#Temperature|Temperature]]
 
*[[Advanced_world_generation#Rainfall|Rainfall]]
 
*[[Advanced_world_generation#Drainage|Drainage]]
 
*[[Advanced_world_generation#Savagery|Savagery]]
 
*[[Advanced_world_generation#Volcanism|Volcanism]]
 
*[[Vegetation|Current vegetation]]
 
*[[Evil]]
 
*[[Water|Salinity]]
 
* Diplomacy
 
* Hydrological map (rivers, streams, lakes, oceans)
 
* [[Noble|Nobility]]
 
* Cadaster (Structures, roads, ...)
 
* [[Trading|Trade]]
 
|
 
;Examples
 
<gallery mode=packed>
 
File:Standard biome and site map.png|Biome & site map
 
File:World_graphic-el-region5-203-10075.PNG|Elevation incl. lake and ocean floors
 
File:World_graphic-elw-region5-203-10075.PNG|Elevation respecting water level
 
File:World graphic-tmp-region5-203-10075.PNG|Temperature
 
File:World_graphic-rain-region5-203-10075.PNG|Rainfall
 
File:World_graphic-drn-region5-203-10075.PNG|Drainage
 
File:World_graphic-sav-region5-203-10075.PNG|Savagery
 
File:World_graphic-vol-region5-203-10075.PNG|Volcanism
 
File:World_graphic-veg-region5-203-10075.PNG|Current vegetation
 
File:World_graphic-evil-region5-203-10075.PNG|Evil
 
File:World_graphic-sal-region5-203-10075.PNG|Salinity
 
</gallery>
 
|}
 
 
 
== Utilities & Tools ==
 
{{Main|Utilities#Legends tools}}
 
There are many utilities that work with the data exported from Legends mode, or make exporting that info easier. 
 
 
 
===Export tools===
 
 
 
When using [[DFHack]], you can use the built-in <code>exportlegends maps</code> to export all detailed maps, saving a lot of time on large worlds compared to exporting them individually and waiting for each to finish. Likewise, <code>exportlegends all</code> will export all including all detailed maps, as well as their worldgen info and legends XML. See Further [https://docs.dfhack.org/en/stable/docs/_auto/base.html#exportlegends docs.dfhack.org] Documentation.
 
 
 
[http://www.bay12forums.com/smf/index.php?topic=131307 Export processing script] can automate processing of Legends information, and is included in the Windows [[Utility:Lazy_Newb_Pack|Lazy Newb Pack]]. If GIMP is installed, the script will use Dwarf Map Maker (see below); optipng can be used to compress the images from bitmaps to .png files. This tool previously also removed non-printing ASCII characters from the XML dump, that could crash Legends Viewer (usually caused by DFHack's workflow), and creates a compressed folder for each region suitable for Legends Viewer (or simply compresses the XML, if some parts have not been exported).
 
 
 
===Legends viewing tools and visualisers===
 
 
 
The most famous is likely [[Utilities#Legends_Viewer|Legends Viewer]], an alternative interface that recreates legends mode from exported data with many more features such as graphs, filtering, sorting, and hyperlinks.  There are alternative tools with similar functionality, including [[DF2014:Utilities#World_Viewer|World Viewer]]. 
 
 
 
[http://www.bay12forums.com/smf/index.php?topic=73095.msg2261106#msg2261106 The Dwarf Map Maker] is available as a GIMP script (free software) or a photoshop actionscript.  Both use the detailed maps to produce a pretty fantasy map that looks somewhat like a satellite image.  The GIMP script is called as part of PeridexisErrant's legends processing script, if the dependencies are present. 
 
 
 
{{Translation| dwarven = gomath | elvish = liceva | goblin = olzul | human = en}}
 
 
 
{{Category|Guides}}
 
[[ru:Legends]]
 

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)

This page is a member of 1 hidden category: