====== Heroic Games Launcher (Epic Games store) ======

<WRAP center round important>
The Heroic flatpak is not officially integrated. This wiki page's instructions may not work for all situations and Batocera cannot provide support help for it, use at your own discretion.
</WRAP>

[[https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher|Heroic Games Launcher]] is an open-source launcher available on [[systems:flatpak|Flathub]] which supports launching games from the Epic Games Store using [[https://github.com/derrod/legendary|Legendary]] and GOG Games. Unfortunately this launcher is not as fully integrated into Batocera as other flatpaks are so some manual work is required.

===== Install ======

<WRAP center round important>
If you already have the Heroic Launcher Flatpak package installed, it will conflict. [[systems:flatpak#uninstalling_flatpaks|Uninstall it first.]]
</WRAP>

Search for "Heroic Games Launcher" in the "flatpak config" tool available in the application tools from "F1" file manager, and install it from there.

{{:systems:heroic_15.png?nolink&400|}}

Or you can install it from the command line in XTerm or a SSH session:

<code>
flatpak install com.heroicgameslauncher.hgl
batocera-flatpak-update
</code>

Then, once installed edit a file ''/userdata/roms/flatpak/Heroic.sh'' (as explained [[systems:flatpak#my_flatpaks_including_steam_won_t_launch|on this page]] with the following content:
<code>
#!/bin/sh
flatpak run com.heroicgameslauncher.hgl --no-sandbox
</code>

Once you reload the game lists from EmulationStation (**Game Settings** --> **Update Gamelists**) you will find a newly created ''Heroic'' launcer in the Ports section of EmulationStation. This is the one you need to launch, **not** the "Heroic Games Launcher" one with the sword icon, unfortunately, this one cannot be launched on Batocera, at the time of writing.

===== Launch Heroic Games Launcher =====

===== Login =====

Heroic Games Launcher will offer two services to login to. Log in to the appropriate one (or select **Manage Accounts**):

{{:systems:heroic_01.png?540|}}

<WRAP center round tip>
As alternative for Epic Store login, the External Login is available, this way you have to inform your Epic Store Account [[https://www.epicgames.com/help/en-US/epic-accounts-c74/general-support-c79/what-is-an-epic-account-id-and-where-can-i-find-it-a3659|SID]] to log in properly.
</WRAP>

<WRAP center round help>
If the log in fails, press the reload symbol at the top of the launcher window to try again.

{{:systems:heroic_13.png?540|}}
</WRAP>

Your games will appear in the **Library** split between **Epic Games** and **GOG**. It could take a while to download all games' information and boxart.

{{:systems:heroic_04.png?540|}}

===== Download Game =====

  - Go to **Library**
  - Select the game
  - Select **Install**

{{:systems:heroic_04.png?540|}} {{:systems:heroic_05.png?540|}} {{:systems:heroic_06.png?540|}} {{:systems:heroic_07.png?540|}} {{:systems:heroic_08.png?540|}}

<WRAP center round tip>
[[#wine_install_for_windows_games|Windows games will need to have their intended version of WINE selected.]]

{{:systems:heroic_12.png?460|}} {{:systems:heroic_14.png?380|}}
</WRAP>

===== Install Wine (for Windows games) =====

  - Select **Wine Manager**
  - Select the desired version of Wine to be downloaded. In order of recommendation: "Wine-GE", "Wine-Lutris" and "Proton-GE", the rest are older versions (some games do not work with the latest versions)

{{:systems:heroic_03.png?540|}}

==== Global Wine setting ====

  - Go to **Settings** -> **Wine** -> **Wine Version** and select the desired version of Wine.

{{:systems:heroic_10.png?540|}}

==== Per game Wine setting ====

  - Go to **Library**
  - Select the downloaded Windows game
  - Go to **Settings**
  - Select the desired version of Wine to use for that game.

{{:systems:heroic_08.png?540|}}
{{:systems:heroic_09.png?540|}}

===== Launch game =====

  - Go to **Library**
  - Select a [[#download_game|downloaded]] game
  - Select **PLAY NOW** ([[#wine_install_for_windows_games|Windows games require Wine to be set up first]])
    * Heroic Games Launcher will say "Opening the Game..." and then eventually "Playing (STOP)" <WRAP center round important>
Games may take a while to initially launch as they need to compile shaders for your hardware.
</WRAP>
  - If playing a Windows game, confirm the Wine installation dialogue box.
  - Game start!

{{:systems:heroic_08.png?540|}} {{:systems:heroic_11.png?500|}}

<WRAP center round info>
Right now, Batocera isn't integrated to Heroic Games Launcher; its games will not be automatically added and launchable with EmulationStation like Steam does. This may change in the future.
</WRAP>

==== Uninstall a game ====

  - Go to **Library**
  - Select an installed game
  - Select **Tools** at the top of the window
  - Select **Uninstall**

==== Other option ====

Other options can be found in **Settings** -> **Other**.

{{:systems:heroic_17.png?400|}}