Func water (Source)

GoldSrc

Source Engine

Source 2

Edit Tabs

Class hierarchy
CBaseDoor ↳CBaseToggle ↳CBaseEntity
doors.cpp

This entity is not in the FGD by default.
See below for instructions on making it available.

This entity is obsolete. Its use is discouraged. It may only exist/function in older engine branches.
It has since been deprecated by: func_water_analog. Non-moving water brushes should be part of worldspawn.

func_water is a semi-internal brush entity available in all Source games. An entity-based water brush, being assigned water contents by VBSP. A legacy entity from the GoldSrc engine, deprecated by func_water_analog. It is still used in some Half-Life: Source maps.

Water entity notes (edit):

Important:Does not work with the Water shader.
Refract can be used as a workaround for dynamic refraction with cubemapped reflections, although Valve does not provide any materials which do this.
Existing materials which are compatible include:

• nature/water_movingplane.vmt (LightmappedGeneric)
• nature/water_dx70.vmt (LightmappedGeneric)
• nature/hazard_liquid.vmt (LightmappedGeneric) (only in )
• liquids/!greenslime.vmt (UnlitTwoTexture) (only in )

Confirm:Does the Water shader work if using cubemap reflections and refractions, instead of the real-time versions? This would still be beneficial for the ability to have two normal maps scrolling in different directions.

Bug:Water must be part of the world in Left 4 Dead series otherwise it doesn't work properly and acts as non-solid brush.

Non-Valve games ()

Bug:In Black Mesa, if this entity uses multiple brushes, VPhysics objects interact incorrectly with this entity. It looks like they are using BBox of this entity to calculate physics, instead of using brushes. This issue can be found in Interloper chapter. Separate water into several separate entities to avoid this bug. Examples. Note how the hat is "flying in air". Note how the hat is "flying in air".

Code:Both func_water and func_door are linked to CBaseDoor C++ class. The game code checks the classname KV to distinguish between them, applying specific behaviors if the classname is "func_water". As such, using AddOutput to change the classname of a func_water may have unexpected effects.

Keyvalues

Name (targetname) <string>

The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.

See also: Generic Keyvalues, Inputs and Outputs available to all entities

Note:All Keyvalues / Inputs / Outputs are same as func_door.

FGD Code

While func_water exists in base.fgd, it is commented out. It can either be uncommented, or this simpler FGD entry can be added anywhere after the func_door entry.

@SolidClass base(func_door) = func_water : "A water brush entity that moves linearly along a given distance, in a given direction." []

See also

• func_water_analog