Go to file
Roman Chistokhodov a4acefb25c
Call DeathMsg for non-VGUI scoreboard (used to highlight the killer) (#456)
2024-06-09 09:53:57 +00:00
.github/workflows gha: use release configuration for linux builds. 2024-01-15 11:35:13 +05:00
android android: enable pollyhedral optimization by default. 2024-01-12 14:08:27 +05:00
cl_dll Call DeathMsg for non-VGUI scoreboard (used to highlight the killer) (#456) 2024-06-09 09:53:57 +00:00
cmake Remove linuxunkabi library suffix, as engine doesn't use it anymore 2024-02-10 04:06:59 +03:00
common Rename EFLAG_MONSTER to EFLAG_FLESH_SOUND (#449) 2024-04-14 09:12:07 +00:00
contrib/iZarif Port spectator changes from HLSDK 2.4. 2024-02-13 03:41:13 +05:00
dlls Fix compile.bat scripts to build with MSVC6 2024-05-21 18:55:44 +03:00
engine Fix synctype_t enumeration redefinition. 2023-03-12 01:55:34 +05:00
external/SDL2 Remove some SDL_config headers 2024-04-28 19:20:17 +00:00
game_shared game_shared: vcs_info: fix undefined branch name 2024-05-21 18:55:44 +03:00
pm_shared Disable jump sounds while player is frozen. 2024-02-19 02:23:26 +05:00
public Remove linuxunkabi library suffix, as engine doesn't use it anymore 2024-02-10 04:06:59 +03:00
scripts/waifulib Remove linuxunkabi library suffix, as engine doesn't use it anymore 2024-02-10 04:06:59 +03:00
utils Use definitions from build.h everywhere. 2023-11-01 01:25:07 +05:00
vgui_support@9910859822 Add vgui_support as submodule. 2022-06-18 06:36:40 +05:00
.gitignore android: merge .gitignore 2024-01-02 10:45:33 +02:00
.gitmodules Add vgui_support as submodule. 2022-06-18 06:36:40 +05:00
.travis.yml Fix addressing variables in travis 2018-04-04 17:31:26 +03:00
Android.mk Improve client 2016-03-01 20:18:42 +00:00
CMakeLists.txt Remove USE_SDL2. Always use SDL2 on Windows when available 2024-04-28 19:20:17 +00:00
LICENSE replace gnu.txt with LICENSE from ValveSoftware/halflife (#84) 2019-06-12 23:58:48 +03:00
README.md Update README.md. 2024-01-15 11:22:18 +05:00
appveyor.yml Update build instructions. Rename cmake project from HLSDK-XASH3D to HLSDK-PORTABLE (#274) 2022-07-18 13:13:44 +00:00
mod_options.txt HL 25th anniversary update satchel changes. (#429) 2024-01-28 09:15:15 +00:00
waf waf: upgrade to latest waifu release 2024-04-07 16:51:34 +00:00
waf.bat waf: upgrade to latest waifu master 2023-04-17 03:59:56 +03:00
wscript Query git and set XASH_BUILD_COMMIT and XASH_BUILD_BRANCH macros 2024-04-07 16:51:34 +00:00


Half-Life SDK for GoldSource and Xash3D Build Status Windows Build Status

Half-Life SDK for GoldSource & Xash3D with some bugfixes.


  • Fixed an occasional bug when houndeyes stuck unable to do anything. Technical detail: now monster's Activity is set before the call to SetYawSpeed. Patch
  • Monsters now play idle sounds as it's supposed by the code. Technical detail: the problem was a check for a wrong variable. Patch
  • Fixed a bug that caused talk monsters (scientists and security guards) to face a wrong direction during scripted sequence sometimes. Patch
  • Fixed squad member removal. This bug affected houndeye attacks as their attack depends on percieved number of squad members. Patch
  • Scientists now react to smells. Patch
  • Tau-cannon (gauss) plays idle animations.
  • Tau-cannon (gauss) beam color depends on the charge as it was before the prediction code was introduced in Half-Life. Patch
  • Brought back gluon flare in singleplayer. Patch
  • Hand grenades don't stay primed after holster, preventing detonation after weapon switch. Patch
  • Fixed flashlight battery appearing as depleted on restore.
  • Fixed a potential overflow when reading sentences.txt. Patch
  • Fixed beam attachment invalidated on restore (that led to visual bugs). Patch
  • Fixed alien controllers facing wrong direction in non-combat state. Patch
  • Fixed weapon deploy animations not playing sometimes on fast switching between weapons. Patch Patch2
  • Fixed tripmine sometimes having wrong body on pickup Patch

Bugfix-related macros that can be enabled during the compilation:

  • CROWBAR_DELAY_FIX fixes a bug when crowbar has a longer delay after the first hit.
  • CROWBAR_FIX_RAPID_CROWBAR fixes a "rapid crowbar" bug when hitting corpses of killed monsters.
  • GAUSS_OVERCHARGE_FIX fixes tau-cannon (gauss) charge sound not stopping after the overcharge.
  • CROWBAR_IDLE_ANIM makes crowbar play idle animations.
  • TRIPMINE_BEAM_DUPLICATION_FIX fixes tripmine's beam duplication on level transition.
  • HANDGRENADE_DEPLOY_FIX makes handgrenade play draw animation after finishing a throw.
  • WEAPONS_ANIMATION_TIMES_FIX fixes deploy and idle animation times of some weapons.

Bugfix-related server cvars:

  • satchelfix: if set to 1, doors won't get blocked by satchels. Fixes an infamous exploit on crossfire map.
  • explosionfix: if set to 1, explosion damage won't propagate through thin bruses.
  • selfgauss: if set to 0, players won't hurt themselves with secondary attack when shooting thick brushes.

Note: the macros and cvars were adjusted in hlfixed branch (for further information read this). The bugfix macros are kept turned off in master branch to maintain the compatibility with vanilla servers and clients.

Other server cvars:

  • mp_bhopcap: if set to 1, enable bunny-hop.
  • chargerfix: if set to 1, wall-mounted health and battery chargers will play reject sounds if player has the full health or armor.
  • corpsephysics: if set to 1, corpses of killed monsters will fly a bit from an impact. It's a cut feature from Half-Life.

Support for mods

This repository contains (re-)implementations of some mods as separate branches derived from master. The list of supported mods can be found here. Note that some branches are unstable and incomplete.

To get the mod branch locally run the following git command:

git fetch origin asheep:asheep

This is considering that you have set FWGS/hlsdk-portable as an origin remote and want to fetch asheep branch.

Obtaining source code

Either clone the repository via git or just download ZIP via Code button on github. The first option is more preferable as it also allows you to search through the repo history, switch between branches and clone the vgui submodule.

To clone the repository with git type in Git Bash (on Windows) or in terminal (on Unix-like operating systems):

git clone --recursive https://github.com/FWGS/hlsdk-portable

Build Instructions

Windows x86.


Install and run Visual Studio Installer. The installer allows you to choose specific components. Select Desktop development with C++. You can untick everything you don't need in Installation details, but you must keep MSVC and corresponding Windows SDK (e.g. Windows 10 SDK or Windows 11 SDK) ticked. You may also keep C++ CMake tools for Windows ticked as you'll need cmake. Alternatively you can install cmake from the cmake.org and during installation tick Add to the PATH....

Opening command prompt

If cmake was installed with Visual Studio Installer, you'll need to run Developer command prompt for VS via Windows Start menu. If cmake was installed with cmake installer, you can run the regular Windows cmd.

Inside the prompt navigate to the hlsdk directory, using cd command, e.g.

cd C:\Users\username\projects\hlsdk-portable

Note: if hlsdk-portable is unpacked on another disk, nagivate there first:

cd projects\hlsdk-portable


Сonfigure the project:

cmake -A Win32 -B build

Note that you must repeat the configuration step if you modify CMakeLists.txt files or want to reconfigure the project with different parameters.

The next step is to compile the libraries:

cmake --build build --config Release

hl.dll and client.dll will appear in the build/dlls/Release and build/cl_dll/Release directories.

If you have a mod and want to automatically install libraries to the mod directory, set GAMEDIR variable to the directory name and CMAKE_INSTALL_PREFIX to your Half-Life or Xash3D installation path:

cmake -A Win32 -B build -DGAMEDIR=mod -DCMAKE_INSTALL_PREFIX="C:\Program Files (x86)\Steam\steamapps\common\Half-Life"

Then call cmake with --target install parameter:

cmake --build build --config Release --target install

Choosing Visual Studio version

You can explicitly choose a Visual Studio version on the configuration step by specifying cmake generator:

cmake -G "Visual Studio 16 2019" -A Win32 -B build

Editing code in Visual Studio

After the configuration step, HLSDK-PORTABLE.sln should appear in the build directory. You can open this solution in Visual Studio and continue developing there.

Windows x86. Using Microsoft Visual Studio 6

Microsoft Visual Studio 6 is very old, but if you still have it installed, you can use it to build this hlsdk. There are no project files, but two .bat files, for server and client libraries. They require variable MSVCDir to be set to the installation path of Visual Studio:

set MSVCDir=C:\Program Files\Microsoft Visual Studio
cd dlls && compile.bat && cd ../cl_dll && compile.bat

hl.dll and client.dll will appear in dlls/ and cl_dll/ diretories. The libraries built with msvc6 should be compatible with Windows XP.

Linux x86. Portable steam-compatible build using Steam Runtime in chroot


The official way to build Steam compatible games for Linux is through steam-runtime.

Install schroot. On Ubuntu or Debian:

sudo apt install schroot

Clone https://github.com/ValveSoftware/steam-runtime and follow instructions: download and setup the chroot.

sudo ./setup_chroot.sh --i386 --tarball ./com.valvesoftware.SteamRuntime.Sdk-i386-scout-sysroot.tar.gz


Now you can use cmake and make prepending the commands with schroot --chroot steamrt_scout_i386 --:

schroot --chroot steamrt_scout_i386 -- cmake -DCMAKE_BUILD_TYPE=Release -B build-in-steamrt -S .
schroot --chroot steamrt_scout_i386 -- cmake --build build-in-steamrt

Linux x86. Portable steam-compatible build without Steam Runtime


Install C++ compilers, cmake and x86 development libraries for C, C++ and SDL2. On Ubuntu/Debian:

sudo apt install cmake build-essential gcc-multilib g++-multilib libsdl2-dev:i386


cmake -DCMAKE_BUILD_TYPE=Release -B build -S .
cmake --build build

Note that the libraries built this way might be not compatible with Steam Half-Life. If you have such issue you can configure it to build statically with c++ and gcc libraries:

cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="${CMAKE_CXX_FLAGS} -static-libstdc++ -static-libgcc" -B build -S .
cmake --build build

Alternatively, you can avoid libstdc++/libgcc_s linking using small libsupc++ library and optimization build flags instead(Really just set Release build type and set C compiler as C++ compiler):

cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=cc -B build -S .
cmake --build build

To ensure portability it's still better to build using Steam Runtime or another chroot of some older distro.

Linux x86. Portable steam-compatible build in your own chroot


Use the most suitable way for you to create an old distro 32-bit chroot. E.g. on Ubuntu/Debian you can use debootstrap.

sudo apt install debootstrap schroot
sudo mkdir -p /var/choots
sudo debootstrap --arch=i386 jessie /var/chroots/jessie-i386 # On Ubuntu type trusty instead of jessie
sudo chroot /var/chroots/jessie-i386
# inside chroot
apt install cmake build-essential gcc-multilib g++-multilib libsdl2-dev

Create and adapt the following config in /etc/schroot/chroot.d/jessie.conf (you can choose a different name):

description=Debian jessie i386

Insert your actual user name in place of yourusername.


Prepend any make or cmake call with schroot -c jessie --:

schroot --chroot jessie -- cmake -DCMAKE_BUILD_TYPE=Release -B build-in-chroot -S .
schroot --chroot jessie -- cmake --build build-in-chroot


  1. Set up Android Studio/Android SDK.

Android Studio

Open the project located in the android folder and build.


cd android
./gradlew assembleRelease

Customizing the build


  • rootProject.name - project name displayed in Android Studio (optional).


  • android->namespace and android->defaultConfig->applicationId - set both to desired package name.
  • getBuildNum function - set releaseDate variable as desired.


  • .putExtra("gamedir", ...) - set desired gamedir.


  • application->android:label - set desired application name.
  • su.xash.engine.gamedir value - set to same as above.

Nintendo Switch


  1. Set up dkp-pacman.
  2. Install dependency packages:
sudo dkp-pacman -S switch-dev dkp-toolchain-vars switch-mesa switch-libdrm_nouveau switch-sdl2
  1. Make sure the DEVKITPRO environment variable is set to the devkitPro SDK root:
export DEVKITPRO=/opt/devkitpro
  1. Install libsolder:
source $DEVKITPRO/switchvars.sh
git clone https://github.com/fgsfdsfgs/libsolder.git
make -C libsolder install

Building using CMake

mkdir build && cd build
aarch64-none-elf-cmake -G"Unix Makefiles" -DCMAKE_PROJECT_HLSDK-PORTABLE_INCLUDE="$DEVKITPRO/portlibs/switch/share/SolderShim.cmake" ..
make -j

Building using waf

./waf configure -T release --nswitch
./waf build

PlayStation Vita


  1. Set up VitaSDK.
  2. Install vita-rtld:
    git clone https://github.com/fgsfdsfgs/vita-rtld.git && cd vita-rtld
    mkdir build && cd build
    cmake -DCMAKE_BUILD_TYPE=Release ..
    make -j2 install

Building with waf:

./waf configure -T release --psvita
./waf build

Building with CMake:

mkdir build && cd build
cmake -G"Unix Makefiles" -DCMAKE_TOOLCHAIN_FILE="$VITASDK/share/vita.toolchain.cmake" -DCMAKE_PROJECT_HLSDK-PORTABLE_INCLUDE="$VITASDK/share/vrtld_shim.cmake" ..
make -j

Other platforms

Building on other architectures (e.g x86_64 or arm) and POSIX-compliant OSes (e.g. FreeBSD) is supported.


Install C and C++ compilers (like gcc or clang), cmake and make.


cmake -DCMAKE_BUILD_TYPE=Release -B build -S .
cmake --build build

Force 64-bit build:

cmake -DCMAKE_BUILD_TYPE=Release -D64BIT=1 -B build -S .
cmake --build build

Building with waf

To use waf, you need to install python (2.7 minimum)

./waf configure -T release

Force 64-bit build:

./waf configure -T release -8

Build options

Some useful build options that can be set during the cmake step.

  • GOLDSOURCE_SUPPORT - allows to turn off/on the support for GoldSource input. Set to ON by default on x86 Windows and x86 Linux, OFF on other platforms.
  • 64BIT - allows to turn off/on 64-bit build. Set to OFF by default on x86_64 Windows, x86_64 Linux and 32-bit platforms, ON on other 64-bit platforms.
  • USE_VGUI - whether to use VGUI library. OFF by default. You need to init vgui_support submodule in order to build with VGUI.

This list is incomplete. Look at CMakeLists.txt to see all available options.

Prepend option names with -D when passing to cmake. Boolean options can take values OFF and ON. Example: