Hammer Check For Problems Dialog: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
 
m (Nesciuse moved page Hammer Check For Problems Dialog/en to Hammer Check For Problems Dialog without leaving a redirect: Move en subpage to basepage)
 
(21 intermediate revisions by 14 users not shown)
Line 1: Line 1:
[[Category:Level Design]]
{{LanguageBar}}
=Check for problems        Shortcut: ALT+P=


[[Image:hammer checkforproblemsdialog.jpg]]
 
__NOTOC__[[File:hammer checkforproblemsdialog.png|right]]


Opening this dialog will cause Hammer to run through your map and notify you of any errors it finds.
Opening this dialog will cause Hammer to run through your map and notify you of any errors it finds.


When you select one of the errors, the entity/solid will be highlighted (if applicable) and three options become available to you.
When you select one of the errors, the [[entity]]/solid will be highlighted (if applicable) and three options become available to you:
 
== Go to error ==
This button will center the 2D and 3D views on the object that the error is referring to.
 
{{tip|Double-clicking on an item in the list can also be used a shortcut to show the error.}}
 
== Fix ==
This button will attempt to fix the currently selected error.


=Go to error=
== Fix all (of type) ==
Using this button will fix all errors of the selected error type.


This button will center the 2D windows on the selected error object.
{{note|The '''Check for Problems''' command looks for errors in unmodified, supported game types (Half-Life 2 , Counter-Strike, etc). If you are creating maps for a proprietary game with your own game code and .[[FGD]], some or all of the errors generated by this command may not be applicable.}}


=Fix=
== Check visible parts of the map only ==
When this is selected, errors related to objects in hidden [[Grouping and VisGrouping|Visgroups]] will not be shown in the list.{{clr}}


This button will attempt to fix the currently selected error.
== Common errors ==
; <code>Invalid solid structure</code>
: The solid has invalid structure, probably as a result of [[vertex manipulation]]. What this means is that the solid is not convex in every plane. You will need to either fix it, or if this is not possible, rebuild it.


=Fix all (of type)=
; <code>Solid Entity (entity_name) is empty.</code>
: This solid-entity contains no solids. Fixing the error deletes the entity.


Selected this button will fix all errors of the selected type.
; <code>Entity (entity_name) has unused keyvalue "key_name".</code>
: The entity contains [[keyvalues]] (variables) that are not used in its class. You can fix this error with the Fix button. Note that this error will pop up if you are taking advantage of custom compile tools which add keyvalues to entities, but you are not using an FGD file that has these special keyvalues listed.


'''Note:''' The '''Check for Problems''' command looks for errors in unmodified, supported game types (Half-Life 2 , Counter-Strike, etc). If you are creating maps for a proprietary game with your own game code and .FGD, some or all of the errors generated by this command may not be applicable.
; <code>There is no player start.</code>
: There is no [[info_player_start]] entity in the map. This error could also occur if you are using the [[Hammer_Cordon_Usage|Edit Cordon Bounds]] tool, and the player start entity was not inside the cordon area marked. If no player start point was created, use the [[Hammer Entity Tool|Entity Tool]] to create one.


=Some common errors that may occur in your maps...=
== See also ==
* [[Optimizing and Checking Your Map]]
* [[Controlling Geometry Visibility and Compile Times]]
* [[Compile Errors]]
* [[Troubleshooting Level Design]]


{|
[[Category:Hammer Dialogs]]
| <code>Invalid solid structure</code> || | The solid has invalid structure, probably as a result of vertex manipulation. What this means is that the solid is not convex in every plane. You will need to either fix it, or if this is not possible, rebuild it.
|-
| <code>Solid Entity (entity_name) is empty.</code> || This solid-entity contains no solids. Fixing the error deletes the entity.
|-
| <code>Entity (entity_name) has unused keyvalues.</code> || The entity contains keyvalues (variables) that are not used in its class. You can fix this error with the Fix button. Note that this error will pop up if you are taking advantage of custom compile tools which add keyvalues to entities, but you are not using an FGD file that has these special keyvalues listed.
|-
| <code>There is no player start.</code> || There is no info_player_start entity in the map, or the start point was embedded in a solid object. This error could also occur if you are using the '''Edit Cordon Bounds''' tool, and the player start entity was not inside the cordon area marked. If no player start point was created, use the '''Entity Tool''' to create one.
|}

Latest revision as of 07:20, 12 July 2024

English (en)Deutsch (de)Translate (Translate)


Hammer checkforproblemsdialog.png

Opening this dialog will cause Hammer to run through your map and notify you of any errors it finds.

When you select one of the errors, the entity/solid will be highlighted (if applicable) and three options become available to you:

Go to error

This button will center the 2D and 3D views on the object that the error is referring to.

Tip.pngTip:Double-clicking on an item in the list can also be used a shortcut to show the error.

Fix

This button will attempt to fix the currently selected error.

Fix all (of type)

Using this button will fix all errors of the selected error type.

Note.pngNote:The Check for Problems command looks for errors in unmodified, supported game types (Half-Life 2 , Counter-Strike, etc). If you are creating maps for a proprietary game with your own game code and .FGD, some or all of the errors generated by this command may not be applicable.

Check visible parts of the map only

When this is selected, errors related to objects in hidden Visgroups will not be shown in the list.

Common errors

Invalid solid structure
The solid has invalid structure, probably as a result of vertex manipulation. What this means is that the solid is not convex in every plane. You will need to either fix it, or if this is not possible, rebuild it.
Solid Entity (entity_name) is empty.
This solid-entity contains no solids. Fixing the error deletes the entity.
Entity (entity_name) has unused keyvalue "key_name".
The entity contains keyvalues (variables) that are not used in its class. You can fix this error with the Fix button. Note that this error will pop up if you are taking advantage of custom compile tools which add keyvalues to entities, but you are not using an FGD file that has these special keyvalues listed.
There is no player start.
There is no info_player_start entity in the map. This error could also occur if you are using the Edit Cordon Bounds tool, and the player start entity was not inside the cordon area marked. If no player start point was created, use the Entity Tool to create one.

See also