Setting up Hammer - Revision history

Admin: name

2026-02-20T19:14:44Z

name

← Older revision		Revision as of 19:14, 20 February 2026
Line 10:		Line 10:
	# Run {{code\|hammerplusplus.exe}}.		# Run {{code\|hammerplusplus.exe}}.

	As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. ~~Ficool~~'s compilers [https://ficool2.github.io/HammerPlusPlus-Website/tools.html (VBSP++/VVIS++/VRAD++)] have a superset of our compiler's functionality, however some features like ambient occlusion may need to be retuned, as VRAD++ takes different parameters than ours.		As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. ficool2's compilers [https://ficool2.github.io/HammerPlusPlus-Website/tools.html (VBSP++/VVIS++/VRAD++)] have a superset of our compiler's functionality, however some features like ambient occlusion may need to be retuned, as VRAD++ takes different parameters than ours.

	== Step 2: Configuring VRAD ==		== Step 2: Configuring VRAD ==

Admin: Tools++ work on TF2C and no longer have any meaningful missing features, adjust documentation accordingly

2026-02-20T19:13:59Z

Tools++ work on TF2C and no longer have any meaningful missing features, adjust documentation accordingly

← Older revision		Revision as of 19:13, 20 February 2026
Line 10:		Line 10:
	# Run {{code\|hammerplusplus.exe}}.		# Run {{code\|hammerplusplus.exe}}.

	As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. VBSP++ ~~and~~ VRAD++ ~~are not supported as they are missing TF2C-specific~~ features ~~we use~~, ~~but VVIS~~++ ~~should work if you wish to use it~~.		As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. Ficool's compilers [https://ficool2.github.io/HammerPlusPlus-Website/tools.html (VBSP++/VVIS++/VRAD++)] have a superset of our compiler's functionality, however some features like ambient occlusion may need to be retuned, as VRAD++ takes different parameters than ours.

	== Step 2: Configuring VRAD ==		== Step 2: Configuring VRAD ==

NinjaV: formatting

2026-02-16T01:57:10Z

formatting

← Older revision		Revision as of 01:57, 16 February 2026
Line 6:		Line 6:
	# Make sure Team Fortress 2 Classified is installed on Steam.		# Make sure Team Fortress 2 Classified is installed on Steam.
	# Download the latest [https://ficool2.github.io/HammerPlusPlus-Website/download.html Team Fortress 2 build of Hammer++].		# Download the latest [https://ficool2.github.io/HammerPlusPlus-Website/download.html Team Fortress 2 build of Hammer++].
	# Copy the files of the Team Fortress 2 build of H++ into the <code>steamapps\common\Team Fortress 2 Classified~~</code>~~ folder, as if you were installing it for Live TF2.		# Copy the files of the Team Fortress 2 build of H++ into the {{code\|steamapps\common\Team Fortress 2 Classified}} folder, as if you were installing it for Live TF2.
	# Navigate to the <code>steamapps\common\Team Fortress 2 Classified\bin\x64~~</code>~~ folder, and run <code>hammer_tf2c_setup.bat~~</code>~~ (this should be right next to <code>hammerplusplus.exe~~</codE>~~ if you have installed everything correctly).		# Navigate to the {{code\|steamapps\common\Team Fortress 2 Classified\bin\x64}} folder, and run {{code\|hammer_tf2c_setup.bat}} (this should be right next to {{code\|hammerplusplus.exe}} if you have installed everything correctly).
	# Run <code>hammerplusplus.exe~~</code>~~.		# Run {{code\|hammerplusplus.exe}}.

	As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. VBSP++ and VRAD++ are not supported as they are missing TF2C-specific features we use, but VVIS++ should work if you wish to use it.		As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. VBSP++ and VRAD++ are not supported as they are missing TF2C-specific features we use, but VVIS++ should work if you wish to use it.

Technochips: updated guide. based on 14bit's guide.

2026-02-01T00:55:03Z

updated guide. based on 14bit's guide.

