Xash3D is a custom Gold Source build from a scratch. Xash3D overcomes obsolete Gold Source engine's limits and provides for you a new quality of gaming experience and modmaking capabilities, for example: higher limits for bsp-models, studiomodels scaling, realistic values of lighting on server side, entity patch technology support, support of additional map types, support of precaching "on the fly", support for using real HD-textures (up to 4096 x 4096 px) for maps, models, sprites and decals in any played mod and many other features...

Post feature Report RSS Running Half-Life under Xash3D: user's manual (English)

Hello, if you are new with how to use Xash3D Engine to run Half-Life and its' mods, this manual is for you. Just follow the instruction and have fun!

Posted by on

How to get work Half-Life under Xash3D:

step-by-step instruction for anyone.

It is important to understand, that Xash3D is an independent game engine. It's not a mod for Half-Life, so to get Half-Life work with it, you have to make a separate installation of the game. Please follow these steps carefully and you won't confuse with anything.

1. Please install a Half-Life game properly at first. Currently, a full version of Half-Life can be purchased and activated via Steam. If you have a CD with an old WON version of Half-Life, you can use it too. But please remember, that it's recommended to update your WON version of the game with a patch 1.1.1.0 to be prepared for running latest Half-Life mods also, not only Half-Life itself. If you are not sure which version of the WON game you have installed, just launch the game and look at the right lower corner of the game menu screen. There are some numbers with your game version. If it's not a "v46/1.1.1.0", please update your game. But you don't need to update your Steam version of the game with this patch. Any Steam version of the game should be compatible and ready for running latest mods via Xash3D, but be sure to follow this instruction carefully, especially step 6 - some files have to be added/replaced to have all things working properly.

2. Download the latest version of Xash3D Engine. Currently, it's a build 4344 (v0.99). You can get it at the "Files" section. After downloading you will get a Xash3D_build4344_with_extras.zip file on your computer.

3. Now you have to create a separate folder for Xash3D installation. You can create this folder anywhere you want, but please don't create it inside that directory where your Half-Life is installed already (don't be a noob, LOL). It's better to use simple path to this folder and give it an appropriate name, something like "D:\Games\Xash3D". This folder will be your main Xash3D game directory.

4. Locate and open a folder with a basic Half-Life game content. For the WON version of game it can be something like "C:\Sierra\Half-Life\". You will see a "valve" directory inside. For the current Steam version of the game it can be something like "C:\Program Files\Steam\SteamApps\common\Half-Life". You also will be able to find a "valve" directory inside it.

5. Copy the whole "valve" folder with all of its' content from your Half-Life game folder directly into the main Xash3D game directory (which was created at Step 3). So after that you get something like "D:\Games\Xash3D\valve" with a basic game content. If you are using Steam version of the game as a source, after copying (extracting) of "valve" folder also check inside "valve\sound\common" folder. There are some launch_*.wav files. Copy them to the "valve\media" folder (these sounds are required for Xash3D game menu, but they present in this folder only in WON versions of the game).

