View source for Game-Porting-Toolkit-With-Heroic-Games-Launcher

== Guide: Using the Game Porting Toolkit with the Heroic Games Launcher ==

This is particularly useful because '''as it currently stands, the real Epic Games Launcher fails to install under the Game Porting Toolkit'''.

* Install either of the following:

** The Homebrew-command-line-based Game Porting toolkit from apple: https://www.applegamingwiki.com/wiki/Game_Porting_Toolkit

** Whisky: https://github.com/IsaacMarovitz/Whisky/releases

* Install the native macOS Heroic Games Launcher from https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases (or from Homebrew)

* Open Heroic, and log into your Epic Games and/or GoG account.

* Go to the "Wine Manager" and install a '''numbered''' version of Wine, such that it won't auto update- we are going to modify it.

** At the time of writing this, the newest numbered version of Wine-Crossover is "Wine-Crossover-Wine-22.1.0"

* Press the folder icon that appears after installing it to open the directory containing Heroic's Wine installations.

* Right-click on the version of Wine you just installed and press "Show Package Contents"

* Open this directory in the Terminal

** If you have "OpenInTerminal" this is one button, otherwise press "Show Path Bar" and navigate where it says with "cd"

** It should be something like "cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0"

* "cd Contents/MacOS"

* Remove the existing Wine: "rm wine"

* Create a symlink to Game Porting Toolkit's Wine: 

** CLI Game Porting Toolkit: "ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine"

** Whisky: "ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine"

* "cd ../Resources"

* Remove the existing Wine: "rm -rfv wine"

* Create a symlink to Game Porting Toolkit's Wine

** CLI Game Porting Toolkit: "ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine"

** Whisky: "ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine wine"

* We are now done in the terminal. Install any games you want to try playing.

* Select the game you want to play, and press the settings button in the top-right

* Make sure the version of Wine you just downloaded and modified is selected

* Make sure your Game Porting Toolkit Wine Prefix is selected. If you followed Apple's guide this is /Users/you/my-game-prefix

* If you Open the "Other" section you can also add any environment variables you want like "WINEESYNC=1" and "MTL_HUD_ENABLED=1"

* Close the settings and try running the game!