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
m
(Updated page for better format and clarity. Made this late at night while tired, probably made some errors.)
 
(One intermediate revision by one other user not shown)
Line 3: Line 3:
 
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
Line 9: Line 11:
 
** 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)
+
* Have the native macOS Heroic Games Launcher installed from https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases (or from Homebrew)
 +
 
 +
 
 +
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".
 +
 
 +
{{Image|WinePath.png|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:
  
* Open Heroic, and log into your Epic Games and/or GoG account.
+
<pre>cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0</pre>
  
* 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.
+
Now, navigate to the MacOS folder inside of Wine with this command:
  
** At the time of writing this, the newest numbered version of Wine-Crossover is "Wine-Crossover-Wine-22.1.0"
+
<pre>cd Contents/MacOS</pre>
  
* Press the folder icon that appears after installing it to open the directory containing Heroic's Wine installations.
+
Remove the existing Wine in the current directory:
  
* Right-click on the version of Wine you just installed and press "Show Package Contents"
+
<pre>rm wine</pre>
  
* 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"
+
Now create a symlink to Game Porting Toolkit's Wine:
  
** It should be something like "cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0"
+
*Using the CLI Game Porting Toolkit:
 +
<pre>ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine</pre>
  
* "cd Contents/MacOS"
+
*Using Whisky:
 +
<pre>ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine</pre>
  
* Remove the existing Wine: "rm wine"
+
Navigate to the resources folder:
  
* Create a symlink to Game Porting Toolkit's Wine:
+
<pre>cd ../Resources</pre>
  
** CLI Game Porting Toolkit: "ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine"
+
Remove the existing Wine in the current directory:
  
** Whisky: "ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine"
+
<pre>rm -rfv wine</pre>
  
* "cd ../Resources"
+
Now create another symlink to Game Porting Toolkit's Wine:
  
* Remove the existing Wine: "rm -rfv wine"
+
*Using the CLI Game Porting Toolkit:  
 +
<pre>ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine</pre>
  
* Create a symlink to Game Porting Toolkit's Wine
+
*Using Whisky:
 +
<pre>ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine wine</pre>
  
** CLI Game Porting Toolkit: "ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine"
+
We are now done in the terminal. You can now install any games you want to try playing.
  
** 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.
+
==== Configuring Games ====
  
* Select the game you want to play, and press the settings button in the top-right
+
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 is selected
+
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 is /Users/you/my-game-prefix
+
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"
+
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!
+
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.