View source for User:Cvoxalury/Hammer

{{DISPLAYTITLE:Hammer}}
{{src topicon}}
{{LanguageBar}}
'''{{hatnote|This article is about the official level editor for Half-Life 2 and other Source titles.}}'''
'''{{For|the level editor for Half-Life and GoldSrc titles|[[Valve Hammer Editor]]|}}'''
'''{{For|Source 2 titles|[[Hammer (Source 2)]]|}}'''
[[File:Hammer splash.png|thumb|right|Hammer 4.x splash screen.]]
[[File:Hammer screen.jpg|thumb|right|Main view of Hammer 4.1.]]
'''Hammer 4.x''' is [[Valve]]'s in-house level editor for {{src|1}} titles, included in the [[Source SDK]]. It is a further evolution of [[Valve Hammer Editor|Hammer 3.x]]. Many of its core concepts, features, and UI elements still match those of 3.x, as does the underlying mapping theory: building [[Leak|sealed]] levels with [[Brush|brushes]] and compiling them into [[BSP]] maps. 

While in many ways improved, its core is still tied to ancient software architecture, and, being a product of its time, it often stuggles under the load of designing modern-looking levels. 

Despite that, {{hl2|1.bold}} and every other Source title was built with it. Its relative ease of entry and gradual learning curve attract modders to this day.
{{ModernImportant|There are several community-made updates to Hammer (unfortunately, none are open-source, as the source code for Hammer has never been officially released, only either leaked, or available to licensees who kept it closed).<br>They are not essential for creating Source levels, but include bugfixes, QoL and extended features. '''They are [[User:Cvoxalury/Hammer#Community fixes|listed further below]]'''.}}

== Installing and launching ==
Older versions of Hammer are shipped in their respective [[Source SDK]] packages, and are intended to be launched via the Source SDK Launcher.

Since the [[Steampipe]] update, Hammer is installed automatically with the games, and is available in the {{path|<nowiki>/bin/</nowiki>}} folder of a particular game ({{path|<nowiki>Half-Life 2/bin</nowiki>}}, {{path|<nowiki>Portal/bin</nowiki>}}, etc). However, in some cases, such as with {{p2|1.bold}} and {{l4d|1.bold}}, their '''Authoring Tools''' need to be installed and launched to access '''Hammer'''.

Some of these sub-versions are interchangeable, such as between HL2, [[Episode 1|both]] of its [[Episode 2|Episodes]], Portal, {{css|1.bold}} and {{src13|1.bold}}. Others, such as Portal 2's and {{csgo|1.bold}}, have certain exclusive features ({{w|icon=0|Maya}} integration for P2, [[Sprinkle]] Tool for CS:GO) and may not be fully compatible with other titles. 

For further information on setting up Hammer for Source, see [[Your First Map]], [[Getting Started]] and its following articles. 

See also [[:Category:Hammer]] for more links to Hammer documentation.

== Features and tools ==
{{stub}}
Compared to Hammer 3.x, the most notable new features include [[Displacements]], [[I/O]] system, and using Source's own materialsystem for rendering textures and models. Later versions expanded on the user interface, adding the particle browser (since ASW), improved Model Browser, [[Instance|instances]] and other extra tools.

{{seealso|[[:Category:Hammer Toolbars]]}}

