Hammer Manual Configuration: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(ported page from old site)
 
(minor corrections, added sections)
Line 1: Line 1:
If the Hammer Editor does not automatically configure 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 [[Incorrect Hammer configuration]].
== Read this first! ==


'''Note:''' In most cases, Hammer will configure itself and you '''do not''' need to follow this procedure.
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 [[Incorrect Hammer configuration]].


== Setting the Game Configurations ==
'''Important Note:''' 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 [[Incorrect Hammer configuration|reset the game configuration]] instead.
 
== Adding a new Game Configuration ==


1. Run '''Hammer''' from the '''Source SDK Launcher'''.
1. Run '''Hammer''' from the '''Source SDK Launcher'''.


2. If you see this message box, click the '''No''' button:
2. When you see the '''First Time Setup''' dialog box, click the '''No''' button:


:[[Image:Setup_NoGameConfig.png]]
:[[Image:Setup_NoGameConfig.png]]


3. This '''Configure Hammer''' dialog should appear next:
3. This '''Configure Hammer''' dialog should appear next.


:[[Image:Setup_GameConfig_01.png]]
:[[Image:Setup_GameConfig_01.png]]


4. Click on the topmost '''Edit''' button, next to the '''Configuration '''drop-down list. The '''Edit Game Configurations '''dialog appears:
If this dialog does not appear, choose '''Options''' from the '''Tools''' menu, and then select the '''Game Configurations''' tab.
 
4. Click on the topmost '''Edit''' button, next to the '''Configuration '''drop-down list. The '''Edit Game Configurations''' dialog appears:


:[[Image:Setup_EditGameConfig.png]]
:[[Image:Setup_EditGameConfig.png]]
Line 23: Line 27:
:[[Image:Setup_AddGame.png]]
:[[Image:Setup_AddGame.png]]


