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

Difference between revisions of "v0.34:Saved game folder"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(→‎Contents: spelling)
m (Changed categorization to Template:Category)
 
(14 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{quality|Fine|00:48, 29 April 2012 (UTC)}}{{av}}
+
{{Quality|Exceptional|21:05, 11 May 2013 (UTC)}}
 +
{{av}}
  
The '''saved game folder''' is the location in where a certain region's information and necessary files are stored and accessed by Dwarf Fortress. Knowledge on the technicals of the saved game folder is crucial if one wishes to [[Importing and exporting worlds|import or export saves]].
+
The '''saved game folder''' is the location in where a certain region's information and necessary files are stored and accessed by ''Dwarf Fortress''. Knowledge on the technicals of the saved game folder is crucial if one wishes to [[Importing and exporting worlds|import or export saves]].
  
 
== Location ==
 
== Location ==
Individual [[world generation|worlds]] are stored in the '''data/save/''' directory in the Dwarf Fortress root directory.  By default, they are saved in the format: ''region#'', where # is a number, starting with region1 and then incrementing; however, world directories can be renamed without consequence (this will not change the actual name of the world). On Windows 7, if Dwarf Fortress is installed in the Program Files subdirectory, the saved game folders are instead located at "Users\Myname\Appdata\Local\VirtualStore\Program Files\Dwarf Fortress\data\save".
+
Individual [[world generation|worlds]] are stored in the '''data/save/''' directory in the Dwarf Fortress root directory.  By default, they are saved in the format: ''region#'', where # is a number, starting with region1 and then incrementing; however, world directories can be renamed without consequence '''if the game is not running''' (this will not change the actual name of the world). On modern versions of Windows, if Dwarf Fortress is installed in the Program Files directory, the saved game folders are instead located at "Users\Myname\Appdata\Local\VirtualStore\Program Files\Dwarf Fortress\data\save" unless the game was invoked with "Run as Administrator".
  
 
If you have modified your [[d_init.txt]] to seasonally backup, then the backup folders will be named ''region#-season-year'', for example region1-spr-202.
 
If you have modified your [[d_init.txt]] to seasonally backup, then the backup folders will be named ''region#-season-year'', for example region1-spr-202.
  
This can become confusing if you frequently [[cheating|savescum]]. There is no way to change the name of these folders inside the game, but it is safe to change them using the standard methods of your operating system if the game is not running.  However, '''never''' alter or delete the folder with the name of the game you're playing ''while saving'' from the game, or while that game is running! This can cause fatal flaws many dwarf-seasons later, and is one known cause of the [http://www.bay12games.com/forum/index.php?topic=34936.0| "Nemesis Unit Load Failed"] crash error.
+
This can become confusing if you frequently [[cheating|savescum]]. There is no way to change the name of these folders inside the game, but it is safe to change them using the standard methods of your operating system if the game is not running.  However, '''never''' alter or delete the folder with the name of the game you're playing ''while saving'' from the game, or while that game is running! This can cause fatal flaws many dwarf-seasons later, and is one known cause of the "Nemesis Unit Load Failed" crash error.
  
 
== Contents ==
 
== Contents ==
Line 17: Line 18:
 
** There is also a ''graphics'' folder for [[Graphics set repository|graphics]] for creatures.
 
** There is also a ''graphics'' folder for [[Graphics set repository|graphics]] for creatures.
 
** Finally, there may be an ''interaction examples'' folder. This, along with any files or folders not present in the aforementioned two folders, can be safely deleted.
 
** Finally, there may be an ''interaction examples'' folder. This, along with any files or folders not present in the aforementioned two folders, can be safely deleted.
* A series of files named ''art_image-#.dat''. As their name would suggest, these files store information about art and are necessary for proper functioning. Replacement with other files is not recommended.
+
* A series of files named ''art_image-#.dat''. As their name would suggest, these files store information about art and are necessary for proper functioning. Don't replace!
 
* A series of files named ''feature-#-#.dat''. The amount of these files is heavily dependent on the size of the world, and they store the information about map features (such as [[river]]s, [[cavern]]s, [[magma sea]]s, and [[adamantine|spires]]). Replacing these files will very rarely crash the game, but usually will cause unwanted effects such as magma seas present on the surface. These files do not seem to cause too many crashes when removed, and do not exist in some peculiar worlds.
 