@@ Line 1: / Line 1: @@
-This page will walk you through setting up Hammer++ with our custom tools for TF2Classic map development.
+This page will walk you through setting up Hammer++ with our custom tools for TF2 Classified map development.
-Valve's Hammer will not display materials correctly without using the [https://www.moddb.com/mods/mapbase/downloads/mapbase-multi-tool Mapbase Multi-Tool] to create a shortcut. This page will guide you through installing Hammer++ instead, which does ''not'' require using the Multi-Tool.
 __TOC__
 == Step 1: Installing Hammer++ ==
-Now you're ready to get mapping for TF2 Classic!
+# Make sure Team Fortress 2 Classified is installed on Steam.
-=== Configuring VRAD ===
+As of the Steam release (3.0.0) we include new customized versions of the compilers with the game. Older versions of TF2C's VBSP, VRAD, and VVIS are no longer compatible. VBSP++ and VRAD++ are not supported as they are missing TF2C-specific features we use, but VVIS++ should work if you wish to use it.
-In the "Run Map..."/F9 dialog, you should click the "Expert..." button in the bottom-left corner of the panel to view your configurations, and adjust the parameters for the $light_exe command in the configuration you use for your final compile to be:
+== Step 2: Configuring VRAD ==
-Meanwhile, for fast compiles when prototyping your map, you can simply use:
+When preparing a final compile of your map, you need to make sure that the parameters you're passing to VRAD are supported by our custom build. Some, such as -staticproplighting, are now enabled by default and will produce an error if you include them. The default VRAD settings we use for most official TF2C maps are:
-== Troubleshooting ==
+{{pre|-final -hdr -softencosine -ao -aoradius 2 -LargeDispSampleRadius -worldtextureshadows -StaticPropIndirectMode 2 -choptexlights}}
-We recommend deleting output files related to your map or tweaking $light_exe parameters. Specifically, this has sometimes been caused by using '-both' in your VRAD flags, which is now obsolete and recommended against. If you're completely unable to solve it, you can also use the [https://drive.google.com/drive/folders/17pQY8wDkednZi0kMZOSpAtNBNmFWm6GJ Slammin' Source Map Tools] to compile your map. These should be equal, with the exception of lacking support for parallax-corrected cubemaps. These will ''overwrite'' the tools provided by the SDK, so you'll need to modify your Hammer++ configuration again to point to vbsp.exe and vrad.exe. You'll also need to delete the "vrad.redirect" file inside the folder.
+You can add these to your final compile settings in H++ by going to the the "Run Map..."/F9 dialog, click the "Expert..." button in the bottom-left corner of the panel to view your configurations, and add those the parameters to the $light_exe command in your final compile configuration.
 [[Category:Guides]]

NinjaV at 14:49, 31 January 2026

2026-01-31T14:49:53Z

← Older revision		Revision as of 14:49, 31 January 2026
Line 24:		Line 24:
	== Step 3: Configuring Hammer++ for TF2C ==		== Step 3: Configuring Hammer++ for TF2C ==
	=== For the new Team Fortress 2 Classified ===		=== For the new Team Fortress 2 Classified ===
	Go to {{code\|steamDir/steamapps/common/Team Fortress 2 Classified/bin/x64}} and run the {{hammer_tf2c_setup.bat}} file.		Go to {{code\|steamDir/steamapps/common/Team Fortress 2 Classified/bin/x64}} and run the {{code\|hammer_tf2c_setup.bat}} file.

	=== For the legacy Team Fortress 2 Classic ===		=== For the legacy Team Fortress 2 Classic ===
