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

Difference between revisions of "Application directory"

From Official Factorio Wiki
Jump to: navigation, search
m (typo)
m (whitespace)
 
(48 intermediate revisions by 17 users not shown)
Line 1: Line 1:
The application directory stores
+
{{Languages}}
* the saves (every save is a zip-file)
+
== Overview ==
* the [[Mods]]
+
Depending on your installation method and OS, you will have one or two directories that contain Factorio assets, and one that contains user data, such as saves and mods.
* scenarios
 
* configuration
 
* logs (since v0.10.0).
 
  
The directory structure is self-explaining.
+
== User data directory ==
 +
The user data directory is where personal files are stored:
 +
* Save files <code>./saves</code>
 +
* Mods <code>./mods</code>
 +
* Script-output, e.g. from /screenshot <code>./script-output</code>
 +
* Local [[scenario system|scenarios]] <code>./scenarios</code>
 +
* Local settings <code>./config/config.ini</code>
 +
* [[log file]]s <code>factorio-*.log</code>
 +
* Crash dump files <code>factorio-dump-*.dmp</code>
  
You can delete for example the configuration-file; it will be generated new with the defaults.
+
=== Locations ===
 +
Search your computer for the directory location, or type the path into your file manager address bar.
  
It is recommended to create backups from this directory, before you install a new version.
+
Windows:
  
 +
%appdata%\Factorio
  
== Installation by Zip-package ==
+
:The <code>%appdata%</code> shorthand translates to your local version of <code>C:\Users\[user name]\AppData\Roaming</code>
Zip package is just one Factorio directory that doesn't need to be installed, all the saves are there locally easy to find.
 
  
== Installation via Installer ==
+
MacOSX:
=== Windows ===
 
  
Installation package follows UAC. For that case the factorio directory is where you install it (Program files by default) and the user data (saves, player data etc) are stored in
+
~/Library/Application Support/factorio
C:\Users\<username>\AppData\Roaming\Factorio
+
 
Windows Vista and newer (UAC active):
+
Linux distributions:
  %appdata%\factorio
+
 
 +
  ~/.factorio
  
=== MacOSx ===
+
When using Steam on Windows, the config.ini, achievements.dat, modded-achievements.dat and player-data.json can also be found in
The application should be by default installed in the Apps-folder.
 
  
Whereas the data is stored under
+
  C:\Program Files (x86)\Steam\userdata\[user number]\427520\remote
  /users/<replace with your username>/Library/Application Support/factorio
 
  
Which is equivalent to
+
== Application directory ==
~/Library/Application Support/factorio
+
The application directory stores three things:
You can type in this into the finder (press SHIFT-COMMAND-G for goto folder) and put in exactly this line.
+
* Factorio executables <code>./bin</code>
 +
* Data for vanilla Factorio <code>./data</code>
 +
* API documentation <code>./doc-html</code>
 +
 
 +
=== Locations ===
 +
 
 +
Windows:
 +
 
 +
C:\Program Files (x86)\Steam\steamapps\common\Factorio
 +
C:\Program Files\Factorio
 +
 
 +
MacOSX:
  
'''If you still don't see this folder it might be invisible for you.''' Search in the internet for for example about ''"make library folder visible macos"''.
+
~/Library/Application Support/Steam/steamapps/common/Factorio/factorio.app/Contents
 +
/Applications/factorio.app/Contents
  
Example link: http://finerthings.in/featured/lion-library-folder-visible/
+
Linux:
  
=== Linux ===
 
Data is stored under
 
 
  ~/.factorio
 
  ~/.factorio
  
==Changing the save directory==
+
== Changing the user data directory ==
 +
 
 +
You can create a file <code>config-path.cfg</code> to configure Factorio to any directory.
 +
 
 +
'''[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 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.
 +
 
 +
====Linux====
 +
Update <code>__Game_Install_directory/config-path.cfg</code>
 +
 
 +
use-system-read-write-data-directories=true
 +
 
 +
Update <code>__Game_Install_directory/config/config.ini</code>
 +
 
 +
[path]
 +
read-data=__PATH__executable__/../../data
 +
write-data=.local/share/factorio
 +
 
 +
You could set the <code>write-data</code> value to '''<code>.factorio</code>''' if you prefer.
 +
 
 +
Once you have done this, you can remove write permissions to the entire game installation directory '''except''' for <code>config/config.ini</code>, 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.
 +
 
 +
== Installation from 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.
  
It is possible to change the save directory for Factorio. This can be done by editing the location of the "write-data" entry in the ''config-paths.cfg'' file, though this also affects the location of the other directories (mods, scenario, 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]].
+
== See also ==
 +
* [[Install guide]]
 +
* [[Installing Mods]]
 +
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]

Latest revision as of 16:25, 19 January 2021

Overview

Depending on your installation method and OS, you will have one or two directories that contain Factorio assets, and one that contains user data, such as saves and mods.

User data directory

The user data directory is where personal files are stored:

  • Save files ./saves
  • Mods ./mods
  • Script-output, e.g. from /screenshot ./script-output
  • Local scenarios ./scenarios
  • Local settings ./config/config.ini
  • log files factorio-*.log
  • Crash dump files factorio-dump-*.dmp

Locations

Search your computer for the directory location, or type the path into your file manager address bar.

Windows:

%appdata%\Factorio
The %appdata% shorthand translates to your local version of C:\Users\[user name]\AppData\Roaming

MacOSX:

~/Library/Application Support/factorio

Linux distributions:

~/.factorio

When using Steam on Windows, the config.ini, achievements.dat, modded-achievements.dat and player-data.json can also be found in

C:\Program Files (x86)\Steam\userdata\[user number]\427520\remote

Application directory

The application directory stores three things:

  • Factorio executables ./bin
  • Data for vanilla Factorio ./data
  • API documentation ./doc-html

Locations

Windows:

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

MacOSX:

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

Linux:

~/.factorio

Changing the user data directory

You can create a file config-path.cfg 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.

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.

Installation from 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.

See also