6. Proceed to extracting the contents of Xash3D_build4344_with_extras.zip archive into the main Xash3D game directory. At first, you will get 2 more archives: Xash3D_build4344.7z and Xash3D_extras.7z (there's also Xash3D_build4344_sources.7z, but it's only for developer's needs). 7z files are 7-Zip archives, which can be extracted with 7-Zip program or with any other appropriate archiver. Continue their extracting into the Xash3D directory with overwriting of any existing files (some files in the "valve" folder must be replaced with files from Xash3D_extras.7z, especially dll-files, otherwise you may get critical error and be unable to play the game). Finally, you will get the Xash3D directory with "docs", "source code" and "valve" folders inside, plus files dedicated.exe, hl.exe, Install Notes.txt, menu.dll, readme.txt, vgui.dll and xash.dll.

7. Now you almost ready to run the game. But firstly, create a shortcut for hl.exe (located in the Xash3D directory) and put it onto your desktop (or into the Programs menu, for example). If you want to enable a console in the game, you have to edit a properties of the shortcut (right-click the shortcut and select a "Properties" tab in pop-up menu). Check the "Target" field and add there parameter " -console" (with space, but without quotes) after hl.exe (it should look like "...\hl.exe" -console). Alternatively, you can use " -dev" parameter. Click "OK". There is also dedicated.exe in Xash3D directory, which can be used to start a dedicated server for multiplayer game (if you are interested in this feature).

8. Start your game via the created shortcut. At the first launch, engine will try to detect your current desktop resolution, and use it in a fullscreen mode. If it fails in doing so (your desktop resolution is not supported, or else), it will use a windowed mode and 800x600 resolution. When the game menu appears, you be able to edit your game preferences (video mode, resolution, sound effects, controls etc.) via "Configuration" menu. Please note, that in the "Sound" menu there is "Enable sound interpolation" checkbox. It's unchecked by default, because this is an experimental feature in Xash3D. It can cause some wrong sound effects in certain situations. So enable it "on your own risk", if you really want to try. It's recommended to restart the game after significant changes of configuration (video mode or resolution settings, multiple changes of control keys etc.) to apply and save new settings properly. In case of engine's crash applied settings will not be saved.

9. If you want to play any Half-Life or Xash3D mod, you have to install it or extract its' content into a separate folder inside a main Xash3D directory (same as for the standard Half-Life game). Follow an instruction that is appended to a mod, but make sure that any mod (with all of its' content) was placed into an individual folder. Any properly installed mod can be selected and activated via "Custom game" menu. You can also create a custom shortcut to run any mod. Just create a copy of the shortcut for hl.exe and add in the "Target" field parameter " -game FOLDERNAME" (with space, but without quotes) after hl.exe. "FOLDERNAME" here is a name of the folder where your mod is located. For example, to run Opposing Force (when installed) you have to add " -game gearbox" parameter after hl.exe (it should look like "...\hl.exe" -game gearbox). In fact, it's all the same system, which you can use to run any mod under standard Half-Life. Please note, that "FOLDERNAME" should not contain spaces (legit names are like "foldername" or "Folder_Name" or "Folder-name" or "FOLDER.NAME", but not like "Folder Name").

10. Make sure you have read an additional information about Xash3D posibilities and features (which is containing in documents in the "docs" folder, plus in those text files in the main Xash3D directory). Some information is also avaliable here, at ModDB. Please read the details, before you ask about something, that you don't know yet.

P. S. If you've used command line parameter for enabling the console, but it still doesn't work, check "gameinfo.txt" in your current mod's folder for the line secure "1", delete this line and save changes.

P. P. S. Be sure to check these 2 articles: #1 & #2 about tested mods and useful compatibility tips.

Comments  (0 - 50 of 78)
Ichiman94
Ichiman94

And I thought this was a basic knowledge that everyone knew, but it's nice for new users who haven't fiddled with modding. This is great!

Reply Good karma Bad karma+1 vote
~X~
~X~

Basic knowledge these days... Is quite more 'basic' than this )

Reply Good karma Bad karma+2 votes
Elec3K
Elec3K

i dont understand i did averything it saids,but i still dont understand wat should i do,should i put it to my hl directory or in a folder with a folder that doesnt even know where the system is,WAT SHOULD I DO?!!!!!.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

I don't understand what's your problem. Most peoples who have read the article and followed these steps clearly understood what they should do.

Reply Good karma+2 votes
Alex-Wolfenstein97
Alex-Wolfenstein97

yeah ... most people , myself included had no problem with getting the game up and running , but what i don't understand is HOW THE **** CAN YOU MAKE IT SO THAT THE TEXTURES FROM HALF-LIFE : GOLD - SINGLEPLAYER WILL ACTUALLY WORK !!!!! For the love of HL and for everything that is good in this world ! ... can someone explicitly tell me how to get these working ??? the docs don't really help as they just give you an ideea of what you have to do , but it's not really clear ! and a few other people have the same problem ... SO HOW THE HELL DO WE FIX THAT / GET IT WORKING ???

Reply Good karma Bad karma0 votes
Qwertyus Author
Qwertyus

If anyone else is interested, read the comments below this article: Moddb.com

Reply Good karma+1 vote
Red_Fire_Gaming
Red_Fire_Gaming

i have a problem with xash3D. I can't turn on look spring and look strafe options in configuration\controls\adv controls.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

They are inactive, if mouse look is enabled.

Reply Good karma+1 vote
nerdenfromsweden
nerdenfromsweden

the console wont work.

Reply Good karma Bad karma+2 votes
Qwertyus Author
Qwertyus

In a shortcut for hl.exe add -console and make sure there is no "secure 1" line in gameinfo.txt in your mod's folder. Delete this line if it's existing, or set to "secure 0". Also some mods can have console disabled by their developers with specific methods. It's not a fault of engine.

Reply Good karma+1 vote
dooki51
dooki51

Where in the shortcut do I put -console? I don't know where it is and there's no "Object" perimeter.

Reply Good karma Bad karma+1 vote
LOCKJAWVENOM
LOCKJAWVENOM

