Debugging Runner and Launcher
On this page, you will learn how to debug and report issues with the runner and the launcher. You might want to read Launchers Lifecycle first.
Getting the logs
Runner and launcher logs are usually the first thing you should be looking into. Here’s the list of where runner and launcher logs can be found.
Watch out, since both runner and launcher logs will get overwritten as soon as you start your game again. If you want to keep them (to send them to support@patchkit.net, for example), you have to make a copy before each run.
Runner
| Operating System | Location | Notes |
|---|---|---|
| Windows | launcher-log.txt | Next to launcher.exe |
| Windows | %APP_DATA%/Remote/patchkit-launcher/launcher-log.txt | >= 1.5.1 if WORKDIR is restricted |
| GNU/Linux | launcher-log.txt | Next to launcher binary |
| Mac OSX | ~/Library/Application Support/PatchKit/Apps/launcher-log.txt |
Unity-based single-launcher
| Operating System | Location |
|---|---|
| Windows | C:\Users\username\AppData\LocalLow\UpSoft\PatchKit Patcher\output_log.txt |
| GNU/Linux | ~/.config/unity3d/UpSoft/PatchKit Patcher/Player.log |
| Mac OSX | ~/Library/Logs/Unity/Player.log |
Note that if you’re using a custom launcher and you change Company Name and Product Name in it’s setting, the path may be different. For more information, please see Unity documentation.
Electron-based single-launcher
| Operating System | Location | |
|---|---|---|
| Windows | C:\Users\username\AppData\Roaming\patchkit-pathcer\secret\pk_logs\ | |
| GNU/Linux | $XDG_CONFIG_HOME/patchkit-patcher/secret/pk_logs/ | If $XDG_CONFIG_HOME is set |
| GNU/Linux | ~/.config/patchkit-patcher/secret/pk_logs/ | |
| Mac OSX | ~/Library/Application Support/patchkit-patcher/secret/pk_logs/ |
Electron-based multi-launcher
| Operating System | Location | Notes |
|---|---|---|
| Windows | C:\Users\username\AppData\Roaming\launcher-name\pk_logs\ | |
| GNU/Linux | $XDG_CONFIG_HOME/launcher-name/pk_logs/ | If $XDG_CONFIG_HOME is set |
| GNU/Linux | ~/.config/launcher-name/pk_logs/ | |
| Mac OSX | ~/Library/Application Support/launcher-name/pk_logs/ |
Command line arguments (unity-based only)
The launcher (formerly patcher) should be run with the following command-line arguments:
"
patcher.exe --installdir "dir" --secret "secret" --readable
”
You can try and launch it with your custom installdir and secret. Remember always to pass --readable, because otherwise, the patcher will expect an encoded secret instead of a string.
Environment variables
Launcher behavior can be overridden by setting up those environment variables.
| Variable Name | Description |
|---|---|
| PK_PATCHER_FORCE_SECRET | Set it to application secret to forcefully change what game should be downloaded. |
| PK_PATCHER_FORCE_VERSION | Change the latest game version to the given one. This is internal version id starting from 1. |