* A series of files named ''feature-#-#.dat''. The amount of these files is heavily dependent on the size of the world, and they store the information about map features (such as [[river]]s, [[cavern]]s, [[magma sea]]s, and [[adamantine|spires]]). Replacing these files will very rarely crash the game, but usually will cause unwanted effects such as magma seas present on the surface. These files do not seem to cause too many crashes when removed, and do not exist in some peculiar worlds.
 
* A series of files named ''region_snapshot-#.dat''. These are the historical maps available in [[Legends|Legends mode]].
 
* A series of files named ''region_snapshot-#.dat''. These are the historical maps available in [[Legends|Legends mode]].
Line 25: Line 26:
  
 
Missing one or more of the aforementioned important files may indicate a problem with the save; this is a very common source of crashes.
 
Missing one or more of the aforementioned important files may indicate a problem with the save; this is a very common source of crashes.
 +
 +
For basic backups, though, all you need to keep to is: Always copy the whole folder, not parts of it.
  
 
== Backing up saves ==
 
== Backing up saves ==
Line 34: Line 37:
 
Do '''not''' overwrite an old folder, as it might leave residual files.
 
Do '''not''' overwrite an old folder, as it might leave residual files.
  
Please '''do''' back up saves.  Although the game has permanent death and you might want to play it in that spirit, the game, it is also an alpha, and your world might become corrupted by an error. You can also make use of the auto save features settable in "data/init/d_init.txt".
+
Although the game has permanent death and you might want to play it in that spirit, the game is also an alpha, can crash, and your world can become corrupted by an error. You can also make use of the auto save features settable in "data/init/d_init.txt". Making backups can save you a lot of grief.
  
 
For more info on the autosave feature, see [[d_init.txt]].
 
For more info on the autosave feature, see [[d_init.txt]].
Line 42: Line 45:
 
Restoring a savegame from backup can be very confusing.
 
Restoring a savegame from backup can be very confusing.
  
The game saves to the directory from which it was loaded, so if you restore a game from a seasonal save after a crash, you will be saving to the folder from which you loaded and not to your default folder where you would expect it.
+
The game saves to the directory from which it was loaded, so if you restore a game from a seasonal save after a crash, you will be saving to the folder from which you loaded (like [region1-spring-1056]) and not to your default folder (like [region1]) where you would expect it.
  
This can cause some high blood pressure and panic, because you will see your 'Region X' save as several years older than you would expect it and it will look like you lost all your work since last autosave to some bug. The save you would like to load is however going to be hidden in the slot from which you loaded from automatic backup.
+
This can cause some high blood pressure and panic, because you will see your 'Region X' save as several years older than you would expect it and it will look like you lost all your work since last autosave to some bug. The save you need to load is however going to be in the slot from which you loaded from automatic backup.
  
 
The golden rule is: if you want to restore a savegame from backup, you should rename that backup to indicate that. Remember to do that while the game is not running, per the instructions for savescumming above.
 
The golden rule is: if you want to restore a savegame from backup, you should rename that backup to indicate that. Remember to do that while the game is not running, per the instructions for savescumming above.
  
[[Category:Modding]]
+
==Warning==
[[Category:Files]]
+
Save folders can be large, ranging from 20 MB for small saves to several hundred megabytes for large saves. If you run out of hard drive space while saving, Dwarf Fortress will ''pretend'' to save correctly, but the save will be unloadable. Opening other saves to verify that they still work, then saving and exiting, will corrupt your previously-working saves as well. Make sure you have sufficient free disk space before launching Dwarf Fortress! {{bug|2587}}
 +
 
 +
{{Category|Modding}}

Latest revision as of 13:07, 4 January 2023

This article is about an older version of DF.

The saved game folder is the location in where a certain region's information and necessary files are stored and accessed by Dwarf Fortress. Knowledge on the technicals of the saved game folder is crucial if one wishes to import or export saves.

Location[edit]

Individual worlds are stored in the data/save/ directory in the Dwarf Fortress root directory. By default, they are saved in the format: region#, where # is a number, starting with region1 and then incrementing; however, world directories can be renamed without consequence if the game is not running (this will not change the actual name of the world). On modern versions of Windows, if Dwarf Fortress is installed in the Program Files directory, the saved game folders are instead located at "Users\Myname\Appdata\Local\VirtualStore\Program Files\Dwarf Fortress\data\save" unless the game was invoked with "Run as Administrator".

