Anonymous edits have been disabled on the wiki. If you want to contribute please login or create an account.

Difference between revisions of "Game-Porting-Toolkit-With-Heroic-Games-Launcher"

From AppleGamingWiki, the wiki about gaming on M1 Apple silicon Macs
(Updated page for better format and clarity. Made this late at night while tired, probably made some errors.)
 
Line 1: Line 1:
 
== Guide: Using the Game Porting Toolkit with the 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'''.
 
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:
+
 
 +
 
 +
==== Requirements ====
 +
* Either of the following installed:
 +
 
 
** The Homebrew-command-line-based Game Porting toolkit from apple: https://www.applegamingwiki.com/wiki/Game_Porting_Toolkit
 
** 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
 
** 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.
+
* Have the native macOS Heroic Games Launcher installed from https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases (or from Homebrew)
* 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.
+
First, open Heroic and log into your Epic Games and/or GoG account.
* Right-click on the version of Wine you just installed and press "Show Package Contents"
+
 
* Open this directory in the Terminal
+
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.
** 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"
+
* At the time of writing this, the newest numbered version of Wine-Crossover is "Wine-Crossover-Wine-22.1.0"
* "cd Contents/MacOS"
+
 
* Remove the existing Wine: "rm wine"
+
Press the folder icon that appears after installing it to open the directory containing Heroic's Wine installations.
* 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"
+
Right-click on the version of Wine you just installed and press "Show Package Contents"
** Whisky: "ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine"
+
 
* "cd ../Resources"
+
Hold option then right click the folder and select "Copy as pathname".
* Remove the existing Wine: "rm -rfv wine"
+
 
* Create a symlink to Game Porting Toolkit's Wine
+
{{Image|WinePath.png|Copying Wine as pathname}}
** 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"
+
Then, open the terminal and then cd to the path you just copied.
* We are now done with 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
+
The command should look something like this, with your path at the end:
* 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
+
<pre>cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0</pre>
* 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!
+
Now, navigate to the MacOS folder inside of Wine with this command:
 +
 
 +
<pre>cd Contents/MacOS</pre>
 +
 
 +
Remove the existing Wine in the current directory:
 +
 
 +
<pre>rm wine</pre>
 +
 
 +
 
 +
Now create a symlink to Game Porting Toolkit's Wine:
 +
 
 +
*Using the CLI Game Porting Toolkit:  
 +
<pre>ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine</pre>
 +
 
 +
*Using Whisky:  
 +
<pre>ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine</pre>
 +
 
 +
Navigate to the resources folder:
 +
 
 +
<pre>cd ../Resources</pre>
 +
 
 +
Remove the existing Wine in the current directory:
 +
 
 +
<pre>rm -rfv wine</pre>
 +
 
 +
Now create another symlink to Game Porting Toolkit's Wine:
 +
 
 +
*Using the CLI Game Porting Toolkit:  
 +
<pre>ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine</pre>
 +
 
 +
*Using Whisky:  
 +
<pre>ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine wine</pre>
 +
 
 +
We are now done in the terminal. You can now install any games you want to try playing.
 +
 
 +
 
 +
==== Configuring Games ====
 +
 
 +
Select the game you want to play, and press the settings button in the top-right of Heroic.
 +
 
 +
Make sure the version of Wine you just downloaded and modified in the terminal is selected.
 +
 
 +
Make sure your Game Porting Toolkit Wine Prefix is selected. If you followed Apple's guide this should be "/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.

Latest revision as of 06:46, 8 June 2023

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.


Requirements

  • Either of the following installed:


First, 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"

Hold option then right click the folder and select "Copy as pathname".

Copying Wine as pathname
Copying Wine as pathname

Then, open the terminal and then cd to the path you just copied.

The command should look something like this, with your path at the end:

cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0

Now, navigate to the MacOS folder inside of Wine with this command:

cd Contents/MacOS

Remove the existing Wine in the current directory:

rm wine


Now create a symlink to Game Porting Toolkit's Wine:

  • Using the CLI Game Porting Toolkit:
ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine
  • Using Whisky:
ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine

Navigate to the resources folder:

cd ../Resources

Remove the existing Wine in the current directory:

rm -rfv wine

Now create another symlink to Game Porting Toolkit's Wine:

  • Using the CLI Game Porting Toolkit:
ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine
  • Using Whisky:
ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine wine

We are now done in the terminal. You can now install any games you want to try playing.


Configuring Games

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

Make sure the version of Wine you just downloaded and modified in the terminal is selected.

Make sure your Game Porting Toolkit Wine Prefix is selected. If you followed Apple's guide this should be "/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.