Installation

Client

Type version command into the game console. You should see output similar to this:

Protocol version 48
Exe version 1.1.2.2/Stdio (valve)
Exe build: 19:53:27 Aug  3 2020 (8684)

On the third line you can see the build number (8684 in this case).

Only versions 4554 and 8xxx and newer are supported.

If you see a different number (e.g. 3245, as in NGHL client) it is not supported.

You have two options:

release builds - these are stable or beta versions which are intended to be used by end-user. Download BugfixedHL-X.X.X-client.zip
development builds - these are built automatically and contain all latest changes. They may be buggy and untested or may not work at all.

You need to log into GitHub to download them.

Follow the link above and select the newest commit. Scroll down and download file BugfixedHL-CI-xxxxxx.zip in the Artifacts panel. Open BugfixedHL-X.X.X-dev-client-[your platform]-....zip.

Make sure to back up any custom changes you made to the game (HUDs, sprites, models, etc) as they may be replaced by the mod.

If you have custom game menu, make a backup of resources/GameMenu.res as it will be replaced to add "Advanced options" menu item.

Open game installation directory (where hl.exe and valve are).
Make sure you've made all backups. Extract valve_addon to that directory, next to valve.
```
Half-Life
├── valve
├── valve_addon
├── valve_hd
├── hl.exe
├── hl_linux
├── ...
```
Replace any conflicting files (you've made backups, right?)
Start the game, go to the video options menu and enable "Allow custom addon content".
Restart the game. You can use about command to check if BHL was installed.

Open game installation directory (where hl.exe is).
Make sure you've made all backups. Extract contents of valve_addon into valve directory. Replace any conflicting files.
Start the game. You can use about command to check if BHL was installed.

Download the ZIP archive.

Follow the download instructions for client but download server archive.
Extract contents of valve_addon directory into valve.
Check that the server starts and aghl.ru convar is present and contains version of BHL.

If you get a CXXABI_1.3.8 error, you should try to delete libstdc++.so.6 from the server root. That will make the server use libstdc++.so.6 from the system, so make sure you have 32-bit libraries installed.

For Ubuntu/Debian:
```
dpkg --add-architecture i386
apt update
apt install libc6:i386 libstdc++6:i386
```
Configure the server. You can find list of convars in the wiki.