Line 39:		Line 39:

	In the "Run Map..."/F9 dialog, you should click the "Expert..." button in the bottom-left corner of the panel to view your configurations, and adjust the parameters for the $light_exe command in the configuration you use for your final compile to be:		In the "Run Map..."/F9 dialog, you should click the "Expert..." button in the bottom-left corner of the panel to view your configurations, and adjust the parameters for the $light_exe command in the configuration you use for your final compile to be:
	-final -hdr -ambientocclusion -aoscale 0.5 -LargeDispSampleRadius -softencosine -worldtextureshadows -game $gamedir $path\$file		{{pre\|-final -hdr -ambientocclusion -aoscale 0.5 -LargeDispSampleRadius -softencosine -worldtextureshadows -game $gamedir $path\$file}}

	Meanwhile, for fast compiles when prototyping your map, you can simply use:		Meanwhile, for fast compiles when prototyping your map, you can simply use:
	-fast -hdr -game $gamedir $path\$file		{{pre\|-fast -hdr -game $gamedir $path\$file}}

	== Troubleshooting ==		== Troubleshooting ==

NinjaV at 14:48, 31 January 2026

2026-01-31T14:48:39Z

← Older revision		Revision as of 14:48, 31 January 2026
Line 14:		Line 14:

	== Step 2: Installing the custom compilation tools ==		== Step 2: Installing the custom compilation tools ==
			NOTE:May '''''NOT''''' work in the new TF2 Classified!

	A custom set of compile tools is required in order to have proper lighting on your maps, due to the default compilers not supporting custom shaders, and relying on DX8 models. We use the Mapbase VBSP and Slammin' VRAD which fix both of these problems, along with many other bugs.		A custom set of compile tools is required in order to have proper lighting on your maps, due to the default compilers not supporting custom shaders, and relying on DX8 models. We use the Mapbase VBSP and Slammin' VRAD which fix both of these problems, along with many other bugs.

