molecalculator

Moles & Molar Mass

Half-Life Xash3D: What It Is and How to Run It

Guide 01-9138 · Updated · Step by step

Xash3D is a free, open-source game engine that reimplements the GoldSrc engine used by the original Half-Life (1998), allowing the game to run on modern operating systems, consoles, and low-end hardware. You enter your Half-Life game files (or use the free Half-Life demo) and the engine, and you get a playable, often improved version of the classic shooter on platforms where the original engine no longer works. This article explains what Xash3D is, how it works, how to set it up, and what to watch out for.

Background: Why Xash3D Exists

Valve’s GoldSrc engine powered Half-Life, its expansions, and Counter-Strike 1.6. It was designed for late-1990s Windows PCs, and while it still runs on modern Windows through compatibility layers, it does not run natively on Android, iOS, or many Linux distributions without heavy tweaking. Xash3D was created by a Russian developer (known as uncle) in the mid-2000s as a clean-room reimplementation of GoldSrc’s core logic. The goal was to make a portable engine that could run Half-Life’s game code (the .dll files and map files) without needing Valve’s original executable. Over time, the project gained a community that ported it to Android, various consoles, and even web browsers. Today, Xash3D is the most reliable way to play Half-Life on phones, Raspberry Pi, and other non-Windows devices.

How Xash3D Works

Xash3D is not a standalone game; it is an engine that requires the original game data. The engine reads the same .wad (textures), .bsp (maps), .wav (sounds), and .dll (game logic) files that the original GoldSrc engine used. It then interprets that data and renders it using OpenGL or Vulkan (depending on the build). Because it is a reimplementation, it does not contain any copyrighted code from Valve; it only uses the publicly documented file formats and behavior. This means you still need to own Half-Life (or use the free demo) to legally play. Xash3D also adds modern features like higher resolutions, widescreen support, and better mouse input, which the original engine lacked.

What You Need to Run Xash3D

To run Xash3D, you need two things:

  • Xash3D engine files – downloaded from the official GitHub repository or a trusted community build.
  • Half-Life game files – either from a Steam installation, the original CD, or the free Half-Life: Uplink demo (available from various archives).

On Android, you can install the Xash3D FWGS (a popular fork) from the Google Play Store or F-Droid, and then copy the Half-Life files into the app’s directory. On PC, you can place the engine files in a folder and point it to your Steam installation’s Half-Life folder. On Linux, you can use the same PC build with Wine or a native build.

How to Install and Set Up Xash3D

The exact steps vary by platform, but the general process is:

  1. Download the Xash3D build for your device (e.g., Xash3D FWGS for Android, or the PC build from GitHub).
  2. Install the app or extract the archive to a folder.
  3. Obtain your Half-Life game files. On Steam, right-click Half-Life in your library, select Manage > Browse local files, and copy the entire folder (or at least the valve subfolder).
  4. Place the game files in the location Xash3D expects (on Android, usually /sdcard/xash/ or the app’s data folder; on PC, just put them in the same folder as the engine).
  5. Launch Xash3D. It should detect the game files and start Half-Life.

If you only have the demo, you can download the valve folder from the free Half-Life: Uplink demo and use that.

Common Problems and Fixes

Users often run into these issues:

  • Game files not detected – Make sure the valve folder is in the correct directory. On Android, the path is usually /sdcard/xash/valve.
  • Black screen or crash on start – Try a different renderer (OpenGL vs. Vulkan) in the settings, or update your GPU drivers.
  • No sound – Ensure the game files include the sound folder; on some builds, you need to copy it manually.
  • Multiplayer not working – Xash3D supports multiplayer, but you may need to use a dedicated server browser or the in-game server list. Some builds have limited netcode compatibility.
  • Mods not loading – Most GoldSrc mods (like Counter-Strike 1.6, Team Fortress Classic, or custom campaigns) require the mod’s files to be placed in the correct folder and launched via the engine’s mod selection menu.

Xash3D vs. Other Ways to Play Half-Life

There are several alternatives to Xash3D, each with trade-offs:

  • Original GoldSrc on Windows – Works on modern Windows with compatibility settings, but lacks widescreen support and has old graphics.
  • Half-Life: Source – A Source engine remake, but it changes the physics and lighting; it is not a faithful port.
  • Wine on Linux – Can run the original, but performance and compatibility vary.
  • Xash3D – Best for non-Windows platforms, offers modern resolutions and performance, and is actively maintained by the community.

For most users, Xash3D is the best choice for Android, Raspberry Pi, or older PCs that struggle with the original.

Is Xash3D Legal and Safe?

Xash3D itself is legal because it is a clean-room reimplementation of the engine’s functionality, not a copy of Valve’s code. However, you must own the game files to use it; downloading Half-Life from a pirate site is illegal and also risks malware. The engine is open-source, so you can inspect the code, and the community builds are generally safe, but always download from the official GitHub or trusted sources. The engine does not contain any malicious code, but any third-party mods you add could be risky, so only download mods from reputable sites.

Frequently Asked Questions

Does Xash3D work with Steam’s Half-Life? Yes, you can copy the Steam installation’s files to the Xash3D folder. The engine reads the same files, so it works with the Steam version.

Can I play Half-Life mods with Xash3D? Yes, most GoldSrc mods work, including Counter-Strike 1.6, Team Fortress Classic, and custom single-player campaigns. Place the mod’s folder in the same directory as the valve folder and select it from the mod list in the engine’s menu.

Is Xash3D available for iOS? There have been experimental iOS ports, but they are not as stable as the Android version. The Android build is the most polished and widely used.

Does Xash3D improve graphics? It can render at higher resolutions and supports widescreen, but it does not add new textures or models. You can use HD texture packs (like the Half-Life HD pack) by placing them in the game files, and the engine will load them.

Is Xash3D the same as the original Half-Life engine? No, it is a reimplementation, so it may have slight differences in physics or rendering edge cases. For most players, it feels identical, but speedrunners or modders might notice minor differences.

Do I need a powerful device to run Xash3D? No, it is very light. It can run on a Raspberry Pi 3 or a low-end Android phone, making it ideal for retro gaming on cheap hardware.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this section

The whole Moles & Molar Mass section →