Troubleshooting - Heroic-Games-Launcher/HeroicGamesLauncher GitHub Wiki

General Debugging tips:

First thing to know is that Heroic is just a GUI (Graphical Interface), unlike Lutris, it doesn't call wine/proton directly, it uses Legendary for it. So is good to have in mind that some issues that you might have with some game might not be related with Heroic or even with Legendary as well.

Config files

Those are stored under:

  • Linux: ~/.config/heroic (settings, caching, gog installed games and metadata, and logs) and ~/.config/legendary (epic installed games, metadata, user information, etc).
  • Linux/SteamOS (Flatpak): ~/.var/app/com.heroicgameslauncher.hgl/config/heroic/ and ~/.var/app/com.heroicgameslauncher.hgl/config/legendary/,
  • Windows: %AppData%\heroic (caching), %UserProfile%\.config\heroic and %UserProfile%\.config\legendary.
  • MacOSX: ~/Library/Application Support/heroic (caching), ~/.config/heroic and ~/.config/legendary.

The General settings for Heroic is the file called config.json. Caching is stored under the store folder. The Game settings and Game Logs (Installation and PlayLogs) are in the GameConfig folder.

Not Supported Games

Right now Heroic doesn't support games that require an external launcher like Origin or Uplay.

How to read output from game launch

Go to the GamePage clicking on the GameCard, and then click on the Tools tab on the top and then click on Latest Log. That will open a log file with everything that happened when you tried to launch the game. With that, you can start troubleshooting and use it to get help on our Discord Server or on any Linux Community.

Game Won't Launch

Several things can cause that and probably Heroic has little or nothing to do with it. But, one thing you can check is the Compatibility with the game on ProtonDB, even though there you will find more things related to the game on Steam and might not apply to the Epic Games version.

Another thing is to check the latest log like was said above.

Some games like Borderlands 2 and Borderlands: The Pre-Sequel, need that you install some things on the prefix first. Normally the needed files stay under a folder called redist or something similar under the game folder and have all the necessary exe or msi files. To install them, open the Game Settings and go to the Wine Tab. Then you can use the feature called Install EXE on prefix to install those files.

Sometimes, after a long time without using Heroic, your credentials might expire, we are working on showing a message about that and ask to login again, but for now, nothing is shown and when trying to launch the game, nothing will happen. So you will need to manually click logout and restart Heroic. Login again and then launch your game. All your games will be there, don't worry about them being uninstalled.

Wine not found error when launching

If you are using an old version of Heroic, prior to 2.3.0, you might encounter this error and it is simple to solve. Just go to the game settings, wine settings, then select a different wine version and then get back to the other one. In case you have only one version being shown, try downloading a new version from the Wine Manager. This is due to some changes that we did on how we handle settings from 2.3.0.

Game still shows as installed after uninstalling or uninstalled after installing

Most of the time, this can be fixed by Refreshing the Library (found under the User Submenu). If that doesn't fix it. Call for help in our Discord Server.

Game installed but on a different path and Heroic can't launch it

For that, you can use the helper on the GamePage that fixes the installed path. Go to the game page, click on the settings button and choose to change the installed path. If that doesn't work for some reason, you can fix it manually by changing the path on the .config/legendary/installed.json file.

Heroic doesn't open, never loads games after login or shows a Blank Window

Close the App or kill the process if necessary then:

  • Try removing/renaming the Heroic folder and the Legendary folder: ~/.config/legendary.

And Login again with a NEW SID. It is important that you generate a new SID because after using it the first time it becomes invalid.

image

Running Heroic from Terminal/Powershell to debug errors

  • Linux: Just open the terminal and type heroic if it's installed globally or launch the AppImage from it.
  • Windows: Open Powershell and Navigate into %USER%\AppData\Local\Programs\heroic. Run .\Heroic.exe
  • Mac: Open the terminal, navigate to /Applications/Heroic.app/Contents/MacOS and run ./Heroic

Debugging frontend Errors

By default, when launching Heroic from the terminal, you will be able to see all the backend messages, errors, warnings, etc. But not from the frontend. To enable the frontend logs to show up in the terminal, launch heroic with the --enable-logging flag. Like: heroic --enable-logging or ELECTRON_ENABLE_LOGGING=true heroic on Linux and MacOSX.

Interesting solved issues