View source for Configuring Hammer for Half-Life

{{LanguageBar}}


[[File:Hammer Editor 3.4 Splash Screen.png|thumb|Hammer 3.4's Splash screen|right|250px]]
{{HL1}} Half-Life maps are designed using Hammer Editors 3.3 through 3.5, and are powered by the {{goldsrc|4}}, the predecessor to the current {{hammer4|4}} series, AKA the [[Source SDK]]. If you don't already have Half-Life 1's editor, [steam://run/254430 click here to download]. In order for the Hammer Editor to make maps for Half-Life, it needs access to certain files and programs, such as compile tools, game data, and so-on. This page will give you a quick run through on how to set everything up, and get on your way to map making.
{{note|Once you have successfully configured the Hammer Editor to your liking, click '''Apply''', '''OK''', and restart Hammer for your changes to take full effect.}}
{{note|This guide assumes you have a regular Steam installation of everything. You may have to follow alternate or additional steps if you:
* Have Steam, Half-Life, or SDK files installed on a drive that is not <code>C:\</code>
* Have Half-Life/SDK files NOT under your Steam folder.
* Obtained your copy of Half-Life through any non-Steam distributor, or CD-ROM.}}
{{note|If you are using J.A.C.K. for Half-Life and Day of Defeat some info on this page will not be needed to configure J.A.C.K.}}

==Game Configurations==
[[File:Hammer 3.4 Edit Game Configuration Screen.png|right|250px]]
Launch Hammer from Steam. (Steam will call it "''Half-Life SDK''".) Click on '''Tools''', '''Options...''' to open the configuration window. Go to the tab labeled '''Game Configurations'''.

===Configuration===
Hammer allows you to setup multiple configurations, so if you want to make maps for more than one GoldSource game, you can make maps for each on the same editor. This section allows you to add, remove, or edit different configurations. 

Click '''Edit''' (the wide one at the top, not the smaller one below), '''Add''', and name your configuration whatever you want. Click '''OK''', '''Close'''.

===Game Data Files===
Click '''Add'''. Select the file at <code>common\Half-Life SDK\Hammer Editor\fgd\half-life\halflife.[[fgd]]</code>. This file ''should'' exist there. If it doesn't, you can make it yourself by copying all the information on [[Half-Life.fgd|this page]]. You can select and use extra FGDs, but anything in them not coded to work in the Half-Life engine will not work. For example: the CS hostage entity.

{{note|ALL filepaths you enter for configurations need to be absolute, meaning they start with <code>C:\</code> and include the full path to the folder or file.}}

The '''Texture Format''' option should now say '''WAD3 (Half-Life / TFC)''' and the '''Map Type''' option should now say '''HalfLife / TFC'''. These should be the only options listed for either.

===Default PointEntity class===
The FGD tells Hammer to automatically select <code>aiscripted_sequence</code> from the [[entity]] list when using the [[Entity Tool]]. You can change the default to any valid [[point entity]] you want.

===Default SolidEntity class===
The FGD tells Hammer to automatically select <code>button_target</code> from the entity list when you tie a brush to an entity. You can change the default to any valid [[brush entity]] you want.

===Game Executable Directory===
This is the folder containing hl.exe. Select the folder <code>common\Half-Life</code>.

===Mod Directory===
Set this to the folder containing everything specific to your mod/game, such as <code>common\Half-Life\bshift</code>. If you're not mapping for a mod, you can set it to the <code>valve</code> folder, but it shouldn't make a difference.{{confirm}}

===Game Directory===
This is the folder holding game-specific files, such as models, animations, textures, etc. For Half-Life, this is at <code>common\Half-Life\valve</code>.

===RMF Directory===
This is where Hammer will save all files related to your map every time you [[Saving and Compiling|compile]]. The engine looks in <code>common\Half-Life\[your game folder]\maps</code> for maps, however, Hammer will generate quite a few files related to your map when saving or compiling, so you may find it preferable to have a separate folder to contain them all (usually named <code>bspsrc</code>). Compiled map files can be stored in another folder, which we will get to configuring near the end.

==Build Programs==
Now go to the tab labeled '''Build Programs'''. These are the programs that process your level geometry, determine where to optimize for visibility, and add lighting to your map. Many mappers use [[Zoner's Half-Life Tools]] (ZHLT), a fan made modification of the original tools developed for Half-Life containing many fixes and improvements. If you use those tools, you will have to give filepaths for those instead of the ones talked about below.

{{Bug|
Hammer might not recognize the compiler executables and throw an error at compile time if the paths contain more than one whitespace. You can:
* Remove whitespaces in the paths. So you can move or rename the <code>common\Half-Life SDK\Hammer Editor\tools</code> folder.
* Wrap the paths in double quotes like so: <code>"<steamapps>\common\Half-Life SDK\Hammer Editor\tools\<executable>.exe"</code>
}}

===Game Executable===
A .exe file to open when the map finishes compiling. Unless you have some non-gaming purpose for Hammer, this should ''probably'' be <code>common\Half-Life\hl.exe</code>.

===CSG executable===
CSG takes your brush geometry and turns it into something readable by the engine. It also adds entities, like <code>[[info_player_start]]</code> to your map. This is at <code>common\Half-Life SDK\Hammer Editor\tools\qcsg.exe</code>.

===BSP executable===
BSP generates [[visleafs]], based off the geometry made by CSG. This is at <code>common\Half-Life SDK\Hammer Editor\tools\qbsp2.exe</code>.

===VIS executable===
VIS determines what is visible from within each visleaf, which is used to save RAM for computers. This is at <code>common\Half-Life SDK\Hammer Editor\tools\vis.exe</code>.

===RAD executable===
RAD<!---is totally sick, bro---> adds unchanging and toggleable lighting into your map, so it won't look so flat and boring. Dynamic lighting, like the HEV flashlight, is done directly in the game. This is at <code>common\Half-Life SDK\Hammer Editor\tools\qrad.exe</code>.

===Compiled Map Directory===
This is where the game usually looks for maps. This should be <code>common\Half-Life\[game]\maps</code>.

==Textures==
Go to the tab labeled '''Textures'''. Textures are the images used to make your cubes and cylinders look like crates and barrels. GoldSource textures are stored inside of large image library files known as WAD3 files. You can insert any WAD files you wish, whether they come from other GoldSource games, the internet, or if you make them yourself. It's highly recommended however that you do not edit any of the default WAD files that come with your game, especially if your game is not a Steam purchased copy.

If using Valve's default compilation tools, it is recommended you only add the WADs you need for the map you are editing to prevent unnecessary asset loading in-game. Most newer, community-made compilation tools automatically exclude WADs that are not being used by the map.

Look in <code>common\Half-Life SDK\Texture Wad Files\</code> for WADs.

==Saving and Compiling==
When you've successfully configured your Hammer Editor to your liking, click '''OK''', restart Hammer, and test to make sure you've configured Hammer correctly. If you've created more than one configuration, you can choose which to use on startup.

Quickly test your map by making a medium-sized box, right clicking it in a 2D view, and clicking '''Make Hollow''', adding an <code>info_player_start</code> entity, and a <code>light</code> entity, then compiling with all settings on '''Normal'''. If all went well you should see something like this:

[[File:Goldsource basic box.jpg|300px|thumbnail|none|Tada!]]

==Running your Map without Hammer==
It shouldn't happen, but if you're unable to run your map directly from Hammer, keep the game open ''while'' you edit your map. When compiling finishes, open the console by pressing <code>`</code>, and type <code>restart</code>, or if the map's not already open, <code>map mapname</code> to load/reload the map with your changes added. 

{{note|Not being able to run your map directly from Hammer is a warning sign that something is wrong with your compile. If your map isn't changing in-game even when you change it in Hammer and recompile, '''something is wrong'''.}}

[[Category:Level Design]]
[[Category:Tutorials]]
[[Category:Half-Life]]
[[Category:Hammer]]


{{stub}}