If you have modified your d_init.txt to seasonally backup, then the backup folders will be named region#-season-year, for example region1-spr-202.

This can become confusing if you frequently savescum. There is no way to change the name of these folders inside the game, but it is safe to change them using the standard methods of your operating system if the game is not running. However, never alter or delete the folder with the name of the game you're playing while saving from the game, or while that game is running! This can cause fatal flaws many dwarf-seasons later, and is one known cause of the "Nemesis Unit Load Failed" crash error.

Contents[edit]

The saved game folder will usually have these contents:

  • A subdirectory, raw, containing the raws directly copied from the time the world was generated.
    • Inside here is an objects folder containing the contents of the raws. This must be kept, but the contents inside can be modified to an extent.
    • There is also a graphics folder for graphics for creatures.
    • Finally, there may be an interaction examples folder. This, along with any files or folders not present in the aforementioned two folders, can be safely deleted.
  • A series of files named art_image-#.dat. As their name would suggest, these files store information about art and are necessary for proper functioning. Don't replace!
  • A series of files named feature-#-#.dat. The amount of these files is heavily dependent on the size of the world, and they store the information about map features (such as rivers, caverns, magma seas, and spires). Replacing these files will very rarely crash the game, but usually will cause unwanted effects such as magma seas present on the surface. These files do not seem to cause too many crashes when removed, and do not exist in some peculiar worlds.
  • A series of files named region_snapshot-#.dat. These are the historical maps available in Legends mode.
  • A series of files named site-#.dat.
  • A series of files named unit-#.dat. Replacing these has been known to cause the infamous Nemesis Unit Load Failed error. Resolving the aforementioned error, however, involves copying these over from a previous backup of the save. Depending on the size of the world, there could easily be thousands of these files, making it infeasible to send the saved game folder without compressing it all in one file first.
  • Depending on the mode currently active (or the lack thereof), a large file named world.sav or world.dat. In fortress mode, this file is named world.sav and includes the current fortress data, as well as the world data. In a save without a currently active game, this is the main save folder. The custom raws generated for the forgotten beasts, titans, demons, night creatures, and evil effects are stored in this file. Replacing this entire file will almost certainly crash the game; however, replacing certain portions of the raws included may still keep the save folder working.

Missing one or more of the aforementioned important files may indicate a problem with the save; this is a very common source of crashes.

For basic backups, though, all you need to keep to is: Always copy the whole folder, not parts of it.

Backing up saves[edit]

Toady recommends that you make backups, and always save to a fresh file:

  1. Copy the relevant region folder in "data/save" to a safe location.
  2. When you want to reuse it, copy that region back to "data/save".

Do not overwrite an old folder, as it might leave residual files.

Although the game has permanent death and you might want to play it in that spirit, the game is also an alpha, can crash, and your world can become corrupted by an error. You can also make use of the auto save features settable in "data/init/d_init.txt". Making backups can save you a lot of grief.

For more info on the autosave feature, see d_init.txt.

Disappearing saves[edit]

Restoring a savegame from backup can be very confusing.

The game saves to the directory from which it was loaded, so if you restore a game from a seasonal save after a crash, you will be saving to the folder from which you loaded (like [region1-spring-1056]) and not to your default folder (like [region1]) where you would expect it.

This can cause some high blood pressure and panic, because you will see your 'Region X' save as several years older than you would expect it and it will look like you lost all your work since last autosave to some bug. The save you need to load is however going to be in the slot from which you loaded from automatic backup.

The golden rule is: if you want to restore a savegame from backup, you should rename that backup to indicate that. Remember to do that while the game is not running, per the instructions for savescumming above.

Warning[edit]

Save folders can be large, ranging from 20 MB for small saves to several hundred megabytes for large saves. If you run out of hard drive space while saving, Dwarf Fortress will pretend to save correctly, but the save will be unloadable. Opening other saves to verify that they still work, then saving and exiting, will corrupt your previously-working saves as well. Make sure you have sufficient free disk space before launching Dwarf Fortress! Bug:2587