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

Difference between revisions of "Half-Life 2"

From AppleGamingWiki, the wiki about gaming on M1 Apple silicon Macs
(Cleaned up Wiki article, removed dead links)
Line 1: Line 1:
 
{{Compatibility/macOS
 
{{Compatibility/macOS
 
|native              = Perfect
 
|native              = Perfect
|native notes        = Compiled the Source Engine Leak. https://jameshug.notion.site/Guide-to-Installing-Portal-Using-Source-Engine-on-macOS-660803f9ced149cfa1647d38fd5a7092<ref>{{Refdevice
+
|native notes        = Compiled the Source Engine Leak. https://github.com/nillerusr/source-engine<ref>{{Refdevice
 
|user=PBeGood4
 
|user=PBeGood4
 
|date=29 April 2023
 
|date=29 April 2023
Line 27: Line 27:
  
 
==Native ARM build from leaked source==
 
==Native ARM build from leaked source==
These instructions are heavily based on guides written by [https://www.youtube.com/watch?v=mMuSXs0SF_g James Hug]. This method can be used to build native ARM macOS ports of Half-Life, Half-Life 2, Half-Life 2: Episode 1 & 2, Portal, Counter-Strike: Source etc. as long as the necessary game files from Steam have been copied into the correct folder.
+
These instructions are based on guides written by [https://www.youtube.com/watch?v=mMuSXs0SF_g James Hug]. This method builds a native port for older Source engine games, such as Half-Life 2, its episodes, and Portal. '''TF2 AND LATER SOURCE GAMES WON'T WORK!!'''
  
Enter these commands into a Terminal window:
+
Enter these commands into Terminal, Homebrew and Xcode Command Line Tools are required:
  
1. Install Homebrew
+
1. Install prerequisites from Homebrew and clone Repository (added the jpeg-turbo dependency from instructions):
 
<pre>
 
<pre>
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
brew install sdl2 freetype2 fontconfig pkg-config opus libpng libedit python3 jpeg jpeg-turbo && brew cleanup && git clone --recursive https://github.com/nillerusr/source-engine && cd source-engine
 
</pre>
 
</pre>
  
On Apple Silicon Macs: remember to set the path, modify this command with your username:
+
2. Set pkg path:
<pre>
 
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/$(whoami)/.zprofile
 
eval "$(/opt/homebrew/bin/brew shellenv)"
 
</pre>
 
 
 
2. If Xcode Command Line Tools does not install, then install it manually:
 
<pre>
 
xcode-select --install
 
</pre>
 
 
 
3. Install required packages from Homebrew (added the jpeg-turbo dependency from instructions)
 
<pre>
 
brew doctor
 
brew cleanup
 
brew install sdl2 freetype2 fontconfig pkg-config opus libpng libedit python3 jpeg jpeg-turbo
 
</pre>
 
 
 
4. Clone the Source Engine GitHub repository
 
<pre>
 
git clone --recursive https://github.com/nillerusr/source-engine
 
cd source-engine
 
</pre>
 
 
 
5. ('''this is step was not needed when building HL2 on 1st July 2023''') The location of <code>StubSteamAPI</code> was recently moved on 23rd May 2023, so this has to be put into the correct place for the build scripts to work:
 
#Rename <code>/stub_steam/</code> to <code>/StubSteamAPI/</code>
 
#Move <code>/StubSteamAPI/</code> into the <code>/thirdparty/</code> folder.
 
 
 
6. Set pkg path:
 
 
<pre>
 
<pre>
 
export PKG_CONFIG_PATH="/opt/homebrew/opt/jpeg/lib/pkgconfig"
 
export PKG_CONFIG_PATH="/opt/homebrew/opt/jpeg/lib/pkgconfig"
 
</pre>
 
</pre>
  
7. Configure game builds:
+
3. Configure, build and install the game into your Documents Folder:
*'''Half-Life 2''':
 
**<code>python3 waf configure -T release --64bits --prefix='' --build-games=hl2</code>
 
*'''Half-Life 2 Episodes''':
 
**<code>python3 waf configure -T release --64bits --prefix='' --build-games=episodic</code>
 
*'''Portal''':
 
**<code>python3 waf configure -T release --64bits --prefix='' --build-games=portal</code>
 
*'''Counter-Strike: Source''':
 
**<code>python3 waf configure -T release --64bits --prefix='' --build-games=cstrike</code>
 
  
8. Build the game:
+
<code>python3 waf configure -T release --64bits --prefix='' --build-games=[game folder] && python3 waf build && python3 waf install --destdir='~/Documents/Build/[game folder]'</code>
<pre>
 
python3 waf build
 
</pre>
 
  
9. Create '''Build folder''' Install build into directory, this can be located anywhere ideally append with <code>hl2</code>, <code>episodic</code>, <code>portal</code>, <code>cstrike</code> etc.
+
Valid Game Folder Names:
<pre>
+
*cstrike (Counter-Strike Source)
python3 waf install --destdir='~/Documents/Build folder/hl2'
+
*episodic (Half-Life 2: Episode 1/2)
</pre>
+
*hl1 (Half-Life: Source)
 
+
*hl2 (Half-Life 2),  
10. Open '''Build folder''' in new Finder window.
+
*portal
 
+
*dod (Day of Defeat: Source)
11. Open Mac version of Steam and install games e.g Half-Life 2, Episode 1, Episode 2, Portal, Counter-Strike: Source etc. these game files I will refer to as the '''Steam folder'''.
+
*hl2mp (Half-Life 2: Deathmatch)
 
 
12. Open '''Steam folder''' in Finder: right-click on game in Steam library, go to Manage and Browse local files. Alternatively navigate to <code>~/Library/Application Support/Steam/steamapps/common/</code>
 
 
 
13. In the '''Steam folder''':
 
*Delete <code>Steam folder/bin/</code> folder.
 
*Copy/move <code>Build folder/bin/</code> folder into <code>Steam folder/</code> replacing the previous <code>Steam folder/bin/</code> folder.
 
 
 
14. In the '''Steam folder''':  
 
*Delete <code>hl2_osx</code>
 
*Copy/move from '''Build folder''' <code>Build folder/hl2_launcher</code>
 
*Rename the <code>hl2_launcher</code> into <code>hl2_osx</code>
 
  
15. In the '''Steam folder''':
+
4. Open your Half-Life 2 Folder, and your game's subfolder. (Portal and/or Day of Defeat Source, if you're installing those games), Right-Click > "Browse local files". '''DO NOT MESS WITH THE HL2 FOLDER UNLESS YOU'RE ACTUALLY INSTALLING HL2'''!)
*Navigate inside 'game' folder (e.g. <code>/hl2/</code> or <code>/episodic/</code> or <code>/portal/</code> or <code>/cstrike/</code>)
 
*Delete the bin subfolder (e.g. <code>Steam folder/hl2/bin/</code>)
 
*From the '''Build folder''' go to game folder (e.g. <code>Build folder/hl2/</code>) and move/copy from the '''Build folder''' to the '''Steam folder''' into the game (e.g. <code>Steam folder/hl2/</code>)
 
  
16. Now the respective game can be launched from within Steam.
+
5. Modify Installation Files:
 
+
*Delete the root and game folder <code>"bin"</code> directories and <code>"hl2_osx"</code> executable
17. Other parameters:
+
**Move your <code>"bin", "[game folder]/bin"</code> folders and <code>"hl2_launcher"</code> executable to your Half-Life 2 folder,
*cstrike (Counter-Strike: Source) - in addition tot he above instructions, also copy the <code>Steam folder/hl2/</code> and put it in the root of the <code>Steam folder</code> so that the game will launch.
+
**and rename <code>"hl2_launcher"</code> to <code>"hl2_osx"</code>
*tf (Team Fortress Classic)
+
Congratulations! You (hopefully) successfully built a working Native Source Port!
*dod (Day of Defeat)
 
*hl2mp (Half-Life 2: Deathmatch)
 
  
 
=== Suggested settings for the native version ===
 
=== Suggested settings for the native version ===
Line 124: Line 69:
  
 
This starts the game in the windowed borderless mode and limits FPS to 120.
 
This starts the game in the windowed borderless mode and limits FPS to 120.
Windowed borderless is needed to ignore the Macbook's notch (render the game under it). Otherwise the interface elements and aim are shifted incorrectly, potentially making the game less playable.
+
Windowed borderless is needed to ignore the Macbook's notch (render the game under it). Otherwise the interface elements and aim are shifted incorrectly, potentially making the game less playable. Optionally, if you have EP2 installed and want to launch EP1 or base HL2 (or any other Half-Life 2 folder game), you can launch it by appending <code>-game [game subfolder name]</code>. If you'd like to play EP2 again, simply remove the <code>-game</code> parameter. '''Make sure NOT to share game "bin" folders or they WILL crash upon loading!'''
  
 
2. '''Add settings to autoexec.cfg'''
 
2. '''Add settings to autoexec.cfg'''

Revision as of 20:28, 25 September 2023

macOS Compatibility

Method Rating Notes
Native Perfect Compiled the Source Engine Leak. https://github.com/nillerusr/source-engine[1]
Rosetta 2 Unknown
Compatibility layer
CrossOver Runs Installed via Steam on CrossOver 21, extreme fps drops during shootouts and explosions.
Wine Unknown
Virtualization
Parallels Perfect Playable.[2]

Native ARM build from leaked source

These instructions are based on guides written by James Hug. This method builds a native port for older Source engine games, such as Half-Life 2, its episodes, and Portal. TF2 AND LATER SOURCE GAMES WON'T WORK!!

Enter these commands into Terminal, Homebrew and Xcode Command Line Tools are required:

1. Install prerequisites from Homebrew and clone Repository (added the jpeg-turbo dependency from instructions):

brew install sdl2 freetype2 fontconfig pkg-config opus libpng libedit python3 jpeg jpeg-turbo && brew cleanup && git clone --recursive https://github.com/nillerusr/source-engine && cd source-engine

2. Set pkg path:

export PKG_CONFIG_PATH="/opt/homebrew/opt/jpeg/lib/pkgconfig"

3. Configure, build and install the game into your Documents Folder:

python3 waf configure -T release --64bits --prefix= --build-games=[game folder] && python3 waf build && python3 waf install --destdir='~/Documents/Build/[game folder]'

Valid Game Folder Names:

  • cstrike (Counter-Strike Source)
  • episodic (Half-Life 2: Episode 1/2)
  • hl1 (Half-Life: Source)
  • hl2 (Half-Life 2),
  • portal
  • dod (Day of Defeat: Source)
  • hl2mp (Half-Life 2: Deathmatch)

4. Open your Half-Life 2 Folder, and your game's subfolder. (Portal and/or Day of Defeat Source, if you're installing those games), Right-Click > "Browse local files". DO NOT MESS WITH THE HL2 FOLDER UNLESS YOU'RE ACTUALLY INSTALLING HL2!)

5. Modify Installation Files:

  • Delete the root and game folder "bin" directories and "hl2_osx" executable
    • Move your "bin", "[game folder]/bin" folders and "hl2_launcher" executable to your Half-Life 2 folder,
    • and rename "hl2_launcher" to "hl2_osx"

Congratulations! You (hopefully) successfully built a working Native Source Port!

Suggested settings for the native version

Tested on Macbook Pro 16 2021 16 GB

1. Add launch parameters (Steam): -noborder -windowed -refresh 120 -autoexec

This starts the game in the windowed borderless mode and limits FPS to 120. Windowed borderless is needed to ignore the Macbook's notch (render the game under it). Otherwise the interface elements and aim are shifted incorrectly, potentially making the game less playable. Optionally, if you have EP2 installed and want to launch EP1 or base HL2 (or any other Half-Life 2 folder game), you can launch it by appending -game [game subfolder name]. If you'd like to play EP2 again, simply remove the -game parameter. Make sure NOT to share game "bin" folders or they WILL crash upon loading!

2. Add settings to autoexec.cfg

In /Users/<username>/Library/Application Support/Steam/steamapps/common/Half-Life 2/hl2/cfg/autoexec.cfg, add this:

//set the video mode to your display resolution (i.e. 1728x1117 - Default, 2056x1329 - More Space). Uncomment only the resolution you are using.
mat_setvideomode 1728 1117 1
//mat_setvideomode 2056 1329 1
// Forces the engine to load audio asynchronously. Removes audio micro-stuttering in some cases.
snd_async_fullyasync 1
snd_async_minsize 0
snd_noextraupdate 1
// Improve texture quality
mat_picmip -1 
mat_antialias 4
mat_forceaniso 8
//BELOW: Enables software AA at maximum quality. Software AA works alongside normal AA, and helps to remove further
//aliasing, such as power lines. Little to no frame loss with this enabled.
mat_software_aa_quality 8
mat_software_aa_strength 2
mat_software_aa_strength_vgui 2
mat_software_aa_blur_one_pixel_lines 0.5
mat_software_aa_edge_threshold .8
// Enables small motion blur with forward movement, feel free to remove
mat_motion_blur_forward_enabled 1
// Key binding to manually to enable some of the settings
bind "/" "r_newflashlight 0; r_lod 0; r_maxdlights 128; r_shadowmaxrendered 1024; echo 'Graphics commands have been applied.'"

This will make sure that the game will run at max settings. FPS will still be 120 almost everywhere except the places in the game that were buggy on the other platforms as well.

r_newflashlight 0 - disables HL2 flashlight that is not working well (causes various artefacts when interacting with shadows). With this setting the game will use the still functional HL1 implementation of flashlight.

r_lod 0 - always fully load all nearby objects (buildings, cars, etc.). Looks better as the objects will not switch their appearance suddenly when you approach them. There is little to none performance penalty on Mac with its SSD.

r_maxdlights 128; r_shadowmaxrendered 1024; - could potentially improve the look of the game, feel free to remove if you see no difference.

Binding these r_* settings command to / key is necessary, because the game will reset these settings while in the Main Menu.

You need to tap / key when you already loaded the save game. The settings then will stay enabled for the whole session (even if re-loading the saves), until you exit the game


Known bugs

- When playing with Airpods, the audio starts stuttering randomly. Fix: Mute and unmute the audio on the Macbook.

References

  1. Verified by User:PBeGood4 on 29 April 2023
    Device: M1 MacBook Pro
    Method: Compiled Source Engine Leak
    Resolution: 1920x1080
    Settings: high
    Framerate: 120+ FPS
  2. Verified by User:gp on 7 Sep 2021
    Device: Mac M1 16 GB RAM
    OS: Windows 11 (latest Insider ISO)
    Method: Parallels 17
    Resolution: 1080p
    Settings: Medium
    Framerate: 50~60 FPS