Hammer Manual Configuration

From Valve Developer Community
Jump to: navigation, search
English (en)한국어 (ko)русский (ru)español (es)中文 (zh)
Edit
Icon-broom.png
This article or section needs to be updated to include current information regarding the subject because:
This needs to better explain each game now having its own copy of Hammer and the compile tools.
Remember to check for any notes left by the tagger at this article's talk page

Read This First!

If you launch the Hammer editor with no proper game configurations set up, the Hammer Editor has not automatically configured itself after installing the Source SDK. You can follow these steps to manually configure it. Before following these steps to repair a bad configuration, it is strongly suggested that you first attempt to fix your configuration by following the steps outlined in Reset the Source SDK Game Configuration.

Warning.pngWarning:In most cases, Hammer will configure itself and you do not need to follow this procedure. If you have problems, it is much simpler to reset the game configuration instead. Doing this, however will remove your mod configurations
Note.pngNote:The Source SDK Launcher is no longer used with Source 2013 Source 2013 games and mods, so the above warning does not apply to them.

Adding a New Game Configuration

  1. Launch Hammer.
  2. The First Time Setup dialog box may appear. If it does, click the No button:
    Setup NoGameConfig.png
  3. If the First Time Setup window did appear, this Configure Hammer dialog should now be open. Otherwise, click Options in the Tools menu, and then open the Game Configurations tab.
    Setup GameConfig 01.png
  4. Click on the Edit button to the right of the Configuration drop-down list, which will open the Edit Game Configurations dialog:
    Setup EditGameConfig.png
  5. Press the Add button. This will open the Add a game dialog:
    Setup AddGame.png
  6. Enter a name for the new configuration, usually the name of the game or mod. Press OK to confirm your choice and close the dialog.
  7. Press the Close button in the Edit Game Configurations dialog.

Setting Game Directory and Basic Parameters

  1. You should now be back in the Configure Hammer dialog with your configuration selected in the Configuration drop-down list:
    Setup GameConfig 02.png
  2. Press Add to the right of the Game Data files list. An Open dialog will appear:
    Setup AddGameOpen.png
  3. Select the appropriate .FGD file for your game or mod:
    • For a Counter-Strike: Source configuration, click on cstrike.fgd and then the Open button.
    • For a Half-Life 2 configuration, click on halflife2.fgd and then the Open button.
    • For a Half-Life 2 Deathmatch configuration, click on hl2mp.fgd and then the Open button.
    • For a Team Fortress 2 configuration, click on tf.fgd and then the Open button.
  4. Now you'll be back in the Configure Hammer dialog with these fields filled out:
    Setup GameConfig 03.png
  5. Type 0.25 into the Default texture scale field. Type tools\toolsskybox into the Cordon texture field.
  6. Under Game Executable Directory, hit Browse and select the folder where the game executable (such as hl2.exe) is located.
    For example, the directory for a Counter-Strike configuration might be:
    $SteamUserDir\Counter-Strike Source
  7. Under Game Directory, enter the path of the folder that contains gameinfo.txt.
    For example, the game directory for a Half-Life 2 configuration might be:
    $SteamUserDir\Half-Life 2\hl2
    For mods located in the sourcemods folder, the game directory would be of the form:
    C:\Program Files (x86)\Steam\steamapps\sourcemods\mod
  8. Under Hammer Map Directory, you should enter the folder where you wish to save your .VMF map source files.
    • Example for Counter-Strike:
    C:\Program Files (x86)\Steam\steamapps\common\sourcesdk_content\cstrike\mapsrc
    • Example for Half-Life 2:
    C:\Program Files (x86)\Steam\steamapps\common\sourcesdk_content\hl2\mapsrc
    • Example for Half-Life 2 Deathmatch:
    C:\Program Files (x86)\Steam\steamapps\common\sourcesdk_content\hl2mp\mapsrc

Setting up the Build Programs

  1. Click on the Build Programs tab:
    Setup BuildPrograms.png
  2. In Game Executable, enter the path of the .exe file used to launch the game.
    • For example, for a Counter-Strike configuration, your Game Executable might be:
    $SteamUserDir\counter-strike source\hl2.exe
    • For a Half-Life 2 configuration, your Game Executable might be:
    $SteamUserDir\half-life 2\hl2.exe
    • For a Half-Life 2 Deathmatch configuration, your Game Executable might be:
    $SteamUserDir\half-life 2 deathmatch\hl2.exe
  3. In BSP executable, enter the location of vbsp.exe:
    EXEDIR\bin\vbsp.exe
    EXEDIR is the value that was entered into Game Executable Directory field earlier.
  4. In VIS executable, enter the location of the vvis.exe:
    EXEDIR\bin\vvis.exe
    EXEDIR is the value that was entered into Game Executable Directory field earlier.
  5. In RAD executable, enter the location of the vrad.exe:
    EXEDIR\bin\vrad.exe
    EXEDIR is the value that was entered into Game Executable Directory field earlier.
  6. In Place compiled maps in this directory before running the game, enter the Game Directory with \maps appended to the end of it:
    • Example for Counter-Strike:
    $SteamUserDir\counter-strike source\cstrike\maps
    • Example for Half-Life 2:
    $SteamUserDir\half-life 2\hl2\maps
    • Example for Half-Life 2 Deathmatch:
    $SteamUserDir\half-life 2 deathmatch\hl2mp\maps
    • Example for MOD:
    C:\Program Files (x86)\Steam\steamapps\sourcemods\MODDIR\maps
    MODDIR is the name of your game directory for your mod.
  7. Press OK. Hammer is now configured for use.