Troubleshooting Level Design: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (minor fixes)
Line 3: Line 3:


;Compiling the map takes a very long time
;Compiling the map takes a very long time
:If your map is large or complicated, make sure you are using [[func_detail]] appropriately. See [[Controlling Geometry Visibility and Compile Times]].
:If your map is large or complicated, make sure you are using [[func_detail]] appropriately. See [[Controlling Geometry Visibility and Compile Times]].


;The compile window says there is a memleak
;The compile window says there is a memleak
:Don't worry; this is not an error. Carry on.
:Don't worry; this is not an error. Carry on.


;Compiling the map gives an error
;Compiling the map gives an error
Line 12: Line 12:


==In-game problems==
==In-game problems==
;People on the Internet join the game while you're trying to test it
;People on the Internet join the game while you're trying to test it
:By default, testing your map sets your computer up as a server over the Internet, so casual players may come across it and join. To prevent this, type ''sv_lan 1'' in the [[console]] before loading your map.
:By default, testing your map sets your computer up as a server over the Internet, so casual players may come across it and join. To prevent this, type ''sv_lan 1'' in the [[console]] before loading your map.


;Everything is very bright (no shadows)
;Everything is very bright (no shadows)
:You probably have a [[leak]]. It is also possible that you turned off the lighting stage in the Compile Options dialog.
:You probably have a [[leak]]. It is also possible that you turned off the lighting stage in the Compile Options dialog.


;Dynamic shadows (shadows for players and prop_physics) appear where they shouldn't
;Dynamic shadows (shadows for players and prop_physics) appear where they shouldn't
:This is a glitch. It can often interfere with gameplay, because it gives away player positions when they think they're hidden. To fix it, create an [[info_no_dynamic_shadow]] entity, and use its Pick button to select the offending surface.
:This is a shadow rendering error due to the method that shadows are calculated. It can often interfere with gameplay, because it gives away player positions when they think they're hidden. To fix it, create an [[info_no_dynamic_shadow]] entity, and use its Pick button to select the offending surface.


;Reflections look weird or too bright
;Reflections look weird or too bright
:Type "buildcubemaps" in the [[console]], and reload the map. Sometimes new cubemaps do not look correct until the map is reloaded. And make sure you've put in enough env_cubemaps.
:Type <code>buildcubemaps</code> in the [[console]], and reload the map. Sometimes new cubemaps do not look correct until the map is reloaded. And make sure you've put in enough [[env_cubemap]]s.


;Water is invisible from above, but looks correct from below
;Water is invisible from above, but looks correct from below
:Sometimes this happens if cubemaps have not been built yet. (Type buildcubemaps in the console.) It can also happen if you skipped the visiblity or lighting stage of compiling. The visibilty compile phase will not run correctly if you have a [[leak]].
:Sometimes this happens if cubemaps have not been built yet. (Type <code>buildcubemaps</code> in the [[console]].) It will also happen if you skipped the visiblity or lighting stage of compiling. The visibilty compile phase will not run correctly if you have a [[leak]].


;Invisible Prop
;Invisible Props
:The prop may have its fadeout distance set too close.
:The prop may have its End Fade distance set too close. Sometimes the value is accidentely changed while moving prop entities.


:Also, some props can only be used as certain types of props and otherwise will be invisible. For instance there are tables that only work as [[prop_physic]]s, and other props that only work as [[prop_dynamic]]s.
:Also, some props can only be used as certain types of props and otherwise will be invisible. For instance there are tables that only work as [[prop_physic]]s, and other props that only work as [[prop_dynamic]]s.


;Ladder doesn't work
;Ladder doesn't work
:Make sure the ladder entity is not touching anything solid. It must be at least one unit away from all solid surfaces. Read the [[Ladders - Adding ladder entities to levels.|instructions]] carefully. Ladders work differently in Half-Life 2 and in Counter-Strike: Source.
:Make sure the ladder entity is not touching anything solid. It must be at least one unit away from all solid surfaces. Read the [[Creating Ladders]] instructions carefully. Ladders work differently in Half-Life 2 and in Counter-Strike: Source.


