Log file: Difference between revisions
(Update info, explain the factorio init process in a bit more depth) |
No edit summary |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 2: | Line 2: | ||
Log files store details about the run of Factorio and contain information that help when solving bugs. Log files are created from version 0.10.0 onwards. | Log files store details about the run of Factorio and contain information that help when solving bugs. Log files are created from version 0.10.0 onwards. | ||
== Log | == Log file location == | ||
Factorio keeps log files in the [[ | Factorio keeps log files in the [[user data directory]], next to the saves and mods directories. It is a .log file that can be opened with any text editor. | ||
The file you need most of the time is '''factorio-current.log'''. | The file you need most of the time is '''factorio-current.log'''. | ||
| Line 24: | Line 24: | ||
After initializing mods, it will checksum them (used for the mod portal, to detect new versions) and start loading sprites, creating atlas bitmaps. At some point, it will print <code>Sprites loaded</code> and start compressing the atlas depending on graphics settings. It will then load the sound engine, check custom inputs, and then finish. | After initializing mods, it will checksum them (used for the mod portal, to detect new versions) and start loading sprites, creating atlas bitmaps. At some point, it will print <code>Sprites loaded</code> and start compressing the atlas depending on graphics settings. It will then load the sound engine, check custom inputs, and then finish. | ||
As soon as the user loads a map, it will state so, and specify the process of loading the map, loading from a few .dat files. The user is now free to play. | As soon as the user loads a map, it will state so, and specify the process of loading the map, loading from a few .dat files. The user is now free to play. | ||
== Bug Reporting == | == Bug Reporting == | ||
Latest revision as of 08:05, 2 May 2019
Log files store details about the run of Factorio and contain information that help when solving bugs. Log files are created from version 0.10.0 onwards.
Log file location
Factorio keeps log files in the user data directory, next to the saves and mods directories. It is a .log file that can be opened with any text editor.
The file you need most of the time is factorio-current.log. Backup copy of the log file from previous run is in factorio-previous.log.
File layout
The file is a long list of lines. The first column is the amount of seconds the game has been running. Typically, game starting will take anywhere from 10-60 secs.
The first line is a print about your build of the game. For the Steam version for Linux, this will be:
0.000 2017-04-24 21:39:48; Factorio 0.15.1 (build 29050, linux64, steam)
It will vary by version, OS, and origin of the game.
Next follows information about the install of the game itself, like the specific version of the OS, and arguments provided to the game launch. It will also print read/write data paths, which can give clues about where the game stores the files it creates, and it's install location.
It then prints off a bunch of information about graphics, hardware, and starts loading mods. The base game is loaded first, then all the mods the user has installed. It will print the order it loads mods in, this can be useful for debugging when a mod causes the game to fail to init. The log file also gives some insight to the interior code of Factorio, right after checking checksums it will load the PlayerData.cpp file, which compares the player-data.json to the cloud version (if running on steam) and checks for changes.
After initializing mods, it will checksum them (used for the mod portal, to detect new versions) and start loading sprites, creating atlas bitmaps. At some point, it will print Sprites loaded and start compressing the atlas depending on graphics settings. It will then load the sound engine, check custom inputs, and then finish.
As soon as the user loads a map, it will state so, and specify the process of loading the map, loading from a few .dat files. The user is now free to play.
Bug Reporting
Log files are important for finding crashes, especially ones related to automatic updates and graphic settings. Please attach the current log file to all crash reports.
How to post bug report on the forum
Log files are usually extremely helpful in bug reports, as it gives the devs some insight to any errors or notices the game produces as it fails. Including the whole log file is important, as it can be difficult to judge what parts of the log file are useful to Wube. Since the log file can be extremely large, posting the log to an external service like pastebin is a good idea. Simply link it when you make the bug report. You may also be asked to provide your world save.
Privacy
Log files (in 0.10.5 and later) contain the system date and time of your Factorio session, your updater login name and full paths for some files belonging to Factorio or mods. Before 0.10.5 the log also could contain your updater token (not a password) as a part of update request URLs. This has since been removed. Typically all of the information in a log file is not sensitive.