Hammer Object Properties Dialog

From Valve Developer Community
Jump to: navigation, search

The Object Properties dialog box is the primary method of modifying entity properties. It also allows you to adjust VisGroup properties for one or many brushes. For non-entity objects, only the VisGroup tab will appear in the Object Properties dialog box. Information about individual entities can be found in the list of entities.

Class Info Tab

Hammer objectproperties1.png

Warning:Adding quotation marks in any parameter will result in a compiling error like "Unexpected End of File". A source map with such comments will crash Hammer when the file is loading.

To fix this, edit the VMF file with a text editor such as Notepad or Notepad++. Usually Hammer will crash immediately when the VMF is saved if an invalid parameter exists; if this happens, search the file for any information you can remember about the object that was being edited. Try the object name, texture name, and entity names. The quotation marks that surround the parameter should not be removed - remove only the quotations inside the parameter. It is recommended to create a backup of the file before attempting to edit it yourself.


This drop-down list contains all the entities available on the selected object.


Clicking this button will open the help dialog for the selected entity class. The help dialog gives a description of the entity, its keyvalues, as well as all of its Inputs and Outputs.


This is a list of the different parameters that can be changed on the entity. Click on an category (or Key) on the left, and the data (value) for that key is displayed in the box to the right. You can change values for the entity by typing in the field.


The angle control is comprised of two parts - the Angle text box and the angle compass. These two allow you to accomplish the same thing - setting an angle between 0 and 359. The Angle text box also allows you to choose "up" and "down" which correspond to angles -1 and -2.


Some entity properties - those that require a path/filename of a sprite, sound, or model - will have a Browse button beside their property when you click on them. Clicking on this button will allow you to browse through the appropriate game directory for the sprite, sound, or model. This behavior is controlled by the game data file. For more information on that, see FGD.


Some entity properties - those that point to another named entity, have a Mark button. When pressed, the selection switches from the current entity to the entity named in the value field.

Mark + Add

Works identical to Mark, except that it adds the marked item to the selection instead of switching the selection to it.


Clicking this button will turn the mouse cursor into the eyedropper icon. Clicking on any named entity in the 3D view will paste the clicked entity's name into the value field. Note that the entity clicked must have a name, or the eyedropper will have no data to paste.


This will copy all the keyvalues and parameters from the currently selected entity to the clipboard. This is independent of the standard Copy command.


This will paste the keyvalues in the clipboard onto the currently selected entities. This is independent of the standard Paste command.


Allows you to enter comments for the entity. This information is saved with the map. Useful for documenting the purpose of the entity in your map. For example, "This entity triggers the gate to open when the player walks into the room."


Object Properties with SmartEdit disabled.

Class Info has two modes, a regular editing mode and SmartEdit (toggled by the SmartEdit button). When you use the SmartEdit mode, all of the entity's keyvalue (entity variable) descriptions are shown to you. This button turns off the "friendly" interface to the keyvalue data and lets you edit keys and values directly, for advanced users.

Outputs Tab

List all of the Outputs for the current entity, and lets you add additional Outputs that the selected entity fires. See Inputs and Outputs for more information on working with Outputs.

Hammer objectproperties3.png

Inputs Tab

Shows all of the Inputs to the current entity. Double-click an Input to go to the Outputs tab of the entity that originated the Input. See Inputs and Outputs for more information on working with Outputs.

Hammer objectproperties4.png

Flags Tab

You will find listed here all the available flags for an entity. This section is only available when editing an the properties of entities. A flag allows you to toggle on or off specific features of an entity. If more than one entity is selected, some of the flag checkmarks may appear gray. This signifies that the flag is enabled on only some of the selected entities. More information on flag usage for specific entities can be found in the list of entities.

Hammer objectproperties5.png

VisGroup Tab

This section allows you to assign the selected object to a VisGroup or remove it from one. To assign the objects to a VisGroup, simply select the VisGroups from the list. All selected objects will be assigned to the VisGroups you select. An object can be in any number of VisGroups. Pressing Edit groups opens the Edit VisGroups dialog. For more information on VisGroups, see Grouping and VisGrouping.

Hammer visgroup4.png

See also