6. Type in "CounterStrike", "cstrike", "Half-Life 2", "HL2DM" or an equivalent to name your configuration. The exact name is unimportant, what's important is that it makes sense to you. Press '''OK''' to confirm your choice and close the dialog.
6. Type in "Counter-Strike", "cstrike", "Half-Life 2", "HL2DM" or an equivalent to name your configuration. This is the name that will appear in the Source SDK Launcher where it says '''Current Game'''. The exact name is unimportant, what's important is that it makes sense to you. Press '''OK''' to confirm your choice and close the dialog.


7. Press the '''Close''' button in the '''Edit Game Configurations''' dialog.
7. Press the '''Close''' button in the '''Edit Game Configurations''' dialog.


8. You should now be back in the '''Configure Hammer''' dialog with your entry in the '''Configuration''' drop-down list:
== Setting game directory and basic parameters ==
 
You should now be back in the '''Configure Hammer''' dialog with your entry in the '''Configuration''' drop-down list:


:[[Image:Setup_GameConfig_02.png]]
:[[Image:Setup_GameConfig_02.png]]


9. Press '''Add''' to the right of the '''Game Data''' files list. An '''Open''' dialog will appear:
1. Press '''Add''' to the right of the '''Game Data''' files list. An '''Open''' dialog will appear:


:[[Image:Setup_AddGameOpen.png]]
:[[Image:Setup_AddGameOpen.png]]


10. Open the appropriate .fgd file for your configuration:
2. Open the appropriate .FGD file for your configuration:


:For a '''Counter-Strike: Source''' configuration, click on <code>cstrike.fgd</code> and then the '''Open''' button.
:For a '''Counter-Strike: Source''' configuration, click on <code>cstrike.fgd</code> and then the '''Open''' button.
Line 41: Line 47:
:For a '''Half-Life 2''' configuration, click on <code>halflife2.fgd</code> and then the '''Open''' button.
:For a '''Half-Life 2''' configuration, click on <code>halflife2.fgd</code> and then the '''Open''' button.


:For a '''Half-Life 2 Deathmatch''' configuration, click on <code>hl2mp.fgd</code> and then the '''Open''' button.  
:For a '''Half-Life 2 Deathmatch''' configuration, click on <code>hl2mp.fgd</code> and then the '''Open''' button.


11. Now you'll be back in the '''Configure Hammer''' dialog with these fields filled out:
3. Now you'll be back in the '''Configure Hammer''' dialog with these fields filled out:


:[[Image:Setup_GameConfig_03.png]]
:[[Image:Setup_GameConfig_03.png]]


12. Type <code>0.25</code> into the '''Default texture scale''' field.  
4. Type <code>0.25</code> into the '''Default texture scale''' field. Type <code>tools\toolsskybox</code> into the '''Cordon texture''' field.


13. Under '''Game Executable Directory''', hit '''Browse''' and go to where you have the the game installed. : For example:
5. Under '''Game Executable Directory''', hit '''Browse''' and go to where you have the the game installed. : For example:
<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source</code>
<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source</code>


:Where ''username'' should be your Steam Login name.  
:Where ''username'' should be your Steam Login name.


14. Under '''Game Directory''', copy what you entered into '''Game Executable Directory''', paste it into '''Game Directory''', and add the game directory to the end. The game directory for Counter-Strike is <code>\cstrike</code>. For Half-Life 2, it is <code>\hl2</code>. For Half-Life 2 Deathmatch, it is <code>\hl2mp</code>.  
6. Under '''Game Directory''', copy what you entered into '''Game Executable Directory''', paste it into '''Game Directory''', and add the game directory to the end. The game directory for Counter-Strike is <code>\cstrike</code>. For Half-Life 2, it is <code>\hl2</code>. For Half-Life 2 Deathmatch, it is <code>\hl2mp</code>.


:For example, for a '''Counter-Strike''' configuration, your '''Game Directory''' might be:  
:For example, for a '''Counter-Strike''' configuration, your '''Game Directory''' might be:
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source\cstrike</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source\cstrike</code>


Line 65: Line 71:
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\half-life 2 deathmatch\hl2mp</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\half-life 2 deathmatch\hl2mp</code>


Again, where ''username'' should be your Steam Login name.
:Again, where ''username'' should be your Steam Login name.


15. Under '''Hammer Map Directory''', you should enter in where you wish to save your .VMF map source files. Using the [[content_directory_structure]], you should enter the appropriate <code>mapsrc</code> directory:
7. Under '''Hammer Map Directory''', you should enter in where you wish to save your .VMF map source files. Using the [[Source SDK Files and Directory Structure]], you should enter the appropriate <code>mapsrc</code> directory:


:Example for '''Counter-Strike''':  
:Example for '''Counter-Strike''':
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\sourcesdk_content\cstrike\mapsrc</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\sourcesdk_content\cstrike\mapsrc</code>


Line 84: Line 90:
:[[Image:Setup_BuildPrograms.png]]
:[[Image:Setup_BuildPrograms.png]]


1. Copy and paste the '''Game executable Directory''' you entered into the '''Game Configuration'''s tab previously, then add <code>\hl2.exe</code> on the end.  
1. Copy and paste the '''Game executable Directory''' you entered into the '''Game Configurations''' tab previously, then add <code>\hl2.exe</code> on the end.


:For example, for a '''Counter-Strike''' configuration, your '''Game Executable ''' might be:  
:For example, for a '''Counter-Strike''' configuration, your '''Game Executable ''' might be:
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source\hl2.exe</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source\hl2.exe</code>


Line 95: Line 101:
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\half-life 2 deathmatch\hl2.exe</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\half-life 2 deathmatch\hl2.exe</code>


:Again, where ''username'' should be your Steam Login name.  
:Again, where ''username'' should be your Steam Login name.


2. For '''BSP executable''', enter the location of the <code>vbsp.exe</code>:
2. For '''BSP executable''', enter the location of the <code>vbsp.exe</code>:
Line 111: Line 117:
5. For '''Place compiled maps in this directory before running the game''', add <code>\maps</code> the end of the '''Game Directory''':
5. For '''Place compiled maps in this directory before running the game''', add <code>\maps</code> the end of the '''Game Directory''':


:Example for '''Counter-Strike''':  
:Example for '''Counter-Strike''':
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source\cstrike\maps</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\counter-strike source\cstrike\maps</code>


:Example for '''Half-Life 2''':  
:Example for '''Half-Life 2''':
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\half-life 2\hl2\maps</code>
:<code>C:\Program Files\Valve\Steam\SteamApps\''username''\half-life 2\hl2\maps</code>



Revision as of 18:49, 23 August 2005

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 Incorrect Hammer configuration.

Important Note: 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.

Adding a new Game Configuration

1. Run Hammer from the Source SDK Launcher.

2. When you see the First Time Setup dialog box, click the No button:

Setup NoGameConfig.png

3. This Configure Hammer dialog should appear next.

Setup GameConfig 01.png

If this dialog does not appear, choose Options from the Tools menu, and then select the Game Configurations tab.

4. Click on the topmost Edit button, next to the Configuration drop-down list. The Edit Game Configurations dialog appears:

Setup EditGameConfig.png

5. Press the Add button. This will open the Add a game dialog:

Setup AddGame.png

6. Type in "Counter-Strike", "cstrike", "Half-Life 2", "HL2DM" or an equivalent to name your configuration. This is the name that will appear in the Source SDK Launcher where it says Current Game. The exact name is unimportant, what's important is that it makes sense to you. 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

You should now be back in the Configure Hammer dialog with your entry in the Configuration drop-down list:

Setup GameConfig 02.png

1. Press Add to the right of the Game Data files list. An Open dialog will appear:

Setup AddGameOpen.png

2. Open the appropriate .FGD file for your configuration:

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.

3. Now you'll be back in the Configure Hammer dialog with these fields filled out:

Setup GameConfig 03.png

4. Type 0.25 into the Default texture scale field. Type tools\toolsskybox into the Cordon texture field.

5. Under Game Executable Directory, hit Browse and go to where you have the the game installed. : For example: C:\Program Files\Valve\Steam\SteamApps\username\counter-strike source

Where username should be your Steam Login name.

6. Under Game Directory, copy what you entered into Game Executable Directory, paste it into Game Directory, and add the game directory to the end. The game directory for Counter-Strike is \cstrike. For Half-Life 2, it is \hl2. For Half-Life 2 Deathmatch, it is \hl2mp.

For example, for a Counter-Strike configuration, your Game Directory might be:
C:\Program Files\Valve\Steam\SteamApps\username\counter-strike source\cstrike
For a Half-Life 2, your Game Directory might be:
C:\Program Files\Valve\Steam\SteamApps\username\half-life 2\hl2
For a Half-Life 2 Deathmatch, your Game Directory might be:
C:\Program Files\Valve\Steam\SteamApps\username\half-life 2 deathmatch\hl2mp
Again, where username should be your Steam Login name.

7. Under Hammer Map Directory, you should enter in where you wish to save your .VMF map source files. Using the Source SDK Files and Directory Structure, you should enter the appropriate mapsrc directory:

Example for Counter-Strike:
C:\Program Files\Valve\Steam\SteamApps\username\sourcesdk_content\cstrike\mapsrc
Example for Half-Life 2:
C:\Program Files\Valve\Steam\SteamApps\username\sourcesdk_content\hl2\mapsrc
Example for Half-Life 2 Deathmatch:
C:\Program Files\Valve\Steam\SteamApps\username\sourcesdk_content\hl2mp\mapsrc

Setting up the Build Programs

Click on the Build Programs tab:

Setup BuildPrograms.png

1. Copy and paste the Game executable Directory you entered into the Game Configurations tab previously, then add \hl2.exe on the end.

For example, for a Counter-Strike configuration, your Game Executable might be:
C:\Program Files\Valve\Steam\SteamApps\username\counter-strike source\hl2.exe
For a Half-Life 2 configuration, your Game Executable might be:
C:\Program Files\Valve\Steam\SteamApps\username\half-life 2\hl2.exe
For a Half-Life 2 Deathmatch configuration, your Game Executable might be:
C:\Program Files\Valve\Steam\SteamApps\username\half-life 2 deathmatch\hl2.exe
Again, where username should be your Steam Login name.

2. For BSP executable, enter the location of the vbsp.exe:

C:\Program Files\Valve\Steam\SteamApps\username\sourcesdk\bin\vbsp.exe

3. For VIS executable, enter the location of the vvis.exe::

C:\Program Files\Valve\Steam\SteamApps\username\sourcesdk\bin\vvis.exe

4. For RAD executable, enter the location of the vrad.exe::

C:\Program Files\Valve\Steam\SteamApps\username\sourcesdk\bin\vrad.exe

5. For Place compiled maps in this directory before running the game, add \maps the end of the Game Directory:

Example for Counter-Strike:
C:\Program Files\Valve\Steam\SteamApps\username\counter-strike source\cstrike\maps
Example for Half-Life 2:
C:\Program Files\Valve\Steam\SteamApps\username\half-life 2\hl2\maps
Example for Half-Life 2 Deathmatch:
C:\Program Files\Valve\Steam\SteamApps\username\half-life 2 deathmatch\hl2mp\maps

6. Press OK. Hammer is now configured for use.