;Building cubemaps causes the game to crash with a memory reference error
;Building cubemaps causes the game to crash with a memory reference error
:Make sure the game resolution is at least 800x600. This can also happen in widescreen mode.
:Make sure the game resolution is at least 800x600. This can also happen in widescreen mode.


==Trouble with Counter-Strike:Source Maps==
==Trouble with Counter-Strike:Source Maps==


;The hostages won't move
;The hostages won't move
:Hostages require a [[Bot Navigation for Counter-Strike:Source|navigation mesh]] in order to work. (They used to use info_nodes, but that is now obsolete.)
:Hostages require a [[Bot Navigation for Counter-Strike:Source|navigation mesh]] in order to work. (They used to use [[info_node]]s, but that is now obsolete.)


;When the map is loaded, it says "Both Teams are Full".
;When the map is loaded, it says "Both Teams are Full".
:You need to have both [[info_player_counterterrorist]] and [[info_player_terrorist]] entities in the map. See [[Making levels for Counter-Strike: Source]] for information on the necessary entities. Also check the console: if it reports that there are invalid spawn points, try moving them up away from the surface, because they may be intersection with the terrain. It is okay for them to start a little bit in the air.
:You need to have both [[info_player_counterterrorist]] and [[info_player_terrorist]] entities in the map. See [[Making levels for Counter-Strike: Source]] for information on the necessary entities. Also check the console: if it reports that there are invalid spawn points, try moving them up away from the surface, because they may be intersection with the terrain. It is okay for them to start a little bit in the air.

Revision as of 14:41, 21 July 2005

Trouble with Compiling Maps

Compiling the map takes a very long time
If your map is large or complicated, make sure you are using func_detail appropriately. See Controlling Geometry Visibility and Compile Times.
The compile window says there is a memleak
Don't worry; this is not an error. Carry on.
Compiling the map gives an error
See Compile Errors for a list of compiling errors with explanations, or visit this site: Interlopers.net error list

In-game problems

People on the Internet join the game while you're trying to test it
By default, testing your map sets your computer up as a server over the Internet, so casual players may come across it and join. To prevent this, type sv_lan 1 in the console before loading your map.
Everything is very bright (no shadows)
You probably have a leak. It is also possible that you turned off the lighting stage in the Compile Options dialog.
Dynamic shadows (shadows for players and prop_physics) appear where they shouldn't
This is a shadow rendering error due to the method that shadows are calculated. It can often interfere with gameplay, because it gives away player positions when they think they're hidden. To fix it, create an info_no_dynamic_shadow entity, and use its Pick button to select the offending surface.
Reflections look weird or too bright
Type buildcubemaps in the console, and reload the map. Sometimes new cubemaps do not look correct until the map is reloaded. And make sure you've put in enough env_cubemaps.
Water is invisible from above, but looks correct from below
Sometimes this happens if cubemaps have not been built yet. (Type buildcubemaps in the console.) It will also happen if you skipped the visiblity or lighting stage of compiling. The visibilty compile phase will not run correctly if you have a leak.
Invisible Props
The prop may have its End Fade distance set too close. Sometimes the value is accidentely changed while moving prop entities.
Also, some props can only be used as certain types of props and otherwise will be invisible. For instance there are tables that only work as prop_physics, and other props that only work as prop_dynamics.
Ladder doesn't work
Make sure the ladder entity is not touching anything solid. It must be at least one unit away from all solid surfaces. Read the Creating Ladders instructions carefully. Ladders work differently in Half-Life 2 and in Counter-Strike: Source.
Building cubemaps causes the game to crash with a memory reference error
Make sure the game resolution is at least 800x600. This can also happen in widescreen mode.

Trouble with Counter-Strike:Source Maps

The hostages won't move
Hostages require a navigation mesh in order to work. (They used to use info_nodes, but that is now obsolete.)
When the map is loaded, it says "Both Teams are Full".
You need to have both info_player_counterterrorist and info_player_terrorist entities in the map. See Making levels for Counter-Strike: Source for information on the necessary entities. Also check the console: if it reports that there are invalid spawn points, try moving them up away from the surface, because they may be intersection with the terrain. It is okay for them to start a little bit in the air.