Template:Archived Page History/Source 2/Docs/Level Design/Hammer Overview/en: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{langsp}}
{{APH|Source 2/Docs/Level Design/Hammer Overview}}
{{Note|This article was originally written for {{Dota2|4}}, but the content of this page also largely applies to all other {{src2|4}} games.}}
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.
[[File:Hammer overview default01.png|800px|thumb|center|The default Hammer layout]]
 
== 3D Viewport ==
This shows you a 3D view of your map and allows you to navigate around, as discussed in the [[Dota 2 Workshop Tools/Level Design/Navigation|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 ({{Key|F6}}) and Fullbright ({{Key|F5}}).
 
[[File:hammer_overview_3d_viewport.png|600px|thumb|center|View of the 3D viewport.]]
 
 
== 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.
 
* {{Key|Ctrl|Spacebar}} cycles between top, front, and side views.
* {{Key|Ctrl|A|Spacebar}} with a selection cycles between top, front, and side views centering the view on that selection.
 
[[File:hammer_overview_2d_viewport.png|600px|thumb|center|View of the 2D viewport. You can set this 2D view to be from the Top, Front, or Side.]]
 
== Customizing Window Panes ==
[[File:Hammer overview popout.png|200px|thumb|right|A pane highlighting the pop out and close buttons.]]
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.
 
{{Tip|If the panes discussed in the following article are missing, or if you're unsure how to recover a closed window/pane, you can restore your layout via ''View'' -> ''Toolbars'' -> ''Default 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. {{Key|Shift|S}} for ''Selection Tool'', you will be switched to that tool from whichever one you were in.
 
{{tip|Hammer will display shortcut Keys when hovering the mouse over buttons. Most commonly used buttons have shortcut Keys associated with them.}}
 
 
[[File:hammer_overview_icon_selection_tool.png|42px|left]]
 
=== 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.
 
* {{Key|Shift|S}} - Selection
 
 
[[File:hammer_overview_icon_translate_tool.png|42px|left]]
 
=== Translate Tool ===
[[File:Hammer overview snap settings.png|300px|thumb|right|Snap settings; Located bottom right side in Hammer.]]
 
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 {{Key|Ctrl}} while translating the selection.
 
* {{Key|T}} - Translate
* {{Key|Ctrl|LMB|}} - While translating a selection this temporarily disables grid snapping
* {{Key|[}} and {{Key|]}} - Change grid size in power of two increments
 
{{tip|Grabbing the small purple origin on the ''Translate Tool'' will allow movement on any axis but more importantly will snap the selection to the surface of another element. Useful for quick prop placement.}}
 
 
[[File:hammer_overview_icon_rotate_tool.png|42px|left]]
 
=== 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.
 
* {{Key|R}} - Rotate
* {{Key|Ctrl|LMB|}} - While rotating this temporarily disables the angle snap settings
* ''Angle'' - Bottom right of the Hammer window defines snap angle
 
 
[[File:hammer_overview_icon_scale_tool.png|42px|left]]
 
=== 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.
 
{{Tip| After dragging the scale tool along a given axis, you can use the NumPad to input values to scale by that percentage amount. For example, if you drag the center purple cube and then input "2.0" on the numpad it will scale it double what is it's original size. }}
 
* {{Key|E}} - Scale
 
 
[[File:hammer_overview_icon_pivot_tool.png|42px|left]]
 
=== 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.
 
* {{Key|Insert}} - Enter/Exit Pivot Tool
* {{Key|End}} - Reset Pivot
* ''Set Origin To Pivot'' - Only applies to meshes but can be used to save the pivot point for future selections
 
 
[[File:hammer_overview_icon_entity_tool.png|42px|left]]
 
=== 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.
 
* {{Key|Shift|E}} - Entity Tool
* {{Key|Alt|Enter}} - Opens properties for a placed entity
 
 
[[File:hammer_overview_icon_block_tool.png|42px|left]]
 
=== 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.
 
* {{Key|Shift|B}} - Block Tool
* {{Key|Esc}} - Cancel creation
* {{Key|Enter}} or {{Key|Space}} - Confirm creation
* Holding {{Key|Shift}} while drawing a brush will automatically set a temporary workplane to that surface under your cursor.
 
{{tip|When confirming a shape created by the ''Block Tool'', changing to a mode such as ''Edges'' will select all edges on the newly created shape.}}
 
[[File:hammer_overview_icon_clipping_tool.png|42px|left]]
 
=== 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 {{Key|Enter}}, 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.
 
* {{Key|Shift|X}} - Clipping Tool
* {{Key|Enter}} - Confirm cut
 
 
[[File:hammer_overview_icon_mirror_tool.png|42px|left]]
=== 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.
 
* {{Key|Shift|F}} - Mirror
 
 
[[File:hammer_overview_icon_texture_projection_tool.png|42px|left]]
 
=== 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.
 
* {{Key|Shift|P}} - Texture Projection
 
 
[[File:hammer_overview_icon_paint_tool.png|42px|left]]
 
=== Paint Tool ===
The ''Paint Tool'' allows blending of materials on displacement geometry (often referred to as terrain but not limited to ground type materials).
 
* {{Key|Shift|V}}
 
 
[[File:hammer_overview_icon_displacement_tool.png|42px|left]]
 
=== 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.
 
{{note|Requires a face to be subdivided. The tool will not work on regular geometry. This can be accomplished in the ''Face'' selection properties and selecting an appropriate subdivision amount}}
 
* {{Key|Shift|D}} - Displacement Tool
 
{{tip|Dota 2 terrain is comprised of a lot of smaller subdivided terrain. This is generally not shaped with the ''Displacement Tool'' due to the gameplay requirement of gameplay surfaces being completely flat.}}
 
 
[[File:hammer_overview_icon_asset_spray_tool.png|42px|left]]
 
=== 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.
 
 
[[File:hammer_overview_icon_tile_editor.png|42px|left]]
 
=== 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 [[Dota_2_Workshop_Tools/Level_Design/Tile_Editor|Tile Editor introduction]] for details.
 
{{note|Selecting this tool for the first time in a map without tiles will auto-generate a large space to paint tiles in. If this is undesirable, this newly-created ''Tile Grid'' can be selected in the ''Outliner'' pane and deleted like any other object.}}
 
 
[[File:hammer_overview_icon_path_tool.png|42px|left]]
 
=== Path Tool ===
[[File:Hammer overview path tool.png|150px|thumb|right|The default path tool settings.]]
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.
* {{Key|Shift|P}} - Path Tool
 
 
 
[[File:hammer_overview_icon_physics_simulation.png|42px|left]]
 
=== Physics Tool ===
[[File:Hammer overview physics simulation tool.png|150px|thumb|right|The tool with nothing selected.]]
''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 {{Key|Space}}.
* {{Key|Shift|C}} - Physics Simulation Menu
* {{Key|Space}} - Toggles the simulation.
* {{Key|LMB}} - On the currently simulated objects, click dragging an object will move it around.
{{clr}}
 
[[File:hammer_overview_icon_mesh_projection_tool.png|42px|left]]
 
=== Mesh Projection Tool ===
[[File:Hammer overview mesh projection tool.png|150px|thumb|right|The settings of Mesh Project.]]
''Mesh Projection'' projects a selected mesh or mesh components onto the visible objects in the world using the projection direction selected in the tool.
* {{Key|Space}} - Reprojects based on the settings.
* {{Key|Enter}} - Confirms the projection
* {{Key|Esc}} - Cancels the projection
 
== Selection Modes ==
[[File:hammer_overview_selection_modes.png|400px|thumb|center|The different 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 [[Dota 2 Workshop Tools/Level Design/Basic Construction|Basic Construction]].
 
* {{Key|1}} ''Vertices''
* {{Key|2}} ''Edges''
* {{Key|3}} ''Faces''
* {{Key|4}} ''Meshes''
* {{Key|5}} ''Objects''
* {{Key|6}} ''Groups''
 
== Undo History ==
[[File:Hammer overview undo history.png|150px|thumb|right|Example of clicking to undo a set of actions.]]
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 {{Key|Ctrl}}+{{Key|Z}} a large number of times to get to your desired map state.
 
* {{Key|Ctrl|Z}} - Undo
{{clr}}
 
== Command History ==
[[File:hammer_overview_command_history.png|150px|thumb|right|Command History.]]
 
{{Note|Command history is not on by default. Look in View > Toolbars to enable it.}}
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 [[Dota 2 Workshop Tools/Level Design/Command History|Command History]].
 
* {{Key|Shift|G}} - Repeat single command
{{clr}}
 
== Outliner ==
[[File:hammer_overview_outliner.png|150px|thumb|right|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.
{{clr}}
 
== Selection Sets ==
[[File:hammer_overview_selection_sets.png|150px|thumb|right|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.
 
* {{Key|Ctrl|R}} - Create selection set
{{clr}}
 
== Object Properties ==
[[File:Hammer overview object properties 01.png|600px|thumb|right|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.
 
* {{Key|Alt|Enter}} - Object Properties
{{clr}}
 
== Active Material ==
[[File:hammer_overview_active_material.png|150px|thumb|right|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.
 
* {{Key|Ctrl|M}} - Lift material under the cursor and make it the new active material
* {{Key|Shift|T}} - Apply active material to the currently selected face or mesh
{{clr}}
 
== Assets Tabs ==
[[File:Hammer overview assets tabs01.png|500px|thumb|center|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''.
 
{{tip|Any of the viewports can be changed to the ''Asset'' pane by clicking the drop down button in the top right of any given viewport.}}
{{clr}}
 
== 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").
* {{Key|F1}} will open a help menu that shows all the command categories.
** {{Key|RMB}} -> ''All Commands'' does the same as above.
** Either search through the categories or use the filter field to search for a command.
 
 
'''Next''': [[Source 2/Docs/Level Design/Basic Construction|Basic Construction]]

Latest revision as of 14:24, 18 August 2024

Note.pngNote:Archived rest of page history of page Source 2/Docs/Level Design/Hammer Overview
Icon-Important.pngImportant:These pages are linked often from page history logs so Special:WhatLinksHere will not show anything.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Template:Archived_Page_History/Source_2/Docs/Level_Design/Hammer_Overview/en&oldid=445625"