Source 2/Docs/Level Design/Hammer Overview

Most of the Hammer interface can be moved around and changed to suit the individual user, with the exception of the main editing windows. These have a variety of layout options, but cannot be moved around.
== 3D Viewport ==
This shows you a 3D view of your map and allows you to navigate around, as discussed in the Navigation tutorial earlier. Much of your work will be done in this viewport.
You can adjust the lighting used in this viewport by toggling between All Lighting () and Fullbright ().
== 2D Viewport ==
The 2D viewport gives you a top, front, or side view of your map, which can be useful when you want to see an object from a certain view or work on geometry in a way that's constrained along certain axes.
* cycles between top, front, and side views.
* with a selection cycles between top, front, and side views centering the view on that selection.
== Customizing Window Panes ==
Almost any pane can be popped out or closed using the small buttons in the top right of a pane. The small overlapped windows icon can be used to pop the pane out. Once a pane is popped out it can be re-sized and dropped back into the layout. A pane can also be closed using the small "X".
This overview assumes a default Hammer layout.
== Tools ==
Covers the various tools for accomplishing tasks in Hammer. When a tool is active, the Tool Properties pane to the right shows its unique properties and commands.
Tools are globally accessible. This means that if you hit the Key associated with another tool, e.g. for Selection Tool, you will be switched to that tool from whichever one you were in.
=== Selection Tool ===
The Selection Tool is the default tool when Hammer is started and is the most basic way to select geometry elements (vertices, edges, faces, meshes), objects, and groups. Once a selection is made it can be manipulated via the various other tools available.
* - Selection
=== Translate Tool ===
The Translate Tool allows movement of a selection along the X, Y, or Z axis. Drag the gizmo's red arrow for X-axis movement, green arrow for Y-axis movement, or blue arrow for Z-axis movement. You can also grab the colored squares to translate the object along two axes at once. Translation distance is dictated by grid size but can be overridden by holding while translating the selection.
* - Translate
* - While translating a selection this temporarily disables grid snapping
* and - Change grid size in power of two increments
=== Rotate Tool ===
The Rotate Tool allows rotation of models along any axis. The gizmo will change to red, green, and blue circles and dragging any of these will rotate the object along the desired axis. It is possible to rotate along multiple axes by dragging the yellow sphere in the center of the gizmo (hidden until hovering the pointer over it). The angle at which that rotation snaps is determined by the value provided for Angle at the bottom right of Hammer.
* - Rotate
* - While rotating this temporarily disables the angle snap settings
* Angle - Bottom right of the Hammer window defines snap angle
=== Scale Tool ===
The Scale Tool allows you to scale geometry and models. Its gizmo is composed of red, green, and blue cubes. Drag the red cube to scale your geometry along the X axis, green to scale along the Y axis, blue to scale along the Z axis. Similar to Translate, you can scale along two axes at once by dragging the appropriate squares. It is also possible to scale along all three axes at once by dragging the purple cube at the origin of the gizmo.
* - Scale
=== Pivot Tool ===
The Pivot Tool allows changing of a selection's pivot point. Various tools use the pivot point to determine how to act upon your selection. For example, if rotating a cube around a pivot that's located in the cube's exact center, the cube will spin in place. Moving the pivot to one of the cube's corners will cause it to rotate around that specific corner. Moving an element's pivot point is a temporary setting, unless you use Set Origin To Pivot. Deselecting and re-selecting will reset the pivot point.
* - Enter/Exit Pivot Tool
* - Reset Pivot
* Set Origin To Pivot - Only applies to meshes but can be used to save the pivot point for future selections
=== Entity Tool ===
The Entity Tool allows placement of any type of entity class in your map. These include things like lights, player spawn locations, AI spawn locations, logic relays, props, etc.
* - Entity Tool
* - Opens properties for a placed entity
=== Block Tool ===
The Block Tool will create basic meshes. The most commonly used mesh is usually the 'block', hence the name of the tool. The usual workflow is to place basic geometry in the world and then use the more precise geometry editing tools (translate, rotate, scale) to hone in on the desired shape of the geometry.
Some of the other geometric shapes have presets to modify ahead of time to get different shapes. For example, the cylinder can make quick columns, arch can create arched doorways or spiral staircases, and so on.
* - Block Tool
* - Cancel creation
* or - Confirm creation
* Holding while drawing a brush will automatically set a temporary workplane to that surface under your cursor.
=== Clipping Tool ===
The Clipping Tool will slice geometry in a variety of ways. Cuts must be made in the 2D viewport and must be confirmed with , otherwise the change is discarded. The Clipping Tool has three different modes that determine whether it keeps the geometry on one side of the cut, the other side of the cut, or both sides of the cut. Cycle through these by repeating the shortcut Key.
* - Clipping Tool
* - Confirm cut
=== Mirror Tool ===
The Mirror Tool allows mirroring of a selection across a user-defined axis. In the 2D view, click and drag a line to choose which axis it will use to mirror.
* - Mirror
=== Texture Projection Tool ===
The Texture Projection Tool is used to do basic UV mapping. Can be useful for complex geometry that needs fine tuning. There are more automated methods for UV mapping covered in other parts of the documentation.
* - Texture Projection
=== Paint Tool ===
The Paint Tool allows blending of materials on displacement geometry (often referred to as terrain but not limited to ground type materials).
* 
=== Displacement Tool ===
The Displacement Tool is a method to sculpt geometry inside Hammer using displacements as a base. One usage case for this tool is to build rolling hills for a terrain-based map.
* - Displacement Tool
=== Asset Spray Tool ===
The Asset Spray Tool is a work-in-progress, unsupported tool that allows any asset to be "painted" onto surfaces in the world.
=== Tile Editor ===
The Tile Editor allows the easy creation of custom maps using a set of predefined tiles that link together to form a playable gameplay space. In Tile Editor, you can paint terrain, water, paths, trees, plants, and even place shops, barracks and other gameplay objects. See the Tile Editor introduction for details.
=== Path Tool ===
The Path Tool is the tool for making paths. You can use this to make prop based splines for curved geometry. There's a few types of rope you can add: Generic Path, Static Cable, Trajectory Path, move_Keyframed, move_rope, move_track, and path_particle_rope. The path_particle_rope uses particles as rope. Set it from selecting a particle from the asset browser.
* - Path Tool
=== Physics Tool ===
Physics Simulation allows you to use the prop_physics abilities in the editor. Open the menu, select a prop_physics and click Start Simulation or press .
* - Physics Simulation Menu
* - Toggles the simulation.
* - On the currently simulated objects, click dragging an object will move it around.
=== Mesh Projection Tool ===
Mesh Projection projects a selected mesh or mesh components onto the visible objects in the world using the projection direction selected in the tool.
* - Reprojects based on the settings.
* - Confirms the projection
* - Cancels the projection
== Selection Modes ==
Your active Selection Mode defines the element that can be selected. Vertices, edges, faces, meshes, objects, groups, bones, and navigation are all valid selection modes.
Selection modes are covered in more detail in Basic Construction.
* Vertices
* Edges
* Faces
* Meshes
* Objects
* Groups
== Undo History ==
Each action taken in Hammer will appear in the Undo History. Clicking on a previous change which will change the state of the map to that point in time. There are cases where this is a much clearer and faster way of undoing changes than using + a large number of times to get to your desired map state.
* - Undo
== Command History ==
Any action performed in Hammer gets tracked as a command in the Command History pane. The Repeat Commands can be used in conjunction with the selected command (or multiple selected commands) to repeat the desired action.
For more on this see Command History.
* - Repeat single command
== Outliner ==
The Outliner pane provides a view of all the objects in a map. Objects can be selected here much like in the 2D or 3D view. Basic searches can be run via the Mapnode name filter field. Advanced filtering options are located under the Entity filter options checkbox, which allows searching of entities by various class and/or any Key/value combinations.
== Selection Sets ==
The Selection Sets pane displays all the objects in the map. The Auto selection set is generated automatically and contains all the objects in a map. Custom selection sets can be defined via the New Selection Set button. You can use the buttons to the left of a category to hide or show objects en masse.
It may be desirable to place an entire region of a map in a selection set to easily toggle on/off. This would be accomplished via a new custom selection set to help keep the map more organized. This is especially useful in very complex or large maps.
To add objects to an existing selection set, simply select what you would like to add and press the Key combination. Choose the existing set from the drop-down menu and click OK.
* - Create selection set
== Object Properties ==
The Object Properties pane displays the various properties that can be changed on any given object. Object Properties contains everything that defines a particular entity, and also includes the Input and Output tabs of the logic system.
* - Object Properties
== Active Material ==
Displays the currently active material. Any geometry created will have this material applied to it. Click the Browse button to set it to a different material. When in Faces selection mode, right-clicking a face and choosing Lift Material Under Cursor from the drop-down menu will make it the active material.
* - Lift material under the cursor and make it the new active material
* - Apply active material to the currently selected face or mesh
== Assets Tabs ==
Similar in setup to the Asset Browser, this contains tabs for each of the various types of pieces of content used to create a map: Materials, Decals, Models, Particles, Prefabs, and Selection.
== Useful Settings ==
* Tools -> Options -> View 3D
** Backplane Distance: Change this value to adjust how far map geometry renders in the 3D viewport. This can help with rendering performance in large complex maps.
** Forward Speed Max: Adjusts how quickly the camera moves through the 3D viewport.
* Toggle Grid Navigation Preview: Displays Dota 2's navigation grid inside of Hammer highlighting pathable and unpathable regions.
* Tools -> Options -> Key Bindings can be used to see a list of all Hammer commands
** Note: This only shows commands that have hotKeys associated with them.
** Use the filter field to search for a particular context (e.g. "ToolSelection") or a particular command (e.g. "merge").
* will open a help menu that shows all the command categories.
** -> All Commands does the same as above.
** Either search through the categories or use the filter field to search for a command.
Next: Basic Construction
Category:Level Design/Source 2