In other languages: Deutsch 日本語 Polski Русский Türkçe 简体中文

Application directory: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
m (→‎Windows: - indentation revert from my last edit)
(Restructured page and added details on the user data and the application directories)
Line 1: Line 1:
{{Languages}}
{{Languages}}
= Overview =
Depending on your installation method and OS, you will have one or two directories that contain Factorio assets.
== Application directory ==
The application directory stores
The application directory stores
* the saves (every save is a zip-file)
* Factorio executables (./bin)
* the [[Mods]]
* Data for vanilla Factorio (./data)
* scenarios
* API documentation
* configuration
* [[Log File]] (since v0.10.0).


The directory structure is self-explaining.
== User Data directory ==
* Save games (as zip files within ./saves)
* User-installed/created [[Mods]] (./mods)
* User-installed/created [[scenarios]] (./scenarios)
* User configuration (./config)
* [[Log File]] (factorio-*.log)


You can delete for example the configuration-file; it will be generated new with the defaults.
You can delete for example the configuration-file; it will be generated new with the defaults.


It is recommended to create backups from this directory, before you install a new version.
It is recommended to create backups from this directory before installing a new version.


= Directory locations by OS and installation method =
== Windows ==
== Windows ==
=== Installation via Steam ===
=== Installation via Steam ===
Line 61: Line 68:
  ~/.factorio
  ~/.factorio


==Changing the application directory==
=Changing the application 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 72: Line 79:
=== The following discussion applies to version 0.11.13. ===
=== The following discussion applies to version 0.11.13. ===


It is possible to change the application directory location for Factorio.
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.
 
This can be done by editing 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.
Line 95: Line 100:
Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.
Note that if someone changes any options, in-game, those option changes will apply to everyone who plays on the same computer.


== See also ==
= See also =
 
* [[Download and Installation]]
* [[Download and Installation]]
* [[Install Guide]]
* [[Install Guide]]

Revision as of 07:44, 29 May 2016

Overview

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

Application directory

The application directory stores

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

User Data directory

  • Save games (as zip files within ./saves)
  • User-installed/created Mods (./mods)
  • User-installed/created scenarios (./scenarios)
  • User configuration (./config)
  • Log File (factorio-*.log)

You can delete for example the configuration-file; it will be generated new with the defaults.

It is recommended to create backups from this directory before installing a new version.

Directory locations by OS and installation method

Windows

Installation via Steam

Application directory:

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

User data directory:

%appdata%\factorio

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 Installer

Application directory:

C:\Users\<username>\AppData\Roaming\Factorio

User data directory:

%appdata%\factorio

MacOSx

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

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 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

__Game_Install_Directory__

Installation via Steam

Data is stored under

~/.factorio

Changing the application 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).

Windows: there is also the ZIP-Package, that can be installed in any directory.


The following discussion applies to version 0.11.13.

In order to change the application 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