func_viscluster

func_viscluster is an internal brush entity available in all Source games since Source 2007.

tools\tools_viscluster from Black Mesa, a custom trigger texture designed to make it easy to identify visclusters.

It allows you to manually tell VVIS that the visleafs inside its volume can all see each other and should be treated as one. This is useful in large open areas where visibility calculations would otherwise take a very, very long time to complete. Poor use may be expensive for in-game performance. It can be textured with any material, but is conventionally textured with a trigger material, such as tools\toolstrigger.

Note:This is an internal entity. When the map is compiled by VBSP, it is processed and then removed; it does not exist when the map is running.

Note:This entity does not actually change the location or number of leafs in a map. Hammer's portal file says this occurs, but commands such as mat_leafvis show the leaves to still be intact.

Warning:The brush should not cross the surface of a water material or an areaportal. If it really does need to be used over water, bring the brush level with the surface of the water on one side, and then create a second, separate func_viscluster on the other side. Never allow a func_viscluster brush to cross a water plane, or very strange things happen.

See also

• Viscluster video tutorial
• Visibility optimization