If it means anything by now, I finally found out how to do it. After making the shortcut, go into the properties like he said. Go to the "target" box and after the filepath and its quotations, press space once and type "-console" there. "Console" should be all the way at the end and, once again, outside the quotations. Hope this helped if it's not too late lol.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

By the way, yes, right name of that box in english version of Windows is "Target", so thanks you point this out (I have russian version of Windows where that box named "Object", so I've made a mistake writing the instruction above). Now mistake is fixed.

P. S. A sample of shortcut parameters (for those who still has any doubts).

1. If your path to hl.exe contains names without spaces it will look like this:
D:\Games\Xash3D\hl.exe -console -game gearbox

2. If your path contains spaces, then there will be quotes:
"D:\My Games\Xash3D Engine\hl.exe" -console -game gearbox

Reply Good karma+1 vote
LOCKJAWVENOM
LOCKJAWVENOM

Glad I could help!

Reply Good karma Bad karma+1 vote
Red_Fire_Gaming
Red_Fire_Gaming

i can't turn on look spring and look strafe options. Also when i create a server it doesn't let me to go to adv options. Reply plzz i can't find any solution

Reply Good karma Bad karma0 votes
earlkim111
earlkim111

they hunger works

Reply Good karma Bad karma+1 vote
wEight
wEight

Both hl and #hl only launches dedicated server.. i don't see the game.

Reply Good karma Bad karma+2 votes
Red_Fire_Gaming
Red_Fire_Gaming

why in my xash3D the look spring and look strafe options are disabled and i can't turn them on?

Reply Good karma Bad karma0 votes
keanedawg
keanedawg

Following the instructions solely on Github, I was able to run the Xash.exe along with it's menu, but I cannot launch any actual game (if I hit "new game" and then select "easy", nothing happens). Is this what is supposed to happen? I thought I would be able to play Half-Life.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Xash.exe is intended to run XashXT (advanced mod for Xash3D), but only if both Xash3D & XashXT are properly installed.

Reply Good karma+1 vote
chrisgregorious
chrisgregorious

Is CS 1.6 working successfully yet? - Half-Life works fine, but CS 1.6 throws out 'xash3d can't initialize client dll' when launching with -console -game cstrike.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Only CS 1.3 and earlier versions are supported.

Reply Good karma+1 vote
Mikko-setä
Mikko-setä

Will you add support for CS 1.6?

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

It's not possible to add support for original CS 1.6 because its' client.dll is encrypted and can be loaded only by Steam version of Half-Life. But authors of Xash3D FWGS have managed to recreate client functions of CS 1.6 for Android version of Xash3D, so if they will be interested, they can create the client.dll for Windows version of Xash3D, as I assume. But they probably will not be interested, because they don't want to allow players from PC (with mouse & keyboard in their hands) play on same game servers with Android players (which have to use touch controls and can't compete with those who play with mouse & kb).

Reply Good karma+2 votes
CYKABLYAT!!!
CYKABLYAT!!!

when i run the game it brings up a dedicated server thing how do i get to the actual game?
and i ran hl.exe the one thats in my xash3d folder

Reply Good karma Bad karma0 votes
Chrysaliarus
Chrysaliarus

Hey, the menu launches up fine for me. I did everything listed in the installation guide, however when I press on any difficulty setting nothing happens. Any reason behind this? It's probably my fault but I wouldn't mind some assistance.

Edit: Just found the comment that you replied to about this. so sorry about the repeat question. However this is a guide about running half-life with xash3d so i'd think it would be a good idea to include instructions for installing XashXT on this guide as well?

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

XashXT is just a mod, so it should be installed and used as any other mod. Nothing specific, except those things which are already described in the manual's item number 9. The only one difference is that XashXT has its' own launcher (xash.exe), which you can use to run the mod directly without need to use "-game xash" key in your shortcut for xash.exe.

Reply Good karma+1 vote
mzoom
mzoom

Is there any other way i could enable the console? When I put the -console text im told its not valid.

Reply Good karma Bad karma+1 vote
MafiaGreed
MafiaGreed

If I copy the valve_hd folder, would the hd model pack work?

Reply Good karma Bad karma+2 votes
Qwertyus Author
Qwertyus

It will work, if you copy all the content inside of valve_hd over the content in valve folder. Otherwise it won't (latest SteamPipe features have not been implemented yet).

Reply Good karma+2 votes
FanProgrammer
FanProgrammer

bad post

Reply Good karma Bad karma+2 votes
FriesNburger
FriesNburger

