In other languages: Deutsch Polska Русский Turkish 中文

Difference between revisions of "Application directory"

From Official Factorio Wiki
Jump to: navigation, search
(Cleanup, fixes to grammar, updates)
(move User Data to the top, since that is what everyone is looking for)
Line 2: Line 2:
  
 
== Overview ==  
 
== Overview ==  
 +
Depending on your installation method and OS, you will have one or two directories that contain Factorio assets.
 +
 +
== User Data directory ==
 +
The user data directory is where personal files are stored, such as world saves. Search your computer for this directory, or type it into your file manager address bar.
 +
 +
==== Windows ====
 +
%appdata%\Factorio
 +
 +
==== Mac OSX ====
 +
~/Library/Application Support/factorio
  
Depending on your installation method and OS, you will have one or two directories that contain Factorio assets.
+
==== Linux ====
 +
~/.factorio
  
== Application directory ==
+
==== Zip File ====
The application directory stores three things:
+
The unzipped Factorio directory
* Factorio executables (./bin)
 
* Data for vanilla Factorio (./data)
 
* API documentation
 
  
== User Data directory ==
+
A list of all things found here:
The save directory is where user-personal files are stored, such as world saves. A list of all things found here:
 
  
 
* Save games (as zip files)
 
* Save games (as zip files)
Line 25: Line 32:
 
It is recommended to create backups from this directory (of saves, config, etc) before installing a new version, or installing mods.  
 
It is recommended to create backups from this directory (of saves, config, etc) before installing a new version, or installing mods.  
  
== Directory locations by OS and installation method ==
+
== Application directory ==
=== Windows ===
+
The application directory stores three things:
==== Installation via [http://steampowered.com Steam] ====
+
* Factorio executables (./bin)
Application directory:
+
* Data for vanilla Factorio (./data)
 +
* API documentation
 +
 
 +
==== Windows ====
 
  C:\Program Files (x86)\Steam\steamapps\common\Factorio
 
  C:\Program Files (x86)\Steam\steamapps\common\Factorio
 +
C:\Program Files\Factorio
  
User data directory:
+
==== Mac OSX ====
%appdata%\factorio
+
~/Library/Application Support/Steam/steamapps/common/Factorio/factorio.app/Contents/
 
 
==== Installation by Zip-package ====
 
Application directory and User data directory will be the location to which Factorio was unpacked.
 
 
 
:For example, if you unpacked the zip to:
 
C:\Factorio
 
:Then your saves can be found in:
 
C:\Factorio\saves
 
:and mods in:
 
C:\Factorio\mods
 
 
 
==== Installation via native Installer ====
 
Application directory:
 
C:\Users\<username>\AppData\Roaming\Factorio
 
User data directory:
 
%appdata%\factorio
 
 
 
=== Mac OSX ===
 
 
 
==== Installation via Steam ====
 
Application directory:
 
 
 
<code>/Users/<replace with your username>/Library/Application Support/Steam/steamapps/common/Factorio/factorio.app/Contents/</code>
 
 
 
==== Installation via Installer ====
 
The application should be by default installed in the Apps-folder.
 
 
 
Whereas the data is stored under
 
/users/<replace with your username>/Library/Application Support/factorio
 
 
 
Which is equivalent to
 
 
  ~/Library/Application Support/factorio
 
  ~/Library/Application Support/factorio
You can type in this into the Finder (press SHIFT-COMMAND-G for goto folder) and put in exactly this line.'
 
Or you can use in Finder the 'Find a folder' and write '~/Library/Application Support' (See [http://www.factorioforums.com/forum/viewtopic.php?f=49&t=9345 Can't find Mods folder]).
 
 
The factorio internal application-data can be found (when you have installed it) in
 
 
/Applications/factorio.app/Contents/data
 
 
Same directory structure as in Application support.
 
 
=== Linux ===
 
  
Data is stored under <code>~/.factorio</code>.
+
==== Linux ====
 +
~/.factorio
  
==== Installation via Steam ====
+
==== Zip File ====
Data is stored under <code>~/.factorio</code>.
+
The unzipped Factorio directory
  
====Changing the application directory====
+
== Changing the user data directory ==
  
 
You can create a file <code>config-path.config</code> to configure Factorio to any directory.
 
You can create a file <code>config-path.config</code> to configure Factorio to any directory.
Line 87: Line 58:
 
'''[http://www.factorioforums.com/forum/viewtopic.php?f=49&t=12819&p=87281#p87281 Please see this discussion]''' (for MacOS, but should work on any other OS).
 
'''[http://www.factorioforums.com/forum/viewtopic.php?f=49&t=12819&p=87281#p87281 Please see this discussion]''' (for MacOS, but should work on any other OS).
  
In order to change the application directory, user must edit the location of the "write-data" entry in the file <code>__Game_Install_directory/config/config.ini</code>. This affects the location of mods, scenario and temp.
+
In order to change the user data directory, user must edit the location of the "write-data" entry in the file <code>__Game_Install_directory/config/config.ini</code>. This affects the location of mods, scenario and temp.
  
 
If you want to move only the location of your save files you can '''[[Application_Directory/Changing_the_save_directory|change the the save directory using symlinks]]''' but this still means that all users of the computer will share the same data, including settings.
 
If you want to move only the location of your save files you can '''[[Application_Directory/Changing_the_save_directory|change the the save directory using symlinks]]''' but this still means that all users of the computer will share the same data, including settings.

Revision as of 19:09, 10 October 2016


Overview

Depending on your installation method and OS, you will have one or two directories that contain Factorio assets.

User Data directory

The user data directory is where personal files are stored, such as world saves. Search your computer for this directory, or type it into your file manager address bar.

Windows

%appdata%\Factorio

Mac OSX

~/Library/Application Support/factorio

Linux

~/.factorio

Zip File

The unzipped Factorio directory

A list of all things found here:

  • Save games (as zip files)
  • User-installed/created Mods.
  • User-installed/created scenarios.
  • User configuration and settings storage
  • Log File (factorio-*.log)
  • Player data (player-data.json)

Note: Deleting the configuration file will result in a default replacement being generated upon the next Factorio launch.

It is recommended to create backups from this directory (of saves, config, etc) before installing a new version, or installing mods.

Application directory

The application directory stores three things:

  • Factorio executables (./bin)
  • Data for vanilla Factorio (./data)
  • API documentation

Windows

C:\Program Files (x86)\Steam\steamapps\common\Factorio
C:\Program Files\Factorio

Mac OSX

~/Library/Application Support/Steam/steamapps/common/Factorio/factorio.app/Contents/
~/Library/Application Support/factorio

Linux

~/.factorio

Zip File

The unzipped Factorio directory

Changing the user data directory

You can create a file config-path.config to configure Factorio to any directory.

Please see this discussion (for MacOS, but should work on any other OS).

In order to change the user data directory, user must edit the location of the "write-data" entry in the file __Game_Install_directory/config/config.ini. This affects the location of mods, scenario and temp.

If you want to move only the location of your save files you can change the the save directory using symlinks but this still means that all users of the computer will share the same data, including settings.

Linux

Update __Game_Install_directory/config-path.cfg

use-system-read-write-data-directories=true

Update __Game_Install_directory/config/config.ini

[path]
read-data=__PATH__executable__/../../data
write-data=.local/share/factorio

You could set the write-data value to .factorio if you prefer.

Once you have done this, you can remove write permissions to the entire game installation directory except for config/config.ini, which must be writable by all people who wish to play the game.

Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.

See also