== Community fixes ==
* {{slamminsrc|1.bold}} addresses performance and bug issues, adds convenience options and features, and comes with extended compilers: '''[[Slammin' Source Map Tools|Slammin' Compile Tools]]''';
* {{hammer++|1.bold}} updates Hammer with additional tools and modernized workflow, realtime in-editor lighting preview, in-editor physics and more. It is based on the no longer available [https://web.archive.org/web/20201006134116/https://github.com/Gocnak/sdk-2013-hammer "SDK 2013 Hammer"] project, which closed off access after its developers started working with an engine license;
* {{TeamSpen's Hammer Addons|1.bold}} is a set of [[FGD]] enhancements, editor assets and scripts for working with Hammer, which don't directly modify the editor.

== Developer resources ==
* [[Level Design Video Tutorials]] - a large collection of videos on mapping techniques and tricks across multiple Source titles.
* [[Mapping Sites]] and [[General Sites]] - listing of forums and resources in various languages.
* [[Map Archive Sites]] - for downloading existing maps (primarily for '''Half-Life 2''').
* See [[:Category:Level Design]] for all documentation on the subject.

== Common issues ==
{{seealso|[[Compile Errors]]}}
=== No grid (black viewports) ===
First, check that the grid is on. The hotkey {{Key|Shift|R}} controls, so give it a try.

If that didn't help, check the formatting of your mod's {{path|gameinfo|txt}}. 

It needs to include a key called {{code|SteamAppId}}, and the number after it needs to match the [[Steam Application ID]] of the base game you will be using to launch your mod.

This issue may also be caused by using a different Hammer version than the one intended for the game. To stay on the safe side, be sure to be launching {{path|hammer|exe}} from the {{path|<nowiki>/bin/</nowiki>}} folder of the base game of your mod, or using Authoring Tools to launch it, if you're modding '''Portal 2''', '''Left 4 Dead''' or '''Left 4 Dead 2''' or '''Counter-Strike: Global Offensive'''.

=== Poor performance ===
The fault is inherent to Hammer's 32-bit and single-thread architecture. It will struggle to display too many detailed objects and draw levels across vast distances; this is even apparent with '''Half-Life 2''''s own stock levels. To make matters worse, having a large number of visible objects - ''regardless'' of what they are or how low-poly they are - will degrade both performance and input times, and make everything like selecting, editing settings, or moving objects take longer. 

To fix it, keep the Model and Detail render distance in the 3D View tab of the Settings, on the lower side.
{{Tip|Hotkeys {{Key|1}} and {{Key|2}} move the 3D view clipping plane back and forth - you can use it to quickly adjust it and thus lessen the rendering load on the editor.}}

Make sure you didn't accidentally turn on '''Radius Culling''' by pressing {{Key|C}}. This easy to press hotkey can cause huge performance loss and, to add insult to injury, make your level ''not compile'' until it is turned off.

The '''Radius Culling''' status is indicated by a circled red "R" on the [[Hammer Map Operations Toolbar|Map Operations]] toolbar. '''Make sure it is de-pressed''', unless you actually intend to use it.
{{Note|Depending on the Hammer version, the button and the feature itself may not be present altogether. Older - pre-[[Steampipe]] - Hammer didn't have it, while '''Slammin' Hammer''' and '''Hammer++''' keep it off by default and remove the hotkey.}}

== Version history ==
{| class="standard-table mw-collapsible mw-collapsed"
|- style="position:sticky; top:0; z-index:10"
! style="background:#666666; text-align:center; width:5em" | Version
! style="background:#666666; text-align:center; width:15em" | Game/Branch
! style="background:#666666; text-align:center; width:10em" | Release date
! style="background:#666666; text-align:center" | Features
|-
| 4.0
| All {{src04|1.bold}} games
| November 05, 2004
| Initial release of Hammer in the Source SDK.

'''Updates:'''
* '''Source Engine materials system'''. Materials created with the Source Engine's advanced shader-based texturing system are properly rendered inside the Hammer Editor. 
* '''Displacement surfaces'''. A new class of mesh geometry that can be sculpted into different shapes and connected to one another to create terrain and other complex surfaces.
* '''Input and Outputs entity system'''. Entities use a new method to trigger and connect to one another, offering a higher level of flexibility and control than ever before. 
* '''Hierarchical VisGroups'''. Objects can now be in multiple VisGroups, and Visgroups can be organized in a hierarchical manner for easier selection and organization.
* '''Entity Helpers'''. New user interface controls that make editing parameters on entities such as spotlights and doors easier and clearer.
* '''Per-face Lightmap controls'''. Lightmap density can be controlled on a per-face basis for more control over the balance of visual quality and rendering performance. 
* '''Sound Browser'''. Built-in browser to hear a preview of sounds available to level designers.
* '''Non-modal Entity Report and Check for Problems dialogs'''. Dialogs are now non-modal, allowing for changes in the level and camera controls while using the information in the dialog boxes.
* '''Smoothing Groups'''. Per-face control of lighting-based smoothing. 
* '''Find and Replace'''. Functions to both search and replace for text in any entity name, parameter, input, or output.
* '''Selection Mode toolbar'''. A new toolbar to control the impact of groups and entities upon the selection tools. 
* '''Overlays'''. A new type of texture entity, similar to decals, but with far greater control over how it is applied to surfaces.
|-
|4.1
| {{hl2lc|1.bold}}, All {{src06|1.bold}} games and newer<!-- HDR was first introduced in HL2 Lost Coast, which was probably run on special build of Source 2004 or a beta 2006 build when it came out in 2005.-->
|November 22, 2005
|
'''Updates:'''
* '''HDR tools support'''. High Dynamic Range levels can be compiled and run from Hammer.
* '''VGUI Model Browser'''. All new model browser with a full tree control and real-time 3D previewing of model geometry, rendered with the Source material system.
* '''Enhanced 2D and 3D Views'''. 2D and 3D views are now rendered with a unified Source materials system, allowing for real-time feedback of transformations in all viewports simultaneously, and much faster rendering of the viewports. 
* '''2D model and displacement Rendering'''. Prop models and displacement geometry rendering in 2D viewports.
* '''Enhanced Auto Visgroups'''. A larger number of Visgroup categories, as well as an improved interface makes Visgroups more powerful.
* '''Autosave feature'''. Creates automatic, numbered backups of maps, with options for when and where backups are created.
* '''Paste Special enhancements'''. Provides options for renaming objects when pasted to avoid name collisions with automatic entity I/O fixup.
|-
|4.1
| {{src07|1.bold}}
| October 10, 2007
|
'''Updates:'''
* '''Inspecting Leaves in Hammer'''. You can now see [[visleaves]] using the Load Portal File option in Hammer, instead of using the {{code|glview}} application.
{{Todo|Add more updates and changes in Source 2007 Hammer.}}
|-
|4.1 (unknown build)
| {{l4d|1.bold}}
| June 25, 2009
| Initial release of {{l4dtools|1.bold}}'s Hammer.
|-
|4.1 (unknown build)
| {{l4d2|1.bold}}
| Between November 17, 2009 and December 26, 2009
| Initial release of {{l4d2tools|1.bold}}'s Hammer.<br>{{Question|When L4D2 tools was actually released?}}
|-
|4.1 (unknown launch build)<!-- Only fill the build from the very first version of SDK. -->
| {{as|1.bold}}
|July 19, 2010
| [[Valve Map Format]] (.vmf) that are created using this version are incompatible<br> with previous version of Hammer without some modification and workarounds (such as using '''Left 4 Dead Authoring Tools'''/'''[[L4D2 Authoring Tools|Left 4 Dead 2 Authoring Tools]]''' or editing VMF files).
'''Updates:'''
* Added a way to export the selected brushes to Maya. 
|-
|4.1 (unknown build)
| {{p2|1.bold}}
|May 6, 2011
| Initial release of {{p2tools|1.bold}}'s Hammer.{{confirm}}
|-
|4.1 (unknown build)
| '''Portal 2'''
|May 12, 2011
| 
'''Fixes:'''
* Fixed certain keystrokes being ignored by Hammer when browsing models
|-
|4.1 (unknown build)
| '''Portal 2'''
|May 17, 2011
| 
'''Fixes:'''
* Fixed crash that could occur when malformed brushes were saved in a map and then re-opened in Hammer.
* Hammer will now properly save maps after detecting and fixing malformed brushes. Fixes “Permission Denied” error some users were experiencing.
* Removed “Lighting Preview” option as this is not currently supported.
|-
|4.1 (unknown build)
| '''Portal 2'''
|May 20, 2011
| 
'''Fixes:'''
* Fixed Hammer becoming unresponsive after launching map
|-
|4.1 (unknown build)
| '''Portal 2'''
|May 26, 2011 to May 21, 2012
| Unknown
|-
|4.1 (BETA, unknown build)
| {{csgo|1.bold}}
|May 5, 2012 (or earlier){{confirm}}
| Initial release of {{csgotools|1.bold}}'s Hammer.
|-
|4.1 (unknown launch build)
| {{csgo|bold}}
|August 21, 2012
| Launch version of {{csgotools|1.bold}}'s Hammer.
|-
|4.1 (build 8678)
| '''Alien Swarm'''
|September 24, 2020
| Latest version for '''Alien Swarm'''.
|-
|4.1 (build 9008)
| {{src13|1.bold}}
| July 2, 2021
| Latest version for {{dods|1.bold}}, {{hl2dm|1.bold}} and {{src13mp|1.bold|nt=0}}
|-
|4.1 (build 9092)
| {{tf2|1.bold}}
| September 16, 2021
| Unknown
|-
|4.1 (build 9109)
| '''Team Fortress 2'''
| October 5, 2021
| Unknown
|-
|4.1 (build 9464)
| '''Team Fortress 2'''
| September 26, 2022
| Unknown
|-
|4.1 (build 9520)
| {{hl2|1.bold}}
| November 17, 2023
| Latest version for {{src13|1.bold}} {{hl2|only}}.
|-
|4.1 (build 9540)
| '''Team Fortress 2'''
| December 8, 2022
| Unknown
|-
|4.1 (build 10038)
| '''Team Fortress 2'''
| April 18, 2024
| Added a dedicated 64 bit version.
|-
|4.1 (build 10042)
| '''Team Fortress 2'''
| April 22, 2024
| Latest version for {{tf2|4}}.
|}