The .chm help file documentation that comes with this doesn't work. No text displays when I click a page. Is there a separate download for this?

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

It's probably something related to your OS. You can try online documentation:
Xash3d.ru

Reply Good karma+1 vote
Guest
Guest

Thanks for the info its really helping me...

Reply Good karma Bad karma+1 vote
Knight45
Knight45

A video would be helpful, hopefully someone makes one that isn't about Androids.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

The process is almost the same - take files, copy them with a right order, enjoy.

Reply Good karma+1 vote
TheLegendaryFox
TheLegendaryFox

The game starts up fine, but for some reason, almost all textures are white, and the menu options are only white squares. Maybe my video card is too old?

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Look like you missed something while installing the game or mods. Or you haven't Xash3D extras installed. Re-read the manual and do every step properly.

Reply Good karma+1 vote
Joshuaortiz698
Joshuaortiz698

I tried to load the console in my mods but It does not work.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Remove the line "secure 1" or set it to "secure 0" in gameinfo.txt of your mod's folder.

Reply Good karma+2 votes
xwjh123
xwjh123

Hi,i met a problem which was described as "unknown sequence xxxxxx,must be specified" while i was testing condition zero deleted scenes with xash3D engine

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Condition Zero is not supported officially by Xash3D (you should get client.dll error at start of the game). Probably you're trying to play the game without original CZ's client.dll, so there can be errors of any kind.

Reply Good karma+1 vote
ayracaat
ayracaat

Host_InitError: can't initialize client.dll

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Congratulations, you haven't read the manual carefully, or tried to play unsupported mod. For Steam version of Half-Life you have to use dlls from extras. For Opposing Force and Blue Shift you need dlls from WON versions of these games. And... unsupported mods... they just unsupported, you know.

Reply Good karma+1 vote
ayracaat
ayracaat

Used dlls from extras, same problem. And if I play Shaft (mod) there is no problem, but I can't still play Half-Life.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

Replace:
hl.dll in valve\dlls
client.dll in valve\cl_dlls
with corresponding files from extras.

And check gameinfo.txt in "valve" for proper settings. It should be something like:
basedir "valve"
gamedir "valve"
title "Half-Life"
startmap "c0a0"
trainmap "t0a0"
version 1
dllpath "cl_dlls"
gamedll "dlls/hl.dll"
and so on.

Reply Good karma+1 vote
ayracaat
ayracaat

Everything seems to work "fine" the thing was actually like this: dllpath "client.dll" When I downloaded. But there seems to be bugs in the game: Most of the textures are white, menu are white and I placed my WON valve file, I even tryed with the Steam version.

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

I don't know, what are you doing to have such errors. It's not normal and shouldn't happen. Looks like you have a special talent to get those problems. Probably you are using f**ked up version of Half-Life, or some of stupid mods instead of original Half-Life, or just didn't put files in that place where they are intended to be. All textures are obviously in wad-files, they can be missed or modded or corrupted. So check them for presence/contents/integrity (there is a program called Wally, which allows to browse wad-files). To investigate other issues start the game with "...\hl.exe" -dev 3 -log parameters, try to begin or load a game, quit it and check engine.log (open with Notepad) in your main game folder. It should give you a clue what files have you missed etc. (that log can also be seen in the console during the game).

Reply Good karma+1 vote
aldhifi
aldhifi

Hi, my game menu are changed, but when i play the game, there is no differences(no effect at all) just like regular half life with goldscr, except the resolution setting, what did i miss?

Reply Good karma Bad karma+1 vote
Qwertyus Author
Qwertyus

There should not be significant differencies if you're playing a common Half-Life mod or Half-Life itself.

Reply Good karma+1 vote
aldhifi
aldhifi

oh sorry my bad, i thought there will be differencies like realistic flashlight (like i saw someone vid on youtube about xash3d). Because i really need real flashlight for playing afraid of monster:DC, i kinda dont like HL flashlight for aom:DC

Reply Good karma Bad karma+1 vote
Post a comment
Sign in or join with:

Only registered members can share their thoughts. So come on! Join the community today (totally free - or sign in with your social account on the right) and join in the conversation.

Follow Report Profile
Platforms
Windows
Company
Xash XT Group
Contact
Send Message
Licence
GPL
Release date
Engine watch
Follow
Feature
Tags
Feature, Mods
Browse
Features
Report
Report
Share
Related Engines
Xash3D Engine
Xash3D Engine GPL
Related Groups
Xash XT Group
Xash XT Group Developer & Publisher