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

Application directory: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(%appdata% already points to roaming by default)
(25 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{Languages}}
{{Languages}}
The application directory stores
* the saves (every save is a zip-file)
* the [[Mods]]
* scenarios
* configuration
* [[Log File]] (since v0.10.0).


The directory structure is self-explaining.
== 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.


You can delete for example the configuration-file; it will be generated new with the defaults.
== User data directory ==
The user data directory is where personal files are stored, such as world saves, mods, logs, or crash dump files. Search your computer for this directory, or type it into your file manager address bar.


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


== Windows ==
Windows:
=== Installation by Zip-package ===
Application directory is the same as the unpacked factorio directory.


For example, if you unpacked the zip to
  %appdata%\Factorio
  C:\Factorio
Then your saves can be found in
C:\Factorio\saves
and mods in
C:\Factorio\mods


=== Installation via Installer ===
MacOSX:
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
C:\Users\<username>\AppData\Roaming\Factorio
Windows Vista and newer (UAC active):
%appdata%\factorio


== MacOSx ==
~/Library/Application Support/factorio
The application should be by default installed in the Apps-folder.
 
Linux distributions:
 
~/.factorio


Whereas the data is stored under
When using Steam on Windows, the config.ini, achievements.dat, modded-achievements.dat and player-data.json can be found in
/users/<replace with your username>/Library/Application Support/factorio


Which is equivalent to
C:\Program Files (x86)\Steam\userdata\[user number]\427520\remote
~/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.'
== Application directory ==
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 application directory stores three things:
* Factorio executables (./bin)
* Data for vanilla Factorio (./data)
* API documentation (./doc-html)
 
Locations:
 
Windows:


The factorio internal application-data can be found (when you have installed it) in
C:\Program Files (x86)\Steam\steamapps\common\Factorio
C:\Program Files\Factorio


/Applications/factorio.app/Contents/data
MacOSX:


Same directory structure as in Application support.
~/Library/Application Support/Steam/steamapps/common/Factorio/factorio.app/Contents
/Applications/factorio.app/Contents


== Linux ==
Linux:
Data is stored under
__Game_Install_Directory__


==Changing the application directory==
~/.factorio


The following discussion applies to version 0.11.13.
== Changing the user data directory ==


It is possible to change the application directory location for Factorio.
You can create a file <code>config-path.config</code> to configure Factorio to any directory.


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.
'''[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).


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


===Linux===
====Linux====
Update <code>__Game_Install_directory/config-path.cfg</code>  
Update <code>__Game_Install_directory/config-path.cfg</code>  


Line 77: Line 71:


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.
== 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 ==
== See also ==
* [[Download and Installation]]
* [[Download and Installation]]
* [[Install Guide]]
* [[Install guide]]
* [[Mods]]
* [[Mods]]
* [[Installing Mods]]
* [[Installing Mods]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=3389 Forum discussion]
* [http://www.factorioforums.com/forum/viewtopic.php?f=34&t=3389 Forum discussion]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=8294 Linux Version - Save games in $HOME somewhere]

Revision as of 11:33, 13 September 2018


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, such as world saves, mods, logs, or crash dump files. Search your computer for this directory, or type it into your file manager address bar.

Locations

Windows:

%appdata%\Factorio

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

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