Line 21:		Line 23:

	== Step 3: Configuring Hammer++ for TF2C ==		== Step 3: Configuring Hammer++ for TF2C ==
			=== For the new Team Fortress 2 Classified ===
			Go to {{code\|steamDir/steamapps/common/Team Fortress 2 Classified/bin/x64}} and run the {{hammer_tf2c_setup.bat}} file.

			=== For the legacy Team Fortress 2 Classic ===
	Open up Hammer++ by double-clicking "hammerplusplus.exe". After it's started, in the main interface, go to '''Tools''' -> '''Options''' -> '''"Game Configurations" tab''' -> Click "Edit" next to the "Configurations" drop-down. Add a new one, titled however you like.		Open up Hammer++ by double-clicking "hammerplusplus.exe". After it's started, in the main interface, go to '''Tools''' -> '''Options''' -> '''"Game Configurations" tab''' -> Click "Edit" next to the "Configurations" drop-down. Add a new one, titled however you like.

NinjaV: /* Step 1: Installing Hammer++ */

2026-01-31T14:41:34Z

Step 1: Installing Hammer++

← Older revision		Revision as of 14:41, 31 January 2026
Line 3:		Line 3:
	__TOC__		__TOC__
	== Step 1: Installing Hammer++ ==		== Step 1: Installing Hammer++ ==
			=== For the new Team Fortress 2 Classified ===
			Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Team Fortress 2" option and click it. This will download a ZIP file.

			If you open the ZIP file, you'll find a ''hammerplusplus_tf2_buildXXXX'' folder, which itself contains a ''bin'' folder. You should merge the ''bin'' folder inside of the ZIP with the ''bin'' folder in your ''Team Fortress 2 Classified'' directory that contains hammer.exe. After that's finished, hammerplusplus.exe and hammer.exe should be in the same folder.

			=== For the legacy Team Fortress 2 Classic ===
	Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Source SDK 2013 Multiplayer" option and click it. This will download a ZIP file.		Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Source SDK 2013 Multiplayer" option and click it. This will download a ZIP file.

Technochips: fyi the majority of the page will practically change after the steam release, i don't think putting that line in is that necessary especially when it's not out yet.

2025-08-09T16:33:01Z

fyi the majority of the page will practically change after the steam release, i don't think putting that line in is that necessary especially when it's not out yet.

← Older revision		Revision as of 16:33, 9 August 2025
Line 3:		Line 3:
	__TOC__		__TOC__
	== Step 1: Installing Hammer++ ==		== Step 1: Installing Hammer++ ==
	Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Source SDK 2013 Multiplayer" option and click it. This will download a ZIP file. ~~<br>Note: After TF2 Classic releases on Steam, the "Team Fortress 2" option will be required due to the game using the newer-SDK on Steam Release.~~		Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Source SDK 2013 Multiplayer" option and click it. This will download a ZIP file.


	If you open the ZIP file, you'll find a ''hammerplusplus_2013mpbuildXXXX'' folder, which itself contains a ''bin'' folder. You should merge the ''bin'' folder inside of the ZIP with the ''bin'' folder in your ''Source SDK Base 2013 Multiplayer'' directory that contains hammer.exe. After that's finished, hammerplusplus.exe and hammer.exe should be in the same folder.		If you open the ZIP file, you'll find a ''hammerplusplus_2013mpbuildXXXX'' folder, which itself contains a ''bin'' folder. You should merge the ''bin'' folder inside of the ZIP with the ''bin'' folder in your ''Source SDK Base 2013 Multiplayer'' directory that contains hammer.exe. After that's finished, hammerplusplus.exe and hammer.exe should be in the same folder.

NinjaV: added note about install after steam release

2025-08-09T16:20:06Z

added note about install after steam release

← Older revision		Revision as of 16:20, 9 August 2025
Line 3:		Line 3:
	__TOC__		__TOC__
	== Step 1: Installing Hammer++ ==		== Step 1: Installing Hammer++ ==
	Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Source SDK 2013 Multiplayer" option and click it. This will download a ZIP file.		Go to the [https://ficool2.github.io/HammerPlusPlus-Website/download.html download page for Hammer++], scroll down until you find the "Source SDK 2013 Multiplayer" option and click it. This will download a ZIP file. <br>Note: After TF2 Classic releases on Steam, the "Team Fortress 2" option will be required due to the game using the newer-SDK on Steam Release.


	If you open the ZIP file, you'll find a ''hammerplusplus_2013mpbuildXXXX'' folder, which itself contains a ''bin'' folder. You should merge the ''bin'' folder inside of the ZIP with the ''bin'' folder in your ''Source SDK Base 2013 Multiplayer'' directory that contains hammer.exe. After that's finished, hammerplusplus.exe and hammer.exe should be in the same folder.		If you open the ZIP file, you'll find a ''hammerplusplus_2013mpbuildXXXX'' folder, which itself contains a ''bin'' folder. You should merge the ''bin'' folder inside of the ZIP with the ''bin'' folder in your ''Source SDK Base 2013 Multiplayer'' directory that contains hammer.exe. After that's finished, hammerplusplus.exe and hammer.exe should be in the same folder.

VivaRomania: Gonna set a size on this image so it doesn't overflow outside the page on mobile, but should still look good on desktop

2025-06-19T03:39:34Z

Gonna set a size on this image so it doesn't overflow outside the page on mobile, but should still look good on desktop

← Older revision		Revision as of 03:39, 19 June 2025
Line 19:		Line 19:
	Edit this new configuration to point to the TF2C gamedata (the FGD files in the ''tf2classic'' folder), the game executable directory (your Source SDK Base 2013 Multiplayer folder), and the game directory (your ''tf2classic'' folder, containing GameInfo.txt)		Edit this new configuration to point to the TF2C gamedata (the FGD files in the ''tf2classic'' folder), the game executable directory (your Source SDK Base 2013 Multiplayer folder), and the game directory (your ''tf2classic'' folder, containing GameInfo.txt)

	[[File:Hammer Config.png\|thumb\|center\|upright=3\|Example image showcasing what your configuration should look like]]		[[File:Hammer Config.png\|780px\|thumb\|center\|upright=3\|Example image showcasing what your configuration should look like]]

	Now you're ready to get mapping for TF2 Classic!		Now you're ready to get mapping for TF2 Classic!