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
(Created page with "== 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 t...")
 
(Updated page for better format and clarity. Made this late at night while tired, probably made some errors.)
 
(4 intermediate revisions by 2 users 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
  
** Whiskey: https://github.com/IsaacMarovitz/Whisky/releases
+
** Whisky: https://github.com/IsaacMarovitz/Whisky/releases
 +
 
 +
* 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:
 +
 
 +
<pre>cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0</pre>
  
* Install the native macOS Heroic Games Launcher from https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases (or from Homebrew)
+
Now, navigate to the MacOS folder inside of Wine with this command:
  
* Open Heroic, and log into your Epic Games and/or GoG account.
+
<pre>cd Contents/MacOS</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.
+
Remove the existing Wine in the current directory:
  
** At the time of writing this, the newest numbered version of Wine-Crossover is "Wine-Crossover-Wine-22.1.0"
+
<pre>rm wine</pre>
  
* 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"
+
Now create a symlink to Game Porting Toolkit's Wine:
  
* Open this directory in the Terminal
+
*Using the CLI Game Porting Toolkit:
 +
<pre>ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine</pre>
  
** If you have "OpenInTerminal" this is one button, otherwise press "Show Path Bar" and navigate where it says with "cd"
+
*Using Whisky:
 +
<pre>ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine</pre>
  
** It should be something like "cd ~/Library/Application Support/heroic/tools/wine/Wine-crossover-wine-22.1.0"
+
Navigate to the resources folder:
  
* "cd Contents/MacOS"
+
<pre>cd ../Resources</pre>
  
* Remove the existing Wine: "rm wine"
+
Remove the existing Wine in the current directory:
  
* Create a symlink to Game Porting Toolkit's Wine:
+
<pre>rm -rfv wine</pre>
  
** CLI Game Porting Toolkit: "ln -s `/usr/local/bin/brew --prefix game-porting-toolkit`/bin/wine64 wine"
+
Now create another symlink to Game Porting Toolkit's Wine:
  
** Whiskey: "ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine/bin/wine64 wine"
+
*Using the CLI Game Porting Toolkit:  
 +
<pre>ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine</pre>
  
* "cd ../Resources"
+
*Using Whisky:
 +
<pre>ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine wine</pre>
  
* Remove the existing Wine: "rm -rfv wine"
+
We are now done in the terminal. You can now install any games you want to try playing.
  
* Create a symlink to Game Porting Toolkit's Wine
 
  
** CLI Game Porting Toolkit: "ln -s `/usr/local/bin/brew --prefix game-porting-toolkit` wine"
+
==== Configuring Games ====
  
** Whiskey: "ln -s /Applications/Whisky.app/Contents/Resources/Libraries/Wine wine"
+
Select the game you want to play, and press the settings button in the top-right of Heroic.
  
* We are now done in the terminal. Install any games you want to try playing.
+
Make sure the version of Wine you just downloaded and modified in the terminal is selected.
  
* Select the game you want to play, and press the settings button in the top-right
+
Make sure your Game Porting Toolkit Wine Prefix is selected. If you followed Apple's guide this should be "/Users/you/my-game-prefix"
  
* Make sure the version of Wine you just downloaded and modified is selected
+
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.