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

Difference between revisions of "Importing and exporting worlds"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(Tagging v50 page (2254/4888))
m (→‎Save: added main template for saves)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{migrated article}}
+
{{Quality|Fine}}
{{Quality|Unrated}}
 
 
{{av}}
 
{{av}}
  
 
Although ''Dwarf Fortress'' is a single-player game, it is still common to incorporate a social aspect into the game. For example, you may have found a great site that you want to share with others, you want to play a save or embark that someone else posted, you're reporting a crash during world generation, or maybe you simply want to back up your world or game. There are two primary methods for importing and exporting worlds in ''Dwarf Fortress'': exchanging the seed, and exchanging the save.
 
Although ''Dwarf Fortress'' is a single-player game, it is still common to incorporate a social aspect into the game. For example, you may have found a great site that you want to share with others, you want to play a save or embark that someone else posted, you're reporting a crash during world generation, or maybe you simply want to back up your world or game. There are two primary methods for importing and exporting worlds in ''Dwarf Fortress'': exchanging the seed, and exchanging the save.
  
== Seed ==
+
== Seeds ==
"Seed" refers to the 4 specific random strings used to seed the pseudo-random number generator. These values are not sufficient to duplicate a world without the rest of the [[world token|world gen parameters]], but "seed" is shorter to say, so is often used to mean the entire set of parameters.  Provided the versions of ''Dwarf Fortress'' are similar enough and no [[modding]] has taken place on either end, using a person's worldgen parameters suffices to generate the same world/s as they did. Unfortunately, this method is incapable of also moving around any events that happened after world generation ended, including the fortresses or adventures that may have taken place.
+
{{main|Advanced_world_generation#Seed_values|Advanced_world_generation#Seed_notes|l1=Seed values|l2=Seed notes}}
 
+
"Seeds" refers to the 4 specific random strings used to seed the pseudo-random number generator. These values are not sufficient to duplicate a world without the rest of the [[world token|world generation parameters]]. Unfortunately, the historical events during world generation don't currently always happen the same way, and this method is incapable of replicating any events that happened after world generation ended, including any fortresses or adventures. Mods and even parameters can greatly change how a world generates, causing the game to use more or fewer pseudo-random numbers for each step, meaning later steps get a different series of numbers.
If modding has taken place, the world (but still not any events past worldgen) can still be exchanged if both receiver and transmitter have exactly the same modification. Moving the world through this method may be slow for the receiver, especially for worlds with a long history.
 
  
 
===Export===
 
===Export===
The easiest way to export your worldgen parameters is to press {{k|p}} at the "<font color="green">p</font>: Export image/info" prompt right after worldgen has completed. If you didn't do that, then start the game in [[Legends|Legends mode]], and press {{k|P}}. Either way, your ''Dwarf Fortress'' root folder should now contain several new files including a text file with the phrase "world_gen_param" in its name. That's the one people want. Copy or email the file or the text inside it to the receiver, or simply store the file in a safe place to be able to regenerate the world later.
+
When the game generates a world, it writes the seeds it used for that world in the <code>gamelog.txt</code> file in the main ''Dwarf Fortress'' folder. Unfortunately, the game doesn't currently provide a full output of the world generation parameters.
 
 
This process is more difficult during [[Fortress mode|fortress]] or [[Adventure mode|adventure]] play, because the world cannot be loaded in Legends mode. During fortress mode, load up your fortress and press {{k|Esc}}. Go to "export local image". Export local images of however much of your fortress you want (select only one level of it to save time exporting); the exported image is not important. Your ''Dwarf Fortress'' root folder should now contain several new files including a text file with phrase "world_gen_param" in its name. That is the one people want. As before, copy or email the file or its contents to whatever purpose was intended.
 
 
 
During adventure play, the "export local image" function is not available. If this is the case, it is necessary to make a copy of the save. From the ''Dwarf Fortress'' root directory, navigate to "data/save". From there, locate the folder with the region name to export parameters of, and copy the entire folder. Then, paste the folder into the same "data/save" directory. Now, navigate to Dwarf Fortress and load the region with the name "Copy of ..." or "... copy" or the like, and retire or starve the adventurer. Then, load the same copy in Legends mode and press {{k|P}} to export the same "world_gen_param" file.
 
 
 
After these processes, the extra files in the ''Dwarf Fortress'' root directory can be safely deleted. Additionally, after the adventure strategy, the copy of the region can also be deleted.
 
  
 
===Import===
 
===Import===
Open your ''Dwarf Fortress'' root directory, go to Data, then Init. Open the text file called "world_gen.txt". Copy/Paste the parameters given to the bottom of that file. Make sure to save and close the file.
+
If the world was generated using [[advanced world generation]] and the parameters were saved, or can otherwise be remembered, then the seeds can be copied into <code>prefs/world_gen.txt</code>, using the proper tokens. They cannot currently be pasted into the game directly, but can be entered manually.
 
 
Next, open ''Dwarf Fortress''. Go to "Design New World with Advanced Parameters". Worlds that you have parameters for are listed by title on the right. Choose your newly acquired world from the list and hit enter. Note that this process may take a while.
 
  
 
==Save==
 
==Save==
The [[Saved game folder|save folder]] contains all the information on your world, and all the things you have done to it since you started playing. Use this if you want to share your actual fortress or adventure rather than just the pristine unplayed world, or if the world has already been played in and the previous fortresses or adventures are important for the purpose. Moving save folders around is also a useful way to back up your games while keeping clutter to a minimum in the Continue Game menu.
+
{{main|Saved game folder}}
 +
The [[Saved game folder|save folder]] contains all the information on your world, and all the things you have done to it since you started playing. Use this if you want to share your actual fortress or adventure rather than just the pristine unplayed world, or if the world has already been played in and the previous fortresses or adventures are important for the purpose. Moving save folders around is also a useful way to back up your games while keeping clutter to a minimum in the Continue Game menu, and is a more complete way of sharing a world than using seeds.
  
Additionally, moving the world by save preserves all mods and [[Graphics set repository|graphics]]. Therefore, this may be the preferred method when the world is based on a modded game. Moving the world in this way is also significantly easier than by seed, but it may take up more disk space and will be harder to transfer.
+
Additionally, mods are not included in saves, thus, when sharing a save of a modded game you should also include the [[Game_folders_and_files#Mods_folders|installed_mods]] folder.
  
 
===Location===
 
===Location===
Your saved game is located in your ''Dwarf Fortress'' folder inside the "data/save" folder. The save folder will contain one or more sub-folders, each one holding one of your worlds, and a "current" folder. The "current" folder is used to track the changes to the active world while ''Dwarf Fortress'' is running; it is not important unless ''Dwarf Fortress'' is open, and can safely be deleted otherwise.
+
{{main|Game folders and files}}
 +
Your saved game is located in a folder in the <code>save</code> folder, the location of which depends on the [[Settings#Portable_mode|portable mode setting]]. The save folder will contain one or more sub-folders, each one holding one of your worlds, and a <code>current</code> folder. The <code>current</code> folder is used to track the changes to the active world while ''Dwarf Fortress'' is running; it is not important unless ''Dwarf Fortress'' is open, and can safely be deleted otherwise.
  
 
===Export===
 
===Export===
Upload the entire save folder (preferably compressed) to your favorite file host, or, better yet, to the [http://dffd.bay12games.com/ Dwarf Fortress File Depot].
+
Upload the entire save folder (preferably compressed), and the <code>installed_mods</code> folder if applicable, to your favorite file host, or, better yet, to the [http://dffd.bay12games.com/ Dwarf Fortress File Depot].
  
 
===Import===
 
===Import===
Simply drop the other person's save folder in the "data/save", and the game can be played.
+
Copy the other person's save folder to the <code>save</code> folder, and the contents of the <code>installed_mods</code> folder, if included, to your <code>data\installed_mods</code>, then the game can be played.
  
 
{{Category|Guides}}
 
{{Category|Guides}}
 
[[ru:Importing and exporting worlds]]
 
[[ru:Importing and exporting worlds]]

Latest revision as of 01:20, 24 September 2025

This article is about the current version of DF.
Note that some content may still need to be updated.

Although Dwarf Fortress is a single-player game, it is still common to incorporate a social aspect into the game. For example, you may have found a great site that you want to share with others, you want to play a save or embark that someone else posted, you're reporting a crash during world generation, or maybe you simply want to back up your world or game. There are two primary methods for importing and exporting worlds in Dwarf Fortress: exchanging the seed, and exchanging the save.

Seeds[edit]

Main articles: Seed values and Seed notes

"Seeds" refers to the 4 specific random strings used to seed the pseudo-random number generator. These values are not sufficient to duplicate a world without the rest of the world generation parameters. Unfortunately, the historical events during world generation don't currently always happen the same way, and this method is incapable of replicating any events that happened after world generation ended, including any fortresses or adventures. Mods and even parameters can greatly change how a world generates, causing the game to use more or fewer pseudo-random numbers for each step, meaning later steps get a different series of numbers.

Export[edit]

When the game generates a world, it writes the seeds it used for that world in the gamelog.txt file in the main Dwarf Fortress folder. Unfortunately, the game doesn't currently provide a full output of the world generation parameters.

Import[edit]

If the world was generated using advanced world generation and the parameters were saved, or can otherwise be remembered, then the seeds can be copied into prefs/world_gen.txt, using the proper tokens. They cannot currently be pasted into the game directly, but can be entered manually.

Save[edit]

Main article: Saved game folder

The save folder contains all the information on your world, and all the things you have done to it since you started playing. Use this if you want to share your actual fortress or adventure rather than just the pristine unplayed world, or if the world has already been played in and the previous fortresses or adventures are important for the purpose. Moving save folders around is also a useful way to back up your games while keeping clutter to a minimum in the Continue Game menu, and is a more complete way of sharing a world than using seeds.

Additionally, mods are not included in saves, thus, when sharing a save of a modded game you should also include the installed_mods folder.

Location[edit]

Your saved game is located in a folder in the save folder, the location of which depends on the portable mode setting. The save folder will contain one or more sub-folders, each one holding one of your worlds, and a current folder. The current folder is used to track the changes to the active world while Dwarf Fortress is running; it is not important unless Dwarf Fortress is open, and can safely be deleted otherwise.

Export[edit]

Upload the entire save folder (preferably compressed), and the installed_mods folder if applicable, to your favorite file host, or, better yet, to the Dwarf Fortress File Depot.

Import[edit]

Copy the other person's save folder to the save folder, and the contents of the installed_mods folder, if included, to your data\installed_mods, then the game can be played.