View source for Hammer++/Bugs and limitations with unsupported games

{{LanguageBar}}
{{cleanup|grammar and layout}} {{toc-right}}
=={{bms|4}}==
{{todo|Update under {{gmod|4}} version.}}
Works with {{src13sp|4}} or {{Src13mp|4}} version. However, there are some bugs and issues due to which you will not be able to work constantly.

===[[Lightmapped_4WayBlend]] is not loaded===
You will not be able to work with Xen levels and some Earthbound outdoor levels, since this shader is used for surfaces everywhere. 
<br>
<gallery mode=nolines heights=310px widths=310px>
File:4way1.jpg|Hammer
File:4way 222.jpg|Hammer++
</gallery>
<br>
<gallery mode=nolines heights=310px widths=310px>
File:4way_1.jpg|Hammer
File:4way 22.jpg|Hammer++
</gallery>
{{workaround|Use the Hammer++ version for {{gmod|4}}, as it is the only version of Hammer++ that supports [[Lightmapped_4WayBlend]].
{{note|You will need to add {{gmod|4}}'s shaders to the folder. You need it to make Hammer++ working.}}}}

===No surface blend preview===
[[WorldVertexTransition]] was replaced by [[LightmappedGeneric]] in {{bms|3.1}}. This means that you cannot see blended surfaces in Hammer++, since this feature is not provided.
<br>
<gallery mode=nolines heights=310px widths=310px>
File:Blended1.jpg|Hammer
File:Blended2.jpg|Hammer++
</gallery>

===[[GRPortal]] is not loaded===
This shader is used for the nihilanth's portals.
<br>
<gallery mode=nolines heights=310px widths=310px>
File:nihiportal1.jpg|Hammer
File:nihiportal2.jpg|Hammer++
</gallery>

===[[Physics Tool]] doesn't work properly with new ragdoll entities===
[[prop_ragdoll|prop_ragdoll_original]] and {{ent|misc_dead_hev}} are ragdoll entities, Hammer++ doesn't know about this. 
{{workaround|Add {{code|ragdoll()}} in [[FGD]] for these entities.}}
<br>
<gallery mode=nolines heights=310px widths=310px>
File:BMSragdolls.jpg|prop_ragdoll_original and misc_dead_hev simulating as "general" objects, in {{hpp|4}} while prop_ragdoll works fine.
</gallery>

===No [[Parallax_mapping#Parallax occlusion mapping in Black Mesa|Parallax Occlusion Mapping]] preview===
This game supports POM for some shaders. This effect doesn't displays in Hammer++.
<br>
<gallery mode=nolines heights=310px widths=310px>
File:BMSpom2.jpg|Hammer
File:BMSpom1.jpg|Hammer++
</gallery>

{{confirm|More ?}}

=={{strata|4}}==
Mainly works with the {{csgo|3.1}} version. Hammer++ will not provide features from {{StrataHammer|4}} and the engine (mainly UI elements and how it works with content). The convenience of its usage will depend on what you plan to do.

===Only supports the {{csgo|4}} model format===
{{strata|4}} supports all model formats from any game. Hammer++ for {{csgo|3.1}} only supports the model format from {{csgo|3.1}}, so you'll need to port models if they do not use this format.
{{workaround|Use the {{src13sp|3.1}} version}}
===No <code>Scale Override</code> preview===
Static props support the <code>Scale Override</code> keyvalue (similar to {{Src2|3.1}}). You will not see changes in Hammer++.
<br>
<gallery mode=nolines heights=310px widths=310px>
File:ScaleO1.jpg|{{StrataHammer|4.1}}
File:ScaleO2.jpg|{{hpp|4.1}}
</gallery>

===Custom folder is not supported===
{{strata|4}} supports the <code>custom</code> folder. Hammer++ for {{csgo|3.1}} doesn't.
{{workaround|Use the {{src13sp|3.1}} version}}

===Doesn't read <code>mounts.kv</code>===
<code>mounts.kv</code> is a way for {{strata|3.1}} to mount content from other games without editing the <code>[[gameinfo.txt]]</code>. Hammer++ doesn't read this file.

===Escape sequences are not supported===
Only {{strataHammer|4}} supports [https://learn.microsoft.com/en-us/cpp/c-language/escape-sequences?view=msvc-170 escape sequences].

=={{mapbase|4}}==
Works fine with {{src13sp|4}} version. Some custom shaders may work incorrectly, and some custom features will not work as expected.

===[[SDK_Cable]] doesn't work properly===
Display skybox instead of a cable texture.
<br>
<gallery mode=nolines heights=310px widths=310px>
File:cablaSDk.jpg|An example.
</gallery>

===Spotlight textures don't apply to spotlight preview===
{{mapbase|4}} supports customization of the beam and halo texture. Hammer++ always draws the standard textures.
<br>
<gallery mode=nolines heights=310px widths=310px>
File:spotLightMapbase.jpg|An example. Used [[obsolete]] icon for halo and electric texture for beam.
</gallery>

=={{l4ds|4}}==
Hammer++ for L4D2 works fine on {{l4d|4.1}}, except when compiling the map. After compiling the map and trying to join the map, an error will appear and display: ''STEAM validation rejected'' and after pressing ok, the menu will be frozen.

In {{l4d2|4.1}} (which is supported by Hammer++), the same error happens but without the Steam rejection, only displaying multiple repeating errors ''(C_CL4DGameStats: failed to download stats from Steam, EResult 2)'' on console and unable to interact with the menu.

{{fix|Remove the {{code|steam_appid.txt}} from the {{path|hammerplusplus}} folder.}} <!-- I don't see steam_appid.txt in any other hammerplusplus folders, only in l4d2, Accidentally left from the dev? -->

===Textures glitching on Displacements===
In {{l4d2|4.1}}, textures glitch on displacements when the camera view is far away.

{{workaround|Disable the ''Displacements'' [[VisGroup]].}}

<gallery mode=nolines heights=310px widths=310px>
File:Bug-L4d2 texture.png|{{hpp|4}}
File:Comparison Bug-L4D2 texture.png|{{Hammer|4}}
</gallery>

=== Skybox texture glitch ===
This only happens when you have [[env_sun]] in the map.

When looking at the skybox texture with other textures (e.g. {{code|tools/clip}}), entities, etc. The skybox appears normal, when only looking at the skybox texture without looking anything in the map, the texture changes to a sprite texture, which is {{code|sprites/light_glow02_add_noz}}.
{{workaround|[[Hammer_View_Menu#QuickHide_Objects_.3CH.3E|QuickHide]] the '''env_sun'''.}}

<!-- Also i bizarrely found out while making this new section -N0one -->
Also, while looking at the skybox with the sprite showing or looking somewhere in the map and having the Texture tool shown or the "Current texture" on the right side, when minimizing Hammer++ and then going back, the "Current texture" or the "Face Edit Sheet" will take a top left corner screenshot of the 3D view port and replace the image where the texture is supposed to be at.

===Graphics glitching with particles rendering enabled===
Certain particles will break viewports (both 2D and 3D) until Hammer++ is restarted.
<gallery mode=nolines heights=310px widths=310px>
File:Hpp l4d2 particle.jpg|Viewing decompiled c2m4_barns, near "stache whacker" minigame
</gallery>
{{workaround|Disable particle rendering using [[File:Hpp render particles.png|24px]] "Draw paritcles" button.}}


{{confirm|More ?}}

[[Category:Hammer++]]